homelab:standaarden:containers
This is an old revision of the document!
Table of Contents
Containers
- Wat: wat er bij het aanmaken van elke nieuwe container of stack in Portainer geregeld moet zijn.
- Doel: elke container is bij de eerste start goed ingericht (DNS, subnet, updatebeleid, limieten), zonder dat je het later moet nalopen.
Regel
Bij elke nieuwe container of stack, in deze volgorde:
- DNS: elke service met uitgaand verkeer krijgt
dns: 192.168.1.10(Pi-hole), zodat hij per container zichtbaar is. Bij meerdere services staat het adres één keer bovenaan als variabele, bij één service direct bij de service. Waarom: 26.014. - Subnet: geef de stack een vast subnet
172.16.<stack-id>.0/24(stack 37 krijgt172.16.37.0/24), zodat de adressen in Pi-hole niet verspringen en Docker niet terugvalt op een 192.168.x-blok dat kan botsen met het LAN of een VLAN. Bestaande stacks krijgen het bij de eerstvolgende wijziging; het gaat in na een redeploy van de stack. Een netwerk zonder vast subnet krijgt automatisch een adres uit het vangnet172.26.0.0/15; de indeling en de reden staan in het IP-plan. - Bijwerken in Portainer met Re-pull image uit, zodat er geen image-update buiten WUD om binnenkomt.
- Documentatie: een servicepagina volgens de template, en de container in de indeling op de WUD-pagina.
Uitzonderingen op de DNS-regel
Geen dns: bij:
| Container | Reden |
|---|---|
| Pi-hole, Plex, Beszel-Agent | network_mode: host: gebruiken het netwerk van de NAS zelf, dns: is dan niet toegestaan |
| joplin-indexer | network_mode: container:Joplin-DB: deelt het netwerk van een andere container |
| Databases en caches (Joplin-DB, ghostfolio-db, ghostfolio-redis) | geen uitgaand verkeer |
Toepassingsgebied
Alle containers die op de NAS via Portainer als stack zijn aangemaakt. Een stack die alleen host-modus gebruikt heeft geen eigen netwerk en dus geen subnet nodig.
Voorbeeld
Een stack met meerdere services:
x-my-dns: &my-dns - 192.168.1.10 services: prowlarr: image: ... networks: - arr dns: *my-dns networks: arr: ipam: config: - subnet: 172.16.37.0/24
Een stack met één service:
services: omnitools: image: ... dns: - 192.168.1.10 networks: default: ipam: config: - subnet: 172.16.23.0/24
Beheer
Compose per stack in Portainer. Het DNS-adres staat nu in alle stacks; wijzigt het, zoek dan in de compose-bestanden op 192.168.1.10. De vergeven subnetten vind je door te zoeken op 172.16.. Het vangnet staat in dockerd.json op de NAS, zie het IP-plan.
Relaties
homelab/standaarden/containers.1792608013.txt.gz · Last modified: by 127.0.0.1
