Portainer: kontajnery cez prehliadač

Portainer je webové rozhranie pre Docker: zoznam kontajnerov, logy, konzola do kontajnera, volumes, siete a Compose stacky. Je praktický, keď sa nechceš zakaždým pripájať cez SSH len preto, aby si „videl, čo spadlo“.

Inštalácia

docker volume create portainer_data
docker run -d \
  --name portainer \
  --restart unless-stopped \
  -p 127.0.0.1:9443:9443 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:2.21.4

Port je naviazaný na lokálne rozhranie. Panel môžeš otvoriť cez SSH tunel:

ssh -L 9443:127.0.0.1:9443 root@<machine-address>

Potom v prehliadači otvor https://localhost:9443. Certifikát je self-signed, takže prehliadač ťa upozorní — to je pri prístupe cez tunel normálne.

Prvého administrátora vytvorí ten, kto panel otvorí ako prvý. Ak si port vystavil do internetu a odišiel si na čaj, administrátor nebudeš ty. Portainer zatvára registráciu pár minút po štarte, ale nespoliehaj sa na to — vytvor si účet hneď.

Prečo je to nebezpečné a čo s tým

Panel pripája /var/run/docker.sock. Prístup k tomuto socketu je ekvivalent roota na stroji: cez neho môžeš spustiť kontajner s pripojeným rootom hostiteľa. Preto platia tieto pravidlá:

• Nevystavuj port do internetu. Použi buď SSH tunel, alebo webový server s certifikátom a dvojfaktorovým overením.
• Nastav administrátorské heslo dlhé a jedinečné, nie rovnaké ako root heslo stroja.
• Jednotlivým ľuďom daj samostatné účty s obmedzenými právami, nie spoločné prihlásenie.
• Ak panel potrebuješ len zriedka, nechaj kontajner zastavený a spusti ho, keď treba: docker start portainer.

Čo je na ňom praktické

• Logy s vyhľadávaním a zvýrazňovaním — rýchlejšie než docker logs v textovej konzole 80×24.
• Konzola do kontajnera priamo v prehliadači.
• Stacky — vložíš obsah compose.yaml, klikneš na nasadenie. Dobré na jednorazové služby, ale pri trvalých je lepšie mať súbor na disku pod správou verzií: stack vytvorený v paneli sa pri preinštalovaní ľahko stratí.
• Volumes a image — vidíš, čo koľko miesta zaberá; pomôže pri riešení nedostatku miesta.

Čo by si v ňom nemal robiť

• Neuchovávaj v ňom jedinú kópiu definícií svojich služieb. Súbory compose.yaml v adresári na disku prežijú panel.
• Neaktualizuj kontajnery tlačidlom „recreate“ bez toho, aby si rozumel tomu, čo sa stane s volumes. Pozri aktualizácia kontajnerov.
• Nepovažuj ho za náhradu monitoringu. Portainer zobrazuje aktuálny stav, nie históriu, a neposiela upozornenia — na to potrebuješ Uptime Kuma.

Zdroje

Kontajner spotrebúva približne 100 MB pamäte a beží na ľubovoľnom tier. Dáta sa ukladajú do volume portainer_data: účty, nastavenia, stacky. Zahrň ho do svojej zálohy alebo buď pripravený nastaviť panel odznova.

Časté chyby

• Zabudnutie, že panel spravuje len tento stroj. Môže spravovať aj druhý stroj, ale na to potrebuje agenta na ňom a otvorený port medzi nimi.
• Používanie tagu latest pre samotný panel. Väčšia aktualizácia mení formát dát. Pripni verziu.
• Zmazanie „nepoužívaného“ volume cez čistenie. Portainer ťa síce upozorní, ale ľudia kliknú na tlačidlo bez čítania. Volumes s databázami vyzerajú ako nepoužívané, kým je kontajner zastavený — pozri volumes.