From 0963a542d8cb086d11030666176430f8a46042ac Mon Sep 17 00:00:00 2001 From: Jimmy Song Date: Tue, 16 May 2017 21:45:53 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=A0=87=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...’Œç§˜é’¥.md => 01-创建TLSè¯ä¹¦å’Œå¯†é’¥.md | 2 +- ...nfig文件.md => 02-创建kubeconfig文件.md | 0 ...d集群.md => 03-创建高å¯ç”¨etcd集群.md | 0 ...¥å…·.md => 04-安装kubectl命令行工具.md | 2 +- 05-部署高å¯ç”¨master集群.md | 2 +- 06-部署node节点.md | 2 +- 07-安装kubednsæ’件.md | 2 +- 08-安装dashboardæ’件.md | 2 +- 09-安装heapsteræ’件.md | 2 +- 10-安装EFKæ’件.md | 2 +- 11-ingress解æž.md | 2 ++ 12-安装traefik-ingress.md | 2 +- 14-分布å¼è´Ÿè½½æµ‹è¯•.md | 2 +- 20-deployment概念解æž.md | 16 ++++++++-------- README.md | 9 +++++---- SUMMARY.md | 9 +++++---- 16 files changed, 30 insertions(+), 26 deletions(-) rename 01-TLSè¯ä¹¦å’Œç§˜é’¥.md => 01-创建TLSè¯ä¹¦å’Œå¯†é’¥.md (99%) rename 02-kubeconfig文件.md => 02-创建kubeconfig文件.md (100%) rename 03-高å¯ç”¨etcd集群.md => 03-创建高å¯ç”¨etcd集群.md (100%) rename 04-kubectl命令行工具.md => 04-安装kubectl命令行工具.md (92%) diff --git a/01-TLSè¯ä¹¦å’Œç§˜é’¥.md b/01-创建TLSè¯ä¹¦å’Œå¯†é’¥.md similarity index 99% rename from 01-TLSè¯ä¹¦å’Œç§˜é’¥.md rename to 01-创建TLSè¯ä¹¦å’Œå¯†é’¥.md index 8b1ccd0e9..e9e79bbef 100644 --- a/01-TLSè¯ä¹¦å’Œç§˜é’¥.md +++ b/01-创建TLSè¯ä¹¦å’Œå¯†é’¥.md @@ -1,4 +1,4 @@ -# 创建 kubernetes å„组件 TLS 加密通信的è¯ä¹¦å’Œç§˜é’¥ +# 创建TLSè¯ä¹¦å’Œç§˜é’¥ `kubernetes` 系统的å„组件需è¦ä½¿ç”¨ `TLS` è¯ä¹¦å¯¹é€šä¿¡è¿›è¡ŒåŠ å¯†ï¼Œæœ¬æ–‡æ¡£ä½¿ç”¨ `CloudFlare` çš„ PKI 工具集 [cfssl](https://github.com/cloudflare/cfssl) æ¥ç”Ÿæˆ Certificate Authority (CA) 和其它è¯ä¹¦ï¼› diff --git a/02-kubeconfig文件.md b/02-创建kubeconfig文件.md similarity index 100% rename from 02-kubeconfig文件.md rename to 02-创建kubeconfig文件.md diff --git a/03-高å¯ç”¨etcd集群.md b/03-创建高å¯ç”¨etcd集群.md similarity index 100% rename from 03-高å¯ç”¨etcd集群.md rename to 03-创建高å¯ç”¨etcd集群.md diff --git a/04-kubectl命令行工具.md b/04-安装kubectl命令行工具.md similarity index 92% rename from 04-kubectl命令行工具.md rename to 04-安装kubectl命令行工具.md index 798731692..358b076bf 100644 --- a/04-kubectl命令行工具.md +++ b/04-安装kubectl命令行工具.md @@ -1,4 +1,4 @@ -# 下载和é…ç½® kubectl 命令行工具 +# 安装kubectl命令行工具 本文档介ç»ä¸‹è½½å’Œé…ç½® kubernetes 集群命令行工具 kubelet 的步骤。 diff --git a/05-部署高å¯ç”¨master集群.md b/05-部署高å¯ç”¨master集群.md index 586e2e0bb..744e820dc 100644 --- a/05-部署高å¯ç”¨master集群.md +++ b/05-部署高å¯ç”¨master集群.md @@ -1,4 +1,4 @@ -# 部署高å¯ç”¨ kubernetes master 集群 +# 部署高å¯ç”¨master 集群 kubernetes master 节点包å«çš„组件： diff --git a/06-部署node节点.md b/06-部署node节点.md index 28c8905e4..9aff37bb2 100644 --- a/06-部署node节点.md +++ b/06-部署node节点.md @@ -1,4 +1,4 @@ -# 部署kubernetes node节点 +# 部署node节点 kubernetes node 节点包å«å¦‚下组件： diff --git a/07-安装kubednsæ’件.md b/07-安装kubednsæ’件.md index 35660ba5d..9056a1bf4 100644 --- a/07-安装kubednsæ’件.md +++ b/07-安装kubednsæ’件.md @@ -1,4 +1,4 @@ -# 安装和é…ç½® kubedns æ’件 +# 安装kubednsæ’件 官方的yaml文件目录：`kubernetes/cluster/addons/dns`。 diff --git a/08-安装dashboardæ’件.md b/08-安装dashboardæ’件.md index 6aa2693f1..549d6ae15 100644 --- a/08-安装dashboardæ’件.md +++ b/08-安装dashboardæ’件.md @@ -1,4 +1,4 @@ -# é…置和安装 dashboard +# 安装dashboardæ’件 官方文件目录：`kubernetes/cluster/addons/dashboard` diff --git a/09-安装heapsteræ’件.md b/09-安装heapsteræ’件.md index 752915de1..0d7940aec 100644 --- a/09-安装heapsteræ’件.md +++ b/09-安装heapsteræ’件.md @@ -1,4 +1,4 @@ -# é…置和安装 Heapster +# 安装heapsteræ’件 到 [heapster release 页é¢](https://github.com/kubernetes/heapster/releases) 下载最新版本的 heapster。 diff --git a/10-安装EFKæ’件.md b/10-安装EFKæ’件.md index f0ce2fb04..cb073703b 100644 --- a/10-安装EFKæ’件.md +++ b/10-安装EFKæ’件.md @@ -1,4 +1,4 @@ -# é…置和安装 EFK +# 安装EFKæ’件 官方文件目录：`cluster/addons/fluentd-elasticsearch` diff --git a/11-ingress解æž.md b/11-ingress解æž.md index 59380ea1d..aa69cc269 100644 --- a/11-ingress解æž.md +++ b/11-ingress解æž.md @@ -1,3 +1,5 @@ +# Ingressè§£æž + ## å‰è¨€ 这是kubernete官方文档中[Ingress Resource](https://kubernetes.io/docs/concepts/services-networking/ingress/)的翻译，åŽé¢çš„章节会讲到使用[Traefik](https://github.com/containous/traefik)æ¥åšIngress controller，文章末尾给出了几个相关链接。 diff --git a/12-安装traefik-ingress.md b/12-安装traefik-ingress.md index 18bf00366..43c9e2dc4 100644 --- a/12-安装traefik-ingress.md +++ b/12-安装traefik-ingress.md @@ -1,4 +1,4 @@ -# Kubernetes traefik ingress安装 +# 安装traefik ingress ## Ingress简介 diff --git a/14-分布å¼è´Ÿè½½æµ‹è¯•.md b/14-分布å¼è´Ÿè½½æµ‹è¯•.md index e69e0b94f..9e5bbe92d 100644 --- a/14-分布å¼è´Ÿè½½æµ‹è¯•.md +++ b/14-分布å¼è´Ÿè½½æµ‹è¯•.md @@ -1,4 +1,4 @@ -## è¿ç”¨Kubernetes进行分布å¼è´Ÿè½½æµ‹è¯• +## 分布å¼è´Ÿè½½æµ‹è¯• 该教程æ述如何在[Kubernetes](http://kubernetes.io)中进行分布å¼è´Ÿè½½å‡è¡¡æµ‹è¯•ï¼ŒåŒ…括一个web应用ã€dockeré•œåƒå’ŒKubernetes controllers/services。更多资料请查看[Distributed Load Testing Using Kubernetes](http://cloud.google.com/solutions/distributed-load-testing-using-kubernetes) 。 diff --git a/20-deployment概念解æž.md b/20-deployment概念解æž.md index dfb9a0da6..49783025e 100644 --- a/20-deployment概念解æž.md +++ b/20-deployment概念解æž.md @@ -71,12 +71,12 @@ nginx-deployment-2035384211-qqcnn 1/1 Running 0 18s app 刚创建的Replica Setå°†ä¿è¯æ€»æ˜¯æœ‰3个nginxçš„pod存在。 -**注æ„：** 你必须在Deployment中的selector指定正确pod template label（在该示例中是 `app = nginx`），ä¸è¦è·Ÿå…¶ä»–çš„controlleræžæ··äº†ï¼ˆåŒ…括Deploymentã€Replica Setã€Replication Controller等）。**Kubernetes本身ä¸ä¼šé˜»æ­¢ä½ è¿™ä¹ˆåš**，如果你真的这么åšäº†ï¼Œè¿™äº›controller之间会相互打架，并å¯èƒ½å¯¼è‡´ä¸æ­£ç¡®çš„行为。 +**注æ„：** 你必须在Deployment中的selector指定正确pod template label（在该示例中是 `app = nginx`），ä¸è¦è·Ÿå…¶ä»–çš„controlleræžæ··äº†ï¼ˆåŒ…括Deploymentã€Replica Setã€Replication Controller等）。**Kubernetes本身ä¸ä¼šé˜»æ­¢ä½ è¿™ä¹ˆåš**，如果你真的这么åšäº†ï¼Œè¿™äº›controller之间会相互打架，并å¯èƒ½å¯¼è‡´ä¸æ­£ç¡®çš„行为。 ## æ›´æ–°Deployment -**注æ„：** Deploymentçš„rollout当且仅当Deploymentçš„pod template（例如`.spec.template`）中的label更新或者镜åƒæ›´æ”¹æ—¶è¢«è§¦å‘。其他更新，例如扩容Deploymentä¸ä¼šè§¦å‘rollout。 +**注æ„：** Deploymentçš„rollout当且仅当Deploymentçš„pod template（例如`.spec.template`）中的label更新或者镜åƒæ›´æ”¹æ—¶è¢«è§¦å‘。其他更新，例如扩容Deploymentä¸ä¼šè§¦å‘rollout。 å‡å¦‚我们现在想è¦è®©nginx pod使用`nginx:1.9.1`çš„é•œåƒæ¥ä»£æ›¿åŽŸæ¥çš„`nginx:1.7.9`çš„é•œåƒã€‚ @@ -187,7 +187,7 @@ Events: 默认情况下，kubernetes会在系统中ä¿å­˜å‰ä¸¤æ¬¡çš„Deploymentçš„rollout历å²è®°å½•ï¼Œä»¥ä¾¿ä½ å¯ä»¥éšæ—¶ä¼šé€€ï¼ˆä½ å¯ä»¥ä¿®æ”¹`revision history limit`æ¥æ›´æ”¹ä¿å­˜çš„revision数）。ß -**注æ„：**åªè¦Deploymentçš„rollout被触å‘就会创建一个revision。也就是说当且仅当Deploymentçš„Pod template（如`.spec.template`）被更改，例如更新template中的label和容器镜åƒæ—¶ï¼Œå°±ä¼šåˆ›å»ºå‡ºä¸€ä¸ªæ–°çš„revision。 +**注æ„：** åªè¦Deploymentçš„rollout被触å‘就会创建一个revision。也就是说当且仅当Deploymentçš„Pod template（如`.spec.template`）被更改，例如更新template中的label和容器镜åƒæ—¶ï¼Œå°±ä¼šåˆ›å»ºå‡ºä¸€ä¸ªæ–°çš„revision。 其他的更新，比如扩容Deploymentä¸ä¼šåˆ›å»ºrevision——因此我们å¯ä»¥å¾ˆæ–¹ä¾¿çš„手动或者自动扩容。这æ„味ç€å½“你回退到历å²revision是，直邮Deployment中的Pod template部分æ‰ä¼šå›žé€€ã€‚ @@ -487,7 +487,7 @@ nginx-2142116321 0 0 0 2m nginx-3926361531 3 3 3 28s ``` -**注æ„：**在æ¢å¤Deployment之å‰ä½ æ— æ³•å›žé€€ä¸€ä¸ªæš‚åœäº†ä¸ªDeployment。 +**注æ„：** 在æ¢å¤Deployment之å‰ä½ æ— æ³•å›žé€€ä¸€ä¸ªæš‚åœäº†ä¸ªDeployment。 ## DeploymentçŠ¶æ€ @@ -552,9 +552,9 @@ Once the deadline has been exceeded, the Deployment controller adds a with the æµè§ˆ [Kubernetes API conventions](https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md#typical-status-properties) 查看关于status conditions的更多信æ¯ã€‚ -**注æ„：**kubernetes除了报告`Reason=ProgressDeadlineExceeded`状æ€ä¿¡æ¯å¤–ä¸ä¼šå¯¹å¡ä½çš„Deploymentåšä»»ä½•æ“作。更高层次的å调器å¯ä»¥åˆ©ç”¨å®ƒå¹¶é‡‡å–相应行动，例如，回滚Deployment到之å‰çš„版本。 +**注æ„：** kubernetes除了报告`Reason=ProgressDeadlineExceeded`状æ€ä¿¡æ¯å¤–ä¸ä¼šå¯¹å¡ä½çš„Deploymentåšä»»ä½•æ“作。更高层次的å调器å¯ä»¥åˆ©ç”¨å®ƒå¹¶é‡‡å–相应行动，例如，回滚Deployment到之å‰çš„版本。 -**注æ„：**如果你暂åœäº†ä¸€ä¸ªDeployment，在暂åœçš„这段时间内kubernetnesä¸ä¼šæ£€æŸ¥ä½ æŒ‡å®šçš„deadline。你å¯ä»¥åœ¨Deploymentçš„rollout途中安全的暂åœå®ƒï¼Œç„¶åŽå†æ¢å¤å®ƒï¼Œè¿™ä¸ä¼šè§¦å‘超过deadline的状æ€ã€‚ +**注æ„：** 如果你暂åœäº†ä¸€ä¸ªDeployment，在暂åœçš„这段时间内kubernetnesä¸ä¼šæ£€æŸ¥ä½ æŒ‡å®šçš„deadline。你å¯ä»¥åœ¨Deploymentçš„rollout途中安全的暂åœå®ƒï¼Œç„¶åŽå†æ¢å¤å®ƒï¼Œè¿™ä¸ä¼šè§¦å‘超过deadline的状æ€ã€‚ ä½ å¯èƒ½åœ¨ä½¿ç”¨Deployment的时候é‡åˆ°ä¸€äº›çŸ­æš‚的错误，这些å¯èƒ½æ˜¯ç”±äºŽä½ è®¾ç½®äº†å¤ªçŸ­çš„timeout，也有å¯èƒ½æ˜¯å› ä¸ºå„ç§å…¶ä»–错误导致的短暂错误。例如，å‡è®¾ä½ ä½¿ç”¨äº†æ— æ•ˆçš„引用。当你Describe Deployment的时候å¯èƒ½ä¼šæ³¨æ„到如下信æ¯ï¼š @@ -643,7 +643,7 @@ $ echo $? ä½ å¯ä»¥è®¾ç½®Deployment中的 `.spec.revisionHistoryLimit` 项æ¥æŒ‡å®šä¿ç•™å¤šå°‘旧的ReplicaSet。 余下的将在åŽå°è¢«å½“作垃圾收集。默认的，所有的revision历å²å°±éƒ½ä¼šè¢«ä¿ç•™ã€‚在未æ¥çš„版本中，将会更改为2。 -**注æ„：**将该值设置为0，将导致所有的Deployment历å²è®°å½•éƒ½ä¼šè¢«æ¸…除，该Deploynent就无法å†å›žé€€äº†ã€‚ +**注æ„：** 将该值设置为0，将导致所有的Deployment历å²è®°å½•éƒ½ä¼šè¢«æ¸…除，该Deploynent就无法å†å›žé€€äº†ã€‚ ## 用例 @@ -679,7 +679,7 @@ Deploymentä¹Ÿéœ€è¦ [`.spec` section](https://github.com/kubernetes/community/bl 在Podçš„templateè·Ÿ`.spec.template`ä¸åŒæˆ–者数é‡è¶…过了`.spec.replicas`规定的数é‡çš„情况下，Deployment会æ€æŽ‰labelè·Ÿselectorä¸åŒçš„Pod。 -**注æ„：**ä½ ä¸åº”该å†åˆ›å»ºå…¶ä»–label跟这个selector匹é…çš„pod，或者通过其他Deployment，或者通过其他Controller，例如ReplicaSetå’ŒReplicationController。å¦åˆ™è¯¥Deployment会被把它们当æˆéƒ½æ˜¯è‡ªå·±åˆ›å»ºçš„。Kubernetesä¸ä¼šé˜»æ­¢ä½ è¿™ä¹ˆåšã€‚ +**注æ„：** ä½ ä¸åº”该å†åˆ›å»ºå…¶ä»–label跟这个selector匹é…çš„pod，或者通过其他Deployment，或者通过其他Controller，例如ReplicaSetå’ŒReplicationController。å¦åˆ™è¯¥Deployment会被把它们当æˆéƒ½æ˜¯è‡ªå·±åˆ›å»ºçš„。Kubernetesä¸ä¼šé˜»æ­¢ä½ è¿™ä¹ˆåšã€‚ 如果你有多个controller使用了é‡å¤çš„selector，controller们就会互相打架并导致ä¸æ­£ç¡®çš„行为。 diff --git a/README.md b/README.md index 90694786e..d9cf2a6a3 100644 --- a/README.md +++ b/README.md @@ -12,10 +12,10 @@ GitHub地å€ï¼šhttps://github.com/rootsongjc/kubernetes-handbook - [0.0 介ç»](README.md) - [1.0 Kubernetes集群安装](00-kubernetes安装å‰è¨€.md) - - [1.1 创建 TLS 通信所需的è¯ä¹¦å’Œç§˜é’¥](01-TLSè¯ä¹¦å’Œç§˜é’¥.md) - - [1.2 创建kubeconfig 文件](02-kubeconfig文件.md) - - [1.3 创建三节点的高å¯ç”¨etcd集群](03-高å¯ç”¨etcd集群.md) - - [1.4 安装kubectl命令行工具](04-kubectl命令行工具.md) + - [1.1 创建 TLS è¯ä¹¦å’Œç§˜é’¥](01-创建TLSè¯ä¹¦å’Œå¯†é’¥.md) + - [1.2 创建kubeconfig 文件](02-创建kubeconfig文件.md) + - [1.3 创建高å¯ç”¨etcd集群](03-创建高å¯ç”¨etcd集群.md) + - [1.4 安装kubectl命令行工具](04-安装kubectl命令行工具.md) - [1.5 部署高å¯ç”¨master集群](05-部署高å¯ç”¨master集群.md) - [1.6 部署node节点](06-部署node节点.md) - [1.7 安装kubednsæ’件](07-安装kubednsæ’件.md) @@ -31,6 +31,7 @@ GitHub地å€ï¼šhttps://github.com/rootsongjc/kubernetes-handbook - 3.0 Kubernetesä¸­çš„å®¹å™¨è®¾è®¡æ¨¡å¼ TODO - 4.0 Kubernetesä¸­çš„æ¦‚å¿µè§£æž - [4.1 Deployment概念解æž](20-deployment概念解æž.md) + - [4.2 kubernetesé…置最佳实践.md](22-kubernetesé…置最佳实践.md) - 5.0 Kubernetes的安全设置 - [5.1 Kubernetes中的RBAC支æŒ](13-kubernetes中的RBAC支æŒ.md) - 6.0 Kubernetes网络é…ç½® diff --git a/SUMMARY.md b/SUMMARY.md index df4ba1183..5bff16597 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -2,13 +2,13 @@ * [0.0 介ç»](README.md) * [1.0 Kubernetes集群安装](00-kubernetes安装å‰è¨€.md) - * [1.1 创建 TLS 通信所需的è¯ä¹¦å’Œç§˜é’¥](01-TLSè¯ä¹¦å’Œç§˜é’¥.md) - * [1.2 创建kubeconfig 文件](02-kubeconfig文件.md) - * [1.3 创建三节点的高å¯ç”¨etcd集群](03-高å¯ç”¨etcd集群.md) + * [1.1 创建TLSè¯ä¹¦å’Œç§˜é’¥](01-创建TLSè¯ä¹¦å’Œå¯†é’¥.md) + * [1.2 创建kubeconfig 文件](02-创建kubeconfig文件.md) + * [1.3 创建高å¯ç”¨etcd集群](03-创建高å¯ç”¨etcd集群.md) * [1.4 安装kubectl命令行工具](04-kubectl命令行工具.md) * [1.5 部署高å¯ç”¨master集群](05-部署高å¯ç”¨master集群.md) * [1.6 部署node节点](06-部署node节点.md) - * [1.7 部署kubednsæ’件](07-安装kubednsæ’件.md) + * [1.7 安装kubednsæ’件](07-安装kubednsæ’件.md) * [1.8 安装dashboardæ’件](08-安装dashboardæ’件.md) * [1.9 安装heapsteræ’件](09-安装heapsteræ’件.md) * [1.10 安装EFKæ’件](10-安装EFKæ’件.md) @@ -21,6 +21,7 @@ * [3.0 Kubernetes中的容器设计模å¼]() * [4.0 Kubernetes中的概念解æž]() * [4.1 Deployment概念解æž](20-deployment概念解æž.md) + * [4.2 kubernetesé…置最佳实践.md](22-kubernetesé…置最佳实践.md) * [5.0 Kubernetes的安全设置]() * [5.1 Kubernetes中的RBAC支æŒ](13-kubernetes中的RBAC支æŒ.md) * [6.0 Kubernetes网络é…ç½®]()