Te lo sei perso? Dai un occhiata qui!

Il comando per eseguire un nuovo container è docker container run nome_immagine ( o docker run nome_immagine per retrocompatibilità ).
Lascio un link alla documentazione, sia per la prima, sia per la seconda versione.
Il sito ufficiale mette a disposizione anche una pagina di reference che spiega approfonditamente tale aspetto.

Abbiamo già visto indirettamente in alcune occasioni l’utilizzo di docker container run, però è giunto il momento di andare più in profondità e capire cosa significa lanciare un nuovo container e quali sono le eventuali funzionalità che possiamo sfruttare.

Creare un container

Quando lanciamo un container, lanciamo un processo isolato. Esso è dotato del proprio file system, la propria interfaccia di rete e il proprio albero di processi che esegue nell’host ma in modo del tutto indipendente.

La struttura del comando di esecuzione di un container è la seguente:

docker container run [OPTIONS] IMAGE [COMMAND] [ARG...]

dove:

• docker container run è il comando run del sottomenu di docker
• OPTIONS è l’elenco dei flag utilizzati per l’esecuzione del comando
• IMAGE è il tag dell’immagine che utilizziamo per lanciare un container
• COMMAND l’eventuale istruzione con la quale vogliamo eseguire il container se quella prevista nel Dockerfile non ci soddisfa cosi com’è
• ARG è l’insieme dei parametri da passare eventualmente al container

Con il comando docker container run –help è possibile visualizzare l’elenco dei flag come segue:

docker container run --help
Usage: docker container run [OPTIONS] IMAGE [COMMAND] [ARG…]
Run a command in a new container
Options:
--add-host list Add a custom host-to-IP mapping (host:ip)
-a, --attach list Attach to STDIN, STDOUT or STDERR
--blkio-weight uint16 Block IO (relative weight), between 10 and 1000, or 0 to disable (default 0)
--blkio-weight-device list Block IO weight (relative device weight) (default [])
--cap-add list Add Linux capabilities
--cap-drop list Drop Linux capabilities
--cgroup-parent string Optional parent cgroup for the container
--cidfile string Write the container ID to the file
--cpu-period int Limit CPU CFS (Completely Fair Scheduler) period
--cpu-quota int Limit CPU CFS (Completely Fair Scheduler) quota
--cpu-rt-period int Limit CPU real-time period in microseconds
--cpu-rt-runtime int Limit CPU real-time runtime in microseconds
-c, --cpu-shares int CPU shares (relative weight)
--cpus decimal Number of CPUs
--cpuset-cpus string CPUs in which to allow execution (0-3, 0,1)
--cpuset-mems string MEMs in which to allow execution (0-3, 0,1)
-d, --detach Run container in background and print container ID
--detach-keys string Override the key sequence for detaching a container
--device list Add a host device to the container
--device-cgroup-rule list Add a rule to the cgroup allowed devices list
--device-read-bps list Limit read rate (bytes per second) from a device (default [])
--device-read-iops list Limit read rate (IO per second) from a device (default [])
--device-write-bps list Limit write rate (bytes per second) to a device (default [])
--device-write-iops list Limit write rate (IO per second) to a device (default [])
--disable-content-trust Skip image verification (default true)
--dns list Set custom DNS servers
--dns-option list Set DNS options
--dns-search list Set custom DNS search domains
--domainname string Container NIS domain name
--entrypoint string Overwrite the default ENTRYPOINT of the image
-e, --env list Set environment variables
--env-file list Read in a file of environment variables
--expose list Expose a port or a range of ports
--gpus gpu-request GPU devices to add to the container ('all' to pass all GPUs)
--group-add list Add additional groups to join
--health-cmd string Command to run to check health
--health-interval duration Time between running the check (ms|s|m|h) (default 0s)
--health-retries int Consecutive failures needed to report unhealthy
--health-start-period duration Start period for the container to initialize before starting health-retries countdown (ms|s|m|h) (default 0s)
--health-timeout duration Maximum time to allow one check to run (ms|s|m|h) (default 0s)
--help Print usage
-h, --hostname string Container host name
--init Run an init inside the container that forwards signals and reaps processes
-i, --interactive Keep STDIN open even if not attached
--ip string IPv4 address (e.g., 172.30.100.104)
--ip6 string IPv6 address (e.g., 2001:db8::33)
--ipc string IPC mode to use
--isolation string Container isolation technology
--kernel-memory bytes Kernel memory limit
-l, --label list Set meta data on a container
--label-file list Read in a line delimited file of labels
--link list Add link to another container
--link-local-ip list Container IPv4/IPv6 link-local addresses
--log-driver string Logging driver for the container
--log-opt list Log driver options
--mac-address string Container MAC address (e.g., 92:d0:c6:0a:29:33)
-m, --memory bytes Memory limit
--memory-reservation bytes Memory soft limit
--memory-swap bytes Swap limit equal to memory plus swap: '-1' to enable unlimited swap
--memory-swappiness int Tune container memory swappiness (0 to 100) (default -1)
--mount mount Attach a filesystem mount to the container
--name string Assign a name to the container
--network network Connect a container to a network
--network-alias list Add network-scoped alias for the container
--no-healthcheck Disable any container-specified HEALTHCHECK
--oom-kill-disable Disable OOM Killer
--oom-score-adj int Tune host's OOM preferences (-1000 to 1000)
--pid string PID namespace to use
--pids-limit int Tune container pids limit (set -1 for unlimited)
--platform string Set platform if server is multi-platform capable
--privileged Give extended privileges to this container
-p, --publish list Publish a container's port(s) to the host
-P, --publish-all Publish all exposed ports to random ports
--read-only Mount the container's root filesystem as read only
--restart string Restart policy to apply when a container exits (default "no")
--rm Automatically remove the container when it exits
--runtime string Runtime to use for this container
--security-opt list Security Options
--shm-size bytes Size of /dev/shm
--sig-proxy Proxy received signals to the process (default true)
--stop-signal string Signal to stop a container (default "SIGTERM")
--stop-timeout int Timeout (in seconds) to stop a container
--storage-opt list Storage driver options for the container
--sysctl map Sysctl options (default map[])
--tmpfs list Mount a tmpfs directory
-t, --tty Allocate a pseudo-TTY
--ulimit ulimit Ulimit options (default [])
-u, --user string Username or UID (format: [:])
--userns string User namespace to use
--uts string UTS namespace to use
-v, --volume list Bind mount a volume
--volume-driver string Optional volume driver for the container
--volumes-from list Mount volumes from the specified container(s)
-w, --workdir string Working directory inside the container

Ci sono molti flag, ma a mio avviso i più utili sono:

• -d : (detached) una volta lanciato il container, il terminale viene rilasciato e il processo continua a girare in background. Il comportamento di default prevede che il container venga eseguito in foreground.

• –rm : il container viene rimosso automaticamente una volta terminata l’esecuzione
• –env : passa una lista di variabili d’ambiente al container
• –env-file : passa un file con la lista delle variabili d’ambiente al container
• -p : pubblica verso l’esterno le porte del container specificandone il binding nella forma -p <porta dell’host>:<porta del container>

Cosa succede quando lanciamo un container?

Quando lanciamo un nuovo container, viene prima cercata l’immagine in locale.
Se l’immagine non viene trovata in locale, viene cercata nel registry di default (Docker Hub) o eventualmente in quello specificato.
Se non specifichiamo un tag, viene scaricata l’immagine con il tag “latest”.

Solo a questo punto il container è pronto per essere istanziato.

Docker assegna al container un ip virtuale nella rete privata all’interno del docker engine.
Dopo vengono eseguiti gli eventuali bind verso l’host e il container viene lanciato utilizzando CMD e entrypoint.

C’è molta carne al fuoco, direi che è giunto il momento di un esempio.

—
Prosegui su: Servire una pagina statica con NGINX e Docker

Immagine: Foto creata da wirestock – it.freepik.com

L'articolo Container – cosa sono e come si creano proviene da Docker Tutorial.

Per chi non lo conoscesse, Nginx (pronunciato engine-x) è un progetto open source che implementa un reverse proxy per i protocolli HTTP, HTTPS, SMTP, POP3 e IMAP, un load balancer, cache HTTP e un web server.

Il nostro obiettivo è quello di mostrare la pagina di default di Nginx servendola da un container Docker.

Per questo esercizio io sto usando la versione: 1.19.5-alpine.

La documentazione che viene messa a disposizione nella pagina del docker hub spiega svariati aspetti dell’utilizzo di tale immagine, ma per non fare confusione ne usiamo solo alcune.

Lanciare il container

Per lanciare il primo container con Nginx eseguiamo questo comando:

docker container run -it --rm -d -p 8080:80 --name web nginx:1.19.5-alpine

con questo comando, stiamo dicendo diverse cose:

• docker container run: comando per lanciare un nuovo container
  • run crea sempre un nuovo container, tuttavia è possibile utilizzare le funzioni start e unpause come abbiamo visto qui.
• –it: combinazione di -i e -t
  • -i: il container viene eseguito in modo interattivo ovvero mantiene lo standard input attivo, anche se il container viene eseguito in background
  • -t: è possibile interagire con il container poiché viene allocata una (pseudo-)interfaccia tty
• –rm: il container verrà cancellato automaticamente una volta che esso avrà terminato l’esecuzione
• -d: una volta istanziato il container, l’esecuzione continuerà in background rilasciando quindi il terminale
• -p 8080:80: la porta 80 del container verrà dirottata nella porta 8080 dell’host
• –name web: al container sarà associato il nome “web”
• nginx:1.19.5-alpine: tag dell’immagine da cui istanziamo il container.
  • se, come in questo caso, non specifichiamo un registry prima del nome, l’immagine verrà cercata prima tra quelle in locale e poi nel docker hub (che è il registry di default)

Dopo aver eseguito questo comando, possiamo vedere la pagina di default di Nginx all’indirizzo http://0.0.0.0:8080.

Aggiungiamo un volume

Ora possiamo modificare il comportamento mettendo una nostra pagina al posto di quella di default.

Senza addentrarci troppo nelle logiche di Nginx, per adesso basta tenere a mente che i file devono essere inseriti nella cartella raggiungibile a questo percorso: /usr/share/nginx/html.

A questo punto, basta creare un file index.html e provare ad iniettarlo in quella posizione!
Io ho creato questo file index.html e lo ho salvato nella cartella “contenuto-mio-sito” al percorso: ~/contenuto-mio-sito .

<!DOCTYPE html>
<html>
<body>
<h1>La mia pagina</h1>
<p>Esempio da DockerTutorial.it</p>
</body>
</html>

Ora dobbiamo prima fermare il container creato in precedenza con

docker container stop web

Creare un Dockerfile con il seguente contenuto nella cartella in cui abbiamo creato il file index.html

FROM nginx:1.19.5-alpine
COPY ./index.html /usr/share/nginx/html/index.html

fare la build e poi

docker image build -t esempio-nginx:0.0.1 .

e poi istanziare il nuovo container con il bind dei file.

docker container run -it --rm -d -p 8080:80 --name web -v ~/contenuto-mio-sito:/usr/share/nginx/html esempio-nginx:0.0.1

visitando la pagina http://0.0.0.0:8080 ora vedremo il la nostra pagina html.

Aggiungiamo le variabili d’ambiente

Per provare ad utilizzare le variabili d’ambiente, proviamo a servire la pagina su una porta diversa.
Nella documentazione esposta nel dockerhub relativamente a Nginx, possiamo vedere che la variabile si chiama: NGINX_PORT.

Come prima cosa interrompiamo l’esecuzione del container creato precedentemente

docker container stop web

Poi aggiungiamo la variabile d’ambiente inline con -e NGINX_PORT=85

docker container run -it --rm -d -e NGINX_PORT=85 -p 8080:85 --name web -v ~/contenuto-mio-sito:/usr/share/nginx/html esempio-nginx:0.0.1

Visitando l’indirizzo http://0.0.0.0:8080 otterremo sempre lo stesso risultato.

Gestione dei log

È possibile analizzare i log di un container utilizzando docker container logs <nome o id del container> (link alla documentazione).

Nel nostro caso:

docker container logs web

Rimozione container

Per rimuovere un container è sufficiente eseguire docker container rm <nome o id del container>

docker rm web

Se si desidera rimuovere un container in esecuzione, è necessario applicare il flag -f che forza la rimozione.

docker rm -f web

—
Prosegui su: Accedere a un container

Immagine: Foto creata da wirestock – it.freepik.com

L'articolo Servire una pagina con Nginx e Docker proviene da Docker Tutorial.

Anche se Docker non da nativamente un modo per accedere a un container, possiamo utilizzare un trucco ovvero eseguire un nuovo processo su quel container che esegue una shell.

Il comando che docker mette a disposizione per lanciare un nuovo processo è: docker container exec <nome o id del container> <comando>

Per interagire con un container, tendenzialmente si esegue una shell che in questo caso è invocata mediante il comando sh.

Supponendo di avere il container della sezione precedente in esecuzione (altrimenti lanciarlo come da istruzioni previste qui), eseguiamo:

docker container exec web sh

Ci accorgiamo presto che l’esecuzione termina subito, senza darci modo di interagire con il container. Questo accade perché dobbiamo avere un’esecuzione interattiva e un tty per poterci interagire. Anche in questo caso, abbiamo bisogno dei flag -i e -t. Se ritentiamo l’esecuzione con questi flag come segue

docker container exec -it web sh

Otteniamo un accesso alla shell.

Per uscire dalla shell basta utilizzare la shortcut Ctrl+d

—
Prosegui su: Accedere a un container

Immagine: Neve foto creata da wirestock – it.freepik.com

L'articolo Accedere a un container proviene da Docker Tutorial.