Ne approfitto per fare un breve cenno a come si è evoluta la CLI (Command Line Interface) negli ultimi tempi, in modo da chiarire perché a volte sia possibile trovare alcuni comandi con una sintassi differente.
Avrei potuto prendere un comando già visto ma dato che ci siamo, impariamo qualcosa di nuovo. Prendiamo quindi:
docker image inspect
Questo comando restituisce un oggetto in formato json con i metadati dell’immagine specificata per parametro.
Eseguendo:
docker image inspect alpine
Ottenendo il seguente risultato:
[
{
"Id": "sha256:f70734b6a266dcb5f44c383274821207885b549b75c8e119404917a61335981a",
"RepoTags": [
"alpine:latest"
],
"RepoDigests": [
"alpine@sha256:9a839e63dad54c3a6d1834e29692c8492d93f90c59c978c1ed79109ea4fb9a54"
],
"Parent": "",
"Comment": "",
"Created": "2020-04-24T01:05:03.92860976Z",
"Container": "d3de5454dd4538da6ccb451b8fe1574b2efc482f958b04e6d109f123198d3d30",
"ContainerConfig": {
"Hostname": "d3de5454dd45",
"Domainname": "",
"User": "",
"AttachStdin": false,
"AttachStdout": false,
"AttachStderr": false,
"Tty": false,
"OpenStdin": false,
"StdinOnce": false,
"Env": [
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
],
"Cmd": [
"/bin/sh",
"-c",
"#(nop) ",
"CMD [\"/bin/sh\"]"
],
"ArgsEscaped": true,
"Image": "sha256:fce4411719cb54972247bbe799cf1dd74ecffda05bad4909df5224000dfd070e",
"Volumes": null,
"WorkingDir": "",
"Entrypoint": null,
"OnBuild": null,
"Labels": {}
},
"DockerVersion": "18.09.7",
"Author": "",
"Config": {
"Hostname": "",
"Domainname": "",
"User": "",
"AttachStdin": false,
"AttachStdout": false,
"AttachStderr": false,
"Tty": false,
"OpenStdin": false,
"StdinOnce": false,
"Env": [
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
],
"Cmd": [
"/bin/sh"
],
"ArgsEscaped": true,
"Image": "sha256:fce4411719cb54972247bbe799cf1dd74ecffda05bad4909df5224000dfd070e",
"Volumes": null,
"WorkingDir": "",
"Entrypoint": null,
"OnBuild": null,
"Labels": null
},
"Architecture": "amd64",
"Os": "linux",
"Size": 5612304,
"VirtualSize": 5612304,
"GraphDriver": {
"Data": {
"MergedDir": "/var/lib/docker/overlay2/bb0a38faf8a51dd52fed8883ddefe73effab9736c4f67eea46a78a3ad4de4bc2/merged",
"UpperDir": "/var/lib/docker/overlay2/bb0a38faf8a51dd52fed8883ddefe73effab9736c4f67eea46a78a3ad4de4bc2/diff",
"WorkDir": "/var/lib/docker/overlay2/bb0a38faf8a51dd52fed8883ddefe73effab9736c4f67eea46a78a3ad4de4bc2/work"
},
"Name": "overlay2"
},
"RootFS": {
"Type": "layers",
"Layers": [
"sha256:3e207b409db364b595ba862cdc12be96dcdad8e36c59a03b7b3b61c946a5741a"
]
},
"Metadata": {
"LastTagTime": "0001-01-01T00:00:00Z"
}
}
]
vedremo diversi hash, tag architettura di riferimento, versione di Docker e molte altre informazioni su che a mio avviso ha senso approfondire, soprattutto in questa fase.
La cosa strana è che eseguendo:
docker inspect alpine
otteniamo esattamente lo stesso risultato.
Perché ci sono due modi diversi di eseguire lo stesso comando?
Questo avviene perché la CLI di Docker ha cambiato la sua notazione ed ora utilizza dei sotto-comandi per evitare di avere dei conflitti sui nomi e per rendere il tutto più chiaro.
Docker Inc. vorrebbe abbandonare il supporto alla notazione precedente, per capirci, quella senza i sotto-comandi. Ad oggi sono ancora operativi e siccome questo potrebbe rompere molti script su cui Docker non ha controllo è possibile che possa non avvenire nell’immediato (o forse non avvenire mai). Consiglio personale, abituiamoci ad usare la nuova notazione così ci proteggiamo da eventuali rimozioni di comandi legacy e evitiamo di incorrere in spiacevoli inconvenienti.
Ma quali sono questi sottocomandi?
Eseguiamo il comando “docker”, senza alcun parametro.
Usage: docker [OPTIONS] COMMAND
A self-sufficient runtime for containers
Options:
--config string Location of client config files (default "/Users/fabioros/.docker")
-c, --context string Name of the context to use to connect to the daemon (overrides DOCKER_HOST env var and default
context set with "docker context use")
-D, --debug Enable debug mode
-H, --host list Daemon socket(s) to connect to
-l, --log-level string Set the logging level ("debug"|"info"|"warn"|"error"|"fatal") (default "info")
--tls Use TLS; implied by --tlsverify
--tlscacert string Trust certs signed only by this CA (default "/Users/fabioros/.docker/ca.pem")
--tlscert string Path to TLS certificate file (default "/Users/fabioros/.docker/cert.pem")
--tlskey string Path to TLS key file (default "/Users/fabioros/.docker/key.pem")
--tlsverify Use TLS and verify the remote
-v, --version Print version information and quit
Management Commands:
builder Manage builds
checkpoint Manage checkpoints
config Manage Docker configs
container Manage containers
context Manage contexts
image Manage images
network Manage networks
node Manage Swarm nodes
plugin Manage plugins
secret Manage Docker secrets
service Manage services
stack Manage Docker stacks
swarm Manage Swarm
system Manage Docker
trust Manage trust on Docker images
volume Manage volumes
Commands:
attach Attach local standard input, output, and error streams to a running container
build Build an image from a Dockerfile
commit Create a new image from a container's changes
cp Copy files/folders between a container and the local filesystem
create Create a new container
deploy Deploy a new stack or update an existing stack
diff Inspect changes to files or directories on a container's filesystem
events Get real time events from the server
exec Run a command in a running container
export Export a container's filesystem as a tar archive
history Show the history of an image
images List images
import Import the contents from a tarball to create a filesystem image
info Display system-wide information
inspect Return low-level information on Docker objects
kill Kill one or more running containers
load Load an image from a tar archive or STDIN
login Log in to a Docker registry
logout Log out from a Docker registry
logs Fetch the logs of a container
pause Pause all processes within one or more containers
port List port mappings or a specific mapping for the container
ps List containers
pull Pull an image or a repository from a registry
push Push an image or a repository to a registry
rename Rename a container
restart Restart one or more containers
rm Remove one or more containers
rmi Remove one or more images
run Run a command in a new container
save Save one or more images to a tar archive (streamed to STDOUT by default)
search Search the Docker Hub for images
start Start one or more stopped containers
stats Display a live stream of container(s) resource usage statistics
stop Stop one or more running containers
tag Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE
top Display the running processes of a container
unpause Unpause all processes within one or more containers
update Update configuration of one or more containers
version Show the Docker version information
wait Block until one or more containers stop, then print their exit codes
Run 'docker COMMAND --help' for more information on a command.Quello che ci verrà restituito è un semplice cheatsheet. Non è completo, per quello è sempre possibile utilizzare l’help come indicato nell’ultima riga (Run ‘docker COMMAND –help’ for more information on a command.).
Tuttavia, questo comando ci fornisce tutto ciò di cui abbiamo bisogno in questo momento.
Tra i comandi (Commands) è possibile osservare la voce ‘inspect’.
inspect Return low-level information on Docker objects
La descrizione di questo comando fa riferimento ad oggetti Docker generici e non alle immagini. Probabilmente è sovraccaricato. Sappiamo già che è presente all’interno del sotto-comando image, verifichiamo se è definito anche all’interno del sotto-comando container.
Eseguiamo quindi:
docker container
È possibile notare che il comando inspect è definito anche qui e si riferisce ai container.
Utilizzare i sotto-comandi aiuta molto a mettere ordine sia agli script, sia alle idee.
—
Prosegui su: Nomi delle immagini
Immagine: Barca rossa nel lago vicino alla montagna – it.freepik.com