update: the docker related

Author: adoyle-h

docker/docker-proxy.md

@@ -1,23 +1,27 @@
 # docker 代理
 
-加速 docker pull 的几种方法
+因为中国已屏蔽 docker hub。需要翻墙才能访问。
 
-1. 通过 registry-mirror 镜像服务器来加速
-2. 通过代理服务来加速
+解决方法：
 
-## docker for mac
+1. 通过 registry-mirror 镜像服务器
+2. 通过 http 代理服务
+
+## 不同客户端的配置位置
+
+### docker for mac
 
 对于 dokcer for mac 用户，打开设置 - Docker Engine，设置 registry-mirror 配置。
 
-## orbstack
+### orbstack
 
 对于 [orbstack](https://orbstack.dev/) 用户，
 通过 `orb config docker` 或者在 app 界面的「设置-Docker-Advanced engine config」设置 registry-mirror 配置。
 或者，通过 `orb config set network_proxy` 或者在 app 界面的「设置-Network-Proxy」设置代理。
 
 ## registry-mirror
 
-因为国内用 docker pull 会非常慢。建议使用 docker 镜像加速。
+docker [registry-mirror](https://docs.docker.com/docker-hub/image-library/mirror/) 只对 pull 镜像有效。
 
 ```json
 {
@@ -59,3 +63,7 @@
  }
 }
 ```
+
+## docker push, docker login 失败
+
+需要通过设置[代理服务](#代理服务)来解决问题。

docker/multi-arch-build.md

@@ -42,8 +42,10 @@ docker buildx commands:
 
 ## builder
 
-当前的构建器实例 (builder) 的 driver 是 `docker-container` 或者 `kubernetes` 时，可以构建多架构镜像。
-默认的 default builder 是 `docker` driver，而不是 `docker-container` driver。
+当构建器实例 (builder) 的 driver 是 `docker-container` 或者 `kubernetes` 时，可以构建多架构镜像。
+driver=docker 时，只能构建当前系统架构的镜像。
+
+默认的 builder 是 `docker` driver。你可以使用 `docker buildx ls` 和 `docker buildx inspect` 查看详情。
 
 所以你要用 `docker buildx create` 创建自己的构建器实例。`--driver docker-container` 是默认参数，会创建一个基于 `moby/buildkit` 镜像的容器。在这个容器中构建多架构镜像。
 
@@ -52,6 +54,46 @@ docker buildx commands:
 - `docker buildx use` 切换 builder 实例。
 - `docker buildx inspect` 查看当前 builder 实例信息。
 
+### builder 配置
+
+当创建 `--driver=docker-container` 构建器后，在该实例里执行的构建操作，不会受到 docker 系统配置的影响。
+比如 buildx pull 镜像时，不会受到系统配置的 registry mirror 的影响。
+
+你可以在创建构建器时用 `--buildkitd-config` 参数指定配置，详见[文档](https://docs.docker.com/build/buildkit/configure/)。
+
+### 中国环境下的 buildx 配置
+
+由于 docker.io registry 已经被 GFW。pull/push image 都会失败。所以若想在中国环境下操作，有两种常见方案：
+
+#### 使用镜像仓库
+
+这种方法只适用于：只需要 pull image，不用 push image。
+
+1. 准备可用的 registry mirror。例如 `mirror.docker.io`。
+2. 当前目录下创建 config.toml 文件。内容为
+
+    ```toml
+    [registry."docker.io"]
+      mirrors = ["mirror.docker.io"]`
+    ```
+
+3. 创建 builder: `docker buildx create --name $BUILDER --bootstrap --use --buildkitd-config=./config.toml`
+4. 构建镜像 `docker buildx build`
+
+#### 使用 http 代理
+
+这种方法适用于：需要 push/push image。
+
+1. 准备可用的 http 代理。
+2. 创建 builder: `docker buildx create --name $BUILDER --bootstrap --use`
+3. 构建镜像 `http_proxy=$http_proxy https_proxy=$http_proxy docker buildx build`
+
+注意：如果你的 proxy 代理程序运行在本机上，`$http_proxy` 的值应该是 `http://127.0.0.1:$port`，而不是 `http://host.docker.internal:$port`。
+
+注意：使用 `--driver-opt env.http_proxy` 创建的 builder 实测是无效果的: `docker buildx create --name $BUILDER --bootstrap --use --driver-opt env.http_proxy=$http_proxy --driver-opt env.https_proxy=$http_proxy`。
+
+详见 https://github.com/moby/buildkit/issues/5839
+
 ## docker buildx build
 
 `docker buildx build --platform linux/amd64,linux/arm64,linux/386,linux/arm/v7,linux/arm/v6 --push --tag owner/image:version .`

others/tini-in-dockerfile.md

@@ -22,3 +22,13 @@ ENTRYPOINT ["/tini", "--"]
 3. tini 依赖 libc。
   - 当你使用 alpine 作为 base image 时，默认是没有安装 libc 的。
   - 解决方案：用包管理器来安装 tini。或者下载 tini-static 版本。详见 https://github.com/krallin/tini#statically-linked-version
+
+## 现在无须手动安装 tini
+
+在 docker 1.13 之后的版本，tini 已经内置到 docker 系统，名为 docker-init。详见[文档](https://docs.docker.com/reference/cli/docker/container/run/#init)。
+
+只要 `docker run --init` 即可。默认不开启。这样就不用在构建镜像时引入 tini。
+
+对于 docker compose，只要加上 `init: true` 参数即可。
+
+compose 标准文档里也定义了 [init 参数](https://github.com/compose-spec/compose-spec/blob/main/spec.md#init)。