MirrorMirror
/
funkwhale
mirror of https://dev.funkwhale.audio/funkwhale/funkwhale.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/developer/setup/docker.md
View File

@ -79,18 +79,30 @@ Træfik.
Then run the network services to access the running containers. 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 ```sh
docker compose -f compose.net.yml up -d 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 ```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`. 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} ::::{tab-set}
@ -148,7 +160,9 @@ When everything works as expected, you can also access it at
::: :::
:::{note} :::{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`. Then restart the networking stack with `docker compose -f compose.net.yml up -d`.
::: :::