s390x/docker

注意：这是https://hub.docker.com/_/docker的`s390x`架构"per-architecture"仓库——更多信息请参见官方镜像文档中的https://github.com/docker-library/official-images#architectures-other-than-amd64和官方镜像FAQ中的https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what。

快速参考

• 维护者：
  https://github.com/docker-library/docker

• 获取帮助：
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic或https://stackoverflow.com/help/on-topic

支持的标签及对应的Dockerfile链接

警告：此镜像在s390x架构上不受支持

快速参考（续）

• 提交issue的位置：
  https://github.com/docker-library/docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/docker/、https://hub.docker.com/r/arm32v6/docker/、https://hub.docker.com/r/arm32v7/docker/、https://hub.docker.com/r/arm64v8/docker/、https://hub.docker.com/r/winamd64/docker/

• 已发布镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/docker（https://github.com/docker-library/repo-info/commits/master/repos/docker）
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fdocker
  https://github.com/docker-library/official-images/blob/master/library/docker（https://github.com/docker-library/official-images/commits/master/library/docker）

• 此描述的来源：
  https://github.com/docker-library/docs/tree/master/docker（https://github.com/docker-library/docs/commits/master/docker）

什么是Docker-in-Docker？

虽然通常不建议在Docker内部运行Docker，但存在一些合法用例，例如Docker本身的开发。

Docker是一个开源项目，通过在Linux、Mac OS和Windows上提供操作系统级虚拟化的额外抽象层和自动化，实现应用程序在软件容器内的自动化部署。

***.org/wiki/Docker_(software)

在运行Docker-in-Docker之前，请务必阅读Jérôme Petazzoni关于该主题的优秀博客文章https://jpetazzo.github.io/2015/09/03/do-not-use-docker-in-docker-for-ci/，其中他概述了这样做的一些优缺点（以及可能遇到的一些棘手问题）。

如果您仍然确定需要Docker-in-Docker，而不仅仅是访问容器的主机Docker服务器，请继续阅读。

如何使用此镜像

TLS

从18.09+版本开始，此镜像的dind变体将在DOCKER_TLS_CERTDIR环境变量指定的目录中自动生成TLS证书。

警告：在18.09版本中，此行为默认禁用（为了兼容性）。如果您使用--network=host、共享网络命名空间（如Kubernetes Pod中），或通过其他方式拥有对容器的网络访问权限（包括通过其网关接口在dind实例内启动的容器），这可能存在安全问题（例如可能导致对主机系统的访问）。建议通过将变量设置为适当的值（-e DOCKER_TLS_CERTDIR=/certs或类似）来启用TLS。在19.03+版本中，此行为默认启用。

启用时，Docker守护进程将以--host=tcp://0.0.0.0:2376 --tlsverify ...启动（禁用时，Docker守护进程将以--host=tcp://0.0.0.0:2375启动）。

在DOCKER_TLS_CERTDIR指定的目录中，入口点脚本将创建/使用三个目录：

• ca：证书颁发机构文件（cert.pem、key.pem）
• server：dockerd（守护进程）证书文件（cert.pem、ca.pem、key.pem）
• client：docker（客户端）证书文件（cert.pem、ca.pem、key.pem；适用于DOCKER_CERT_PATH）

为了从"客户端"容器使用此功能，至少需要共享$DOCKER_TLS_CERTDIR目录的client子目录（如以下示例所示）。

要禁用此镜像行为，只需覆盖容器命令或入口点以直接运行dockerd（... s390x/docker:dind dockerd ...或... --entrypoint dockerd s390x/docker:dind ...）。

启动守护进程实例

console
$ docker run --privileged --name some-docker -d \
	--network some-network --network-alias docker \
	-e DOCKER_TLS_CERTDIR=/certs \
	-v some-docker-certs-ca:/certs/ca \
	-v some-docker-certs-client:/certs/client \
	s390x/docker:dind

注意：--privileged（特权模式）是Docker-in-Docker正常运行所必需的，但应谨慎使用，因为它提供对主机环境的完全访问权限，如https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities所述。

从第二个容器连接到它

console
$ docker run --rm --network some-network \
	-e DOCKER_TLS_CERTDIR=/certs \
	-v some-docker-certs-client:/certs/client:ro \
	s390x/docker:latest version
Client: Docker Engine - Community
 Version:           18.09.8
 API version:       1.39
 Go version:        go1.10.8
 Git commit:        0dd43dd87f
 Built:             Wed Jul 17 17:38:58 2019
 OS/Arch:           linux/amd64
 Experimental:      false

Server: Docker Engine - Community
 Engine:
  Version:          18.09.8
  API version:      1.39 (minimum version 1.12)
  Go version:       go1.10.8
  Git commit:       0dd43dd87f
  Built:            Wed Jul 17 17:48:49 2019
  OS/Arch:          linux/amd64
  Experimental:     false

console
$ docker run -it --rm --network some-network \
	-e DOCKER_TLS_CERTDIR=/certs \
	-v some-docker-certs-client:/certs/client:ro \
	s390x/docker:latest sh
/ # docker version
Client: Docker Engine - Community
 Version:           18.09.8
 API version:       1.39
 Go version:        go1.10.8
 Git commit:        0dd43dd87f
 Built:             Wed Jul 17 17:38:58 2019
 OS/Arch:           linux/amd64
 Experimental:      false

Server: Docker Engine - Community
 Engine:
  Version:          18.09.8
  API version:      1.39 (minimum version 1.12)
  Go version:       go1.10.8
  Git commit:       0dd43dd87f
  Built:            Wed Jul 17 17:48:49 2019
  OS/Arch:          linux/amd64
  Experimental:     false

console
$ docker run --rm --network some-network \
	-e DOCKER_TLS_CERTDIR=/certs \
	-v some-docker-certs-client:/certs/client:ro \
	s390x/docker:latest info
Containers: 0
 Running: 0
 Paused: 0
 Stopped: 0
Images: 0
Server Version: 18.09.8
Storage Driver: overlay2
 Backing Filesystem: extfs
 Supports d_type: true
 Native Overlay Diff: true
Logging Driver: json-file
Cgroup Driver: cgroupfs
Plugins:
 Volume: local
 Network: bridge host macvlan null overlay
 Log: awslogs fluentd gcplogs gelf journald json-file local logentries splunk syslog
Swarm: inactive
Runtimes: runc
Default Runtime: runc
Init Binary: docker-init
containerd version: 894b81a4b802e4eb2a91d1ce216b8817763c29fb
runc version: 425e105d5a03fabd737a126ad93d62a9eeede87f
init version: fec3683
Security Options:
 apparmor
 seccomp
  Profile: default
Kernel Version: 4.19.0-5-amd64
Operating System: Alpine Linux v3.10 (containerized)
OSType: linux
Architecture: x86_64
CPUs: 12
Total Memory: 62.79GiB
Name: e174d61a4a12
ID: HJXG:3OT7:MGDL:Y2BL:WCYP:CKSP:CGAM:4BLH:NEI4:IURF:4COF:AH6N
Docker Root Dir: /var/lib/docker
Debug Mode (client): false
Debug Mode (server): false
Registry: https://index.docker.io/v1/
Labels:
Experimental: false
Insecure Registries:
 127.0.0.0/8
Live Restore Enabled: false
Product License: Community Engine

WARNING: bridge-nf-call-iptables is disabled
WARNING: bridge-nf-call-ip6tables is disabled

console
$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock s390x/docker:latest version
Client: Docker Engine - Community
 Version:           18.09.8
 API version:       1.39
 Go version:        go1.10.8
 Git commit:        0dd43dd87f
 Built:             Wed Jul 17 17:38:58 2019
 OS/Arch:           linux/amd64
 Experimental:      false

Server: Docker Engine - Community
 Engine:
  Version:          18.09.7
  API version:      1.39 (minimum version 1.12)
  Go version:       go1.10.8
  Git commit:       2d0083d
  Built:            Thu Jun 27 17:23:02 2019
  OS/Arch:          linux/amd64
  Experimental:     false

自定义守护进程标志

console
$ docker run --privileged --name some-docker -d \
	--network some-network --network-alias docker \
	-e DOCKER_TLS_CERTDIR=/certs \
	-v some-docker-certs-ca:/certs/ca \
	-v some-docker-certs-client:/certs/client \
	s390x/docker:dind --storage-driver overlay2

运行时设置注意事项

受https://github.com/docker/docker-ce-packaging/blob/57ae892b13de399171fc33f878b70e72855747e6/systemd/docker.service#L30-L45启发，您可能需要考虑以下运行时配置选项的不同值，尤其是对于生产Docker实例：

console
$ docker run --privileged --name some-docker -d \
	... \
	--ulimit nofile=-1 \
	--ulimit nproc=-1 \
	--ulimit core=-1 \
	--pids-limit -1 \
	--oom-score-adj -500 \
	s390x/docker:dind

其中一些可能不支持基于主机dockerd的设置，例如--ulimit nofile=-1，会给出类似error setting rlimit type 7: operation not permitted的错误，有些可能从主机dockerd实例继承合理值，或者可能不适用于您的Docker-in-Docker使用场景（例如，您可能希望将--oom-score-adj设置为高于主机dockerd的值，以便您的Docker-in-Docker实例在主机Docker实例之前被终止）。

数据存储位置

重要说明：有多种方式存储在Docker容器中运行的应用程序所使用的数据。我们鼓励docker镜像的用户熟悉可用的选项，包括：

• 让Docker通过使用其自己的内部卷管理https://docs.docker.com/storage/volumes/。这是默认方式，对用户来说简单且相当透明。缺点是对于直接在主机系统上运行（即容器外部）的工具和应用程序，可能难以定位文件。
• 在主机系统上（容器外部）创建数据目录，并https://docs.docker.com/storage/bind-mounts/。这将文件放置在主机系统上的已知位置，并使主机系统上的工具和应用程序易于访问文件。缺点是用户需要确保目录存在，并且主机系统上的目录权限和其他安全机制设置正确。

Docker文档是了解不同存储选项和变体的良好起点，有多个博客和论坛帖子讨论并提供该领域的建议。我们在此仅展示上述后一种选项的基本步骤：

1. 在主机系统的合适卷上创建数据目录，例如/my/own/var-lib-docker。

2. 像这样启动您的docker容器：

   console
   $ docker run --privileged --name some-docker -v /my/own/var-lib-docker:/var/lib/docker -d s390x/docker:dind
   

命令中的-v /my/own/var-lib-docker:/var/lib/docker部分将底层主机系统的/my/own/var-lib-docker目录挂载为容器内的/var/lib/docker，Docker默认将在其中写入数据文件。

许可

查看此镜像中包含的软件的https://github.com/docker/docker/blob/eb7b2ed6bbe3fbef588116d362ce595d6e35fc43/LICENSE。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可（例如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可信息可能在https://github.com/docker-library/repo-info/tree/master/repos/docker中找到。

至于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可。