Compose
About versions and upgrading (Compose)
ASP.NET Core + SQL Server on Linux (Compose)
CLI environment variables (Compose)
Command-line completion (Compose)
Compose（組成）
Compose command-line reference（組合命令行參考）
Control startup order (Compose)
Django and PostgreSQL (Compose)
Docker stacks and distributed application bundles (Compose)
docker-compose build（docker-compose構(gòu)建）
docker-compose bundle
docker-compose config
docker-compose create
docker-compose down
docker-compose events
docker-compose exec
docker-compose help
docker-compose images
docker-compose kill
docker-compose logs
docker-compose pause
docker-compose port
docker-compose ps
docker-compose pull
docker-compose push
docker-compose restart
docker-compose rm
docker-compose run
docker-compose scale
docker-compose start
docker-compose stop
docker-compose top
docker-compose unpause
docker-compose up
Environment file (Compose)
Environment variables in Compose
Extend services in Compose
Frequently asked questions (Compose)
Getting started (Compose)
Install Compose
Link environment variables (deprecated) (Compose)
Networking in Compose
Overview of Docker Compose
Overview of docker-compose CLI
Quickstart: Compose and WordPress
Rails and PostgreSQL (Compose)
Sample apps with Compose
Using Compose in production
Using Compose with Swarm
Engine
.NET Core application (Engine)
About images, containers, and storage drivers (Engine)
Add nodes to the swarm (Engine)
Apply custom metadata (Engine)
Apply rolling updates (Engine)
apt-cacher-ng
Best practices for writing Dockerfiles (Engine)
Binaries (Engine)
Bind container ports to the host (Engine)
Breaking changes (Engine)
Build your own bridge (Engine)
Configure container DNS (Engine)
Configure container DNS in user-defined networks (Engine)
CouchDB (Engine)
Create a base image (Engine)
Create a swarm (Engine)
Customize the docker0 bridge (Engine)
Debian (Engine)
Default bridge network
Delete the service (Engine)
Deploy a service (Engine)
Deploy services to a swarm (Engine)
Deprecated Engine features
Docker container networking (Engine)
Docker overview (Engine)
Docker run reference (Engine)
Dockerfile reference (Engine)
Dockerize an application
Drain a node (Engine)
Engine
FAQ (Engine)
Fedora (Engine)
Get started (Engine)
Get started with macvlan network driver (Engine)
Get started with multi-host networking (Engine)
How nodes work (Engine)
How services work (Engine)
Image management (Engine)
Inspect the service (Engine)
Install Docker (Engine)
IPv6 with Docker (Engine)
Join nodes to a swarm (Engine)
Legacy container links (Engine)
Lock your swarm (Engine)
Manage nodes in a swarm (Engine)
Manage sensitive data with Docker secrets (Engine)
Manage swarm security with PKI (Engine)
Manage swarm service networks (Engine)
Migrate to Engine 1.10
Optional Linux post-installation steps (Engine)
Overview (Engine)
PostgreSQL (Engine)
Raft consensus in swarm mode (Engine)
Riak (Engine)
Run Docker Engine in swarm mode
Scale the service (Engine)
SDKs (Engine)
Select a storage driver (Engine)
Set up for the tutorial (Engine)
SSHd (Engine)
Storage driver overview (Engine)
Store service configuration data (Engine)
Swarm administration guide (Engine)
Swarm mode key concepts (Engine)
Swarm mode overlay network security model (Engine)
Swarm mode overview (Engine)
Understand container communication (Engine)
Use multi-stage builds (Engine)
Use swarm mode routing mesh (Engine)
Use the AUFS storage driver (Engine)
Use the Btrfs storage driver (Engine)
Use the Device mapper storage driver (Engine)
Use the OverlayFS storage driver (Engine)
Use the VFS storage driver (Engine)
Use the ZFS storage driver (Engine)
Engine: Admin Guide
Amazon CloudWatch logs logging driver (Engine)
Bind mounts (Engine)
Collect Docker metrics with Prometheus (Engine)
Configuring and running Docker (Engine)
Configuring logging drivers (Engine)
Control and configure Docker with systemd (Engine)
ETW logging driver (Engine)
Fluentd logging driver (Engine)
Format command and log output (Engine)
Google Cloud logging driver (Engine)
Graylog Extended Format (GELF) logging driver (Engine)
Journald logging driver (Engine)
JSON File logging driver (Engine)
Keep containers alive during daemon downtime (Engine)
Limit a container's resources (Engine)
Link via an ambassador container (Engine)
Log tags for logging driver (Engine)
Logentries logging driver (Engine)
PowerShell DSC usage (Engine)
Prune unused Docker objects (Engine)
Run multiple services in a container (Engine)
Runtime metrics (Engine)
Splunk logging driver (Engine)
Start containers automatically (Engine)
Storage overview (Engine)
Syslog logging driver (Engine)
tmpfs mounts
Troubleshoot volume problems (Engine)
Use a logging driver plugin (Engine)
Using Ansible (Engine)
Using Chef (Engine)
Using Puppet (Engine)
View a container's logs (Engine)
Volumes (Engine)
Engine: CLI
Daemon CLI reference (dockerd) (Engine)
docker
docker attach
docker build
docker checkpoint
docker checkpoint create
docker checkpoint ls
docker checkpoint rm
docker commit
docker config
docker config create
docker config inspect
docker config ls
docker config rm
docker container
docker container attach
docker container commit
docker container cp
docker container create
docker container diff
docker container exec
docker container export
docker container inspect
docker container kill
docker container logs
docker container ls
docker container pause
docker container port
docker container prune
docker container rename
docker container restart
docker container rm
docker container run
docker container start
docker container stats
docker container stop
docker container top
docker container unpause
docker container update
docker container wait
docker cp
docker create
docker deploy
docker diff
docker events
docker exec
docker export
docker history
docker image
docker image build
docker image history
docker image import
docker image inspect
docker image load
docker image ls
docker image prune
docker image pull
docker image push
docker image rm
docker image save
docker image tag
docker images
docker import
docker info
docker inspect
docker kill
docker load
docker login
docker logout
docker logs
docker network
docker network connect
docker network create
docker network disconnect
docker network inspect
docker network ls
docker network prune
docker network rm
docker node
docker node demote
docker node inspect
docker node ls
docker node promote
docker node ps
docker node rm
docker node update
docker pause
docker plugin
docker plugin create
docker plugin disable
docker plugin enable
docker plugin inspect
docker plugin install
docker plugin ls
docker plugin push
docker plugin rm
docker plugin set
docker plugin upgrade
docker port
docker ps
docker pull
docker push
docker rename
docker restart
docker rm
docker rmi
docker run
docker save
docker search
docker secret
docker secret create
docker secret inspect
docker secret ls
docker secret rm
docker service
docker service create
docker service inspect
docker service logs
docker service ls
docker service ps
docker service rm
docker service scale
docker service update
docker stack
docker stack deploy
docker stack ls
docker stack ps
docker stack rm
docker stack services
docker start
docker stats
docker stop
docker swarm
docker swarm ca
docker swarm init
docker swarm join
docker swarm join-token
docker swarm leave
docker swarm unlock
docker swarm unlock-key
docker swarm update
docker system
docker system df
docker system events
docker system info
docker system prune
docker tag
docker top
docker unpause
docker update
docker version
docker volume
docker volume create
docker volume inspect
docker volume ls
docker volume prune
docker volume rm
docker wait
Use the Docker command line (Engine)
Engine: Extend
Access authorization plugin (Engine)
Docker log driver plugins
Docker network driver plugins (Engine)
Extending Engine with plugins
Managed plugin system (Engine)
Plugin configuration (Engine)
Plugins API (Engine)
Volume plugins (Engine)
Engine: Security
AppArmor security profiles for Docker (Engine)
Automation with content trust (Engine)
Content trust in Docker (Engine)
Delegations for content trust (Engine)
Deploying Notary (Engine)
Docker security (Engine)
Docker security non-events (Engine)
Isolate containers with a user namespace (Engine)
Manage keys for content trust (Engine)
Play in a content trust sandbox (Engine)
Protect the Docker daemon socket (Engine)
Seccomp security profiles for Docker (Engine)
Secure Engine
Use trusted images
Using certificates for repository client verification (Engine)
Engine: Tutorials
Engine tutorials
Network containers (Engine)
Get Started
Part 1: Orientation
Part 2: Containers
Part 3: Services
Part 4: Swarms
Part 5: Stacks
Part 6: Deploy your app
Machine
Amazon Web Services (Machine)
Digital Ocean (Machine)
docker-machine active
docker-machine config
docker-machine create
docker-machine env
docker-machine help
docker-machine inspect
docker-machine ip
docker-machine kill
docker-machine ls
docker-machine provision
docker-machine regenerate-certs
docker-machine restart
docker-machine rm
docker-machine scp
docker-machine ssh
docker-machine start
docker-machine status
docker-machine stop
docker-machine upgrade
docker-machine url
Driver options and operating system defaults (Machine)
Drivers overview (Machine)
Exoscale (Machine)
Generic (Machine)
Get started with a local VM (Machine)
Google Compute Engine (Machine)
IBM Softlayer (Machine)
Install Machine
Machine
Machine CLI overview
Machine command-line completion
Machine concepts and help
Machine overview
Microsoft Azure (Machine)
Microsoft Hyper-V (Machine)
Migrate from Boot2Docker to Machine
OpenStack (Machine)
Oracle VirtualBox (Machine)
Provision AWS EC2 instances (Machine)
Provision Digital Ocean Droplets (Machine)
Provision hosts in the cloud (Machine)
Rackspace (Machine)
VMware Fusion (Machine)
VMware vCloud Air (Machine)
VMware vSphere (Machine)
Notary
Client configuration (Notary)
Common Server and signer configurations (Notary)
Getting started with Notary
Notary changelog
Notary configuration files
Running a Notary service
Server configuration (Notary)
Signer configuration (Notary)
Understand the service architecture (Notary)
Use the Notary client
?
本文檔使用 PHP中文網(wǎng)手冊(cè) 發(fā)布
文字
描述
列表圖像
用法
docker images [OPTIONS] [REPOSITORY[:TAG]]
備選方案
名字，簡(jiǎn)寫 | 默認(rèn) | 描述 |
|---|---|---|
--all, -a | false | 顯示所有圖像（默認(rèn)隱藏中間圖像） |
--digests | false | 顯示摘要 |
--filter, -f | 根據(jù)提供的條件過(guò)濾輸出 | |
--format | 使用Go模板打印出漂亮的圖像 | |
--no-trunc | false | 不要截?cái)噍敵?/p> |
--quiet, -q | false | 只顯示數(shù)字ID |
父命令
Command | Description |
|---|---|
docker | The base command for the Docker CLI. |
擴(kuò)展描述
默認(rèn)docker images將顯示所有頂級(jí)圖像，它們的存儲(chǔ)庫(kù)和標(biāo)簽，以及它們的大小。
Docker 映像具有中間層，docker build通過(guò)允許緩存每個(gè)步驟來(lái)提高可重用性，減少磁盤使用并加快速度。這些中間層默認(rèn)不顯示。
SIZE是圖像及其所有父圖像占用的累積空間。這也是您docker save在映像中創(chuàng)建的 Tar 文件內(nèi)容所使用的磁盤空間。
如果圖像具有多個(gè)存儲(chǔ)庫(kù)名稱或標(biāo)簽，則圖像將被多次列出。這張單張圖片（通過(guò)匹配識(shí)別IMAGE ID）SIZE只用了一次。
實(shí)例
列出最近創(chuàng)建的圖像
$ docker images REPOSITORY TAG IMAGE ID CREATED SIZE<none> <none> 77af4d6b9913 19 hours ago 1.089 GB committ latest b6fa739cedf5 19 hours ago 1.089 GB<none> <none> 78a85c484f71 19 hours ago 1.089 GB docker latest 30557a29d5ab 20 hours ago 1.089 GB<none> <none> 5ed6274db6ce 24 hours ago 1.089 GB postgres 9 746b819f315e 4 days ago 213.4 MB postgres 9.3 746b819f315e 4 days ago 213.4 MB postgres 9.3.5 746b819f315e 4 days ago 213.4 MB postgres latest 746b819f315e 4 days ago 213.4 MB
按名稱和標(biāo)簽列出圖像
docker images命令采用可選[REPOSITORY[:TAG]]參數(shù)，將列表限制為與參數(shù)匹配的圖像。如果您指定REPOSITORY但不是TAG，則該docker images命令會(huì)列出給定存儲(chǔ)庫(kù)中的所有圖像。
例如，要列出“java”存儲(chǔ)庫(kù)中的所有圖像，請(qǐng)運(yùn)行以下命令：
$ docker images java REPOSITORY TAG IMAGE ID CREATED SIZE java 8 308e519aac60 6 days ago 824.5 MB java 7 493d82594c15 3 months ago 656.3 MB java latest 2711b1d6f3aa 5 months ago 603.9 MB
[REPOSITORY[:TAG]]值必須是“完全匹配”。這意味著，例如，docker images jav與圖像不匹配java。
如果提供REPOSITORY和TAG，僅匹配庫(kù)和標(biāo)簽圖像中列出。要在標(biāo)簽為“8”的“java”存儲(chǔ)庫(kù)中查找所有本地圖像，可以使用：
$ docker images java:8REPOSITORY TAG IMAGE ID CREATED SIZE java 8 308e519aac60 6 days ago 824.5 MB
如果沒(méi)有匹配REPOSITORY[:TAG]，則列表為空。
$ docker images java:0REPOSITORY TAG IMAGE ID CREATED SIZE
列出完整的圖像 ID
$ docker images --no-trunc REPOSITORY TAG IMAGE ID CREATED SIZE<none> <none> sha256:77af4d6b9913e693e8d0b4b294fa62ade6054e6b2f1ffb617ac955dd63fb0182 19 hours ago 1.089 GB committest latest sha256:b6fa739cedf5ea12a620a439402b6004d057da800f91c7524b5086a5e4749c9f 19 hours ago 1.089 GB<none> <none> sha256:78a85c484f71509adeaace20e72e941f6bdd2b25b4c75da8693efd9f61a37921 19 hours ago 1.089 GB docker latest sha256:30557a29d5abc51e5f1d5b472e79b7e296f595abcf19fe6b9199dbbc809c6ff4 20 hours ago 1.089 GB<none> <none> sha256:0124422dd9f9cf7ef15c0617cda3931ee68346455441d66ab8bdc5b05e9fdce5 20 hours ago 1.089 GB<none> <none> sha256:18ad6fad340262ac2a636efd98a6d1f0ea775ae3d45240d3418466495a19a81b 22 hours ago 1.082 GB<none> <none> sha256:f9f1e26352f0a3ba6a0ff68167559f64f3e21ff7ada60366e2d44a04befd1d3a 23 hours ago 1.089 GB tryout latest sha256:2629d1fa0b81b222fca63371ca16cbf6a0772d07759ff80e8d1369b926940074 23 hours ago 131.5 MB<none> <none> sha256:5ed6274db6ceb2397844896966ea239290555e74ef307030ebb01ff91b1914df 24 hours ago 1.089 GB
列表圖像摘要
使用 v2 或更高版本格式的圖像具有稱為digest的內(nèi)容可尋址標(biāo)識(shí)符。只要用于生成圖像的輸入不變，摘要值就可以預(yù)測(cè)。要列出圖片摘要值，請(qǐng)使用以下--digests標(biāo)志：
$ docker images --digests REPOSITORY TAG DIGEST IMAGE ID CREATED SIZE localhost:5000/test/busybox <none> sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 4986bf8c1536 9 weeks ago 2.43 MB
當(dāng)推或拉到2.0注冊(cè)表時(shí)，push或pull命令輸出包含圖像摘要。您可以pull使用摘要值。您也可以通過(guò)引用消化create，run和rmi命令，還有FROM在 Dockerfile 圖像參考。
過(guò)濾
過(guò)濾標(biāo)志（-f或--filter）格式為“key = value”。如果有多個(gè)過(guò)濾器，則傳遞多個(gè)標(biāo)志（例如--filter "foo=bar" --filter "bif=baz"）
目前支持的過(guò)濾器是：
dangling（布爾 - true 或 false ）
標(biāo)簽（
label=<key>或label=<key>=<value>）
before（
<image-name>[:<tag>]，<image id>或<image@digest>） -過(guò)濾圖像創(chuàng)建之前給定 id 或引用
因?yàn)椋?code><image-name>[:<tag>]，
<image id>或<image@digest>） -給定 id 或引用創(chuàng)建的過(guò)濾器的圖像
參考（圖像參考的圖案） - 過(guò)濾參考與指定圖案匹配的圖像
顯示未加標(biāo)簽的圖像（ dangling ）
$ docker images --filter "dangling=true"REPOSITORY TAG IMAGE ID CREATED SIZE<none> <none> 8abc22fbb042 4 weeks ago 0 B<none> <none> 48e5f45168b9 4 weeks ago 2.489 MB<none> <none> bf747efa0e2f 4 weeks ago 0 B<none> <none> 980fe10e5736 12 weeks ago 101.4 MB<none> <none> dea752e4e117 12 weeks ago 101.4 MB<none> <none> 511136ea3c5a 8 months ago 0 B
這將顯示未標(biāo)記的圖像，即圖像樹的葉子（不是中間層）。這些圖像在圖像的新版本repo:tag將圖像標(biāo)識(shí)從圖像標(biāo)識(shí)中移開時(shí)保留為<none>:<none>或不標(biāo)記。如果在容器正在使用時(shí)嘗試刪除圖像，則會(huì)發(fā)出警告。通過(guò)擁有這個(gè)標(biāo)志，它可以批量清理。
你可以結(jié)合使用這個(gè)docker rmi ...：
$ docker rmi $(docker images -f "dangling=true" -q)8abc22fbb042 48e5f45168b9 bf747efa0e2f 980fe10e5736 dea752e4e117 511136ea3c5a
注：：Docker 發(fā)出警告，如果存在使用這些無(wú)標(biāo)記圖像的容器。
用給定的標(biāo)簽顯示圖像
label過(guò)濾器匹配基礎(chǔ)上的存在的圖像label單獨(dú)或label和值。
以下過(guò)濾器將圖像與com.example.version標(biāo)簽進(jìn)行匹配，而不管其值如何。
$ docker images --filter "label=com.example.version"REPOSITORY TAG IMAGE ID CREATED SIZE match-me-1 latest eeae25ada2aa About a minute ago 188.3 MB match-me-2 latest dea752e4e117 About a minute ago 188.3 MB
下面的篩選器將圖像與com.example.version標(biāo)簽上帶有1.0價(jià)值。
$ docker images --filter "label=com.example.version=1.0"REPOSITORY TAG IMAGE ID CREATED SIZE match-me latest 511136ea3c5a About a minute ago 188.3 MB
在本例中，使用0.1值時(shí)，它返回一個(gè)空集，因?yàn)闆](méi)有找到匹配項(xiàng)。
$ docker images --filter "label=com.example.version=0.1"REPOSITORY TAG IMAGE ID CREATED SIZE
按時(shí)間過(guò)濾圖像
before過(guò)濾器僅顯示在具有給定 ID 或引用的圖像之前創(chuàng)建的圖像。例如，擁有這些圖像：
$ docker images REPOSITORY TAG IMAGE ID CREATED SIZE image1 latest eeae25ada2aa 4 minutes ago 188.3 MB image2 latest dea752e4e117 9 minutes ago 188.3 MB image3 latest 511136ea3c5a 25 minutes ago 188.3 MB
過(guò)濾用before會(huì)：
$ docker images --filter "before=image1"REPOSITORY TAG IMAGE ID CREATED SIZE image2 latest dea752e4e117 9 minutes ago 188.3 MB image3 latest 511136ea3c5a 25 minutes ago 188.3 MB
過(guò)濾用since會(huì)：
$ docker images --filter "since=image3"REPOSITORY TAG IMAGE ID CREATED SIZE image1 latest eeae25ada2aa 4 minutes ago 188.3 MB image2 latest dea752e4e117 9 minutes ago 188.3 MB
參考濾波圖像
reference過(guò)濾器僅顯示引用與指定模式匹配的圖像。
$ docker images REPOSITORY TAG IMAGE ID CREATED SIZE busybox latest e02e811dd08f 5 weeks ago 1.09 MB busybox uclibc e02e811dd08f 5 weeks ago 1.09 MB busybox musl 733eb3059dce 5 weeks ago 1.21 MB busybox glibc 21c16b6787c6 5 weeks ago 4.19 MB
過(guò)濾用reference會(huì)：
$ docker images --filter=reference='busy*:*libc'REPOSITORY TAG IMAGE ID CREATED SIZE busybox uclibc e02e811dd08f 5 weeks ago 1.09 MB busybox glibc 21c16b6787c6 5 weeks ago 4.19 MB
格式化輸出
格式化選項(xiàng)（--format）將使用 Go 模板打印容器輸出。
下面列出了 Go 模板的有效占位符：
Placeholder | Description |
|---|---|
.ID | Image ID |
.Repository | Image repository |
.Tag | Image tag |
.Digest | Image digest |
.CreatedSince | Elapsed time since the image was created |
.CreatedAt | Time when the image was created |
.Size | Image disk size |
當(dāng)使用--format選項(xiàng)時(shí)，image命令將完全按照模板聲明輸出數(shù)據(jù)，或者在使用該table指令時(shí)也會(huì)包含列標(biāo)題。
以下示例使用不帶標(biāo)題的模板，并輸出由冒號(hào)分隔的所有圖像ID和Repository條目：
$ docker images --format "{{.ID}}: {{.Repository}}"77af4d6b9913: <none>b6fa739cedf5: committ
78a85c484f71: <none>30557a29d5ab: docker
5ed6274db6ce: <none>746b819f315e: postgres
746b819f315e: postgres
746b819f315e: postgres
746b819f315e: postgres要以表格格式列出存儲(chǔ)庫(kù)和標(biāo)簽的所有圖像，可以使用：
$ docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"IMAGE ID REPOSITORY TAG
77af4d6b9913 <none> <none>b6fa739cedf5 committ latest
78a85c484f71 <none> <none>30557a29d5ab docker latest
5ed6274db6ce <none> <none>746b819f315e postgres 9746b819f315e postgres 9.3746b819f315e postgres 9.3.5746b819f315e postgres latest