whentimeslows/website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[zh] fix links in setup section (4)

Browse Source
This commit is contained in:
Qiming Teng
2020-09-07 21:19:52 +08:00
parent 4b6fc1610a
commit 8e3437245f
6 changed files with 129 additions and 146 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/zh/docs/setup/production-environment/tools/kops.md
+72 -86
View File
@@ -4,11 +4,9 @@ content_type: concept
weight: 20
---
<!--
---
title: Installing Kubernetes with kops
content_type: concept
weight: 20
---
-->
<!-- overview -->
@@ -44,40 +42,35 @@ kops 是一个自用的供应系统：
If your opinions differ from these you may prefer to build your own cluster using [kubeadm](/docs/admin/kubeadm/) as
a building block. kops builds on the kubeadm work.
-->
如果您有不同的观点，您可能更喜欢使用 [kubeadm](/docs/admin/kubeadm/) 作为构建工具来构建自己的集群。kops 建立在 kubeadm 工作的基础上。
如果你有不同的观点，你可能更喜欢使用 [kubeadm](/zh/docs/reference/setup-tools/kubeadm/)
作为构建工具来构建自己的集群。kops 建立在 kubeadm 工作的基础上。
<!-- body -->
<!--
## Creating a cluster
### (1/5) Install kops
#### Requirements
You must have [kubectl](/docs/tasks/tools/install-kubectl/) installed in order for kops to work.
-->
## 创建集群
<!--
### (1/5) Install kops
-->
### (1/5) 安装 kops
<!--
#### Requirements
-->
#### 前提条件
<!--
You must have [kubectl](/docs/tasks/tools/install-kubectl/) installed in order for kops to work.
-->
您必须安装 [kubectl](/docs/tasks/tools/install-kubectl/) 才能使 kops 工作。
你必须安装 [kubectl](/zh/docs/tasks/tools/install-kubectl/) 才能使 kops 工作。
<!--
#### Installation
Download kops from the [releases page](https://github.com/kubernetes/kops/releases) (it is also easy to build from source):
-->
#### 安装
<!--
Download kops from the [releases page](https://github.com/kubernetes/kops/releases) (it is also easy to build from source):
-->
从[下载页面](https://github.com/kubernetes/kops/releases)下载 kops（从源代码构建也很容易）：
<!--
@@ -90,7 +83,7 @@ On macOS:
curl -OL https://github.com/kubernetes/kops/releases/download/1.10.0/kops-darwin-amd64
chmod +x kops-darwin-amd64
mv kops-darwin-amd64 /usr/local/bin/kops
# 您也可以使用 Homebrew 安装 kops
# 你也可以使用 Homebrew 安装 kops
brew update && brew install kops
```
@@ -107,28 +100,27 @@ mv kops-linux-amd64 /usr/local/bin/kops
<!--
### (2/5) Create a route53 domain for your cluster
-->
### (2/5) 为您的集群创建一个 route53 域名
<!--
kops uses DNS for discovery, both inside the cluster and so that you can reach the kubernetes API server
from clients.
-->
kops 在集群内部都使用 DNS 进行发现操作，因此您可以从客户端访问 kubernetes API 服务器。
### (2/5) 为你的集群创建一个 route53 域名
kops 在集群内部都使用 DNS 进行发现操作，因此你可以从客户端访问 kubernetes API 服务器。
<!--
kops has a strong opinion on the cluster name: it should be a valid DNS name. By doing so you will
no longer get your clusters confused, you can share clusters with your colleagues unambiguously,
and you can reach them without relying on remembering an IP address.
-->
kops 对集群名称有明显的要求：它应该是有效的 DNS 名称。这样一来，您就不会再使集群混乱，
kops 对集群名称有明显的要求：它应该是有效的 DNS 名称。这样一来，你就不会再使集群混乱，
可以与同事明确共享集群，并且无需依赖记住 IP 地址即可访问群集。
<!--
You can, and probably should, use subdomains to divide your clusters. As our example we will use
`useast1.dev.example.com`. The API server endpoint will then be `api.useast1.dev.example.com`.
-->
您应该使用子域名来划分集群。作为示例，我们将使用域名 `useast1.dev.example.com`。
你应该使用子域名来划分集群。作为示例，我们将使用域名 `useast1.dev.example.com`。
然后，API 服务器端点域名将为 `api.useast1.dev.example.com`。
<!--
@@ -137,53 +129,56 @@ but also `dev.example.com` or even `example.com`. kops works with any of these,
you choose for organization reasons (e.g. you are allowed to create records under `dev.example.com`,
but not under `example.com`).
-->
Route53 托管区域可以服务子域名。您的托管区域可能是 `useast1.dev.example.com`，还有 `dev.example.com` 甚至 `example.com`。
kops 可以与以上任何一种配合使用，因此通常您出于组织原因选择不同的托管区域。
例如，允许您在 `dev.example.com` 下创建记录，但不能在 `example.com` 下创建记录。
Route53 托管区域可以服务子域名。你的托管区域可能是 `useast1.dev.example.com`，还有 `dev.example.com` 甚至 `example.com`。
kops 可以与以上任何一种配合使用，因此通常你出于组织原因选择不同的托管区域。
例如，允许你在 `dev.example.com` 下创建记录，但不能在 `example.com` 下创建记录。
<!--
Let's assume you're using `dev.example.com` as your hosted zone. You create that hosted zone using
the [normal process](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/CreatingNewSubdomain.html), or
with a command such as `aws route53 create-hosted-zone --name dev.example.com --caller-reference 1`.
-->
假设您使用 `dev.example.com` 作为托管区域。您可以使用[正常流程](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/CreatingNewSubdomain.html) 或者使用诸如 `aws route53 create-hosted-zone --name dev.example.com --caller-reference 1` 之类的命令来创建该托管区域。
假设你使用 `dev.example.com` 作为托管区域。你可以使用
[正常流程](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/CreatingNewSubdomain.html)
或者使用诸如 `aws route53 create-hosted-zone --name dev.example.com --caller-reference 1`
之类的命令来创建该托管区域。
<!--
You must then set up your NS records in the parent domain, so that records in the domain will resolve. Here,
you would create NS records in `example.com` for `dev`. If it is a root domain name you would configure the NS
records at your domain registrar (e.g. `example.com` would need to be configured where you bought `example.com`).
-->
然后，您必须在父域名中设置您的 DNS 记录，以便该域名中的记录可以被解析。在这里，您将在 `example.com` 中为 `dev` 创建 DNS 记录。
如果它是根域名，则可以在域名注册机构配置 DNS 记录。例如，您需要在购买 `example.com` 的地方配置 `example.com`。
然后，你必须在父域名中设置你的 DNS 记录，以便该域名中的记录可以被解析。
在这里，你将在 `example.com` 中为 `dev` 创建 DNS 记录。
如果它是根域名，则可以在域名注册机构配置 DNS 记录。
例如，你需要在购买 `example.com` 的地方配置 `example.com`。
<!--
This step is easy to mess up (it is the #1 cause of problems!) You can double-check that
your cluster is configured correctly if you have the dig tool by running:
-->
这一步很容易搞砸（这是问题的第一大原因！）
如果您安装了 dig 工具，则可以通过运行以下步骤再次检查集群是否配置正确：
如果你安装了 dig 工具，则可以通过运行以下步骤再次检查集群是否配置正确：
<!--
`dig NS dev.example.com`
-->
`dig DNS dev.example.com`
```shell
dig DNS dev.example.com
```
<!--
You should see the 4 NS records that Route53 assigned your hosted zone.
-->
您应该看到 Route53 分配了您的托管区域的 4 条 DNS 记录。
你应该看到 Route53 分配了你的托管区域的 4 条 DNS 记录。
<!--
### (3/5) Create an S3 bucket to store your clusters state
-->
### (3/5) 创建一个 S3 存储桶来存储集群状态
<!--
kops lets you manage your clusters even after installation. To do this, it must keep track of the clusters
that you have created, along with their configuration, the keys they are using etc. This information is stored
in an S3 bucket. S3 permissions are used to control access to the bucket.
-->
kops 使您即使在安装后也可以管理集群。为此，它必须跟踪已创建的集群及其配置、所使用的密钥等。
### (3/5) 创建一个 S3 存储桶来存储集群状态
kops 使你即使在安装后也可以管理集群。为此，它必须跟踪已创建的集群及其配置、所使用的密钥等。
此信息存储在 S3 存储桶中。S3 权限用于控制对存储桶的访问。
<!--
@@ -192,8 +187,8 @@ administer the same clusters - this is much easier than passing around kubecfg f
to the S3 bucket will have administrative access to all your clusters, so you don't want to share it beyond
the operations team.
-->
多个集群可以使用同一 S3 存储桶，并且您可以在管理同一集群的同事之间共享一个 S3 存储桶 - 这比传递 kubecfg 文件容易得多。
但是有权访问 S3 存储桶的任何人都将拥有对所有集群的管理访问权限，因此您不想在运营团队之外共享它。
多个集群可以使用同一 S3 存储桶，并且你可以在管理同一集群的同事之间共享一个 S3 存储桶 - 这比传递 kubecfg 文件容易得多。
但是有权访问 S3 存储桶的任何人都将拥有对所有集群的管理访问权限，因此你不想在运营团队之外共享它。
<!--
So typically you have one S3 bucket for each ops team (and often the name will correspond
@@ -209,31 +204,23 @@ the S3 bucket name.
<!--
* Export `AWS_PROFILE` (if you need to select a profile for the AWS CLI to work)
-->
* 导出 `AWS_PROFILE` 文件（如果您需要选择一个配置文件用来使 AWS CLI 正常工作）
<!--
* Create the S3 bucket using `aws s3 mb s3://clusters.dev.example.com`
-->
* 使用 `aws s3 mb s3://clusters.dev.example.com` 创建 S3 存储桶
<!--
* You can `export KOPS_STATE_STORE=s3://clusters.dev.example.com` and then kops will use this location by default.
We suggest putting this in your bash profile or similar.
-->
* 您可以进行 `export KOPS_STATE_STORE=s3://clusters.dev.example.com` 操作，然后 kops 将默认使用此位置。
我们建议将其放入您的 bash profile 文件或类似文件中。
* 导出 `AWS_PROFILE` 文件（如果你需要选择一个配置文件用来使 AWS CLI 正常工作）
* 使用 `aws s3 mb s3://clusters.dev.example.com` 创建 S3 存储桶
* 你可以进行 `export KOPS_STATE_STORE=s3://clusters.dev.example.com` 操作，然后 kops 将默认使用此位置。
我们建议将其放入你的 bash profile 文件或类似文件中。
<!--
### (4/5) Build your cluster configuration
-->
### (4/5) 建立您的集群配置
<!--
Run "kops create cluster" to create your cluster configuration:
-->
运行 "kops create cluster" 以创建您的集群配置：
### (4/5) 建立你的集群配置
运行 "kops create cluster" 以创建你的集群配置：
`kops create cluster --zones=us-east-1c useast1.dev.example.com`
@@ -242,8 +229,8 @@ kops will create the configuration for your cluster. Note that it _only_ create
not actually create the cloud resources - you'll do that in the next step with a `kops update cluster`. This
give you an opportunity to review the configuration or change it.
-->
kops 将为您的集群创建配置。请注意，它_仅_创建配置，实际上并没有创建云资源 - 您将在下一步中使用 `kops update cluster` 进行配置。
这使您有机会查看配置或进行更改。
kops 将为你的集群创建配置。请注意，它_仅_创建配置，实际上并没有创建云资源 - 你将在下一步中使用 `kops update cluster` 进行配置。
这使你有机会查看配置或进行更改。
<!--
It prints commands you can use to explore further:
@@ -258,8 +245,8 @@ It prints commands you can use to explore further:
-->
* 使用以下命令列出集群：`kops get cluster`
* 使用以下命令编辑该集群：`kops edit cluster useast1.dev.example.com`
* 使用以下命令编辑您的节点实例组：`kops edit ig --name = useast1.dev.example.com nodes`
* 使用以下命令编辑您的主实例组：`kops edit ig --name = useast1.dev.example.com master-us-east-1c`
* 使用以下命令编辑你的节点实例组：`kops edit ig --name = useast1.dev.example.com nodes`
* 使用以下命令编辑你的主实例组：`kops edit ig --name = useast1.dev.example.com master-us-east-1c`
<!--
If this is your first time using kops, do spend a few minutes to try those out! An instance group is a
@@ -267,60 +254,62 @@ set of instances, which will be registered as kubernetes nodes. On AWS this is
You can have several instance groups, for example if you wanted nodes that are a mix of spot and on-demand instances, or
GPU and non-GPU instances.
-->
如果这是您第一次使用 kops，请花几分钟尝试一下！ 实例组是一组实例，将被注册为 kubernetes 节点。
在 AWS 上，这是通过 auto-scaling-groups 实现的。您可以有多个实例组，例如，如果您想要的是混合实例和按需实例的节点，或者
GPU 和非 GPU 实例。
如果这是你第一次使用 kops，请花几分钟尝试一下！ 实例组是一组实例，将被注册为 kubernetes 节点。
在 AWS 上，这是通过 auto-scaling-groups 实现的。你可以有多个实例组。
例如，如果你想要的是混合实例和按需实例的节点，或者 GPU 和非 GPU 实例。
<!--
### (5/5) Create the cluster in AWS
Run "kops update cluster" to create your cluster in AWS:
-->
### (5/5) 在 AWS 中创建集群
<!--
Run "kops update cluster" to create your cluster in AWS:
-->
运行 "kops update cluster" 以在 AWS 中创建集群：
`kops update cluster useast1.dev.example.com --yes`
```shell
kops update cluster useast1.dev.example.com --yes
```
<!--
That takes a few seconds to run, but then your cluster will likely take a few minutes to actually be ready.
`kops update cluster` will be the tool you'll use whenever you change the configuration of your cluster; it
applies the changes you have made to the configuration to your cluster - reconfiguring AWS or kubernetes as needed.
-->
这需要几秒钟的时间才能运行，但实际上集群可能需要几分钟才能准备就绪。每当更改集群配置时，都会使用 `kops update cluster` 工具。
它将对配置进行的更改应用于您的集群 - 根据需要重新配置 AWS 或者 kubernetes。
这需要几秒钟的时间才能运行，但实际上集群可能需要几分钟才能准备就绪。
每当更改集群配置时，都会使用 `kops update cluster` 工具。
它将对配置进行的更改应用于你的集群 - 根据需要重新配置 AWS 或者 kubernetes。
<!--
For example, after you `kops edit ig nodes`, then `kops update cluster --yes` to apply your configuration, and
sometimes you will also have to `kops rolling-update cluster` to roll out the configuration immediately.
-->
例如，在您运行 `kops edit ig nodes` 之后，然后运行 `kops update cluster --yes` 应用您的配置，有时您还必须运行 `kops rolling-update cluster` 立即回滚更新配置。
例如，在你运行 `kops edit ig nodes` 之后，然后运行 `kops update cluster --yes`
应用你的配置，有时你还必须运行 `kops rolling-update cluster` 立即回滚更新配置。
<!--
Without `--yes`, `kops update cluster` will show you a preview of what it is going to do. This is handy
for production clusters!
-->
如果没有 `--yes` 参数，`kops update cluster` 操作将向您显示其操作的预览效果。这对于生产集群很方便！
如果没有 `--yes` 参数，`kops update cluster` 操作将向你显示其操作的预览效果。这对于生产集群很方便！
<!--
### Explore other add-ons
See the [list of add-ons](/docs/concepts/cluster-administration/addons/) to explore other add-ons, including tools for logging, monitoring, network policy, visualization &amp; control of your Kubernetes cluster.
-->
### 探索其他附加组件
<!--
See the [list of add-ons](/docs/concepts/cluster-administration/addons/) to explore other add-ons, including tools for logging, monitoring, network policy, visualization &amp; control of your Kubernetes cluster.
-->
请参阅[附加组件列表](/docs/concepts/cluster-administration/addons/)探索其他附加组件，包括用于 Kubernetes 集群的日志记录、监视、网络策略、可视化和控制的工具。
请参阅[附加组件列表](/zh/docs/concepts/cluster-administration/addons/)探索其他附加组件，
包括用于 Kubernetes 集群的日志记录、监视、网络策略、可视化和控制的工具。
<!--
## Cleanup
* To delete your cluster: `kops delete cluster useast1.dev.example.com --yes`
-->
## 清理
<!--
* To delete your cluster: `kops delete cluster useast1.dev.example.com --yes`
-->
* 删除集群：`kops delete cluster useast1.dev.example.com --yes`
<!--
@@ -332,21 +321,18 @@ See the [list of add-ons](/docs/concepts/cluster-administration/addons/) to expl
* Slack Channel: [#kops-users](https://kubernetes.slack.com/messages/kops-users/)
* [GitHub Issues](https://github.com/kubernetes/kops/issues)
-->
* Slack Channel: [#kops-users](https://kubernetes.slack.com/messages/kops-users/)
* Slack 频道: [#kops-users](https://kubernetes.slack.com/messages/kops-users/)
* [GitHub Issues](https://github.com/kubernetes/kops/issues)
## {{% heading "whatsnext" %}}
<!--
* Learn more about Kubernetes [concepts](/docs/concepts/) and [`kubectl`](/docs/user-guide/kubectl-overview/).
* Learn about `kops` [advanced usage](https://github.com/kubernetes/kops)
* See the `kops` [docs](https://github.com/kubernetes/kops) section for tutorials, best practices and advanced configuration options.
-->
* 了解有关 Kubernetes 的 [concepts](/docs/concepts/) 和 [`kubectl`](/docs/user-guide/kubectl-overview/) 的更多信息。
* 了解有关 Kubernetes 的[概念](/zh/docs/concepts/) 和
[`kubectl`](/zh/docs/reference/kubectl/overview/) 的更多信息。
* 了解 `kops` [高级用法](https://github.com/kubernetes/kops)。
* 请参阅 `kops` [文档](https://github.com/kubernetes/kops) 获取教程、最佳做法和高级配置选项。
content/zh/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md
+1 -1
View File
@@ -471,7 +471,7 @@ The automatic detection of cgroup driver for other container runtimes
like CRI-O and containerd is work in progress.
-->
## 在控制平面节点上配置 kubelet 使用的 cgroup 驱动程序
## 在控制平面节点上配置 kubelet 使用的 cgroup 驱动程序 {#configure-cgroup-driver-used-by-kubelet-on-master-node}
使用 docker 时，kubeadm 会自动为其检测 cgroup 驱动并在运行时对 `/var/lib/kubelet/kubeadm-flags.env` 文件进行配置。