diff --git a/.vuepress/config.js b/.vuepress/config.js index 992b37b..fcefdd2 100644 --- a/.vuepress/config.js +++ b/.vuepress/config.js @@ -96,7 +96,6 @@ module.exports = { title: '概念', collapsable: false, children: [ - 'k8s-core-concepts', 'quick-win', 'why-kuboard', 'concepts' @@ -158,7 +157,8 @@ module.exports = { 'k8s-basics/explore', 'k8s-basics/expose', 'k8s-basics/scale', - 'k8s-basics/update' + 'k8s-basics/update', + 'k8s-basics/k8s-core-concepts' ] }, { @@ -166,7 +166,7 @@ module.exports = { collapsable: false, children: [ 'k8s-intermediate/ingress', - // 'k8s-intermediate/config-map', + 'k8s-intermediate/config-map', // 'k8s-intermediate/recommendation', ] }, diff --git a/learning/README.md b/learning/README.md index 76035b5..66e32c1 100644 --- a/learning/README.md +++ b/learning/README.md @@ -5,13 +5,13 @@ description: Kubernetes 学习路径推荐 # Kubernetes 学习路径推荐 ## **Kubernetes 入门** - * [十分钟带你理解Kubernetes核心概念](./k8s-core-concepts.html) - * [学习Kubernetes基础知识](/learning/k8s-basics/kubernetes-basics.html) (10分钟) - * [部署第一个应用程序](/learning/k8s-basics/deploy-app.html) (5分钟) - * [查看 Pods / Nodes](/learning/k8s-basics/explore.html) (10分钟) - * [公布应用程序](/learning/k8s-basics/expose.html) (10分钟) - * [伸缩应用程序](/learning/k8s-basics/scale.html) (10分钟) - * [执行滚动更新](/learning/k8s-basics/update.html) (10分钟) + * [0. 学习Kubernetes基础知识](/learning/k8s-basics/kubernetes-basics.html) (10分钟) + * [1. 部署第一个应用程序](/learning/k8s-basics/deploy-app.html) (5分钟) + * [2. 查看 Pods / Nodes](/learning/k8s-basics/explore.html) (10分钟) + * [3. 公布应用程序](/learning/k8s-basics/expose.html) (10分钟) + * [4. 伸缩应用程序](/learning/k8s-basics/scale.html) (10分钟) + * [5. 执行滚动更新](/learning/k8s-basics/update.html) (10分钟) + * [6. 复习Kubernetes核心概念](/learning/k8s-basics/k8s-core-concepts.html) (10分钟) ## **Kubernetes 进阶** * [从微服务视角理解 Kubernetes](/articles/201908/kuboard-view-of-k8s.html) diff --git a/learning/k8s-basics/deploy-app.md b/learning/k8s-basics/deploy-app.md index 7d42e64..cc4b5ed 100644 --- a/learning/k8s-basics/deploy-app.md +++ b/learning/k8s-basics/deploy-app.md @@ -2,7 +2,7 @@ description: 本文详细讲解了 Kubernetes Deployment 的概念，并描述了如何使用 kubectl / Kuboard 创建一个 Deployment --- -# 部署第一个应用程序 +# 1. 部署第一个应用程序 本文翻译自 Kubernetes 官网 [Using kubectl to Create a Deployment](https://kubernetes.io/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro/) ，并有所改写 diff --git a/learning/k8s-basics/explore.md b/learning/k8s-basics/explore.md index 87d61ed..c527e78 100644 --- a/learning/k8s-basics/explore.md +++ b/learning/k8s-basics/explore.md @@ -2,7 +2,7 @@ description: 本文介绍了如何使用 kubectl / Kuboard 查看和浏览 Kubernetes 上的节点、容器组、部署等信息，并依据这些信息作出问题诊断。 --- -# 查看 Pods / Nodes +# 2. 查看 Pods / Nodes 本文翻译自 Kubernetes 官网 [Viewing Pods and Nodes](https://kubernetes.io/docs/tutorials/kubernetes-basics/explore/explore-intro/) ，并有所改写 diff --git a/learning/k8s-basics/expose.md b/learning/k8s-basics/expose.md index 1f550fa..4ddaa1e 100644 --- a/learning/k8s-basics/expose.md +++ b/learning/k8s-basics/expose.md @@ -2,7 +2,7 @@ description: 本文详细讲解了 Kubernetes Service 的概念，并描述了如何使用 kubectl / Kuboard 创建一个 Service，以使得部署在 Kubernetes 上的容器可以被访问。 --- -# 公布应用程序 +# 3. 公布应用程序 本文翻译自 Kubernetes 官网 [Using a Service to Expose Your App](https://kubernetes.io/docs/tutorials/kubernetes-basics/expose/expose-intro/) ，并有所改写 diff --git a/learning/k8s-basics/k8s-core-concepts.assets/03d07039d9fc80c0f692d6176f65936e.gif b/learning/k8s-basics/k8s-core-concepts.assets/03d07039d9fc80c0f692d6176f65936e.gif new file mode 100644 index 0000000..7bb9a2e Binary files /dev/null and b/learning/k8s-basics/k8s-core-concepts.assets/03d07039d9fc80c0f692d6176f65936e.gif differ diff --git a/learning/k8s-basics/k8s-core-concepts.assets/d7ce07842371eab180725bab5164ec17.png b/learning/k8s-basics/k8s-core-concepts.assets/d7ce07842371eab180725bab5164ec17.png new file mode 100644 index 0000000..78bafcd Binary files /dev/null and b/learning/k8s-basics/k8s-core-concepts.assets/d7ce07842371eab180725bab5164ec17.png differ diff --git a/learning/k8s-basics/k8s-core-concepts.assets/e7a273fcdc03d2417b354b60c253552f.gif b/learning/k8s-basics/k8s-core-concepts.assets/e7a273fcdc03d2417b354b60c253552f.gif new file mode 100644 index 0000000..cf5fe9a Binary files /dev/null and b/learning/k8s-basics/k8s-core-concepts.assets/e7a273fcdc03d2417b354b60c253552f.gif differ diff --git a/learning/k8s-basics/k8s-core-concepts.assets/label-20190731101545553.png b/learning/k8s-basics/k8s-core-concepts.assets/label-20190731101545553.png new file mode 100644 index 0000000..80f4abc Binary files /dev/null and b/learning/k8s-basics/k8s-core-concepts.assets/label-20190731101545553.png differ diff --git a/learning/k8s-basics/k8s-core-concepts.assets/label.png b/learning/k8s-basics/k8s-core-concepts.assets/label.png new file mode 100644 index 0000000..80f4abc Binary files /dev/null and b/learning/k8s-basics/k8s-core-concepts.assets/label.png differ diff --git a/learning/k8s-basics/k8s-core-concepts.assets/service.png b/learning/k8s-basics/k8s-core-concepts.assets/service.png new file mode 100644 index 0000000..2cad5d2 Binary files /dev/null and b/learning/k8s-basics/k8s-core-concepts.assets/service.png differ diff --git a/learning/k8s-basics/k8s-core-concepts.md b/learning/k8s-basics/k8s-core-concepts.md new file mode 100644 index 0000000..b2e3a2f --- /dev/null +++ b/learning/k8s-basics/k8s-core-concepts.md @@ -0,0 +1,107 @@ +--- +description: 以 gif 动图的形式形象的描述 Kubernetes 核心概念。本文将会简单介绍Kubernetes的核心概念。因为这些定义可以在Kubernetes的文档中找到，所以文章也会避免用大段的枯燥的文字介绍。相反，我们会使用一些图表（其中一些是动画）和示例来解释这些概念。我们发现一些概念（比如Service）如果没有图表的辅助就很难全面地理解。在合适的地方我们也会提供Kubernetes文档的链接以便读者深入学习。 +--- + +# 6. 复习Kubernetes核心概念 + +> 转载信息： +> +> [译文链接](http://www.dockone.io/article/932) 译者：崔婧雯 +> +> [原文链接](http://omerio.com/2015/12/18/learn-the-kubernetes-key-concepts-in-10-minutes/) 作者：Omer Dawelbeit + + +本文将会简单介绍Kubernetes的核心概念。因为这些定义可以在Kubernetes的文档中找到，所以文章也会避免用大段的枯燥的文字介绍。相反，我们会使用一些图表（其中一些是动画）和示例来解释这些概念。我们发现一些概念（比如Service）如果没有图表的辅助就很难全面地理解。在合适的地方我们也会提供Kubernetes文档的链接以便读者深入学习。 + +## 什么是Kubernetes？ + +Kubernetes（k8s）是自动化容器操作的开源平台，这些操作包括部署，调度和节点集群间扩展。如果你曾经用过Docker容器技术部署容器，那么可以将Docker看成Kubernetes内部使用的低级别组件。Kubernetes不仅仅支持Docker，还支持Rocket，这是另一种容器技术。 +使用Kubernetes可以： +* 自动化容器的部署和复制 +* 随时扩展或收缩容器规模 +* 将容器组织成组，并且提供容器间的负载均衡 +* 很容易地升级应用程序容器的新版本 +* 提供容器弹性，如果容器失效就替换它，等等... + +## 集群 + +集群是一组节点，这些节点可以是物理服务器或者虚拟机，之上安装了Kubernetes平台。下图展示这样的集群。注意该图为了强调核心概念有所简化。这里可以看到一个典型的Kubernetes架构图。 + +![1.png](./k8s-core-concepts.assets/d7ce07842371eab180725bab5164ec17.png) + +上图可以看到如下组件，使用特别的图标表示Service和Label： + +* PodContainer（容器） +* Label(![label](./k8s-core-concepts.assets/label.png))（标签） +* Replication Controller（复制控制器） +* Service（![enter image description here](./k8s-core-concepts.assets/service.png)）（服务） +* Node（节点） +* Kubernetes Master（Kubernetes主节点） + + + +## Pod + +[Pod](https://kubernetes.io/docs/concepts/workloads/pods/pod-overview/)（上图绿色方框）安排在节点上，包含一组容器和卷。同一个Pod里的容器共享同一个网络命名空间，可以使用localhost互相通信。Pod是短暂的，不是持续性实体。你可能会有这些问题： + +- 如果Pod是短暂的，那么我怎么才能持久化容器数据使其能够跨重启而存在呢？ 是的，Kubernetes支持 ***卷*** 的概念，因此可以使用持久化的卷类型。 +- 是否手动创建Pod，如果想要创建同一个容器的多份拷贝，需要一个个分别创建出来么？可以手动创建单个Pod，但是也可以使用Replication Controller使用Pod模板创建出多份拷贝，下文会详细介绍。 +- 如果Pod是短暂的，那么重启时IP地址可能会改变，那么怎么才能从前端容器正确可靠地指向后台容器呢？这时可以使用Service，下文会详细介绍。 + + + +## Label + +正如图所示，一些Pod有Label（![enter image description here](./k8s-core-concepts.assets/label-20190731101545553.png)）。一个Label是attach到Pod的一对键/值对，用来传递用户定义的属性。比如，你可能创建了一个"tier"和“app”标签，通过Label（**tier=frontend, app=myapp**）来标记前端Pod容器，使用Label（**tier=backend, app=myapp**）标记后台Pod。然后可以使用 [Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/) 选择带有特定Label的Pod，并且将Service或者Replication Controller应用到上面。 + + + +## Replication Controller + +*是否手动创建Pod，如果想要创建同一个容器的多份拷贝，需要一个个分别创建出来么，能否将Pods划到逻辑组里？* + +Replication Controller确保任意时间都有指定数量的Pod“副本”在运行。如果为某个Pod创建了Replication Controller并且指定3个副本，它会创建3个Pod，并且持续监控它们。如果某个Pod不响应，那么Replication Controller会替换它，保持总数为3.如下面的动画所示： + +![2.gif](./k8s-core-concepts.assets/03d07039d9fc80c0f692d6176f65936e.gif) + +如果之前不响应的Pod恢复了，现在就有4个Pod了，那么Replication Controller会将其中一个终止保持总数为3。如果在运行中将副本总数改为5，Replication Controller会立刻启动2个新Pod，保证总数为5。还可以按照这样的方式缩小Pod，这个特性在执行滚动 [升级](https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#rolling_updates) 时很有用。 + +当创建Replication Controller时，需要指定两个东西： + +1. Pod模板：用来创建Pod副本的模板 +2. Label：Replication Controller需要监控的Pod的标签。现在已经创建了Pod的一些副本，那么在这些副本上如何均衡负载呢？我们需要的是Service。 + +::: tip + +最新 Kubernetes 版本里，推荐使用 Deployment + +::: + + + +## Service + +*如果Pods是短暂的，那么重启时IP地址可能会改变，怎么才能从前端容器正确可靠地指向后台容器呢？* +[Service](https://kubernetes.io/docs/concepts/services-networking/service/) **抽象** +现在，假定有2个后台Pod，并且定义后台Service的名称为‘backend-service’，lable选择器为（）。 的Service会完成如下两件重要的事情： + +- 会为Service创建一个本地集群的DNS入口，因此前端Pod只需要DNS查找主机名为 ‘backend-service’，就能够解析出前端应用程序可用的IP地址。 +- 现在前端已经得到了后台服务的IP地址，但是它应该访问2个后台Pod的哪一个呢？Service在这2个后台Pod之间提供透明的负载均衡，会将请求分发给其中的任意一个（如下面的动画所示）。通过每个Node上运行的代理（kube-proxy）完成。 + + + +下述动画展示了Service的功能。注意该图作了很多简化。如果不进入网络配置，那么达到透明的负载均衡目标所涉及的底层网络和路由相对先进。如果有兴趣，有更深入的介绍。 + +![3.gif](./k8s-core-concepts.assets/e7a273fcdc03d2417b354b60c253552f.gif) + +每个节点都运行如下Kubernetes关键组件： + +- Kubelet：是主节点代理。 +- Kube-proxy：Service使用其将链接路由到Pod，如上文所述。 +- Docker或Rocket：Kubernetes使用的容器技术来创建容器。 + + + +### Kubernetes Master + +集群拥有一个Kubernetes Master（紫色方框）。Kubernetes Master提供集群的独特视角，并且拥有一系列组件，比如Kubernetes API Server。API Server提供可以用来和集群交互的REST端点。master节点包括用来创建和复制Pod的Replication Controller。 diff --git a/learning/k8s-basics/kubernetes-basics.md b/learning/k8s-basics/kubernetes-basics.md index 0fe50b0..2f13ced 100644 --- a/learning/k8s-basics/kubernetes-basics.md +++ b/learning/k8s-basics/kubernetes-basics.md @@ -2,7 +2,7 @@ description: 本文为初学者介绍了一套最合适的 Kubernetes 入门教程，该教程源自于 Kubernetes 官方网站，作者对其进行了翻译，并根据初学者的理解情况做了适当的改写。 --- -# 学习Kubernetes基础知识 +# 0. 学习Kubernetes基础知识 本文翻译自 Kubernetes 官网 [Learn Kubernetes Basics](https://kubernetes.io/docs/tutorials/kubernetes-basics/) ，并有所改写 diff --git a/learning/k8s-basics/scale.md b/learning/k8s-basics/scale.md index ccefd75..a6bde44 100644 --- a/learning/k8s-basics/scale.md +++ b/learning/k8s-basics/scale.md @@ -2,7 +2,7 @@ description: 本文详细讲解了 Kubernetes Scale 的概念，并描述了如何使用 kubectl / Kuboard 对一个应用程序进行 伸缩 操作 --- -# 伸缩应用程序 +# 4. 伸缩应用程序 本文翻译自 Kubernetes 官网 [Running Multiple Instances of Your App](https://kubernetes.io/docs/tutorials/kubernetes-basics/scale/scale-intro/) ，并有所改写 diff --git a/learning/k8s-basics/update.md b/learning/k8s-basics/update.md index b5a153f..9e834d4 100644 --- a/learning/k8s-basics/update.md +++ b/learning/k8s-basics/update.md @@ -2,7 +2,7 @@ description: 本文详细讲解了 Kubernetes Rolling Update 的概念，并描述了如何使用 kubectl / Kuboard 对一个应用程序执行滚动更新。 --- -# 执行滚动更新 +# 5. 执行滚动更新 本文翻译自 Kubernetes 官网 [Performing a Rolling Update](https://kubernetes.io/docs/tutorials/kubernetes-basics/update/update-intro/) ，并有所改写 diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829061750251.png b/learning/k8s-intermediate/config-map.assets/image-20190829061750251.png deleted file mode 100644 index 500bc0b..0000000 Binary files a/learning/k8s-intermediate/config-map.assets/image-20190829061750251.png and /dev/null differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829110253001.png b/learning/k8s-intermediate/config-map.assets/image-20190829110253001.png new file mode 100644 index 0000000..60e8b2e Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829110253001.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829110932787.png b/learning/k8s-intermediate/config-map.assets/image-20190829110932787.png new file mode 100644 index 0000000..9b4fa6f Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829110932787.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829112358038.png b/learning/k8s-intermediate/config-map.assets/image-20190829112358038.png new file mode 100644 index 0000000..08d08d6 Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829112358038.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829112451057.png b/learning/k8s-intermediate/config-map.assets/image-20190829112451057.png new file mode 100644 index 0000000..6e547e0 Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829112451057.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829112834708.png b/learning/k8s-intermediate/config-map.assets/image-20190829112834708.png new file mode 100644 index 0000000..649a4ca Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829112834708.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829135425998.png b/learning/k8s-intermediate/config-map.assets/image-20190829135425998.png new file mode 100644 index 0000000..f3a7275 Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829135425998.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829135734710.png b/learning/k8s-intermediate/config-map.assets/image-20190829135734710.png new file mode 100644 index 0000000..f87d46b Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829135734710.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829141424670.png b/learning/k8s-intermediate/config-map.assets/image-20190829141424670.png new file mode 100644 index 0000000..a254ef9 Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829141424670.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829143229693.png b/learning/k8s-intermediate/config-map.assets/image-20190829143229693.png new file mode 100644 index 0000000..3a0afa6 Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829143229693.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829144149253.png b/learning/k8s-intermediate/config-map.assets/image-20190829144149253.png new file mode 100644 index 0000000..4345a0f Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829144149253.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829151744331.png b/learning/k8s-intermediate/config-map.assets/image-20190829151744331.png new file mode 100644 index 0000000..3a72749 Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829151744331.png differ diff --git a/learning/k8s-intermediate/config-map.assets/image-20190829151912714.png b/learning/k8s-intermediate/config-map.assets/image-20190829151912714.png new file mode 100644 index 0000000..c6cab02 Binary files /dev/null and b/learning/k8s-intermediate/config-map.assets/image-20190829151912714.png differ diff --git a/learning/k8s-intermediate/config-map.md b/learning/k8s-intermediate/config-map.md index 1c470b1..e9e1df7 100644 --- a/learning/k8s-intermediate/config-map.md +++ b/learning/k8s-intermediate/config-map.md @@ -31,10 +31,247 @@ Kubernetes 官网描述了多种 ConfigMap 的创建方法，本文不再复述 并填写表单，如下图所示： - ![image-20190829061750251](./config-map.assets/image-20190829061750251.png) + ![image-20190829110253001](./config-map.assets/image-20190829110253001.png) * 点击 **保存** ConfigMap 创建成功 -* +## 使用 ConfigMap 中的信息配置容器的环境变量 + +* 在名称空间页面点击 **创建工作负载** + + 填写表单如下： + + | 字段名称 | 填写内容 | 备注 | + | -------- | -------------- | ------------------------------------------------------------ | + | 服务类型 | Deployment | | + | 服务分层 | 中间件 | | + | 服务名称 | busybox | | + | 服务描述 | busybox | | + | 副本数量 | 1 | | + | 容器名称 | busybox | | + | 镜像 | busybox:1.29 | | + | 抓取策略 | Always | | + | Command | sleep
3600 | sleep 和 3600 是两个元素 | + | 环境变量 | ENV_KEY_1 | 选择 ConfigMap
ConfigMap 填写 ***my-nginx-config***
Key 填写 ***KEY_1*** | + + 如下图所示： + + ![image-20190829112358038](./config-map.assets/image-20190829112358038.png) + + ![image-20190829112451057](./config-map.assets/image-20190829112451057.png) + +* 点击 **保存** + +* 点击 **应用** + +* 点击 **完成** + +* 在 ***cloud-busybox*** 的工作负载查看界面，进入容器 ***busybox*** 的终端 + + 切换到 /bin/sh 终端 + + 执行命令： `echo $ENV_KEY_1` + + 可查看到输出结果为 `value-1` + + 执行命令：`export` + + 可查看到 ENV_KEY_1='value-1' 已经注入到该容器的环境变量中，如下图所示： + + ![image-20190829112834708](./config-map.assets/image-20190829112834708.png) + +## 将 ConfigMap 中的所有名值对配置为容器的环境变量 + +* 在名称空间页面点击 **创建工作负载** + + 填写表单如下： + + | 字段名称 | 填写内容 | 备注 | + | -------- | -------------- | ------------------------------------------------------------ | + | 服务类型 | Deployment | | + | 服务分层 | 中间件 | | + | 服务名称 | busybox | | + | 服务描述 | busybox | | + | 副本数量 | 1 | | + | 容器名称 | busybox | | + | 镜像 | busybox:1.29 | | + | 抓取策略 | Always | | + | Command | sleep
3600 | sleep 和 3600 是两个元素 | + | 环境变量 | ***my-nginx-config*** | 通过 ***+ 配置*** 按钮添加 | + + 如下图所示： + + ![image-20190829135425998](./config-map.assets/image-20190829135425998.png) + + +* 点击 **保存** + +* 点击 **应用** + +* 点击 **完成** + +* 在 ***cloud-busybox*** 的工作负载查看界面，进入容器 ***busybox*** 的终端 + + 切换到 /bin/sh 终端 + + 执行命令： `echo $KEY_1` + + 可查看到输出结果为 `value-1` + + 执行命令： `echo $KEY_2` + + 可查看到输出结果为 `value-2` + + 执行命令： `echo $KEY_3` + + 可查看到输出结果为 `3600` + + 执行命令：`export` + + 可查看到 `KEY_1` `KEY_2` `KEY_3` 已经注入到该容器的环境变量中，如下图所示： + + ![image-20190829135734710](./config-map.assets/image-20190829135734710.png) + +## 在 Pod 的 Command 中使用 ConfigMap 中定义的变量 + +* 在名称空间页面点击 **创建工作负载** + + 填写表单如下： + + | 字段名称 | 填写内容 | 备注 | + | -------- | -------------- | ------------------------------------------------------------ | + | 服务类型 | Deployment | | + | 服务分层 | 中间件 | | + | 服务名称 | busybox | | + | 服务描述 | busybox | | + | 副本数量 | 1 | | + | 容器名称 | busybox | | + | 镜像 | busybox:1.29 | | + | 抓取策略 | Always | | + | Command | /bin/sh
-c
echo ${ENV_KEY_1} ${ENV_KEY_3} ; sleep ${ENV_KEY_3} | | + | 环境变量 | ENV_KEY_1 / ENV_KEY_3 | 选择 ConfigMap
ConfigMap 填写 ***my-nginx-config***
Key 填写 ***KEY_1***

同样的方法添加 ENV_KEY_3 | + 如下图所示： + + ![image-20190829141424670](./config-map.assets/image-20190829141424670.png) + + +* 点击 **保存** + +* 点击 **应用** + +* 点击 **完成** + +* 在 ***cloud-busybox*** 的工作负载查看界面，进入容器 ***busybox*** 的日志界面，可查看到该命令输出的结果为 + + ``` sh + value-1 3600 + ``` + + 如下图所示 + + ![image-20190829151912714](./config-map.assets/image-20190829151912714.png) + +## 将 ConfigMap 中的信息挂载到数据卷 + +* 创建 ConfigMap 如下图所示： + + 填写表单： + + | 字段名称 | 填写内容 | 备注 | + | ------------ | ------------------ | ---------------------------------------------------- | + | 名称 | my-nginx-config | | + | KEY_1 | value-1 | | + | KEY_2 | value-2 | | + | KEY_3 | 3600 | | + | default_conf | 请参考下面的代码块 | 用来替换 nginx 容器中 /etc/nginx/conf.d/default.conf | + + default_conf 的内容如下： + + ``` nginx + server { + listen 80; + server_name localhost; + location / { + root /usr/share/nginx/html; + index index.html index.htm; + } + error_page 500 502 503 504 /50x.html; + location = /50x.html { + root /usr/share/nginx/html; + } + } + ``` + + + + ![image-20190829144149253](./config-map.assets/image-20190829144149253.png) + +* 创建 nginx Deployment 如下图所示： + + 填写表单： + + | 字段名称 | 填写内容 | 备注 | + | ---------------------- | -------------------------------- | ------------------------------------------------------------ | + | 服务类型 | Deployment | | + | 服务分层 | 展现层 | | + | 服务名称 | nginx | | + | 服务描述 | Nginx部署 | | + | 副本数量 | 1 | | + | 数据卷： | ---------- | ------------ | + | 数据卷名称 | default-conf | | + | 数据卷类型 | configMap | | + | ConfigMap | my-nginx-config | | + | KeyToPath | default_conf --> default.conf | 将数据卷内的 default_conf 的内容映射到路径 default.conf | + | 容器： | ---------- | ------------ | + | 容器名称 | nginx | | + | 镜像 | nginx:1.7.9 | | + | 抓取策略 | Always | | + | 挂载点：容器内路径 | /etc/nginx/conf.d/default.conf | 容器内路径 | + | 挂载点：数据卷 | default-conf | 选择上面已经定义的数据卷 | + | 挂载点：数据卷内子路径 | default.conf | 将数据卷内的 default.conf 映射到容器的 /etc/nginx/conf.d/default.conf | + + ![image-20190829143229693](./config-map.assets/image-20190829143229693.png) + +* 点击 **保存** + +* 点击 **应用** + +* 点击 **完成** + +* 进入 ***终端*** 界面 + + 执行命令 + + ```sh + # 切换当前目录 + cd /etc/nginx/conf.d + # 查看当前目录下的文件 + ls + # 查看 default.conf 的内容（该文件原本的内容已被 configMap 中的内容替换） + cat /default.conf + ``` + + ![image-20190829151744331](./config-map.assets/image-20190829151744331.png) + +::: tip + +* 在这个例子中，我们使用 ConfigMap ***my-nginx-config*** 中的 KEY ***default_conf*** 中的内容挂载到容器的 ***/etc/nginx/conf.d/default.conf*** 路径，以此替换了容器镜像中该路径原来的文件内容； +* 也可以将 ConfigMap 作为一个数据卷（在挂载时不指定数据卷内子路径）挂载到容器，此时 ConfigMap 将映射成一个文件夹，每一个 KEY 是文件夹下的文件名，KEY 对应的 VALUE 是文件当中的内容。 + +::: + +## 注意事项 + +ConfigMap 作为 Kubernetes API 对象，以 key-value 名值对的形式存储配置信息。如前所述，这些信息可以被 Pod（容器组）以不同的方式使用： + +* 将 ConfigMap 中某个 KEY 的 VALUE 作为容器组的环境变量 +* 将 ConfigMap 中所有的名值对作为容器组的环境变量 +* 在定义容器组的 Command 时，使用 ConfigMap 中 KEY 对应的 VALUE +* 将 ConfigMap 中的信息挂载到数据卷 + +**限制**： + +* 必须先创建 ConfigMap，才能在容器组中引用 ConfigMap。如果您引用了一个不存在的 ConfigMap，容器组将不能启动；同样的，如果您引用了 ConfigMap 中不存在的 KEY，容器组也将不能启动 +* ConfigMap 存在于名称空间当中，只有同一个名称空间下的容器组才能引用 \ No newline at end of file diff --git a/overview/README.md b/overview/README.md index f8a6b9c..e17bf0a 100644 --- a/overview/README.md +++ b/overview/README.md @@ -114,13 +114,13 @@ Kuboard 为 Kubernetes 初学者设计了如下学习路径： * 导入一个完整的 example 微服务应用，体验 Spring Cloud 在 Kubernetes 上的部署过程。 * **Kubernetes 入门** - * [十分钟带你理解Kubernetes核心概念](./k8s-core-concepts.html) - * [学习Kubernetes基础知识](/learning/k8s-basics/kubernetes-basics.html) (10分钟) - * [部署第一个应用程序](/learning/k8s-basics/deploy-app.html) (5分钟) - * [查看 Pods / Nodes](/learning/k8s-basics/explore.html) (10分钟) - * [公布应用程序](/learning/k8s-basics/expose.html) (10分钟) - * [伸缩应用程序](/learning/k8s-basics/scale.html) (10分钟) - * [执行滚动更新](/learning/k8s-basics/update.html) (10分钟) + * [0. 学习Kubernetes基础知识](/learning/k8s-basics/kubernetes-basics.html) (10分钟) + * [1. 部署第一个应用程序](/learning/k8s-basics/deploy-app.html) (5分钟) + * [2. 查看 Pods / Nodes](/learning/k8s-basics/explore.html) (10分钟) + * [3. 公布应用程序](/learning/k8s-basics/expose.html) (10分钟) + * [4. 伸缩应用程序](/learning/k8s-basics/scale.html) (10分钟) + * [5. 执行滚动更新](/learning/k8s-basics/update.html) (10分钟) + * [6. 复习Kubernetes核心概念](/learning/k8s-basics/k8s-core-concepts.html) (10分钟) * **Kubernetes 进阶** * [从微服务视角理解 Kubernetes](/articles/201908/kuboard-view-of-k8s.html) @@ -130,7 +130,7 @@ Kuboard 为 Kubernetes 初学者设计了如下学习路径： * **适合人群：** 身边有人带路，并且技术功底比较强的人，能够自行翻阅大量 docker / kubernetes 的官网英文资料。这些人在完成上面的 Kubernetes 入门教程之后，基本上可以在项目中开始实战了。 * 进阶路线二 * 购买一套口碑比较好的视频课程，例如 深入剖析Kubernetes ，由 Kubernetes 社区资深成员与项目维护者 张磊 创作，价钱也仅相当于两杯咖啡的样子。 - * **适合人群：** 技术功底相对薄弱，想要多学习一些理论，在理解 docker /kubernetes 等官网英文资料存在一定困难的人群 + * **适合人群：** 技术功底相对薄弱，想要多学习一些理论，在理解 docker / kubernetes 等官网英文资料存在一定困难的人群