docs(docker): better life cycle examples for net manifest

addresses bca5fcc1d3
This commit is contained in:
jon r 2024-10-11 12:51:14 +02:00
parent d90f8292a6
commit 57ca4fd86d
1 changed files with 18 additions and 4 deletions

View File

@ -79,18 +79,30 @@ Træfik.
Then run the network services to access the running containers.
2. Launch the Træfik web proxy and the dnsmasq resolver using the `net` manifest:
2. Launch the Træfik web proxy, the dnsmasq resolver and the nullmailer using
the `net` manifest:
```sh
docker compose -f compose.net.yml up -d
```
Manage the networking services with regular [Compose life cycle commands](https://docs.docker.com/reference/cli/docker/compose/):
<details><summary>Manage the networking services with regular <a href="https://docs.docker.com/reference/cli/docker/compose/" target="_blank">Compose life cycle commands</a>.</summary>
:::{hint}
```sh
docker compose -f compose.net.yml `config`, `ps`, `stop`, `rm`, `down`, …
docker compose -f compose.net.yml config
docker compose -f compose.net.yml ps
docker compose -f compose.net.yml stop
docker compose -f compose.net.yml rm
docker compose -f compose.net.yml down
docker compose -f compose.net.yml …
```
:::
</details>
3. Add the DNS search domain for `~funkwhale.test` to your system. This allows your system to dereference our domain names `funkwhale.funkwhale.test`, `node1.funkwhale.test`, `node2.…`, `…` to the IP address of the Træfik reverse proxy listening at `172.17.0.1`.
::::{tab-set}
@ -148,7 +160,9 @@ When everything works as expected, you can also access it at
:::
:::{note}
If your `docker0` network has running containers (other than funkwhale) already attached to it, comment out the `net.helpers.docker0.yml` rule in `compose.net.yml`.
If your `docker0` network has running containers not belonging to Funkwhale
already attached to it, comment out the `net.helpers.docker0.yml` rule in
`compose.net.yml`.
Then restart the networking stack with `docker compose -f compose.net.yml up -d`.
:::