TIP#2943: Jak je to s tím spouštěním/zakládáním Docker kontejnerů z příkazové řádky?

Docker kontejner můžete zprovoznit různé, ta základní cesta je, že to uděláte z příkazové řádky. Složité to není, ale je dobré vědět pár drobnosti.

docker run -d --restart unless-stopped --log-opt max-size=10m \
  -p 8080:80 \
  -e TZ=Europe/Paris \
  -e 'CRON_MIN=1,31' \
  -v freshrss_data:/var/www/FreshRSS/data \
  -v freshrss_extensions:/var/www/FreshRSS/extensions \
  --name freshrss \
  freshrss/freshrss

“docker run” znamená, že chcete spustit kontejner a “-d” je detached mode, který potřebujete, pokud chcete něco spustit dlouhodobě a nechat běžet.

“–restart unless-stopped” zajistí, že se váš kontejner opět spustí po (například) restartu počítače či dockeru).

“–log-opt max-size 10m” není běžné, ale omezuje to velikost logování na 10 MB

“-p 8080:80” je podstatně, mapuje to port 80 z kontejneru na port 8080 pro přístup zvenčí. Takže budete aplikaci mít na adrese vašeho dockeru a portu 8080.

“-e” nastavuje proměnné prostředí (mělo by tam být Europe/Prague pr Česko) a bude záležet, jaké proměnné používá samotný kontejner a pak také jaké Linuxové proměnné chcete nastavit. Zjistíte v dokumentaci ke kontejneru. 

“-v” je extrémně důležité, protože tím nastavíte kam si bude kontejner ukládat data. Pokud tohle neuděláte a kontejner přestane běžet, tak o všechna data (nastavení, atd) přijde. Tady je dobré vědět, že v této podobě dojde k založení docker volume (což můžete dělat předem i ručně), konkrétně dvou – freshrss_data a freshrss_extensions  – druhá část určuje, kam v rámci toho volume se budou ukládat věci (je to interní cesta v kontejneru). Opět bude záležet na dané aplikaci, takže konzultujte dokumentaci.

Pokud použijete místo čistého názvu cestu (tv. bind mount), tak si buď založte příslušnou složku předem, ale neuděláte-li to, založí se a použije. Takže i pozor, ať to píšete správně a nemáte pak tyhle věci náhodně rozeseté po disku.

Obecně je lepší využívat právě volume, pokročilejší využití (vývojáři, atd) mají u bind mount různé další výhody. Výhoda použití volume je i ta, že budete mít přehled – každý kontejner bude mít vlastní volume, ty jsou na disku na jednom místě a můžete je i vidět a zkoumat přes docker a další nástroje. 

• přehled založených volume pomoci docker volume ls
• detaily ke konkrétnímu pomocí docker volume inspect jméno
• co běží a kolik toho žere pomocí docker stats

“–name freshrss” určí jak se bude běžící kontejner jmenovat. Unikátní jména, samozřejmě. A můžete mít víc (v tomto případě) freshrss kontejnerů, pokud byste chtěli. 

“freshrss/freshrss” je odkud se kontejner stáhne (název, určení docker image), přidá do vašeho dockeru a poté ho bude možné spustit¨. Pro Heimdall to bude například “lscr.io/linuxserver/heimdall:latest” a určuje to i verzi (:latest neboli poslední) a odkud se stahuje. 

Parametrů má docker run samozřejmě mnohem více, takže se budete setkávat i s jinými, složitějšími podobami.

Alternativou k příkazové řádce je docker compose cesta. Budete vytvářet .yml soubor, který popisuje totéž, co jste výše zadali v příkazové řádce. Ale o tom až někdy jindy.

Ale ještě jedno doporučení, schovávejte si jak jste docker věci spouštěli, může se to hodit pokud je budete chtít zahodit a vytvářet znovu. Docker compose (.yml) mít schované mít budete, je to soubor, ale příkazovou řádku je dobré si uložit do “dokumentace”. Ušetří to čas, protože byste to jinak musel lovit z dockeru (docker inspect) a v původní podobě to získat nejde.

TIP: O FreshRSS zde zmiňovaném je řeč v Náhrada za Feedly? Lokální, napojitelná na Notion a jiné? Jde to. Praktické zkušenost s FreshRSS. Dlouho jsem ho měl na QNAP NAS, čerstvě jsem ho zprovozňoval na Raspberry Pi 5.

Další tipy týkající se Dockeru

Docker Software