doc: Update Custom Configurarion documentation
This commit is contained in:
40
README.md
40
README.md
@@ -21,6 +21,7 @@ For other methods to install `salt-master` please refer to the [Official Salt Pr
|
|||||||
- [Changelog](CHANGELOG.md)
|
- [Changelog](CHANGELOG.md)
|
||||||
- [Quick Start](#quick-start)
|
- [Quick Start](#quick-start)
|
||||||
- [Configuration](#configuration)
|
- [Configuration](#configuration)
|
||||||
|
- [Custom Configuration](#custom-configuration)
|
||||||
- [Custom States](#custom-states)
|
- [Custom States](#custom-states)
|
||||||
- [Minion Keys](#minion-keys)
|
- [Minion Keys](#minion-keys)
|
||||||
- [Master Signed Keys](#master-signed-keys)
|
- [Master Signed Keys](#master-signed-keys)
|
||||||
@@ -99,6 +100,39 @@ docker run --name salt_master --detach \
|
|||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
|
### Custom Configuration
|
||||||
|
|
||||||
|
This image uses its own `master.yml` file to configure `salt-master` to run properly inside the container. However, you can still tune other configuration parameters to fit your needs by adding your configuration files into a `config/` directory and mounting it into `/home/salt/data/config/`.
|
||||||
|
|
||||||
|
For example, you can customize the [Reactor System](https://docs.saltproject.io/en/latest/topics/reactor/index.html) by adding a `reactor.conf` file to `config/`:
|
||||||
|
|
||||||
|
```sls
|
||||||
|
# config/reactor.conf
|
||||||
|
reactor: # Master config section "reactor"
|
||||||
|
- 'salt/minion/*/start': # Match tag "salt/minion/*/start"
|
||||||
|
- /srv/reactor/start.sls # Things to do when a minion starts
|
||||||
|
```
|
||||||
|
|
||||||
|
Then, you have to add the `start.sls` file into your `roots/reactor/` directory:
|
||||||
|
|
||||||
|
```sls
|
||||||
|
# roots/reactor/start.sls
|
||||||
|
highstate_run:
|
||||||
|
local.state.apply:
|
||||||
|
- tgt: {{ data['id'] }}
|
||||||
|
```
|
||||||
|
|
||||||
|
Finally, run your `docker-salt-master` instance mounting the required directories:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
docker run --name salt_master -d \
|
||||||
|
--publish 4505:4505 --publish 4506:4506 \
|
||||||
|
--volume $(pwd)/roots/:/home/salt/data/srv/ \
|
||||||
|
--volume $(pwd)/keys/:/home/salt/data/keys/ \
|
||||||
|
--volume $(pwd)/config/:/home/salt/data/config/ \
|
||||||
|
cdalvaro/docker-salt-master:latest
|
||||||
|
```
|
||||||
|
|
||||||
### Custom States
|
### Custom States
|
||||||
|
|
||||||
In order to provide salt with your custom states you must mount the volume `/home/salt/data/srv/` with your `roots` directory inside it.
|
In order to provide salt with your custom states you must mount the volume `/home/salt/data/srv/` with your `roots` directory inside it.
|
||||||
@@ -555,7 +589,7 @@ Where `salt-service` is one of: `salt-master` os `salt-api` (if `SALT_API_SERVIC
|
|||||||
[stackoverflow_community]: https://stackoverflow.com/tags/salt-stack
|
[stackoverflow_community]: https://stackoverflow.com/tags/salt-stack
|
||||||
[slack_badge]: https://img.shields.io/badge/slack-@saltstackcommunity-blue.svg?logo=slack&logoColor=4A154B&color=4A154B
|
[slack_badge]: https://img.shields.io/badge/slack-@saltstackcommunity-blue.svg?logo=slack&logoColor=4A154B&color=4A154B
|
||||||
[slack_community]: https://saltstackcommunity.herokuapp.com
|
[slack_community]: https://saltstackcommunity.herokuapp.com
|
||||||
[arch_amd64_badge]: https://img.shields.io/badge/arch-amd64-2496ED.svg
|
[arch_amd64_badge]: https://img.shields.io/badge/arch-amd64-inactive.svg
|
||||||
[arch_arm_badge]: https://img.shields.io/badge/arch-arm/v7-2496ED.svg
|
[arch_arm_badge]: https://img.shields.io/badge/arch-arm/v7-inactive.svg
|
||||||
[arch_arm64_badge]: https://img.shields.io/badge/arch-arm64-2496ED.svg
|
[arch_arm64_badge]: https://img.shields.io/badge/arch-arm64-inactive.svg
|
||||||
[arch_link]: https://github.com/users/cdalvaro/packages/container/package/docker-salt-master
|
[arch_link]: https://github.com/users/cdalvaro/packages/container/package/docker-salt-master
|
||||||
|
|||||||
Reference in New Issue
Block a user