====== 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. * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}} ===== 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: [[homelab:besluiten:26.014-dns_voor_containers_via_pi-hole|26.014]]. - **Subnet:** geef de stack een vast subnet ''172.16..0/24'' (stack 37 krijgt ''172.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 vangnet ''172.26.0.0/15''; de indeling en de reden staan in het [[homelab:standaarden:netwerk:ip-plan|IP-plan]]. - **Updatebeleid:** bepaal de categorie (A tot en met D) en zet de labels. Categorieën, labels en afkoeltijden: [[homelab:services:wud|WUD]] en [[homelab:besluiten:26.009-updatebeleid_containers_wud|26.009]]. - **Limieten:** meet het gebruik en zet ''mem_limit'' (ongeveer 2× de piek) en ''cpu_shares''. Zie [[homelab:besluiten:26.012-limiteren_ram_containers|26.012]]. - **Bijwerken in Portainer** met //Re-pull image// uit, zodat er geen image-update buiten WUD om binnenkomt. - **Na opnieuw aanmaken:** open in DSM //Container Manager → Container//, zodat Synology weer naar de nieuwe container wijst. Anders kan de container na een DSM-update wegblijven. Zie de les [[homelab:lessen:containerlijst_dsm_verversen_na_opnieuw_aanmaken|containerlijst verversen]]. - **Mounts:** koppel geen volume-root (zoals ''/volume1'') maar een bestaande gedeelde map (zoals ''/volume1/Media''). Synology kan bij een volume-root geen gedeelde map bepalen en start zo'n container na een DSM-update niet (fout 117). Zie dezelfde les. - **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 | ===== Containers in het servers-VLAN ===== Alleen voor containers die van buiten bereikbaar zijn ([[homelab:besluiten:26.015-servers-vlan_voor_extern_bereikbare_containers|26.015]]). In plaats van ''dns: 192.168.1.10'' gebruikt zo'n container ''dns: 192.168.5.10'' (Pi-hole via de NAS, binnen het VLAN). De container krijgt het externe netwerk ''servers'' met een vast adres uit 192.168.5.32 tot en met 192.168.5.99 (bij voorkeur het stacknummer in Portainer, bijvoorbeeld 192.168.5.53 voor stack 53). Bij een stack met meerdere services (bijvoorbeeld Joplin en zijn database) komt alleen de service die van buiten bereikbaar moet zijn in ''servers''; de rest blijft in het eigen stacknetwerk, en de service staat in beide netwerken. In de reverse proxy van DSM wijst de backend dan naar het adres in 192.168.5.x. services: omnitools: image: ... dns: - 192.168.5.10 networks: servers: ipv4_address: 192.168.5.32 networks: servers: external: true Een dienst op de NAS die zo'n container nodig heeft (bijvoorbeeld Plex of Sonarr) is bereikbaar op 192.168.5.10:poort, en daarvoor is een poortregel in de DSM-firewall nodig voor 192.168.5.0/24. ===== 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 [[homelab:services:portainer|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 [[homelab:standaarden:netwerk:ip-plan|IP-plan]]. ===== Relaties ===== * Besluiten: \\ {{backlinks>.#homelab:besluiten}} * Thema's: {{tag>container dns}}