diff --git a/content/zh/docs/tasks/configure-pod-container/pull-image-private-registry.md b/content/zh/docs/tasks/configure-pod-container/pull-image-private-registry.md new file mode 100644 index 0000000000..7a2cc0d7c2 --- /dev/null +++ b/content/zh/docs/tasks/configure-pod-container/pull-image-private-registry.md @@ -0,0 +1,286 @@ +--- +title: 从私有仓库拉取镜像 +content_template: templates/task +weight: 100 +--- + + + +{{% capture overview %}} + + + +本文介绍如何使用 Secret 从私有的 Docker 镜像仓库或代码仓库拉取镜像来创建 Pod。 + +{{% /capture %}} + +{{% capture prerequisites %}} + +* {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} + + + +您需要 [Docker ID](https://docs.docker.com/docker-id/) 和密码来进行本练习。 + +{{% /capture %}} + +{{% capture steps %}} + + + +## 登录 Docker 镜像仓库 + +在个人电脑上,要想拉取私有镜像必须在镜像仓库上进行身份验证。 + +```shell +docker login +``` + + + +当提示时,输入 Docker 用户名和密码。 + +登录过程会创建或更新保存有授权令牌的 `config.json` 文件。 + +查看 `config.json` 文件: + +```shell +cat ~/.docker/config.json +``` + + + +输出结果包含类似于以下内容的部分: + +```json +{ + "auths": { + "https://index.docker.io/v1/": { + "auth": "c3R...zE2" + } + } +} +``` + +{{< note >}} + +如果使用 Docker 凭证仓库,则不会看到 `auth` 条目,看到的将是以仓库名称作为值的 `credsStore` 条目。 +{{< /note >}} + + + +## 在集群中创建保存授权令牌的 Secret + +Kubernetes 集群使用 `docker-registry` 类型的 Secret 来通过容器仓库的身份验证,进而提取私有映像。 + +创建 Secret,命名为 `regcred`: + +```shell +kubectl create secret docker-registry regcred --docker-server= --docker-username= --docker-password= --docker-email= +``` + + + +在这里: + +* `` 是你的私有 Docker 仓库全限定域名(FQDN)。(参考 https://index.docker.io/v1/ 中关于 DockerHub 的部分) +* `` 是你的 Docker 用户名。 +* `` 是你的 Docker 密码。 +* `` 是你的 Docker 邮箱。 + +这样您就成功地将集群中的 Docker 凭据设置为名为 `regcred` 的 Secret。 + + + +## 检查 Secret `regcred` + +要了解你创建的 `regcred` Secret 的内容,可以用 YAML 格式进行查看: + +```shell +kubectl get secret regcred --output=yaml +``` + + + +输出和下面类似: + +```yaml +apiVersion: v1 +data: + .dockerconfigjson: eyJodHRwczovL2luZGV4L ... J0QUl6RTIifX0= +kind: Secret +metadata: + ... + name: regcred + ... +type: kubernetes.io/dockerconfigjson +``` + + + +`.dockerconfigjson` 字段的值是 Docker 凭据的 base64 表示。 + +要了解 `dockerconfigjson` 字段中的内容,请将 Secret 数据转换为可读格式: + +```shell +kubectl get secret regcred --output="jsonpath={.data.\.dockerconfigjson}" | base64 --decode +``` + + + +输出和下面类似: + +```json +{"auths":{"yourprivateregistry.com":{"username":"janedoe","password":"xxxxxxxxxxx","email":"jdoe@example.com","auth":"c3R...zE2"}}} +``` + + + +要了解 `auth` 字段中的内容,请将 base64 编码过的数据转换为可读格式: + +```shell +echo "c3R...zE2" | base64 --decode +``` + + + +输出结果中,用户名和密码用 `:` 链接,类似下面这样: + +```none +janedoe:xxxxxxxxxxx +``` + + + +注意,Secret 数据包含与本地 `~/.docker/config.json` 文件类似的授权令牌。 + +这样您就已经成功地将 Docker 凭据设置为集群中的名为 `regcred` 的 Secret。 + +## 创建一个使用您的 Secret 的 Pod + +下面是一个 Pod 配置文件,它需要访问 `regcred` 中的 Docker 凭据: + +{{< codenew file="pods/private-reg-pod.yaml" >}} + + + +下载上述文件: + +```shell +wget -O my-private-reg-pod.yaml https://k8s.io/examples/pods/private-reg-pod.yaml +``` + + + +在`my-private-reg-pod.yaml` 文件中,使用私有仓库的镜像路径替换 ``,例如: + +```none +janedoe/jdoe-private:v1 +``` + + + +要从私有仓库拉取镜像,Kubernetes 需要凭证。 +配置文件中的 `imagePullSecrets` 字段表明 Kubernetes 应该通过名为 `regcred` 的 Secret 获取凭证。 + +创建使用了你的 Secret 的 Pod,并检查它是否正常运行: + +```shell +kubectl create -f my-private-reg-pod.yaml +kubectl get pod private-reg +``` + +{{% /capture %}} + +{{% capture whatsnext %}} + + + +* 进一步了解 [Secrets](/docs/concepts/configuration/secret/)。 +* 进一步了解 [使用私有仓库](/docs/concepts/containers/images/#using-a-private-registry)。 +* 参考 [kubectl create secret docker-registry](/docs/reference/generated/kubectl/kubectl-commands/#-em-secret-docker-registry-em-)。 +* 参考 [Secret](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#secret-v1-core)。 +* 参考 [PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core) 中的 `imagePullSecrets` 字段 。 + +{{% /capture %}}