User Tools

Site Tools


homelab:standaarden:containers

This is an old revision of the document!


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:

  1. 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.
  2. Subnet: geef de stack een vast subnet 172.16.<stack-id>.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 IP-plan.
  3. Updatebeleid: bepaal de categorie (A tot en met D) en zet de labels. Categorieën, labels en afkoeltijden: WUD en 26.009.
  4. Limieten: meet het gebruik en zet mem_limit (ongeveer 2× de piek) en cpu_shares. Zie 26.012.
  5. Bijwerken in Portainer met Re-pull image uit, zodat er geen image-update buiten WUD om binnenkomt.
  6. 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