容器的环境变量

learning/README.md

@@ -49,6 +49,9 @@ meta:
     * [节点](/learning/k8s-bg/architecture/nodes.html)
     * [集群内通信](/learning/k8s-bg/architecture/com.html)
     * [控制器](/learning/k8s-bg/architecture/controller.html)
+  * 容器
+    * [容器镜像](/learning/k8s-intermediate/container/images.html)
+    * [容器的环境变量](/learning/k8s-intermediate/container/env.html)
   * 工作负载
     * [容器组 - 概述](/learning/k8s-intermediate/workload/pod.html)
     * [容器组 - 生命周期](/learning/k8s-intermediate/workload/pod-lifecycle.html)

learning/k8s-intermediate/container/env.md

@@ -0,0 +1,34 @@
+---
+vssueId: 123
+layout: LearningLayout
+description: Kubernetes教程_容器镜像在Kubernetes的Pod中使用容器镜像之前，您必须将其推送到一个镜像仓库（或者使用仓库中已经有的容器镜像）。在 Kubernetes 的 Pod 定义中定义容器时，必须指定容器所使用的镜像，容器中的image字段支持与docker命令一样的语法，包括私有镜像仓库和标签。
+meta:
+  - name: keywords
+    content: Kubernetes 教程,K8S 教程,容器环境变量
+---
+
+# 容器的环境变量
+
+Kubernetes为容器提供了一系列重要的资源：
+* 由镜像、一个或多个数据卷合并组成的文件系统
+* 容器自身的信息
+* 集群中其他重要对象的信息
+
+## 容器的信息
+
+在容器中执行 `hostname` 命令或者在libc 中执行 [gethostname](http://man7.org/linux/man-pages/man2/gethostname.2.html) 函调用，获得的是容器所在 Pod 的名字。
+
+Pod 的名字，以及 Pod 所在名称空间可以通过 [downward API](https://kubernetes.io/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information/) 注入到容器的环境变量里。
+
+用户也可以为容器自定义环境变量，请参考 [使用ConfigMap配置您的应用程序](/learning/k8s-intermediate/config/config-map.html)
+
+## 集群的信息
+
+在容器创建时，集群中所有的 Service 的连接信息将以环境变量的形式注入到容器中。例如，已创建了一个名为 `Foo` 的 Service，此时再创建任何容器时，该容器将包含如下环境变量：
+
+```
+FOO_SERVICE_HOST=<Service的ClusterIP>
+FOO_SERVICE_PORT=<Service的端口>
+```
+
+详细信息请参考 [Service-服务发现]](/learning/k8s-intermediate/service/service-details.html#服务发现)

learning/k8s-intermediate/container/images.md

@@ -0,0 +1,57 @@
+---
+vssueId: 122
+layout: LearningLayout
+description: Kubernetes教程_容器镜像在Kubernetes的Pod中使用容器镜像之前，您必须将其推送到一个镜像仓库（或者使用仓库中已经有的容器镜像）。在 Kubernetes 的 Pod 定义中定义容器时，必须指定容器所使用的镜像，容器中的image字段支持与docker命令一样的语法，包括私有镜像仓库和标签。
+meta:
+  - name: keywords
+    content: Kubernetes教程,K8S教程,容器镜像
+---
+
+# 容器镜像
+
+在 Kubernetes 的 Pod 中使用容器镜像之前，您必须将其推送到一个镜像仓库（或者使用仓库中已经有的容器镜像）。在 Kubernetes 的 Pod 定义中定义容器时，必须指定容器所使用的镜像，容器中的 `image` 字段支持与 `docker` 命令一样的语法，包括私有镜像仓库和标签。
+
+例如：`my-registry.example.com:5000/example/web-example:v1.0.1` 由如下几个部分组成：
+
+<font color="blue" weight="500">my-registry.example.com</font>:<font color="green" weight="500">5000</font>/<font color="purple" weight="500">example</font>/<font color="red" weight="500">web-example</font>:<font color="brown" weight="500">v1.0.1</font>
+
+* 蓝色部分：registry 地址
+* 绿色部分：registry 端口
+* 紫色部分：repository 名字
+* 红色部分：image 名字
+* 棕色部分：image 标签
+
+如果您使用 `hub.dokcer.com` Registry 中的镜像，可以省略 registry 地址和 registry 端口。例如：`nginx:latest`，`eipwork/kuboard`
+
+更多内容请参考：[使用私有仓库中的docker镜像](/learning/k8s-intermediate/private-registry.html)
+
+## 更新镜像
+
+Kubernetes中，默认的镜像抓取策略是 `IfNotPresent`，使用此策略，kubelet在发现本机有镜像的情况下，不会向镜像仓库抓取镜像。如果您期望每次启动 Pod 时，都强制从镜像仓库抓取镜像，可以尝试如下方式：
+* 设置 container 中的 `imagePullPolicy` 为 `Always`
+* 省略 `imagePullPolicy` 字段，并使用 `:latest` tag 的镜像
+* 省略 `imagePullPolicy` 字段和镜像的 tag
+* 激活 [AlwaysPullImages](https://kubernetes.io/docs/reference/access-authn-authz/admission-controllers/#alwayspullimages) 管理控制器
+
+在 Kuboard 中，可以在界面中直接指定 container 的 imagePullPolicy，如下图所示：
+
+![Kubernetes教程_指定镜像抓取策略](./images.assets/image-20191007194641973.png)
+
+imagePullPolicy 字段和 image tag的可能取值将影响到 kubelet 如何抓取镜像：
+* `imagePullPolicy: IfNotPresent` 仅在节点上没有该镜像时，从镜像仓库抓取
+* `imagePullPolicy: Always` 每次启动 Pod 时，从镜像仓库抓取
+* `imagePullPolicy` 未填写，镜像 tag 为 `:latest` 或者未填写，则同 `Always` 每次启动 Pod 时，从镜像仓库抓取
+* `imagePullPolicy` 未填写，镜像 tag 已填写但不是 `:latest`，则同 `IfNotPresent` 仅在节点上没有该镜像时，从镜像仓库抓取
+* `imagePullPolicy: Never`，Kubernetes 假设本地存在该镜像，并且不会尝试从镜像仓库抓取镜像
+
+
+::: tip 重要
+* 在生产环境部署时，您应该避免使用 `:latest` tag，如果这样做，您将无法追踪当前正在使用的镜像版本，也无法正确地执行回滚动作
+* 如果要 100% 确保所有的容器都使用了同样的镜像版本，可以尝试使用镜像的 [digest](https://docs.docker.com/engine/reference/commandline/pull/#pull-an-image-by-digest-immutable-identifier)，例如 `sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2`。 Digest 唯一地标识了容器镜像的版本，并且永远不会改变。
+* 容器引擎的镜像缓存机制使得 `imagePullPolicy: Always` 仍然是高效的。在 Docker 中，如果镜像已经存在，抓取尝试非常快速，先检查镜像所有的 layer 是否有更新，如果该镜像在镜像仓库中所有 layer 的 digest 与本地所有 layer 的 digest 相同，则不会再下载镜像。
+:::
+
+
+## 使用私有仓库中的docker镜像
+
+请参考 [使用私有仓库中的docker镜像](/learning/k8s-intermediate/private-registry.html)