Skip to content

Commit

Permalink
feat: updated README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
kemboi22 committed Aug 2, 2024
1 parent 9070983 commit 35cc838
Showing 1 changed file with 4 additions and 31 deletions.
35 changes: 4 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,17 @@
# ns8-linkstack

This is a template module for [NethServer 8](https://github.com/NethServer/ns8-core).
To start a new module from it:

1. Click on [Use this template](https://github.com/NethServer/ns8-linkstack/generate).
Name your repo with `ns8-` prefix (e.g. `ns8-mymodule`).
Do not end your module name with a number, like ~~`ns8-baaad2`~~!

1. Clone the repository, enter the cloned directory and
[configure your GIT identity](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup#_your_identity)

1. Rename some references inside the repo:
```
modulename=$(basename $(pwd) | sed 's/^ns8-//') &&
git mv imageroot/systemd/user/linkstack.service imageroot/systemd/user/${modulename}.service &&
git mv imageroot/systemd/user/linkstack-app.service imageroot/systemd/user/${modulename}-app.service &&
git mv tests/linkstack.robot tests/${modulename}.robot &&
sed -i "s/linkstack/${modulename}/g" $(find .github/ * -type f) &&
git commit -a -m "Repository initialization"
```

1. Edit this `README.md` file, by replacing this section with your module
description

1. Adjust `.github/workflows` to your needs. `clean-registry.yml` might
need the proper list of image names to work correctly. Unused workflows
can be disabled from the GitHub Actions interface.

1. Commit and push your local changes

## Install

Instantiate the module with:

add-module ghcr.io/nethserver/linkstack:latest 1
add-module ghcr.io/gesniusdynamics/linkstack:latest 1

The output of the command will return the instance name.
Output example:

{"module_id": "linkstack1", "image_name": "linkstack", "image_url": "ghcr.io/nethserver/linkstack:latest"}
{"module_id": "linkstack1", "image_name": "linkstack", "image_url": "ghcr.io/gesniusdynamics/linkstack:latest"}

## Configure

Expand Down Expand Up @@ -85,7 +58,7 @@ Some configuration settings, like the smarthost setup, are not part of the
`configure-module` action input: they are discovered by looking at some
Redis keys. To ensure the module is always up-to-date with the
centralized [smarthost
setup](https://nethserver.github.io/ns8-core/core/smarthost/) every time
setup](https://gesniusdynamics.github.io/ns8-core/core/smarthost/) every time
linkstack starts, the command `bin/discover-smarthost` runs and refreshes
the `state/smarthost.env` file with fresh values from Redis.

Expand Down Expand Up @@ -157,7 +130,7 @@ podman exec -ti linkstack-app sh
Test the module using the `test-module.sh` script:


./test-module.sh <NODE_ADDR> ghcr.io/nethserver/linkstack:latest
./test-module.sh <NODE_ADDR> ghcr.io/gesniusdynamics/linkstack:latest

The tests are made using [Robot Framework](https://robotframework.org/)

Expand Down

0 comments on commit 35cc838

Please sign in to comment.