` 首先，前端的Service每次将你的请求分配到不同的前端pod，前端的pod通过后端的service与后端的pod连接，因此，每个的后端pod都可以处理各个请求。
62 |
63 | 清除工作
64 | -------
65 | kubectl delete rc,service -l type=show-type
66 | kubectl delete rc,service -l type=backend-type
67 |
68 | 
69 |
70 |
--------------------------------------------------------------------------------
/111-Downward API example.md:
--------------------------------------------------------------------------------
1 | #Downward API 范例
2 | `译者：钟健鑫` `校对：无`
3 |
4 |
5 | 接下来的例子，你会创建一个pod, 它包含了一个通过访问[downward API](http://kubernetes.io/v1.0/docs/user-guide/downward-api.html)来使用这个pod名字和命名空的容器
6 |
7 | #步骤 0: 前提条件
8 |
9 | 这个例子会假设你有一个安装好并正在运行的Kubernetes集群，也已经在系统的某个路径下安装好了kubectl命令行工具。具体安装步骤请在[安装入门](http://kubernetes.io/v1.0/docs/getting-started-guides/)中找到与你平台对应的安装说明。
10 |
11 | #步骤 1: 创建一个pod
12 |
13 | 容器可以通过环境变量来消费downward API，而且downward API允许容器通过被注入的方来式使用所在pod的name和namespace等信息
14 |
15 | 下面我们使用examples/downward-api/dapi-pod.yaml来创建一个pod,并让它其中的容器通过downward API获取了所属pod的信息:
16 |
17 | ```
18 | $ kubectl create -f docs/user-guide/downward-api/dapi-pod.yaml
19 | ```
20 |
21 | #检查日志
22 | 这个pod在一个容器中运行env命令，来调用downward API。 接下来你就能通过过滤pod的日志来看到这个pod被注入的确切的值：
23 |
24 | ```
25 | $ kubectl logs dapi-test-pod | grep POD_
26 | 2015-04-30T20:22:18.568024817Z POD_NAME=dapi-test-pod
27 | 2015-04-30T20:22:18.568087688Z POD_NAMESPACE=default
28 | ```
29 |
--------------------------------------------------------------------------------
/114-Running your first containers in Kubernetes.md:
--------------------------------------------------------------------------------
1 | #在Kubernetes上运行你的第一个容器
2 | `译者：钟健鑫` `校对：无`
3 |
4 |
5 | 好了，如果你已经开始了任何一个入门指南，并且启动了一个Kubernetes集群。那么接下来呢？ 这个片指南会帮助你正对KUbernetes,在其集群上运行第一个容器。
6 |
7 | ##运行一个容器 (简单版)
8 |
9 | >从这时开始，我假设你已经根据其它入门指南安装了kubectl。
10 |
11 | >下面这行kubectl命令会穿件两个监听80端口的nginx pod. 还会创建一名为my-nginx个replication controller,用来保证始终会有两个pod在运行。
12 |
13 | ```
14 | kubectl run my-nginx --image=nginx --replicas=2 --port=80
15 | ```
16 |
17 | >一旦这些pod被创建好了， 你可以列出他们并查看他们的启动和运行。
18 |
19 | ```
20 | kubectl get pods
21 | ```
22 |
23 | >你也能够看见replication controller被创建了：
24 |
25 | ```
26 | kubectl get rc
27 | ```
28 | To stop the two replicated containers, stop the replication controller:
29 | 如果要停止这两个被复制的容器，你可以通过停止replication： controller
30 |
31 | ```
32 | kubectl stop rc my-nginx
33 | ```
34 |
35 | ##让你的的pod可以被外网方位.
36 |
37 | 在一些平台上（例如Google Compute Engine），kubectl命令能够集成云端提供的API来给pod条件公有IP地址，可以通过以下命令来实现：
38 |
39 | ```
40 | kubectl expose rc my-nginx --port=80 --type=LoadBalancer
41 | ```
42 |
43 | >这个命令会打印出被创建了的service,以及一个外部IP地址映射到service. 对外的IP地址根你实际运行环境有关。例如，对于Google Compute Engine的外部IP地址会被列为新创建的服务的一部分，还可以通在运行时检索。
44 |
45 | ```
46 | kubectl get services
47 | ```
48 |
49 | >为了访问你的nginx初始页面,你还不得不保证通过外部IP的通信是被允许的。那么就要通过让防火墙允许80端口通信才可以做到
50 |
51 | ##接下来: 配置文件
52 |
53 | Most people will eventually want to use declarative configuration files for creating/modifying their applications. A simplified introduction is given in a different document.
54 |
55 | 大多数人最终都会响使用声明式的配置文件来创建或修改他们的应用程勋。另外一个文档给出了一个[简单介绍](http://kubernetes.io/v1.0/docs/user-guide/simple-yaml.html)。
56 |
--------------------------------------------------------------------------------
/127-Exploring Pods.md:
--------------------------------------------------------------------------------
1 | # 滚动升级示例
2 | `译者：赵帅龙` `校对：无`
3 |
4 |
5 | 本例展示了如何使用Kubernetes对一组正在运行的[pods](../../../docs/user-guide/pods.md)做[滚动升级 rolling update](../kubectl/kubectl_rolling-update.md)。如果你还不知道为什么需要滚动升级，或者什么时候做滚动升级，请查看[这里](../managing-deployments.md#updating-your-application-without-a-service-outage)。更多信息查看[滚动升级设计文档](../../design/simple-rolling-update.md)。
6 |
7 | ### 第一步: 前提条件
8 |
9 | 本例子假设你已经fork了一份Kubernetes代码，并且创建了一个[Kubernetes集群](../../../docs/getting-started-guides/):
10 |
11 | ```控制台
12 | $ cd kubernetes
13 | $ ./cluster/kube-up.sh
14 | ```
15 |
16 | ### Step One: Turn up the UX for the demo
17 |
18 | You can use bash job control to run this in the background (note that you must use the default port -- 8001 -- for the following demonstration to work properly).
19 | This can sometimes spew to the output so you could also run it in a different terminal. You have to run `kubectl proxy` in the root of the
20 | Kubernetes repository. Otherwise you will get "404 page not found" errors as the paths will not match. You can find more information about `kubectl proxy`
21 | [here](../../../docs/user-guide/kubectl/kubectl_proxy.md).
22 |
23 | ```console
24 | $ kubectl proxy --www=docs/user-guide/update-demo/local/ &
25 | I0218 15:18:31.623279 67480 proxy.go:36] Starting to serve on localhost:8001
26 | ```
27 |
28 | Now visit the the [demo website](http://localhost:8001/static). You won't see anything much quite yet.
29 |
30 | ### Step Two: Run the replication controller
31 |
32 | Now we will turn up two replicas of an [image](../images.md). They all serve on internal port 80.
33 |
34 | ```console
35 | $ kubectl create -f docs/user-guide/update-demo/nautilus-rc.yaml
36 | ```
37 |
38 | After pulling the image from the Docker Hub to your worker nodes (which may take a minute or so) you'll see a couple of squares in the UI detailing the pods that are running along with the image that they are serving up. A cute little nautilus.
39 |
40 | ### Step Three: Try scaling the replication controller
41 |
42 | Now we will increase the number of replicas from two to four:
43 |
44 | ```console
45 | $ kubectl scale rc update-demo-nautilus --replicas=4
46 | ```
47 |
48 | If you go back to the [demo website](http://localhost:8001/static/index.html) you should eventually see four boxes, one for each pod.
49 |
50 | ### Step Four: Update the docker image
51 |
52 | We will now update the docker image to serve a different image by doing a rolling update to a new Docker image.
53 |
54 | ```console
55 | $ kubectl rolling-update update-demo-nautilus --update-period=10s -f docs/user-guide/update-demo/kitten-rc.yaml
56 | ```
57 |
58 | The rolling-update command in kubectl will do 2 things:
59 |
60 | 1. Create a new [replication controller](../../../docs/user-guide/replication-controller.md) with a pod template that uses the new image (`gcr.io/google_containers/update-demo:kitten`)
61 | 2. Scale the old and new replication controllers until the new controller replaces the old. This will kill the current pods one at a time, spinning up new ones to replace them.
62 |
63 | Watch the [demo website](http://localhost:8001/static/index.html), it will update one pod every 10 seconds until all of the pods have the new image.
64 | Note that the new replication controller definition does not include the replica count, so the current replica count of the old replication controller is preserved.
65 | But if the replica count had been specified, the final replica count of the new replication controller will be equal this number.
66 |
67 | ### Step Five: Bring down the pods
68 |
69 | ```console
70 | $ kubectl delete rc update-demo-kitten
71 | ```
72 |
73 | This first stops the replication controller by turning the target number of replicas to 0 and then deletes the controller.
74 |
75 | ### Step Six: Cleanup
76 |
77 | To turn down a Kubernetes cluster:
78 |
79 | ```console
80 | $ ./cluster/kube-down.sh
81 | ```
82 |
83 | Kill the proxy running in the background:
84 | After you are done running this demo make sure to kill it:
85 |
86 | ```console
87 | $ jobs
88 | [1]+ Running ./kubectl proxy --www=local/ &
89 | $ kill %1
90 | [1]+ Terminated: 15 ./kubectl proxy --www=local/
91 | ```
92 |
93 | ### Updating the Docker images
94 |
95 | If you want to build your own docker images, you can set `$DOCKER_HUB_USER` to your Docker user id and run the included shell script. It can take a few minutes to download/upload stuff.
96 |
97 | ```console
98 | $ export DOCKER_HUB_USER=my-docker-id
99 | $ ./docs/user-guide/update-demo/build-images.sh
100 | ```
101 |
102 | To use your custom docker image in the above examples, you will need to change the image name in `docs/user-guide/update-demo/nautilus-rc.yaml` and `docs/user-guide/update-demo/kitten-rc.yaml`.
103 |
104 | ### Image Copyright
105 |
106 | Note that the images included here are public domain.
107 |
108 | * [kitten](http://commons.wikimedia.org/wiki/File:Kitten-stare.jpg)
109 | * [nautilus](http://commons.wikimedia.org/wiki/File:Nautilus_pompilius.jpg)
110 |
111 |
112 |
113 | []()
114 |
115 |
--------------------------------------------------------------------------------
/128-Updating Live Pods.md:
--------------------------------------------------------------------------------
1 | ### explorer
2 | `译者：赵帅龙` `校对：无`
3 |
4 |
5 | Explorer is a little container for examining the runtime environment kubernetes produces for your pods.
6 |
7 | The intended use is to substitute gcr.io/google_containers/explorer for your intended container, and then visit it via the proxy.
8 |
9 | Currently, you can look at:
10 | * The environment variables to make sure kubernetes is doing what you expect.
11 | * The filesystem to make sure the mounted volumes and files are also what you expect.
12 | * Perform DNS lookups, to see how DNS works.
13 |
14 | `pod.yaml` is supplied as an example. You can control the port it serves on with the -port flag.
15 |
16 | Example from command line (the DNS lookup looks better from a web browser):
17 |
18 | ```console
19 | $ kubectl create -f examples/explorer/pod.yaml
20 | $ kubectl proxy &
21 | Starting to serve on localhost:8001
22 |
23 | $ curl localhost:8001/api/v1/proxy/namespaces/default/pods/explorer:8080/vars/
24 | PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
25 | HOSTNAME=explorer
26 | KIBANA_LOGGING_PORT_5601_TCP_PORT=5601
27 | KUBERNETES_SERVICE_HOST=10.0.0.2
28 | MONITORING_GRAFANA_PORT_80_TCP_PROTO=tcp
29 | MONITORING_INFLUXDB_UI_PORT_80_TCP_PROTO=tcp
30 | KIBANA_LOGGING_SERVICE_PORT=5601
31 | MONITORING_HEAPSTER_PORT_80_TCP_PORT=80
32 | MONITORING_INFLUXDB_UI_PORT_80_TCP_PORT=80
33 | KIBANA_LOGGING_SERVICE_HOST=10.0.204.206
34 | KIBANA_LOGGING_PORT_5601_TCP=tcp://10.0.204.206:5601
35 | KUBERNETES_PORT=tcp://10.0.0.2:443
36 | MONITORING_INFLUXDB_PORT=tcp://10.0.2.30:80
37 | MONITORING_INFLUXDB_PORT_80_TCP_PROTO=tcp
38 | MONITORING_INFLUXDB_UI_PORT=tcp://10.0.36.78:80
39 | KUBE_DNS_PORT_53_UDP=udp://10.0.0.10:53
40 | MONITORING_INFLUXDB_SERVICE_HOST=10.0.2.30
41 | ELASTICSEARCH_LOGGING_PORT=tcp://10.0.48.200:9200
42 | ELASTICSEARCH_LOGGING_PORT_9200_TCP_PORT=9200
43 | KUBERNETES_PORT_443_TCP=tcp://10.0.0.2:443
44 | ELASTICSEARCH_LOGGING_PORT_9200_TCP_PROTO=tcp
45 | KIBANA_LOGGING_PORT_5601_TCP_ADDR=10.0.204.206
46 | KUBE_DNS_PORT_53_UDP_ADDR=10.0.0.10
47 | MONITORING_HEAPSTER_PORT_80_TCP_PROTO=tcp
48 | MONITORING_INFLUXDB_PORT_80_TCP_ADDR=10.0.2.30
49 | KIBANA_LOGGING_PORT=tcp://10.0.204.206:5601
50 | MONITORING_GRAFANA_SERVICE_PORT=80
51 | MONITORING_HEAPSTER_SERVICE_PORT=80
52 | MONITORING_HEAPSTER_PORT_80_TCP=tcp://10.0.150.238:80
53 | ELASTICSEARCH_LOGGING_PORT_9200_TCP=tcp://10.0.48.200:9200
54 | ELASTICSEARCH_LOGGING_PORT_9200_TCP_ADDR=10.0.48.200
55 | MONITORING_GRAFANA_PORT_80_TCP_PORT=80
56 | MONITORING_HEAPSTER_PORT=tcp://10.0.150.238:80
57 | MONITORING_INFLUXDB_PORT_80_TCP=tcp://10.0.2.30:80
58 | KUBE_DNS_SERVICE_PORT=53
59 | KUBE_DNS_PORT_53_UDP_PORT=53
60 | MONITORING_GRAFANA_PORT_80_TCP_ADDR=10.0.100.174
61 | MONITORING_INFLUXDB_UI_SERVICE_HOST=10.0.36.78
62 | KIBANA_LOGGING_PORT_5601_TCP_PROTO=tcp
63 | MONITORING_GRAFANA_PORT=tcp://10.0.100.174:80
64 | MONITORING_INFLUXDB_UI_PORT_80_TCP_ADDR=10.0.36.78
65 | KUBE_DNS_SERVICE_HOST=10.0.0.10
66 | KUBERNETES_PORT_443_TCP_PORT=443
67 | MONITORING_HEAPSTER_PORT_80_TCP_ADDR=10.0.150.238
68 | MONITORING_INFLUXDB_UI_SERVICE_PORT=80
69 | KUBE_DNS_PORT=udp://10.0.0.10:53
70 | ELASTICSEARCH_LOGGING_SERVICE_HOST=10.0.48.200
71 | KUBERNETES_SERVICE_PORT=443
72 | MONITORING_HEAPSTER_SERVICE_HOST=10.0.150.238
73 | MONITORING_INFLUXDB_SERVICE_PORT=80
74 | MONITORING_INFLUXDB_PORT_80_TCP_PORT=80
75 | KUBE_DNS_PORT_53_UDP_PROTO=udp
76 | MONITORING_GRAFANA_PORT_80_TCP=tcp://10.0.100.174:80
77 | ELASTICSEARCH_LOGGING_SERVICE_PORT=9200
78 | MONITORING_GRAFANA_SERVICE_HOST=10.0.100.174
79 | MONITORING_INFLUXDB_UI_PORT_80_TCP=tcp://10.0.36.78:80
80 | KUBERNETES_PORT_443_TCP_PROTO=tcp
81 | KUBERNETES_PORT_443_TCP_ADDR=10.0.0.2
82 | HOME=/
83 |
84 | $ curl localhost:8001/api/v1/proxy/namespaces/default/pods/explorer:8080/fs/
85 | mount/
86 | var/
87 | .dockerenv
88 | etc/
89 | dev/
90 | proc/
91 | .dockerinit
92 | sys/
93 | README.md
94 | explorer
95 |
96 | $ curl localhost:8001/api/v1/proxy/namespaces/default/pods/explorer:8080/dns?q=elasticsearch-logging
97 |
98 |
102 |
LookupNS(elasticsearch-logging):
103 | Result: ([]*net.NS)
104 | Error: <*>lookup elasticsearch-logging: no such host
105 |
106 | LookupTXT(elasticsearch-logging):
107 | Result: ([]string)
108 | Error: <*>lookup elasticsearch-logging: no such host
109 |
110 | LookupSRV("", "", elasticsearch-logging):
111 | cname: elasticsearch-logging.default.svc.cluster.local.
112 | Result: ([]*net.SRV)[<*>{Target:(string)elasticsearch-logging.default.svc.cluster.local. Port:(uint16)9200 Priority:(uint16)10 Weight:(uint16)100}]
113 | Error:
114 |
115 | LookupHost(elasticsearch-logging):
116 | Result: ([]string)[10.0.60.245]
117 | Error:
118 |
119 | LookupIP(elasticsearch-logging):
120 | Result: ([]net.IP)[10.0.60.245]
121 | Error:
122 |
123 | LookupMX(elasticsearch-logging):
124 | Result: ([]*net.MX)
125 | Error: <*>lookup elasticsearch-logging: no such host
126 |
127 |
128 |
129 |
130 | ```
131 |
132 |
133 |
134 | []()
135 |
136 |
--------------------------------------------------------------------------------
/129-api_basicsmd.md:
--------------------------------------------------------------------------------
1 |
2 | `译者：安雪艳` `校对：无`
3 |
4 | # **Kubernetes API**
5 |
6 | [用户指南](https://github.com/kubernetes/kubernetes/blob/master/docs/user-guide/README.md)记录了主系统和API概念。
7 |
8 | [API规范文档](https://github.com/kubernetes/kubernetes/blob/master/docs/devel/api-conventions.md)描述了API整体规范。
9 |
10 | Kubernetes通过[Swagger](http://swagger.io/)记录API所有细节。Kubernetes apiserver (aka "master")提供了一个API接口用于获取Kubernetes API的[Swagger spec](https://github.com/swagger-api/swagger-spec/tree/master/schemas/v1.2)，默认在路径```/swaggerapi```下，```/swagger-ui```是可以使用浏览器查看API文档的UI
11 | 。我们会定期更新[静态生成UI](http://kubernetes.io/third_party/swagger-ui/)。
12 |
13 | 远程访问API在[访问文档](/kubernetes/kubernetes/blob/master/docs/admin/accessing-the-api.md)有讨论。
14 |
15 | Kubernetes API是系统描述性配置的基础。 [Kubectl](/kubernetes/kubernetes/blob/master/docs/user-guide/kubectl/kubectl.md)命令行工具被用于创建，更新，删除，获取API对象。
16 |
17 | Kubernete通过API资源存储自己序列化状态(现在存储在[etcd](https://coreos.com/docs/distributed-configuration/getting-started-with-etcd/))。
18 |
19 | Kubernetes被分成多个组件，各部分通过API相互交互。
20 |
21 | ##API更改
22 |
23 | 根据经验，任何成功的系统都需要成长和改变，可能是一个新的示例出现，也可能是对已有系统进行更改。因此，我们希望Kubernetes API也可以持续的改变和成长。在较长一段时间内，我们不打算中断已有客户端。一般情况，经常会有新的API资源和新的资源字段增加。删除资源或者字段会有一个跟踪废弃流程。删除功能有一个小的废弃策略叫做TBD，但是Kubernetes到达1.0版本时，将会有一个详细的策略代替。
24 |
25 | 如何构成一个兼容性的改变以及如何更改API的详细信息都在[API变化文档](/kubernetes/kubernetes/blob/master/docs/devel/api_changes.md)
26 |
27 | ##API版本
28 |
29 | 为了使删除字段或者重构资源表示更加容易，Kubernetes支持多个API版本。每一个版本都在不同API路径下，例如 ```/api/v1``` 或者```/apis/extensions/v1beta1```.
30 |
31 | 我们选择版本时时根据API而不是根据资源或者字段来确认的，API为系统资源和行为提供了一个清晰的，一致性的视图，并且可以控制访问生命周期结束和／或测试的APIs。
32 |
33 |
34 | 注意API版本控制和软件版本控制只能间接的相关联。文档[API and release versioning proposal](/kubernetes/kubernetes/blob/master/docs/design/versioning.md) 描述了API版本控制和软件版本控制两者之间的关系。
35 |
36 | 不同的API版本会有不同级别的稳定性和支持。每个级别的详细描述包含在文档[API Changes documentation](/kubernetes/kubernetes/blob/master/docs/devel/api_changes.md#alpha-beta-and-stable-versions)中。 内容主要概括如下：
37 |
38 | * Alpha 级别:
39 | * 版本名称包含了 ```alpha``` (e.g. ```v1alpha1``).
40 | * 可能是有问题的。实现的功能可能隐含问题，功能默认是不可用的。
41 | * 支持的功能可能在没有通知的情况下随时删除。
42 | * API的更改可能存在冲突，但是在后续的软件发布中不会有任何通知。
43 | * 由于bugs风险的增加和缺乏长期的支持，推荐在短暂的集群测试中使用。
44 | * Beta 级别:
45 | * 版本名称包含了 ```beta``` (e.g. ```v2beta3```).
46 | * 代码已经测试过。实现的功能认为是安全的，功能默认是可用的。
47 | * 所有已支持的功能不会被删除，细节可能会发生变化。
48 | * 对象的模式和／或定义在随后的beta版本或者稳定版本可能以不兼容的方式改变。在这种情况下，Kubernetes会提供合并到下一个版本的指南。这一过程中可能会要求删除，编译和重新创建API对象。编译过程中可能会要求一些选择。根据不同的功能可能会需要一些应用的下载时间。
49 | * 在随后的发布中存在一些非兼容性的更改，所已推荐在不重要的非商业化的情况下使用。如果你已经有多个集群，并且可以单独更新，你可以放宽这个限制。
50 | * **请尝试我们的bete版本功能并且给出反馈！因为已经是beta版本，对于我们来说太多的更改可能不太实用 **
51 | * Stable 级别:
52 | * 版本名称中包含 vX 这里的X是一个整数.
53 | * 稳定版本的功能在后续的版本发布中会一直存在。
54 |
55 | ##API群组
56 |
57 | 为了使扩展Kubernetes API更加简单，我们正在实现[API groups](/kubernetes/kubernetes/blob/master/docs/proposals/api-group.md). API群组是一些可以读和／或更改相同基础资源的简单的不同的接口。API群组被定义在一个REST路径下，在```apiVersion```的一个序列化对象的字段。
58 |
59 | 当前有两个API群组在使用：
60 |
61 | 1. "core"群组，在REST路径```/api/v1```下，但不是apiVersion字段的一部分。e.g. ```apiVersion: v1 ```。
62 | 2. "extensions"群组, 在REST路径```/apis/extensions/$VERSION```下, 并且使用```apiVersion: extensions/$VERSION ```(e.g. 当前是```apiVersion: extensions/v1beta1```).
63 |
64 | 未来我们希望有更多的API群组，并且所有的群组都在REST路径
65 | ```/apis/$API_GROUP```下，并且使用```apiVersion: $API_GROUP/$VERSION```。我们希望将来有一种方式支持三方可以创建自己的[API groups](design/extending-api.md)，并且可以避免命名冲突。
66 |
67 | ## 扩展资源
68 |
69 | 默认情况下Jobs, Ingress和HorizontalPodAutoscalers都是可用的。其他的扩展资源通过设置apiserver的runtime-config使其可用。runtime-config多个值可通过都逗号分开。例如：设置部署可用，jobs不可用命令，```--runtime-config=extensions/v1beta1/deployments=true,extensions/v1beta1/jobs=false```
70 |
71 | ##v1beta1, v1beta2, and v1beta3已经废弃；请转到v1 ASAP
72 |
73 | 2015年6月4日，Kubernetes v1 API已经默认可以使用。v1beta1和v1beta2 APIs在2015年6月1日删除。v1beta3计划会在2015年6月6日删除。
74 |
75 | ###v1转换技巧(从v1beta3)
76 |
77 | 我们已经将所有文档和例子转换成v1版本。并且写了一个简单的 [API转换工具](/kubernetes/kubernetes/blob/master/docs/admin/cluster-management.md#switching-your-config-files-to-a-new-api-version)来进行简单的转换。使用```kubectl create --validate```命令可以使你的json或者yaml按照Swagger spec规范有效。
78 |
79 | v1beta3和v1版本之间最重要的不同是服务的改变。
80 |
81 | * ```service.spec.portalIP```属性重命名为```service.spec.clusterIP```。
82 | * ```service.spec.createExternalLoadBalancer```已经被删除。 定义了```service.spec.type: "LoadBalancer"```来代替，用于创建外部负载均衡。
83 | * ```service.spec.publicIPs```属性已经被废弃，现在叫做```service.spec.deprecatedPublicIPs```。当v1beta3删除时，这个属性也会被完全删除。这个字段的多数用户使用这个字段来公开nodes上的services端口。现在这些用户应该使用```service.spec.type: "NodePort"```来代替。 获取更多信息可阅读[External Services](/kubernetes/kubernetes/blob/master/docs/user-guide/services.md#external-services)。如果这些还是不能满足你的需求，请提交issue或者联系@thockin。
84 |
85 | v1beta3和v1版本之间其他的不同：
86 |
87 | * ```pod.spec.containers[*].privileged```和```pod.spec.containers[*].capabilities```属性已经合并到```pod.spec.containers[*].securityContext```属性。可以查看文档[Security Contexts](/kubernetes/kubernetes/blob/master/docs/user-guide/security-context.md)。
88 | * ```pod.spec.host```属性被重命名为```pod.spec.nodeName```。
89 | * ```endpoints.subsets[*].addresses.IP```被重命名为```endpoints.subsets[*].addresses.ip```。
90 | * ```pod.status.containerStatuses[*].state.termination```和```pod.status.containerStatuses[*].lastState.termination```属性被分别重命名为```pod.status.containerStatuses[*].state.terminated```和```pod.status.containerStatuses[*].lastState.terminated```。
91 | * ```pod.status.Condition```属性被重命名为```pod.status.conditions```。
92 | * ```status.details.id```属性被重命名为```status.details.name```。
93 |
94 | v1beta3转换技巧(从v1beta1/2)
95 |
96 | v1beta1/2和v1beta3重要不同点:
97 |
98 | * 资源```id```现在称作``name```.
99 | * ```name```，```labels```，```annotations```，和其他元数据现在内嵌在一个称作```metadata```的map中
100 | * ```desiredState``` 现在称作```spec```，```currentState``` 现在称作```status``
101 | * ```/minions``` 已经被移到```/nodes```, 且资源包括各种 ```Node```
102 | * namesapce是必要条件(对于所有资源namesapce)且已经从一个URL参数改为路径：```/api/v1beta3/namespaces/{namespace}/{resource_collection}/{resource_name}```. 如果之前你没有使用过namespace，在这可以使用```default```.
103 | * 所有资源收集器的名字已经小写 - 已经废弃 ```replicationControllers```，使用 ```replicationcontrollers``来代替。
104 | * 查看某个资源的改变，可打开一个HTTP或者Websocket连接查询，并且提供```?watch=true ```请求参数和```resourceVersion```参数进行查询。
105 | * ```labels```查询参数已经被重命名为```labelSelector```。
106 | * ```fields```查询参数已经被重命名为```fieldSelector```。
107 | * Container中的```entrypoint```已经被重命名为```command```，而```command```被重命名为```args```.
108 | * Container, volume, and node资源的定义已经被内嵌到一个maps (e.g., ```resources{cpu:1}```)并没有作为独立的字段，并且资源数值支持[后缀](user-guide/compute-resources.html#specifying-resource-quantities)而不是固定的(e.g., milli-cores)。
109 | * 重新启动策略简单的表示为字串(e.g., ```"Always"```)而不是作为一个内嵌的map(```always{}```).
110 | * Pull策略从```PullAlways```, ```PullNever```，和```PullIfNotPresent```变成了```Always```，```Never```，和```IfNotPresent```。
111 | * volume ```source```被内联到```volume```而非嵌套。
112 | * 宿主机volumes已经从```hostDir```变成了```hostPath```，这样做的好处是，挂载的可以是一个文件也可以是一个路径。
--------------------------------------------------------------------------------
/132-working_with_resourcesmd.md:
--------------------------------------------------------------------------------
1 |
2 | `译者：安雪艳` `校对：无`
3 |
4 | # **资源管理**
5 |
6 | 本篇文章的目的是为了那些已经使用过一些示例并且想学习更多关于kubectl管理资源pod或者services的用户。想直接通过REST API访问的用户和想扩展Kubernetes API的开发者都应该参考文档 [api conventions](../devel/api-conventions.html)和[api document](../api.html).
7 |
8 | # **资源自动更新**
9 |
10 | 当创建一个资源例如pod，随后会收到被创建和资源已添加的的多个字段。可以参考下面的工作示例：
11 | ```
12 | $ cat > /tmp/original.yaml < /tmp/current.yaml
26 | pods/original
27 | $ wc -l /tmp/original.yaml /tmp/current.yaml
28 | 51 /tmp/current.yaml
29 | 9 /tmp/original.yaml
30 | 60 total
31 | ```
32 | 我们提交的资源只有9行，但是我们收到了51行。如果你执行```diff -u /tmp/original.yaml /tmp/current.yaml```，你可以看到pod增加的字段。系统通过如下几种方式增加字段：
33 | * 一些字段时在资源创建时同步设置的，一些异步设置的。
34 | * 例如：```metadata.uid```同步设置. (获取更多信息请看 [metadata](../devel/api-conventions.html#metadata)).
35 | * 例如，```status.hostIP```是在pod被调度后设置。这些谁都发生的比较快。但是你可以注意到还没有设置的pods。这叫做初始化。 (获取更多信息请看[status](../devel/api-conventions.html#spec-and-status)和[late initialization](../devel/api-conventions.html#late-initialization) )。
36 | * 一些字段被设置了默认值。一些默认值是根据cluster设置，一些默认值是API特定版本固定的。(获取更多信息请看 [defaulting](../devel/api-conventions.html#late-initialization)).
37 | * 例如， ```spec.containers[0].imagePullPolicy``` 在api v1版本的默认值一直时```IfNotPresent```。
38 | * 例如，```spec.containers[0].resources.limits.cpu``` 在一些cluster可能默认设置为```100m```，其他clueter中是其他的值，并且不是在所有的clueter中都默认设置。API一般不会改变你已经设置的字段；它只会设置那些你没有定义的字段。
39 |
40 | # **资源文档**
41 |
42 | 你可以在[project website](http://kubernetes.io/v1.1/api-ref.html)或者[github](https://releases.k8s.io/release-1.1/docs/api-reference)上浏览自动生成的API问文档.
43 |
44 |
--------------------------------------------------------------------------------
/133-kubernetes_api_referencemd.md:
--------------------------------------------------------------------------------
1 |
2 | `译者：安雪艳` `校对：无`
3 |
4 |
5 | # **Kubernetes API参考**
6 |
7 | 使用这些参考文档可学习如何通过REST API与Kubernetes交互。
8 |
9 | 你可以通过文档[API versioning](docs/api.html)看到关于扩展API的详细信息.
10 |
11 | 内容列表:
12 |
13 | * [Operations](http://kubernetes.io/v1.1/docs/api-reference/v1/operations.html)
14 | * [Definitions](http://kubernetes.io/v1.1/docs/api-reference/v1/definitions.html)
15 | * Extensions API:
16 | * [Extensions: Operations](http://kubernetes.io/v1.1/docs/api-reference/extensions/v1beta1/operations.html)
17 | * [Extensions: Definitions](http://kubernetes.io/v1.1/docs/api-reference/extensions/v1beta1/definitions.html)
--------------------------------------------------------------------------------
/134-operations.md:
--------------------------------------------------------------------------------
1 | # 运维API
2 | `译者：丁麒玮` `校对：无`
3 |
4 |
5 | {% include "include/API-Operations.html" %}
6 |
--------------------------------------------------------------------------------
/135-Definitions.md:
--------------------------------------------------------------------------------
1 | # 参数说明
2 | `译者：赵帅龙` `校对：无`
3 |
4 |
5 | {% include "include/API-Definitions.html" %}
6 |
7 |
--------------------------------------------------------------------------------
/136-Command Reference.md:
--------------------------------------------------------------------------------
1 | ## kubectl
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 使用kubectl来管理Kubernetes集群。
6 |
7 | ### 摘要
8 |
9 | 使用kubectl来管理Kubernetes集群。
10 |
11 | 可以在https://github.com/kubernetes/kubernetes找到更多的信息。
12 |
13 | ```
14 | kubectl
15 | ```
16 |
17 | ### 选项
18 |
19 | ```
20 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
21 | --api-version="": 和服务端交互使用的API版本。
22 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
23 | --client-certificate="": TLS使用的客户端证书路径。
24 | --client-key="": TLS使用的客户端密钥路径。
25 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
26 | --context="": 指定使用的kubeconfig配置文件中的环境名。
27 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
28 | --kubeconfig="": 命令行请求使用的配置文件路径。
29 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
30 | --log-dir="": 如果不为空，将日志文件写入此目录。
31 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
32 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
33 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
34 | --namespace="": 如果不为空，命令将使用此namespace。
35 | --password="": API Server进行简单认证使用的密码。
36 | -s, --server="": Kubernetes API Server的地址和端口号。
37 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
38 | --token="": 认证到API Server使用的令牌。
39 | --user="": 指定使用的kubeconfig配置文件中的用户名。
40 | --username="": API Server进行简单认证使用的用户名。
41 | --v=0: 指定输出日志的级别。
42 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
43 | ```
44 |
45 | ### 参见
46 |
47 | * [kubectl annotate](kubectl_annotate.md) - 更新资源的注解。
48 | * [kubectl api-versions](kubectl_api-versions.md) - 以“组/版本”的格式输出服务端支持的API版本。
49 | * [kubectl apply](kubectl_apply.md) - 通过文件名或控制台输入，对资源进行配置。
50 | * [kubectl attach](kubectl_attach.md) - 连接到一个正在运行的容器。
51 | * [kubectl autoscale](kubectl_autoscale.md) - 对replication controller进行自动伸缩。
52 | * [kubectl cluster-info](kubectl_cluster-info.md) - 输出集群信息。
53 | * [kubectl config](kubectl_config.md) - 修改kubeconfig配置文件。
54 | * [kubectl create](kubectl_create.md) - 通过文件名或控制台输入，创建资源。
55 | * [kubectl delete](kubectl_delete.md) - 通过文件名、控制台输入、资源名或者label selector删除资源。
56 | * [kubectl describe](kubectl_describe.md) - 输出指定的一个/多个资源的详细信息。
57 | * [kubectl edit](kubectl_edit.md) - 编辑服务端的资源。
58 | * [kubectl exec](kubectl_exec.md) - 在容器内部执行命令。
59 | * [kubectl expose](kubectl_expose.md) - 输入replication controller，service或者pod，并将其暴露为新的kubernetes service。
60 | * [kubectl get](kubectl_get.md) - 输出一个/多个资源。
61 | * [kubectl label](kubectl_label.md) - 更新资源的label。
62 | * [kubectl logs](kubectl_logs.md) - 输出pod中一个容器的日志。
63 | * [kubectl namespace](kubectl_namespace.md) -（已停用）设置或查看当前使用的namespace。
64 | * [kubectl patch](kubectl_patch.md) - 通过控制台输入更新资源中的字段。
65 | * [kubectl port-forward](kubectl_port-forward.md) - 将本地端口转发到Pod。
66 | * [kubectl proxy](kubectl_proxy.md) - 为Kubernetes API server启动代理服务器。
67 | * [kubectl replace](kubectl_replace.md) - 通过文件名或控制台输入替换资源。
68 | * [kubectl rolling-update](kubectl_rolling-update.md) - 对指定的replication controller执行滚动升级。
69 | * [kubectl run](kubectl_run.md) - 在集群中使用指定镜像启动容器。
70 | * [kubectl scale](kubectl_scale.md) - 为replication controller设置新的副本数。
71 | * [kubectl stop](kubectl_stop.md) - （已停用）通过资源名或控制台输入安全删除资源。
72 | * [kubectl version](kubectl_version.md) - 输出服务端和客户端的版本信息。
--------------------------------------------------------------------------------
/137-kubectl_api-versions.md:
--------------------------------------------------------------------------------
1 | ## kubectl api-versions
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 以“组/版本”的格式输出服务端支持的API版本。
6 |
7 | ### 摘要
8 |
9 | 以“组/版本”的格式输出服务端支持的API版本。
10 |
11 | ```
12 | kubectl api-versions
13 | ```
14 |
15 | ### 继承自父命令的选项
16 | ```
17 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
18 | --api-version="": 和服务端交互使用的API版本。
19 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
20 | --client-certificate="": TLS使用的客户端证书路径。
21 | --client-key="": TLS使用的客户端密钥路径。
22 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
23 | --context="": 指定使用的kubeconfig配置文件中的环境名。
24 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
25 | --kubeconfig="": 命令行请求使用的配置文件路径。
26 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
27 | --log-dir="": 如果不为空，将日志文件写入此目录。
28 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
29 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
30 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
31 | --namespace="": 如果不为空，命令将使用此namespace。
32 | --password="": API Server进行简单认证使用的密码。
33 | -s, --server="": Kubernetes API Server的地址和端口号。
34 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
35 | --token="": 认证到API Server使用的令牌。
36 | --user="": 指定使用的kubeconfig配置文件中的用户名。
37 | --username="": API Server进行简单认证使用的用户名。
38 | --v=0: 指定输出日志的级别。
39 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
40 | ```
41 |
42 | ### 参见
43 |
44 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/138-kubectl_cluster-info.md:
--------------------------------------------------------------------------------
1 | ## kubectl cluster-info
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 显示集群信息。
6 |
7 | ### 摘要
8 |
9 | 显示master节点的地址和包含kubernetes.io/cluster-service=true的service（系统service）。
10 |
11 | ```
12 | kubectl cluster-info
13 | ```
14 |
15 | ### 继承自父命令的选项
16 | ```
17 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
18 | --api-version="": 和服务端交互使用的API版本。
19 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
20 | --client-certificate="": TLS使用的客户端证书路径。
21 | --client-key="": TLS使用的客户端密钥路径。
22 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
23 | --context="": 指定使用的kubeconfig配置文件中的环境名。
24 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
25 | --kubeconfig="": 命令行请求使用的配置文件路径。
26 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
27 | --log-dir="": 如果不为空，将日志文件写入此目录。
28 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
29 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
30 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
31 | --namespace="": 如果不为空，命令将使用此namespace。
32 | --password="": API Server进行简单认证使用的密码。
33 | -s, --server="": Kubernetes API Server的地址和端口号。
34 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
35 | --token="": 认证到API Server使用的令牌。
36 | --user="": 指定使用的kubeconfig配置文件中的用户名。
37 | --username="": API Server进行简单认证使用的用户名。
38 | --v=0: 指定输出日志的级别。
39 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
40 | ```
41 |
42 | ### 参见
43 |
44 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/139-kubectl_config_set-cluster.md:
--------------------------------------------------------------------------------
1 | ## kubectl config set-cluster
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 在kubeconfig配置文件中设置一个集群项。
6 |
7 | ### 摘要
8 |
9 | 在kubeconfig配置文件中设置一个集群项。
10 | 如果指定了一个已存在的名字，将合并新字段并覆盖旧字段。
11 |
12 | ```
13 | kubectl config set-cluster NAME [--server=server] [--certificate-authority=path/to/certficate/authority] [--api-version=apiversion] [--insecure-skip-tls-verify=true]
14 | ```
15 |
16 | ### 示例
17 |
18 | ```
19 | # 仅设置e2e集群项中的server字段，不影响其他字段
20 | $ kubectl config set-cluster e2e --server=https://1.2.3.4
21 |
22 | # 向e2e集群项中添加认证鉴权数据
23 | $ kubectl config set-cluster e2e --certificate-authority=~/.kube/e2e/kubernetes.ca.crt
24 |
25 | # 取消dev集群项中的证书检查
26 | $ kubectl config set-cluster e2e --insecure-skip-tls-verify=true
27 | ```
28 |
29 | ### 选项
30 |
31 | ```
32 | --api-version="": 设置kuebconfig配置文件中集群选项中的api-version。
33 | --certificate-authority="": 设置kuebconfig配置文件中集群选项中的certificate-authority路径。
34 | --embed-certs=false: 设置kuebconfig配置文件中集群选项中的embed-certs开关。
35 | --insecure-skip-tls-verify=false: 设置kuebconfig配置文件中集群选项中的insecure-skip-tls-verify开关。
36 | --server="": 设置kuebconfig配置文件中集群选项中的server。
37 | ```
38 |
39 | ### 继承自父命令的选项
40 | ```
41 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
42 | --api-version="": 和服务端交互使用的API版本。
43 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
44 | --client-certificate="": TLS使用的客户端证书路径。
45 | --client-key="": TLS使用的客户端密钥路径。
46 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
47 | --context="": 指定使用的kubeconfig配置文件中的环境名。
48 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
49 | --kubeconfig="": 命令行请求使用的配置文件路径。
50 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
51 | --log-dir="": 如果不为空，将日志文件写入此目录。
52 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
53 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
54 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
55 | --namespace="": 如果不为空，命令将使用此namespace。
56 | --password="": API Server进行简单认证使用的密码。
57 | -s, --server="": Kubernetes API Server的地址和端口号。
58 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
59 | --token="": 认证到API Server使用的令牌。
60 | --user="": 指定使用的kubeconfig配置文件中的用户名。
61 | --username="": API Server进行简单认证使用的用户名。
62 | --v=0: 指定输出日志的级别。
63 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
64 | ```
65 |
66 | ### 参见
67 |
68 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/140-kubectl_config_set-context.md:
--------------------------------------------------------------------------------
1 | ## kubectl config set-context
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 在kubeconfig配置文件中设置一个环境项。
6 |
7 | ### 摘要
8 |
9 | 在kubeconfig配置文件中设置一个环境项。
10 | 如果指定了一个已存在的名字，将合并新字段并覆盖旧字段。
11 |
12 | ```
13 | kubectl config set-context NAME [--cluster=cluster_nickname] [--user=user_nickname] [--namespace=namespace]
14 | ```
15 |
16 | ### 示例
17 |
18 | ```
19 | # 设置gce环境项中的user字段，不影响其他字段。
20 | $ kubectl config set-context gce --user=cluster-admin
21 | ```
22 |
23 | ### 选项
24 |
25 | ```
26 | --cluster="": 设置kuebconfig配置文件中环境选项中的集群。
27 | --namespace="": 设置kuebconfig配置文件中环境选项中的命名空间。
28 | --user="": 设置kuebconfig配置文件中环境选项中的用户。
29 | ```
30 |
31 | ### 继承自父命令的选项
32 | ```
33 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
34 | --api-version="": 和服务端交互使用的API版本。
35 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
36 | --client-certificate="": TLS使用的客户端证书路径。
37 | --client-key="": TLS使用的客户端密钥路径。
38 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
39 | --context="": 指定使用的kubeconfig配置文件中的环境名。
40 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
41 | --kubeconfig="": 命令行请求使用的配置文件路径。
42 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
43 | --log-dir="": 如果不为空，将日志文件写入此目录。
44 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
45 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
46 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
47 | --namespace="": 如果不为空，命令将使用此namespace。
48 | --password="": API Server进行简单认证使用的密码。
49 | -s, --server="": Kubernetes API Server的地址和端口号。
50 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
51 | --token="": 认证到API Server使用的令牌。
52 | --user="": 指定使用的kubeconfig配置文件中的用户名。
53 | --username="": API Server进行简单认证使用的用户名。
54 | --v=0: 指定输出日志的级别。
55 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
56 | ```
57 |
58 | ### 参见
59 |
60 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/141-kubectl_config_set-credentials.md:
--------------------------------------------------------------------------------
1 | ## kubectl config set-credentials
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 在kubeconfig配置文件中设置一个用户项。
6 |
7 | ### 摘要
8 |
9 | 在kubeconfig配置文件中设置一个用户项。
10 | 如果指定了一个已存在的名字，将合并新字段并覆盖旧字段。
11 |
12 | 客户端证书设置：
13 | --client-certificate=certfile --client-key=keyfile
14 |
15 | 不记名令牌设置：
16 | --token=bearer_token
17 |
18 | 基础认证设置：
19 | --username=basic_user --password=basic_password
20 |
21 | 不记名令牌和基础认证不能同时使用。
22 |
23 | ```
24 | kubectl config set-credentials NAME [--client-certificate=path/to/certfile] [--client-key=path/to/keyfile] [--token=bearer_token] [--username=basic_user] [--password=basic_password]
25 | ```
26 |
27 | ### 示例
28 |
29 | ```
30 | # 仅设置cluster-admin用户项下的client-key字段，不影响其他值
31 | $ kubectl config set-credentials cluster-admin --client-key=~/.kube/admin.key
32 |
33 | # 为cluster-admin用户项设置基础认证选项
34 | $ kubectl config set-credentials cluster-admin --username=admin --password=uXFGweU9l35qcif
35 |
36 | # 为cluster-admin用户项开启证书验证并设置证书文件路径
37 | $ kubectl config set-credentials cluster-admin --client-certificate=~/.kube/admin.crt --embed-certs=true
38 | ```
39 |
40 | ### 选项
41 |
42 | ```
43 | --client-certificate="": 设置kuebconfig配置文件中用户选项中的证书文件路径。
44 | --client-key="": 设置kuebconfig配置文件中用户选项中的证书密钥路径。
45 | --embed-certs=false: 设置kuebconfig配置文件中用户选项中的embed-certs开关。
46 | --password="": 设置kuebconfig配置文件中用户选项中的密码。
47 | --token="": 设置kuebconfig配置文件中用户选项中的令牌。
48 | --username="": 设置kuebconfig配置文件中用户选项中的用户名。
49 | ```
50 |
51 | ### 继承自父命令的选项
52 | ```
53 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
54 | --api-version="": 和服务端交互使用的API版本。
55 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
56 | --client-certificate="": TLS使用的客户端证书路径。
57 | --client-key="": TLS使用的客户端密钥路径。
58 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
59 | --context="": 指定使用的kubeconfig配置文件中的环境名。
60 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
61 | --kubeconfig="": 命令行请求使用的配置文件路径。
62 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
63 | --log-dir="": 如果不为空，将日志文件写入此目录。
64 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
65 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
66 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
67 | --namespace="": 如果不为空，命令将使用此namespace。
68 | --password="": API Server进行简单认证使用的密码。
69 | -s, --server="": Kubernetes API Server的地址和端口号。
70 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
71 | --token="": 认证到API Server使用的令牌。
72 | --user="": 指定使用的kubeconfig配置文件中的用户名。
73 | --username="": API Server进行简单认证使用的用户名。
74 | --v=0: 指定输出日志的级别。
75 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
76 | ```
77 |
78 | ### 参见
79 |
80 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/142-kubectl_config_set.md:
--------------------------------------------------------------------------------
1 | ## kubectl config set
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 在kubeconfig配置文件中设置一个单独的值。
6 |
7 | ### 摘要
8 |
9 | 在kubeconfig配置文件中设置一个单独的值
10 |
11 | PROPERTY_NAME 使用“.”进行分隔，每段代表一个属性名或者map的键，map的键不能包含“.”。
12 | PROPERTY_VALUE 需要设置的新值。
13 |
14 | ```
15 | kubectl config set PROPERTY_NAME PROPERTY_VALUE
16 | ```
17 |
18 | ### 继承自父命令的选项
19 | ```
20 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
21 | --api-version="": 和服务端交互使用的API版本。
22 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
23 | --client-certificate="": TLS使用的客户端证书路径。
24 | --client-key="": TLS使用的客户端密钥路径。
25 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
26 | --context="": 指定使用的kubeconfig配置文件中的环境名。
27 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
28 | --kubeconfig="": 命令行请求使用的配置文件路径。
29 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
30 | --log-dir="": 如果不为空，将日志文件写入此目录。
31 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
32 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
33 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
34 | --namespace="": 如果不为空，命令将使用此namespace。
35 | --password="": API Server进行简单认证使用的密码。
36 | -s, --server="": Kubernetes API Server的地址和端口号。
37 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
38 | --token="": 认证到API Server使用的令牌。
39 | --user="": 指定使用的kubeconfig配置文件中的用户名。
40 | --username="": API Server进行简单认证使用的用户名。
41 | --v=0: 指定输出日志的级别。
42 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
43 | ```
44 |
45 | ### 参见
46 |
47 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
48 |
--------------------------------------------------------------------------------
/143-kubectl_config_unset.md:
--------------------------------------------------------------------------------
1 | ## kubectl config unset
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 在kubeconfig配置文件中清除一个单独的值。
6 |
7 | ### 摘要
8 |
9 | 在kubeconfig配置文件中清除一个单独的值。
10 | PROPERTY_NAME 使用“.”进行分隔，每段代表一个属性名或者map的键，map的键不能包含“.”。
11 |
12 | ```
13 | kubectl config unset PROPERTY_NAME
14 | ```
15 |
16 | ### 继承自父命令的选项
17 | ```
18 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
19 | --api-version="": 和服务端交互使用的API版本。
20 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
21 | --client-certificate="": TLS使用的客户端文件路径。
22 | --client-key="": TLS使用的客户端密钥路径。
23 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
24 | --context="": 指定使用的kubeconfig配置文件中的环境名。
25 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
26 | --kubeconfig="": 命令行请求使用的配置文件路径。
27 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
28 | --log-dir="": 如果不为空，将日志文件写入此目录。
29 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
30 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
31 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
32 | --namespace="": 如果不为空，命令将使用此namespace。
33 | --password="": API Server进行简单认证使用的密码。
34 | -s, --server="": Kubernetes API Server的地址和端口号。
35 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
36 | --token="": 认证到API Server使用的令牌。
37 | --user="": 指定使用的kubeconfig配置文件中的用户名。
38 | --username="": API Server进行简单认证使用的用户名。
39 | --v=0: 指定输出日志的级别。
40 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
41 | ```
42 |
43 | ### 参见
44 |
45 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/144-kubectl_config_use-context.md:
--------------------------------------------------------------------------------
1 | ## kubectl config use-context
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 使用kubeconfig中的一个环境项作为当前配置。
6 |
7 | ### 摘要
8 |
9 | 使用kubeconfig中的一个环境项作为当前配置。
10 |
11 | ```
12 | kubectl config use-context CONTEXT_NAME
13 | ```
14 |
15 | ### 继承自父命令的选项
16 | ```
17 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
18 | --api-version="": 和服务端交互使用的API版本。
19 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
20 | --client-certificate="": TLS使用的客户端证书路径。
21 | --client-key="": TLS使用的客户端密钥路径。
22 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
23 | --context="": 指定使用的kubeconfig配置文件中的环境名。
24 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
25 | --kubeconfig="": 命令行请求使用的配置文件路径。
26 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
27 | --log-dir="": 如果不为空，将日志文件写入此目录。
28 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
29 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
30 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
31 | --namespace="": 如果不为空，命令将使用此namespace。
32 | --password="": API Server进行简单认证使用的密码。
33 | -s, --server="": Kubernetes API Server的地址和端口号。
34 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
35 | --token="": 认证到API Server使用的令牌。
36 | --user="": 指定使用的kubeconfig配置文件中的用户名。
37 | --username="": API Server进行简单认证使用的用户名。
38 | --v=0: 指定输出日志的级别。
39 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
40 | ```
41 |
42 | ### 参见
43 |
44 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/145-kubectl_config.md:
--------------------------------------------------------------------------------
1 | ## kubectl config
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 修改kubeconfig配置文件。
6 |
7 | ### 摘要
8 |
9 | 使用config的子命令修改kubeconfig配置文件，如“kubectl config set current-context my-context”。
10 |
11 | 配置文件的读取遵循如下规则：
12 |
13 | The loading order follows these rules:
14 | 1. 如果指定了--kubeconfig选项，那么只有指定的文件被加载。此选项只能被设置一次，并且不会合并其他文件。If the --kubeconfig flag is set, then only that file is loaded. The flag may only be set once and no merging takes place.
15 | 2. 如果设置了$KUBECONFIG环境变量，将同时使用此环境变量指定的所有文件列表（使用操作系统默认的顺序），所有文件将被合并。当修改一个值时，将修改设置了该值的文件。当创建一个值时，将在列表的首个文件创建该值。若列表中所有的文件都不存在，将创建列表中的最后一个文件。
16 | 3. 如果前两项都没有设置,将使用 ${HOME}/.kube/config，并且不会合并其他文件。
17 |
18 |
19 | ```
20 | kubectl config SUBCOMMAND
21 | ```
22 |
23 | ### 选项
24 |
25 | ```
26 | --kubeconfig="": 使用特定的配置文件。
27 | ```
28 |
29 | ### 继承自父命令的选项
30 | ```
31 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
32 | --api-version="": 和服务端交互使用的API版本。
33 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
34 | --client-certificate="": TLS使用的客户端证书路径。
35 | --client-key="": TLS使用的客户端密钥路径。
36 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
37 | --context="": 指定使用的kubeconfig配置文件中的环境名。
38 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
39 | --kubeconfig="": 命令行请求使用的配置文件路径。
40 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
41 | --log-dir="": 如果不为空，将日志文件写入此目录。
42 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
43 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
44 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
45 | --namespace="": 如果不为空，命令将使用此namespace。
46 | --password="": API Server进行简单认证使用的密码。
47 | -s, --server="": Kubernetes API Server的地址和端口号。
48 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
49 | --token="": 认证到API Server使用的令牌。
50 | --user="": 指定使用的kubeconfig配置文件中的用户名。
51 | --username="": API Server进行简单认证使用的用户名。
52 | --v=0: 指定输出日志的级别。
53 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
54 | ```
55 |
56 | ### 参见
57 |
58 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
59 | * [kubectl config set](kubectl_config_set.md) - 在kubeconfig配置文件中设置一个单独的值。
60 | * [kubectl config set-cluster](kubectl_config_set-cluster.md) - 在kubeconfig配置文件中设置一个集群项。
61 | * [kubectl config set-context](kubectl_config_set-context.md) - 在kubeconfig配置文件中设置一个环境项。
62 | * [kubectl config set-credentials](kubectl_config_set-credentials.md) - 在kubeconfig配置文件中设置一个用户项。
63 | * [kubectl config unset](kubectl_config_unset.md) - 在kubeconfig配置文件中清除一个单独的值。
64 | * [kubectl config use-context](kubectl_config_use-context.md) - 使用kubeconfig中的一个环境项作为当前配置。
65 | * [kubectl config view](kubectl_config_view.md) - 显示合并后的kubeconfig设置，或者一个指定的kubeconfig配置文件。
--------------------------------------------------------------------------------
/146-kubectl_config_view.md:
--------------------------------------------------------------------------------
1 | ## kubectl config view
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 显示合并后的kubeconfig设置，或者一个指定的kubeconfig配置文件。
6 |
7 | ### 摘要
8 |
9 | 显示合并后的kubeconfig设置，或者一个指定的kubeconfig配置文件。
10 | 用户可使用--output=template --template=TEMPLATE来选择输出指定的值。
11 |
12 | ```
13 | kubectl config view
14 | ```
15 |
16 | ### 示例
17 |
18 | ```
19 | # 显示合并后的kubeconfig设置
20 | $ kubectl config view
21 |
22 | # 获取e2e用户的密码
23 | $ kubectl config view -o template --template='{{range .users}}{{ if eq .name "e2e" }}{{ index .user.password }}{{end}}{{end}}'
24 | ```
25 |
26 | ### 选项
27 |
28 | ```
29 | --flatten[=false]: 将读取的kubeconfig配置文件扁平输出为自包含的结构（对创建可迁移的kubeconfig配置文件有帮助）
30 | --merge=true: 按照继承关系合并所有的kubeconfig配置文件。
31 | --minify[=false]: 如果为true，不显示目前环境未使用到的任何信息。
32 | --no-headers[=false]: 当使用默认输出格式时不打印标题栏。
33 | -o, --output="": 输出格式，只能使用json|yaml|wide|name|go-template=...|go-template-file=...|jsonpath=...|jsonpath-file=...中的一种。参见golang模板[http://golang.org/pkg/text/template/#pkg-overview]和jsonpath模板[http://releases.k8s.io/release-1.1/docs/user-guide/jsonpath.md]。
34 | --output-version="": 输出资源使用的API版本（默认使用api-version）。
35 | --raw[=false]: 显示未经格式化的字节信息。
36 | -a, --show-all[=false]: 打印输出时，显示所有的资源（默认隐藏状态为terminated的pod）。
37 | --sort-by="": 如果不为空，对输出的多个结果根据指定字段进行排序。该字段使用jsonpath表达式（如“ObjectMeta.Name”）描述，并且该字段只能为字符串或者整数类型。
38 | --template="": 当指定了-o=go-template或-o=go-template-file时使用的模板字符串或者模板文件。模板的格式为golang模板[http://golang.org/pkg/text/template/#pkg-overview]。
39 | ```
40 |
41 | ### 继承自父命令的选项
42 | ```
43 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
44 | --api-version="": 和服务端交互使用的API版本。
45 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
46 | --client-certificate="": TLS使用的客户端证书路径。
47 | --client-key="": TLS使用的客户端密钥路径。
48 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
49 | --context="": 指定使用的kubeconfig配置文件中的环境名。
50 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
51 | --kubeconfig="": 命令行请求使用的配置文件路径。
52 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
53 | --log-dir="": 如果不为空，将日志文件写入此目录。
54 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
55 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
56 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
57 | --namespace="": 如果不为空，命令将使用此namespace。
58 | --password="": API Server进行简单认证使用的密码。
59 | -s, --server="": Kubernetes API Server的地址和端口号。
60 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
61 | --token="": 认证到API Server使用的令牌。
62 | --user="": 指定使用的kubeconfig配置文件中的用户名。
63 | --username="": API Server进行简单认证使用的用户名。
64 | --v=0: 指定输出日志的级别。
65 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
66 | ```
67 |
68 | ### 参见
69 |
70 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
71 |
--------------------------------------------------------------------------------
/147-kubectl_create.md:
--------------------------------------------------------------------------------
1 | ## kubectl create
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 通过文件名或控制台输入，创建资源。
6 |
7 | ### 摘要
8 |
9 | 通过文件名或控制台输入，创建资源。
10 |
11 | 接受JSON和YAML格式的描述文件。
12 |
13 | ```
14 | kubectl create -f FILENAME
15 | ```
16 |
17 | ### 示例
18 |
19 | ```
20 | # 使用pod.json文件创建一个pod
21 | $ kubectl create -f ./pod.json
22 |
23 | # 通过控制台输入的JSON创建一个pod
24 | $ cat pod.json | kubectl create -f -
25 | ```
26 |
27 | ### 选项
28 |
29 | ```
30 | -f, --filename=[]: 用以创建资源的文件名，目录名或者URL。
31 | -o, --output="": 输出格式，使用“-o name”来输出简短格式（资源类型/资源名）。
32 | --schema-cache-dir="/tmp/kubectl.schema": 如果不为空，将API schema缓存为指定文件，默认缓存到“/tmp/kubectl.schema”。
33 | --validate[=true]: 如果为true，在发送到服务端前先使用schema来验证输入。
34 | ```
35 |
36 | ### 继承自父命令的选项
37 | ```
38 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
39 | --api-version="": 和服务端交互使用的API版本。
40 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
41 | --client-certificate="": TLS使用的客户端证书路径。
42 | --client-key="": TLS使用的客户端密钥路径。
43 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
44 | --context="": 指定使用的kubeconfig配置文件中的环境名。
45 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
46 | --kubeconfig="": 命令行请求使用的配置文件路径。
47 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
48 | --log-dir="": 如果不为空，将日志文件写入此目录。
49 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
50 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
51 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
52 | --namespace="": 如果不为空，命令将使用此namespace。
53 | --password="": API Server进行简单认证使用的密码。
54 | -s, --server="": Kubernetes API Server的地址和端口号。
55 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
56 | --token="": 认证到API Server使用的令牌。
57 | --user="": 指定使用的kubeconfig配置文件中的用户名。
58 | --username="": API Server进行简单认证使用的用户名。
59 | --v=0: 指定输出日志的级别。
60 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
61 | ```
62 |
63 | ### 参见
64 |
65 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/148-kubectl_delete.md:
--------------------------------------------------------------------------------
1 | ## kubectl delete
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 通过文件名、控制台输入、资源名或者label selector删除资源。
6 |
7 | ### 摘要
8 |
9 | 通过文件名、控制台输入、资源名或者label selector删除资源。
10 | 接受JSON和YAML格式的描述文件。
11 |
12 | 只能指定以下参数类型中的一种：文件名、资源类型和名称、资源类型和label selector。
13 | 注意：delete命令不检查资源版本，如果有人在你进行删除操作的同时进行更新操作，他所做的更新将随资源同时被删除。
14 |
15 | ```
16 | kubectl delete ([-f FILENAME] | TYPE [(NAME | -l label | --all)])
17 | ```
18 |
19 | ### 示例
20 |
21 | ```
22 | # 通过pod.json文件中指定的资源类型和名称删除一个pod
23 | $ kubectl delete -f ./pod.json
24 |
25 | # 通过控制台输入的JSON所指定的资源类型和名称删除一个pod
26 | $ cat pod.json | kubectl delete -f -
27 |
28 | # 删除所有名为“baz”和“foo”的pod和service
29 | $ kubectl delete pod,service baz foo
30 |
31 | # 删除所有带有lable name=myLabel的pod和service
32 | $ kubectl delete pods,services -l name=myLabel
33 |
34 | # 删除UID为1234-56-7890-234234-456456的pod
35 | $ kubectl delete pod 1234-56-7890-234234-456456
36 |
37 | # 删除所有的pod
38 | $ kubectl delete pods --all
39 | ```
40 |
41 | ### 选项
42 |
43 | ```
44 | --all[=false]: 使用[-all]选择所有指定的资源。
45 | --cascade[=true]: 如果为true，级联删除指定资源所管理的其他资源（例如：被replication controller管理的所有pod）。默认为true。
46 | -f, --filename=[]: 用以指定待删除资源的文件名，目录名或者URL。
47 | --grace-period=-1: 安全删除资源前等待的秒数。如果为负值则忽略该选项。
48 | --ignore-not-found[=false]: 当待删除资源未找到时，也认为删除成功。如果设置了--all选项，则默认为true。
49 | -o, --output="": 输出格式，使用“-o name”来输出简短格式（资源类型/资源名）。
50 | -l, --selector="": 用于过滤资源的Label。
51 | --timeout=0: 删除资源的超时设置，0表示根据待删除资源的大小由系统决定。
52 | ```
53 |
54 | ### 继承自父命令的选项
55 | ```
56 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
57 | --api-version="": 和服务端交互使用的API版本。
58 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
59 | --client-certificate="": TLS使用的客户端证书路径。
60 | --client-key="": TLS使用的客户端密钥路径。
61 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
62 | --context="": 指定使用的kubeconfig配置文件中的环境名。
63 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
64 | --kubeconfig="": 命令行请求使用的配置文件路径。
65 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
66 | --log-dir="": 如果不为空，将日志文件写入此目录。
67 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
68 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
69 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
70 | --namespace="": 如果不为空，命令将使用此namespace。
71 | --password="": API Server进行简单认证使用的密码。
72 | -s, --server="": Kubernetes API Server的地址和端口号。
73 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
74 | --token="": 认证到API Server使用的令牌。
75 | --user="": 指定使用的kubeconfig配置文件中的用户名。
76 | --username="": API Server进行简单认证使用的用户名。
77 | --v=0: 指定输出日志的级别。
78 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
79 | ```
80 |
81 | ### 参见
82 |
83 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/149-kubectl_describe.md:
--------------------------------------------------------------------------------
1 | ## kubectl describe
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 输出指定的一个/多个资源的详细信息。
6 |
7 | ### 摘要
8 |
9 | 输出指定的一个/多个资源的详细信息。
10 |
11 | 此命令组合调用多条API，输出指定的一个或者一组资源的详细描述。
12 |
13 | $ kubectl describe TYPE NAME_PREFIX
14 |
15 | 首先检查是否有精确匹配TYPE和NAME_PREFIX的资源，如果没有，将会输出所有名称以NAME_PREFIX开头的资源详细信息。
16 |
17 | 支持的资源包括但不限于（大小写不限）：pods (po)、services (svc)、
18 | replicationcontrollers (rc)、nodes (no)、events (ev)、componentstatuses (cs)、
19 | limitranges (limits)、persistentvolumes (pv)、persistentvolumeclaims (pvc)、
20 | resourcequotas (quota)和secrets。
21 |
22 | ```
23 | kubectl describe (-f FILENAME | TYPE [NAME_PREFIX | -l label] | TYPE/NAME)
24 | ```
25 |
26 | ### 示例
27 |
28 | ```
29 | # 描述一个node
30 | $ kubectl describe nodes kubernetes-minion-emt8.c.myproject.internal
31 |
32 | # 描述一个pod
33 | $ kubectl describe pods/nginx
34 |
35 | # 描述pod.json中的资源类型和名称指定的pod
36 | $ kubectl describe -f pod.json
37 |
38 | # 描述所有的pod
39 | $ kubectl describe pods
40 |
41 | # 描述所有包含label name=myLabel的pod
42 | $ kubectl describe po -l name=myLabel
43 |
44 | # 描述所有被replication controller “frontend”管理的pod（rc创建的pod都以rc的名字作为前缀）
45 | $ kubectl describe pods frontend
46 | ```
47 |
48 | ### 选项
49 |
50 | ```
51 | -f, --filename=[]: 用来指定待描述资源的文件名，目录名或者URL。
52 | -l, --selector="": 用于过滤资源的Label。
53 | ```
54 |
55 | ### 继承自父命令的选项
56 | ```
57 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
58 | --api-version="": 和服务端交互使用的API版本。
59 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
60 | --client-certificate="": TLS使用的客户端证书路径。
61 | --client-key="": TLS使用的客户端密钥路径。
62 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
63 | --context="": 指定使用的kubeconfig配置文件中的环境名。
64 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
65 | --kubeconfig="": 命令行请求使用的配置文件路径。
66 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
67 | --log-dir="": 如果不为空，将日志文件写入此目录。
68 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
69 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
70 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
71 | --namespace="": 如果不为空，命令将使用此namespace。
72 | --password="": API Server进行简单认证使用的密码。
73 | -s, --server="": Kubernetes API Server的地址和端口号。
74 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
75 | --token="": 认证到API Server使用的令牌。
76 | --user="": 指定使用的kubeconfig配置文件中的用户名。
77 | --username="": API Server进行简单认证使用的用户名。
78 | --v=0: 指定输出日志的级别。
79 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
80 | ```
81 |
82 | ### 参见
83 |
84 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/150-kubectl_exec.md:
--------------------------------------------------------------------------------
1 | ## kubectl exec
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 在容器内部执行命令。
6 |
7 | ### 摘要
8 |
9 | 在容器内部执行命令。
10 |
11 | ```
12 | kubectl exec POD [-c CONTAINER] -- COMMAND [args...]
13 | ```
14 |
15 | ### 示例
16 |
17 | ```
18 | # 默认在pod 123456-7890的第一个容器中运行“date”并获取输出
19 | $ kubectl exec 123456-7890 date
20 |
21 | # 在pod 123456-7890的容器ruby-container中运行“date”并获取输出
22 | $ kubectl exec 123456-7890 -c ruby-container date
23 |
24 | # 切换到终端模式，将控制台输入发送到pod 123456-7890的ruby-container的“bash”命令，并将其输出到控制台/
25 | # 错误控制台的信息发送回客户端。
26 | $ kubectl exec 123456-7890 -c ruby-container -i -t -- bash -il
27 | ```
28 |
29 | ### 选项
30 |
31 | ```
32 | -c, --container="": 容器名。如果未指定，使用pod中的一个容器。
33 | -p, --pod="": Pod名。
34 | -i, --stdin[=false]: 将控制台输入发送到容器。
35 | -t, --tty[=false]: 将标准输入控制台作为容器的控制台输入。
36 | ```
37 |
38 | ### 继承自父命令的选项
39 | ```
40 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
41 | --api-version="": 和服务端交互使用的API版本。
42 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
43 | --client-certificate="": TLS使用的客户端证书路径。
44 | --client-key="": TLS使用的客户端密钥路径。
45 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
46 | --context="": 指定使用的kubeconfig配置文件中的环境名。
47 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
48 | --kubeconfig="": 命令行请求使用的配置文件路径。
49 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
50 | --log-dir="": 如果不为空，将日志文件写入此目录。
51 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
52 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
53 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
54 | --namespace="": 如果不为空，命令将使用此namespace。
55 | --password="": API Server进行简单认证使用的密码。
56 | -s, --server="": Kubernetes API Server的地址和端口号。
57 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
58 | --token="": 认证到API Server使用的令牌。
59 | --user="": 指定使用的kubeconfig配置文件中的用户名。
60 | --username="": API Server进行简单认证使用的用户名。
61 | --v=0: 指定输出日志的级别。
62 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
63 | ```
64 |
65 | ### 参见
66 |
67 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
68 |
--------------------------------------------------------------------------------
/154-kubectl_logs.md:
--------------------------------------------------------------------------------
1 | ## kubectl logs
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 输出pod中一个容器的日志。
6 |
7 | ### 摘要
8 |
9 | 输出pod中一个容器的日志。如果pod只包含一个容器则可以省略容器名。
10 |
11 | ```
12 | kubectl logs [-f] [-p] POD [-c CONTAINER]
13 | ```
14 |
15 | ### 示例
16 |
17 | ```
18 | # 返回仅包含一个容器的pod nginx的日志快照
19 | $ kubectl logs nginx
20 |
21 | # 返回pod ruby中已经停止的容器web-1的日志快照
22 | $ kubectl logs -p -c ruby web-1
23 |
24 | # 持续输出pod ruby中的容器web-1的日志
25 | $ kubectl logs -f -c ruby web-1
26 |
27 | # 仅输出pod nginx中最近的20条日志
28 | $ kubectl logs --tail=20 nginx
29 |
30 | # 输出pod nginx中最近一小时内产生的所有日志
31 | $ kubectl logs --since=1h nginx
32 | ```
33 |
34 | ### 选项
35 |
36 | ```
37 | -c, --container="": 容器名。
38 | -f, --follow[=false]: 指定是否持续输出日志。
39 | --interactive[=true]: 如果为true，当需要时提示用户进行输入。默认为true。
40 | --limit-bytes=0: 输出日志的最大字节数。默认无限制。
41 | -p, --previous[=false]: 如果为true，输出pod中曾经运行过，但目前已终止的容器的日志。
42 | --since=0: 仅返回相对时间范围，如5s、2m或3h，之内的日志。默认返回所有日志。只能同时使用since和since-time中的一种。
43 | --since-time="": 仅返回指定时间（RFC3339格式）之后的日志。默认返回所有日志。只能同时使用since和since-time中的一种。
44 | --tail=-1: 要显示的最新的日志条数。默认为-1，显示所有的日志。
45 | --timestamps[=false]: 在日志中包含时间戳。
46 | ```
47 |
48 | ### 继承自父命令的选项
49 | ```
50 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
51 | --api-version="": 和服务端交互使用的API版本。
52 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
53 | --client-certificate="": TLS使用的客户端证书路径。
54 | --client-key="": TLS使用的客户端密钥路径。
55 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
56 | --context="": 指定使用的kubeconfig配置文件中的环境名。
57 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
58 | --kubeconfig="": 命令行请求使用的配置文件路径。
59 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
60 | --log-dir="": 如果不为空，将日志文件写入此目录。
61 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
62 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
63 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
64 | --namespace="": 如果不为空，命令将使用此namespace。
65 | --password="": API Server进行简单认证使用的密码。
66 | -s, --server="": Kubernetes API Server的地址和端口号。
67 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
68 | --token="": 认证到API Server使用的令牌。
69 | --user="": 指定使用的kubeconfig配置文件中的用户名。
70 | --username="": API Server进行简单认证使用的用户名。
71 | --v=0: 指定输出日志的级别。
72 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
73 | ```
74 |
75 | ### 参见
76 |
77 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/164-kubectl_version.md:
--------------------------------------------------------------------------------
1 | ## kubectl version
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 输出服务端和客户端的版本信息。
6 |
7 | ### 摘要
8 |
9 | 输出服务端和客户端的版本信息。
10 |
11 | ```
12 | kubectl version
13 | ```
14 |
15 | ### 选项
16 |
17 | ```
18 | -c, --client[=false]: 仅输出客户端版本（无需连接服务器）。
19 | ```
20 |
21 | ### 继承自父命令的选项
22 | ```
23 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
24 | --api-version="": 和服务端交互使用的API版本。
25 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
26 | --client-certificate="": TLS使用的客户端证书路径。
27 | --client-key="": TLS使用的客户端密钥路径。
28 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
29 | --context="": 指定使用的kubeconfig配置文件中的环境名。
30 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
31 | --kubeconfig="": 命令行请求使用的配置文件路径。
32 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
33 | --log-dir="": 如果不为空，将日志文件写入此目录。
34 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
35 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
36 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
37 | --namespace="": 如果不为空，命令将使用此namespace。
38 | --password="": API Server进行简单认证使用的密码。
39 | -s, --server="": Kubernetes API Server的地址和端口号。
40 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
41 | --token="": 认证到API Server使用的令牌。
42 | --user="": 指定使用的kubeconfig配置文件中的用户名。
43 | --username="": API Server进行简单认证使用的用户名。
44 | --v=0: 指定输出日志的级别。
45 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
46 | ```
47 |
48 | ### 参见
49 |
50 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/165-Troubleshooting and Support.md:
--------------------------------------------------------------------------------
1 | # 故障排查
2 | `译者：林帆` `校对：无`
3 |
4 |
5 | 在使用Kubernetes时，用户常常会遇到一些错误和迷惑，这个小节的内容将针对常见的问题进行解答。我们将这些问题分为以下两个部分：
6 |
7 | - 应用程序相关的故障排查：当遇到将代码部署到Kubernetes时发生的各类错误时，请参考这部分内容。
8 | - 集群相关的故障排查：当集群系统的管理者发现Kubernetes的集群工作不正常时，请参考这部分内容。
9 |
10 | 用户也可以查看[已知问题列表](https://github.com/kubernetes/kubernetes/blob/master/docs/user-guide/known-issues.md)来了解当前所使用的版本中有哪些我们已经发现的系统问题。
11 |
12 | # 寻求帮助
13 |
14 | 如果以上的故障排查文档不能解决你所遇到的问题，还可以通过下面这几种方式寻求社区的帮助。
15 |
16 | ## 疑问
17 |
18 | 如果你对Kubernetes还不熟悉，文档的“用户指引”部分也许能帮助到你。
19 |
20 | 我们总结了一些用户经常遇到的问题，并分成下面几个方面记录下来了。
21 |
22 | - 日常使用的常见问题
23 | - 开发和调试的常见问题
24 | - 服务相关的常见问题
25 |
26 | 此外，在Stack Overflow网站上也有相关的主题通道可供提问和参考。
27 |
28 | - [Kubernetes相关的提问](http://stackoverflow.com/questions/tagged/kubernetes)
29 | - [谷歌容器引擎GKE相关的提问](http://stackoverflow.com/questions/tagged/google-container-engine)
30 |
31 | ## 更多的帮助内容
32 |
33 | 如果已经提到的这些途径还不足以解答你所遇到的问题，下面提供了其他的一些获取答案的途径。
34 |
35 | ### Stack Overflow
36 |
37 | 社区中的其他人也许遇到过和你相同的问题，Kubernetes的开发者小组会订阅并定期的解答Stack Overflow上[包含有kubernetes标签的提问](http://stackoverflow.com/questions/tagged/kubernetes)。如果所有的这些提问都没有包含你所遇到的问题，你可以通过[这个链接](http://stackoverflow.com/questions/ask?tags=kubernetes)把问题告诉我们。
38 |
39 | ### Slack
40 |
41 | Kubernetes开发小组的成员常常会出没在Slack的`#kubernetes-users`频道中，用户可以在这里直接将问题抛给第一线的开发者，并进行交流。Kubernetes的Slack开发者频道入口地址是[这里](https://kubernetes.slack.com/)，第一次进入频道前，用户需要先到[这里](http://slack.kubernetes.io/)进行注册。我们欢迎倾听到各种不同的声音和问题。
42 |
43 | ### 邮件组
44 |
45 | 谷歌容器引擎小组有个专用的邮件群组，地址是：[google-containers@googlegroups.com](https://groups.google.com/forum/#!forum/google-containers)
46 |
47 | ### Bug和需求
48 |
49 | 如果你发现的问题看起来像是一个潜在的Bug，或者你希望为Kubernetes的开发提出一些需求，请直接提交到Kubernetes在GitHub的[问题追踪页面](https://github.com/kubernetes/kubernetes/issues)里。
50 |
51 | 需要注意的是，在你到这个页面提出任何问题之前，请先在页面中搜索一下，确认没有其他人已经提过类似的问题。
52 |
53 | 当提出Bug时，请务必包含以下信息，以便我们能够尽快的重现并定位故障：
54 |
55 | - Kubernetes的版本：`kubectl version`命令会告知你所需的信息
56 | - 运行的环境（云服务商名称），操作系统发行版类型和版本，网络配置以及所用容器（例如Docker）的版本
57 | - 重现故障的步骤
--------------------------------------------------------------------------------
/166-Applications.md:
--------------------------------------------------------------------------------
1 | # 应用程序相关的故障排查
2 | `译者：林帆` `校对：无`
3 |
4 |
5 | 这个小节将帮助读者调试部署在Kubernetes的应用程序运行不正常的情况。本篇并不会包含如何调试集群组建过程中出现错误的问题，这些内容在文档的下一节中进行介绍。
6 |
7 | ## 内容提要
8 |
9 | - 应用程序故障排查
10 | - 常见问题
11 | - 故障诊断
12 | - 排查Pods的故障
13 | - Pod始终处于Pending状态
14 | - Pod始终处于Waiting状态
15 | - Pod一直崩溃或运行不正常
16 | - Pod在运行但没有如预期工作
17 | - 排查Replication Controllers的故障
18 | - 排查Services的故障
19 | - 服务没有端点信息
20 | - 网络流量没有正确的转发
21 | - 其他问题
22 |
23 | ## 常见问题
24 |
25 | 一些经常被提到的问题都更新在Kubernetes项目GitHub的[常见问题](https://github.com/kubernetes/kubernetes/wiki/User-FAQ)页面。
26 |
27 | ## 故障诊断
28 |
29 | 故障排查的第一步是对故障进行分类。一般来说，应用程序的故障可以分为下面几个方面：
30 |
31 | - Pods的故障
32 | - ReplicationControllers的故障
33 | - Services的故障
34 |
35 | ### 排查Pods的故障
36 |
37 | 检查Pod的问题首先应该了解Pod所处的状况。下面这个命令能够获得Pod当前的状态和近期的事件列表：
38 |
39 | ```
40 | $ kubectl describe pods ${POD_NAME}
41 | ```
42 |
43 | 确认清楚在Pod以及其中每一个容器的状态，是否都处于`Runing`？通过观察容器的已运行时间判断它是否刚刚才重新启动过？
44 |
45 | 根据不同的运行状态，用户应该采取不同的调查措施。
46 |
47 | #### Pod始终处于Pending状态
48 |
49 | 如果Pod保持在`Pending`的状态，这意味着它无法被正常的调度到一个节点上。通常来说，这是由于某种系统资源无法满足Pod运行的需求。观察刚才`kubectl describe`命令的输出内容，其中应该包括了能够判断错误原因的消息。常见的原因有以下这些：
50 |
51 | - **系统没有足够的资源**：你也许已经用尽了集群中所有的CPU或内存资源。对于这种情况，你需要清理一些不在需要的Pod，调整它们所需的资源量，或者向集群中增加新的节点。在[计算资源文档](https://github.com/kubernetes/kubernetes/blob/master/docs/user-guide/compute-resources.md#my-pods-are-pending-with-event-message-failedscheduling)有更详细的说明。
52 |
53 | - **用户指定了`hostPort`**：通过`hostPort`用户能够将服务暴露到指定的主机端口上，但这样会限制Pod能够被调度运行的节点。在大多数情况下，`hostPort`配置都是没有必要的，用户应该采用Service的方式暴露其对外的服务。如果用户确实必须使用`hostPort`的功能，那么此Pod最多只能部署到和集群节点相同的数目。
54 |
55 | #### Pod始终处于Waiting状态
56 |
57 | Pod处在`Waiting`的状态，说明它已经被调度分配到了一个工作节点，然而它无法在那个节点上运行。同样的，在刚才`kubectl describe`命令的输出内容中，应该包含有更详细的错误信息。最经常导致Pod始终`Waiting`的原因是无法下载所需的镜像（译者注：由于国内特殊的网络环境，这类问题出现得特别普遍）。用户可以从下面三个方面进行排查：
58 |
59 | - 请确保正确书写了镜像的名称
60 | - 请检查所需镜像是否已经推送到了仓库中
61 | - 手工的在节点上运行一次`docker pull <镜像名称>`检测镜像能否被正确的拉取下来
62 |
63 | #### Pod一直崩溃或运行不正常
64 |
65 | 首先，查看正在运行容器的日志。
66 |
67 | ```
68 | $ kubectl logs
69 | ```
70 |
71 | 如果容器之前已经崩溃过，通过以下命令可以获得容器前一次运行的日志内容。
72 |
73 | ```
74 | $ kubectl logs --previous
75 | ```
76 |
77 | 此外，还可以使用`exec`命令在指定的容器中运行任意的调试命令。
78 |
79 | ```
80 | $ kubectl exec -c -- <任意命令> <命令参数列表...>
81 | ```
82 |
83 | 值得指出的是，对于只有一个容器的Pod情况，`-c `这个参数是可以省略的。
84 |
85 | 例如查看一个运行中的Cassandra日志文件内容，可以参考下面这个命令：
86 |
87 | ```
88 | $ kubectl exec cassandra -- cat /var/log/cassandra/system.log
89 | ```
90 |
91 | 要是上面的这些办法都不奏效，你也可以找到正在运行该Pod的主机地址，然后使用SSH登陆进去检测。但这是在确实迫不得已的情况下才会采用的措施，通常使用Kubernetes暴露的API应该足够获得所需的环境信息。因此，如果当你发现自己不得不登陆到主机上去获取必要的信息数据时，不妨到Kubernetes的GitHub页面中给我们提一个功能需求（Feature Request），在需求中附上详细的使用场景以及为什么当前Kubernetes所提供的工具不能够满足需要。
92 |
93 | #### Pod在运行但没有如预期工作
94 |
95 | 如果Pod没有按照预期的功能运行，有可能是由于在Pod描述文件中（例如你本地机器的`mypod.yaml`文件）存在一些错误，这些配置中的错误在Pod时创建并没有引起致命的故障。这些错误通常包括Pod描述的某些元素嵌套层级不正确，或是属性的名称书写有误（这些错误属性在运行时会被忽略掉）。举例来说，如果你把`command`属性误写为了`commnd`，Pod仍然会启动，但用户所期待运行的命令则不会被执行。
96 |
97 | 对于这种情况，首先应该尝试删掉正在运行的Pod，然后使用`--validate`参数重新运行一次。继续之前的例子，当执行`kubectl create --validate -f mypod.yaml`命令时，被误写为`commnd`的`command`指令会导致下面这样的错误：
98 |
99 | ```
100 | I0805 10:43:25.129850 46757 schema.go:126] unknown field: commnd
101 | I0805 10:43:25.129973 46757 schema.go:129] this may be a false alarm, see https://github.com/kubernetes/kubernetes/issues/6842
102 | pods/mypod
103 | ```
104 |
105 | 下一件事是检查当前apiserver运行Pod所使用的Pod描述文件内容是否与你想要创建的Pod内容（用户本地主机的那个yaml文件）一致。比如，执行`kubectl get pods/mypod -o yaml > mypod-on-apiserver.yaml`命令将正在运行的Pod描述文件内容导出来保存为`mypod-on-apiserver.yaml`，并将它和用户自己的Pod描述文件`mypod.yaml`进行对比。由于apiserver会尝试自动补全一些缺失的Pod属性，在apiserver导出的Pod描述文件中有可能比本地的Pod描述文件多出若干行，这是正常的，但反之如果本地的Pod描述文件比apiserver导出的Pod描述文件多出了新的内容，则很可能暗示着当前运行的Pod使用了不正确的内容。
106 |
107 | ### 排查Replication Controllers的故障
108 |
109 | Replication Controllers的逻辑十分直白，它的作用只是创建新的Pod副本，仅仅可能出现的错误便是它无法创建正确的Pod，对于这种情况，应该参考上面的『排查Pods的故障』部分进行检查。
110 |
111 | 也可以使用`kubectl describe rc <控制器名称>`来显示与指定Replication Controllers相关的事件信息。
112 |
113 | ### 排查Services的故障
114 |
115 | Service为一系列后端Pod提供负载均衡的功能。有些十分常见的故障都可能导致Service无法正常工作，以下将提供对调试Service相关问题的参考。
116 |
117 | 首先，检查Service连接的服务提供端点（endpoint），对于任意一个Service对象，apiserver都会为其创建一个端点资源（译者注：即提供服务的IP地址和端口号）。
118 |
119 | 这个命令可以查看到Service的端口资源：
120 |
121 | ```
122 | $ kubectl get endpoints
123 | ```
124 |
125 | 请检查这个命令输出端点信息中的端口号与实际容器提供服务的端口号是否一致。例如，如果你的Service使用了三个Nginx容器的副本（replicas），这个命令应该输出三个不同的IP地址的端点信息。
126 |
127 | #### 服务没有端点信息
128 |
129 | 如果刚刚的命令显示Service没有端点信息，请尝试通过Service的选择器找到具有相应标签的所有Pod。假设你的Service描述选择器内容如下：
130 |
131 | ```
132 | ...
133 | spec:
134 | - selector:
135 | name: nginx
136 | type: frontend
137 | ```
138 |
139 | 可以使用以下命令找出相应的Pod：
140 |
141 | ```
142 | $ kubectl get pods --selector=name=nginx,type=frontend
143 | ```
144 |
145 | 找到了符合标签的Pod后，首先确认这些被选中的Pod是正确，有无错选、漏选的情况。
146 |
147 | 如果被选中的Pod没有问题，则问题很可能出在这些Pod暴露的端口没有被正确的配置好。要是一个Service指定了`containerPort`，但被选中的Pod并没有在配置中列出相应的端口，它们就不会出现在端点列表中。
148 |
149 | 请确保所用Pod的`containerPort`与Service的`containerPort`配置信息是一致的。
150 |
151 | #### 网络流量没有正确的转发
152 |
153 | 如果你能够连接到Service，但每次连接上就立即被断开，同时Service的端点列表内容是正确的，很可能是因为Kubernetes的kube-proxy服务无法连接到相应的Pod。
154 |
155 | 请检查以下几个方面：
156 |
157 | - Pod是否在正常工作？从每个Pod的自动重启动次数可以作为有用的参考信息，前面介绍过的Pod错误排查也介绍了更详细的方法
158 | - 能够直接连接到Pod提供的服务端口上吗？不妨获取到Pod的IP地址，然后尝试直接连接它，以验证Pod本身十分运行正确。
159 | - 容器中的应用程序是否监听在Pod和Service中配置的那个端口？Kubernetes不会自动的映射端口号，因此如果应用程序监听在8080端口，务必保证Service和Pod的`containerPort`都配置为了8080。
160 |
161 | #### 其他问题
162 |
163 | 如果上述的这些步骤还不足以解答你所遇到的问题，也就是说你已经确认了相应的Service正在运行，并且具有恰当的端点资源，相应的Pod能够提供正确的服务，集群的DNS域名服务没有问题，IPtable的防火墙配置没有问题，kube-proxy服务也都运转正常。
164 |
165 | 请参看本文档故障排除部分的其他小节，以获取更加全面的故障处理信息。
166 |
167 |
168 |
169 |
170 |
171 |
172 |
173 |
174 |
--------------------------------------------------------------------------------
/167-Clusters.md:
--------------------------------------------------------------------------------
1 | # 集群相关的故障排查
2 | `译者：林帆` `校对：无`
3 |
4 |
--------------------------------------------------------------------------------
/168-User_FAQ.md:
--------------------------------------------------------------------------------
1 | # 日常使用的常见问题
2 | `译者：林帆` `校对：无`
3 |
4 |
--------------------------------------------------------------------------------
/169-Debugging_FAQ.md:
--------------------------------------------------------------------------------
1 | # 开发和调试的常见问题
2 | `译者：林帆` `校对：无`
3 |
4 |
--------------------------------------------------------------------------------
/170-Services_FAQ.md:
--------------------------------------------------------------------------------
1 | # 服务相关的常见问题
2 | `译者：林帆` `校对：无`
3 |
4 |
--------------------------------------------------------------------------------
/198-kubectl_annotate.md:
--------------------------------------------------------------------------------
1 | ## kubectl annotate
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 更新某个资源的注解
6 |
7 | ### 摘要
8 |
9 | 更新一个活多个资源的注解。
10 | 注解是一个键值对，它可以包含比label更多的信息，并且可能是机读数据。
11 | 注解用来存储那些辅助的，非区分性的信息，特别是那些为外部工具或系统扩展插件使用的数据。
12 | 如果--overwrite设为true，将会覆盖现有的注解，否则试图修改一个注解的值将会抛出错误。
13 | 如果设置了--resource-version，那么将会使用指定的这个版本，否则将使用当前版本。
14 |
15 | 支持的资源包括但不限于（大小写不限）：pods (po)、services (svc)、
16 | replicationcontrollers (rc)、nodes (no)、events (ev)、componentstatuses (cs)、
17 | limitranges (limits)、persistentvolumes (pv)、persistentvolumeclaims (pvc)、
18 | resourcequotas (quota)和secrets。
19 |
20 | ```
21 | kubectl annotate [--overwrite] (-f FILENAME | TYPE NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--resource-version=version]
22 | ```
23 |
24 | ### 示例
25 |
26 | ```
27 | # 更新pod “foo”，设置其注解description的值为my frontend。
28 | # 如果同一个注解被赋值了多次，只保存最后一次设置的值。
29 | $ kubectl annotate pods foo description='my frontend'
30 |
31 | # 更新“pod.json”文件中type和name字段指定的pod的注解。
32 | $ kubectl annotate -f pod.json description='my frontend'
33 |
34 | # 更新pod “foo”，设置其注解description的值为my frontend running nginx，已有的值将被覆盖。
35 | $ kubectl annotate --overwrite pods foo description='my frontend running nginx'
36 |
37 | # 更新同一namespace下所有的pod。
38 | $ kubectl annotate pods --all description='my frontend running nginx'
39 |
40 | # 仅当pod “foo”当前版本为1时，更新其注解
41 | $ kubectl annotate pods foo description='my frontend running nginx' --resource-version=1
42 |
43 | # 更新pod “foo”，删除其注解description。
44 | # 不需要--override选项。
45 | $ kubectl annotate pods foo description-
46 | ```
47 |
48 | ### 选项
49 |
50 | ```
51 | --all[=false]: 选择namespace中所有指定类型的资源。
52 | -f, --filename=[]: 用来指定待升级资源的文件名，目录名或者URL。
53 | --overwrite[=false]: 如果设置为true，允许覆盖更新注解，否则拒绝更新已存在的注解。
54 | --resource-version="": 如果不为空，仅当资源当前版本和指定版本相同时才能更新注解。仅当更新单个资源时有效。
55 | ```
56 |
57 | ### 继承自父命令的选项
58 | ```
59 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
60 | --api-version="": 和服务端交互使用的API版本。
61 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
62 | --client-certificate="": TLS使用的客户端证书路径。
63 | --client-key="": TLS使用的客户端密钥路径。
64 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
65 | --context="": 指定使用的kubeconfig配置文件中的环境名。
66 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
67 | --kubeconfig="": 命令行请求使用的配置文件路径。
68 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
69 | --log-dir="": 如果不为空，将日志文件写入此目录。
70 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
71 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
72 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
73 | --namespace="": 如果不为空，命令将使用此namespace。
74 | --password="": API Server进行简单认证使用的密码。
75 | -s, --server="": Kubernetes API Server的地址和端口号。
76 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
77 | --token="": 认证到API Server使用的令牌。
78 | --user="": 指定使用的kubeconfig配置文件中的用户名。
79 | --username="": API Server进行简单认证使用的用户名。
80 | --v=0: 指定输出日志的级别。
81 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
82 | ```
83 |
84 | ### 参见
85 |
86 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/199-kubectl_apply.md:
--------------------------------------------------------------------------------
1 | ## kubectl apply
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 通过文件名或控制台输入，对资源进行配置。
6 |
7 | ### 摘要
8 |
9 |
10 | 通过文件名或控制台输入，对资源进行配置。
11 |
12 | 接受JSON和YAML格式的描述文件。
13 |
14 | ```
15 | kubectl apply -f FILENAME
16 | ```
17 |
18 | ### 示例
19 |
20 | ```
21 | # 将pod.json中的配置应用到pod
22 | $ kubectl apply -f ./pod.json
23 |
24 | # 将控制台输入的JSON配置应用到Pod
25 | $ cat pod.json | kubectl apply -f -
26 | ```
27 |
28 | ### 选项
29 |
30 | ```
31 | -f, --filename=[]: 包含配置信息的文件名，目录名或者URL。
32 | -o, --output="": 输出格式，使用“-o name”来输出简短格式（资源类型/资源名）。
33 | --schema-cache-dir="/tmp/kubectl.schema": 如果不为空，将API schema缓存为指定文件，默认缓存到“/tmp/kubectl.schema”。
34 | --validate[=true]: 如果为true，在发送到服务端前先使用schema来验证输入。
35 | ```
36 |
37 | ### 继承自父命令的选项
38 | ```
39 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
40 | --api-version="": 和服务端交互使用的API版本。
41 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
42 | --client-certificate="": TLS使用的客户端证书路径。
43 | --client-key="": TLS使用的客户端密钥路径。
44 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
45 | --context="": 指定使用的kubeconfig配置文件中的环境名。
46 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
47 | --kubeconfig="": 命令行请求使用的配置文件路径。
48 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
49 | --log-dir="": 如果不为空，将日志文件写入此目录。
50 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
51 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
52 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
53 | --namespace="": 如果不为空，命令将使用此namespace。
54 | --password="": API Server进行简单认证使用的密码。
55 | -s, --server="": Kubernetes API Server的地址和端口号。
56 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
57 | --token="": 认证到API Server使用的令牌。
58 | --user="": 指定使用的kubeconfig配置文件中的用户名。
59 | --username="": API Server进行简单认证使用的用户名。
60 | --v=0: 指定输出日志的级别。
61 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
62 | ```
63 |
64 | ### 参见
65 |
66 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/200-kubectl_attach.md:
--------------------------------------------------------------------------------
1 | ## kubectl attach
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 连接到一个正在运行的容器。
6 |
7 | ### 摘要
8 |
9 | 连接到现有容器中一个正在运行的进程。
10 |
11 | ```
12 | kubectl attach POD -c CONTAINER
13 | ```
14 |
15 | ### 示例
16 |
17 | ```
18 | # 获取正在运行中的pod 123456-7890的输出，默认连接到第一个容器
19 | $ kubectl attach 123456-7890
20 |
21 | # 获取pod 123456-7890中ruby-container的输出
22 | $ kubectl attach 123456-7890 -c ruby-container date
23 |
24 | # 切换到终端模式，将控制台输入发送到pod 123456-7890的ruby-container的“bash”命令，并将其输出到控制台/
25 | # 错误控制台的信息发送回客户端。
26 | $ kubectl attach 123456-7890 -c ruby-container -i -t
27 | ```
28 |
29 | ### 选项
30 |
31 | ```
32 | -c, --container="": 容器名。
33 | -i, --stdin[=false]: 将控制台输入发送到容器。
34 | -t, --tty[=false]: 将标准输入控制台作为容器的控制台输入。
35 | ```
36 |
37 | ### 继承自父命令的选项
38 | ```
39 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
40 | --api-version="": 和服务端交互使用的API版本。
41 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
42 | --client-certificate="": TLS使用的客户端证书路径。
43 | --client-key="": TLS使用的客户端密钥路径。
44 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
45 | --context="": 指定使用的kubeconfig配置文件中的环境名。
46 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
47 | --kubeconfig="": 命令行请求使用的配置文件路径。
48 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
49 | --log-dir="": 如果不为空，将日志文件写入此目录。
50 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
51 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
52 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
53 | --namespace="": 如果不为空，命令将使用此namespace。
54 | --password="": API Server进行简单认证使用的密码。
55 | -s, --server="": Kubernetes API Server的地址和端口号。
56 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
57 | --token="": 认证到API Server使用的令牌。
58 | --user="": 指定使用的kubeconfig配置文件中的用户名。
59 | --username="": API Server进行简单认证使用的用户名。
60 | --v=0: 指定输出日志的级别。
61 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
62 | ```
63 |
64 | ### 参见
65 |
66 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/201-kubectl_edit.md:
--------------------------------------------------------------------------------
1 | ## kubectl edit
2 | `译者：hurf` `校对：无`
3 |
4 |
5 | 编辑服务端的资源。
6 |
7 | ### 摘要
8 |
9 | 使用系统默认编辑器编辑服务端的资源。
10 |
11 | edit命令允许你直接编辑使用命令行工具获取的任何资源。此命令将打开你通过KUBE_EDITOR，GIT_EDITOR
12 | 或者EDITOR环境变量定义的编辑器，或者直接使用“vi”。你可以同时编辑多个资源，但所有的变更都只会一次性
13 | 提交。除了命令行参数外，此命令也接受文件名，但所直指定的文件必须使用早于当前的资源版本。
14 |
15 | 所编辑的文件将使用默认的API版本输出，或者通过--output-version选项显式指定。默认的输出格式是YAML，
16 | 如果你需要使用JSON格式编辑，使用-o json选项。
17 |
18 | 如果当更新资源的时候出现错误，将会在磁盘上创建一个临时文件，记录未成功的更新。更新资源时最常见的错误
19 | 是其他人也在更新服务端的资源。当这种情况发生时，你需要将你所作的更改应用到最新版本的资源上，或者编辑
20 | 保存的临时文件，使用最新的资源版本。
21 |
22 | ```
23 | kubectl edit (RESOURCE/NAME | -f FILENAME)
24 | ```
25 |
26 | ### 示例
27 |
28 | ```
29 | # 编辑名为“docker-registry”的service
30 | $ kubectl edit svc/docker-registry
31 |
32 | # 使用一个不同的编辑器
33 | $ KUBE_EDITOR="nano" kubectl edit svc/docker-registry
34 |
35 | # 编辑名为“docker-registry”的service，使用JSON格式、v1 API版本
36 | $ kubectl edit svc/docker-registry --output-version=v1 -o json
37 | ```
38 |
39 | ### 选项
40 |
41 | ```
42 | -f, --filename=[]: 用来指定待编辑资源的文件名，目录名或者URL。
43 | -o, --output="yaml": 输出格式，可选yaml或者json中的一种。
44 | --output-version="": 输出资源使用的API版本（默认使用api-version）。
45 | ```
46 |
47 | ### 继承自父命令的选项
48 | ```
49 | --alsologtostderr[=false]: 同时输出日志到标准错误控制台和文件。
50 | --api-version="": 和服务端交互使用的API版本。
51 | --certificate-authority="": 用以进行认证授权的.cert文件路径。
52 | --client-certificate="": TLS使用的客户端证书路径。
53 | --client-key="": TLS使用的客户端密钥路径。
54 | --cluster="": 指定使用的kubeconfig配置文件中的集群名。
55 | --context="": 指定使用的kubeconfig配置文件中的环境名。
56 | --insecure-skip-tls-verify[=false]: 如果为true，将不会检查服务器凭证的有效性，这会导致你的HTTPS链接变得不安全。
57 | --kubeconfig="": 命令行请求使用的配置文件路径。
58 | --log-backtrace-at=:0: 当日志长度超过定义的行数时，忽略堆栈信息。
59 | --log-dir="": 如果不为空，将日志文件写入此目录。
60 | --log-flush-frequency=5s: 刷新日志的最大时间间隔。
61 | --logtostderr[=true]: 输出日志到标准错误控制台，不输出到文件。
62 | --match-server-version[=false]: 要求服务端和客户端版本匹配。
63 | --namespace="": 如果不为空，命令将使用此namespace。
64 | --password="": API Server进行简单认证使用的密码。
65 | -s, --server="": Kubernetes API Server的地址和端口号。
66 | --stderrthreshold=2: 高于此级别的日志将被输出到错误控制台。
67 | --token="": 认证到API Server使用的令牌。
68 | --user="": 指定使用的kubeconfig配置文件中的用户名。
69 | --username="": API Server进行简单认证使用的用户名。
70 | --v=0: 指定输出日志的级别。
71 | --vmodule=: 指定输出日志的模块，格式如下：pattern=N，使用逗号分隔。
72 | ```
73 |
74 | ### 参见
75 |
76 | * [kubectl](kubectl.md) - 使用kubectl来管理Kubernetes集群。
--------------------------------------------------------------------------------
/Fingerpost.txt:
--------------------------------------------------------------------------------
1 | # DockOne 文章排版指南
2 |
3 | ## 1.文章排版
4 |
5 | ### 1.1 正确排版如下：
6 |
7 | #### Docker 公司首席布道师谈容器和下一代虚拟化
8 |
9 | 【编者的话】本文为LinuxCon 讲师采访的一部分，Docker 公司的Jerome 分享了Docker 与其它容器技术的区别、Docker 容器的存储和数据迁移、Docker 在企业中的应用等话题。（编者的话主要概括总结文章大意，方便读者阅读）。
10 |
11 | Jerome 是Docker 公司的首席布道师，也是老员工。对社区运营和容器非常了解。本文根据对他的采访整理而成。
12 |
13 | 在这次的访谈中，Jerome 深入分析了Docker 并解释了如何管理Docker 容器的存储，以及如何随着Docker 容器迁移数据。
14 |
15 | __原文链接：Docker containers and the next generation of virtualization （翻译：译者姓名）__
16 |
17 | ----
18 |
19 | **译者介绍**
20 |
21 | 译者姓名，北京理工大学计算机学院在读博士，研究方向是自然语言处理在企业网络信誉评价方面的应用，平时也乐于去实现一些突发的想法。
22 |
23 | ## 2.标点符号
24 |
25 | ### 2.1 不重复使用标点符号
26 |
27 | #### 正确：
28 |
29 | - 德国队竟然战胜了巴西队！
30 | - 她竟然对你说“喵”？！
31 |
32 | #### 错误：
33 |
34 | - 德国队竟然战胜了巴西队！！
35 | - 德国队竟然战胜了巴西队！！！！
36 | - 德国队竟然战胜了巴西队！！！！！！！！
37 | - 她竟然对你说“喵”？？！！
38 | - 她竟然对你说“喵”？！？！？？！！
39 |
40 | ### 2.2 使用全形中文标点
41 |
42 | #### 正确：
43 |
44 | - 嗨！你知道嘛？今天前台的小妹跟我说“喵”了哎！
45 | - 核磁共振成像（NMRI）是什么原理都不知道？JFGI！
46 |
47 | #### 错误：
48 |
49 | - 嗨! 你知道嘛? 今天前台的小妹跟我说"喵" 了哎!
50 | - 嗨!你知道嘛?今天前台的小妹跟我说"喵"了哎!
51 | - 核磁共振成像(NMRI) 是什么原理都不知道? JFGI!
52 | - 核磁共振成像(NMRI)是什么原理都不知道?JFGI!
53 |
54 | #### 注意：
55 |
56 | 对于拿不准的词组或者觉得读者可能会有疑问的翻译，请在中文后面的括号里加上英文原词组。第一次使用括号之后，后文无需再使用括号。注意：括号请使用中文的标点符号。
57 |
58 | ### 2.3 数字使用半角字符
59 |
60 | #### 正确：
61 |
62 | - 这件蛋糕只卖1000 元。
63 |
64 | #### 错误：
65 |
66 | - 这件蛋糕只卖１０００元。
67 |
68 | ### 2.4 英文前后不加空格
69 |
70 | #### 正确：
71 |
72 | - 我是DockOne社区的译者，我喜欢Docker和Kubernetes。
73 |
74 | #### 错误：
75 |
76 | - 我是DockOne 社区的译者，我喜欢Docker 和 Kubernetes。
77 |
78 | #### 2.5 遇到完整的英文整句、特殊名词，其内容使用半角标点
79 |
80 | #### 正确：
81 |
82 | - 乔帮主那句话是怎么说的？“Stay hungry, stay foolish.”。
83 | - 推荐你阅读『Hackers & Painters: Big Ideas from the Computer Age』，非常的有趣。
84 |
85 | #### 错误：
86 |
87 | - 乔帮主那句话是怎么说的？“Stay hungry，stay foolish。”。
88 | - 推荐你阅读『Hackers＆Painters：Big Ideas from the Computer Age』，非常的有趣。
89 |
90 | ## 3.大小写
91 |
92 | ### 3.1 专有名词使用正确的大小写
93 |
94 | #### 正确：
95 |
96 | - 使用GitHub 登录
97 | - 我们的客户有GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。
98 |
99 | #### 错误：
100 |
101 | - 使用github 登录
102 | - 使用GITHUB 登录
103 | - 使用Github 登录
104 | - 使用gitHub 登录
105 | - 我们的客户有github、foursquare、microsoft corporation、google、facebook, inc.。
106 | - 我们的客户有GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。
107 | - 我们的客户有Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。
108 |
109 | #### 注意：
110 |
111 | 默认状态下，技术名称、产品名称的首字母大写，如Java，Web 等。如该技术术语有自己的默认大小写状态，如HTML5、.NET、IntelliJ IDEA 等，请确保译文中的大小写与其一致。
112 |
--------------------------------------------------------------------------------
/Hazelcast:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/Hazelcast
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | Kubernetes中文文档
2 | =======
3 |
4 | Kubernetes文档的中文译本。
5 |
6 | 由DockOne社区组织翻译。
7 |
8 | # 版本 1.1
9 |
10 | ---
11 | - 原始文档链接：http://kubernetes.io/v1.1/index.html
12 | - 最新文档GitHub目录：https://github.com/kubernetes/kubernetes/tree/master/docs
13 |
14 | 
15 |
--------------------------------------------------------------------------------
/book.json:
--------------------------------------------------------------------------------
1 | {
2 | "title": "Kubernetes中文文档",
3 | "description": "Kubernetes文档的中文译本，由DockOne社区组织翻译。",
4 | "language": "zh",
5 | "plugins": ["splitter"]
6 | }
7 |
--------------------------------------------------------------------------------
/images/27gf-counter.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/images/27gf-counter.png
--------------------------------------------------------------------------------
/images/Cover.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/images/Cover.png
--------------------------------------------------------------------------------
/images/all-lines.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/images/all-lines.png
--------------------------------------------------------------------------------
/images/bigquery-logging.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/images/bigquery-logging.png
--------------------------------------------------------------------------------
/images/cloud-logging-console.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/images/cloud-logging-console.png
--------------------------------------------------------------------------------
/images/cloud-logging.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/images/cloud-logging.png
--------------------------------------------------------------------------------
/images/diagram.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/images/diagram.png
--------------------------------------------------------------------------------
/images/k8s-singlenode-docker.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/images/k8s-singlenode-docker.png
--------------------------------------------------------------------------------
/k8s-ui-explore-filter.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/k8s-ui-explore-filter.png
--------------------------------------------------------------------------------
/k8s-ui-explore-groupby.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/k8s-ui-explore-groupby.png
--------------------------------------------------------------------------------
/k8s-ui-explore-poddetail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/k8s-ui-explore-poddetail.png
--------------------------------------------------------------------------------
/k8s-ui-explore.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/k8s-ui-explore.png
--------------------------------------------------------------------------------
/k8s-ui-nodes.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/k8s-ui-nodes.png
--------------------------------------------------------------------------------
/k8s-ui-overview.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/linfan/kubernetes-chinese-docs/d1685abd5ce830e918a6cde337d825e73d6c0c4c/k8s-ui-overview.png
--------------------------------------------------------------------------------