Skip to content

Commit

Permalink
Update localization guidelines (kubernetes#10485)
Browse files Browse the repository at this point in the history
* Update localization guidelines for language labels

Continuing work

Continuing work

Continuing work

More work in progress

Add local OWNERS folders

Add an OWNERS file to Chinese

Remove shortcode for repos

Add Japanese

Alphabetize languages, change weights accordingly

More updates

Add Korean in Korean

Add English to languageName

Feedback from gochist

Move Chinese content from cn/ to zh/

Move OWNERS from cn/ to zh/

Resolve merge conflicts by updating from master

Add files back in to prep for resolution

After rebase on upstream/master, remove files

Review and update localization guidelines

Feedback from gochist, tnir, cstoku

Add a trailing newline to content/ja/OWNERS

Add a trailing newline to content/zh/OWNERS

Drop requirement for GH repo project

Clarify language about forks/branches

Edits and typos

Remove a shortcode specific to a multi-repo language setup

Update aliases and owners

Add explicit OWNERS for content/en

Migrate content from Chinese repo, update regex in config.toml

Remove untranslated strings

Add trailing newline to content/en/OWNERS

Add trailing newlines to OWNERS files

add Jaguar project description (kubernetes#10433)

* add Jaguar project description

[Jaguar](https://gitlab.com/sdnlab/jaguar) is an open source solution for Kubernetes's network based on OpenDaylight.
Jaguar provides overlay network using vxlan and Jaguar CNIPlugin provides one IP address per pod.

* Minor newline tweak

blog post for azure vmss (kubernetes#10538)

Add microk8s to pick-right-solution.md (kubernetes#10542)

* Add microk8s to pick-right-solution.md

Microk8s is a single-command installation of upstream Kubernetes on any Linux and should be included in the list of local-machine solutions.

* capitalized Istio

Add microk8s to foundational.md (kubernetes#10543)

* Add microk8s to foundational.md

Adding microk8s as credible and stable alternative to get started with Kubernetes on a local machine. This is especially attractive for those not wanting to incur the overhead of running a VM for a local cluster.

* Update foundational.md

Thank you for your suggestions! LMK if this works now?

* Rewrote first paragraph

And included a bullet list of features of microk8s

* Copyedit

fix typo (kubernetes#10545)

Fix the kubectl subcommands links. (kubernetes#10550)

Signed-off-by: William Zhang <warmchang@outlook.com>

Fix command issue (kubernetes#10515)

Signed-off-by: mooncake <xcoder@tenxcloud.com>

remove imported community files per issue 10184 (kubernetes#10501)

networking.md: Markdown fix (kubernetes#10498)

Fix front matter, federation command-line tools (kubernetes#10500)

Clean up glossary entry (kubernetes#10399)

update slack link (kubernetes#10536)

typo in StatefulSet docs (kubernetes#10558)

fix discription about horizontal pod autoscale (kubernetes#10557)

Remove redundant symbols (kubernetes#10556)

Fix issue kubernetes#10520 (kubernetes#10554)

Signed-off-by: William Zhang <warmchang@outlook.com>

Update api-concepts.md (kubernetes#10534)

Revert "Fix command issue (kubernetes#10515)"

This reverts commit c02a7fb.

Update memory-constraint-namespace.md (kubernetes#10530)

update memory request to 100MiB corresponding the yaml content

Blog: Introducing Volume Snapshot Alpha for Kubernetes (kubernetes#10562)

* blog post for azure vmss

* snapshot blog post

Resolve merge conflicts in OWNERS*

Minor typo fix (kubernetes#10567)

Not sure what's supposed to be here, proposing removing it.

* Feedback from gochist

Tweaks to feedback

* Feedback from ClaudiaJKang
  • Loading branch information
zacharysarah authored and Dragons committed Oct 8, 2019
1 parent dc70357 commit c786621
Show file tree
Hide file tree
Showing 64 changed files with 1,543 additions and 0 deletions.
3 changes: 3 additions & 0 deletions content/zh/OWNERS
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
<<<<<<< HEAD
# See the OWNERS docs at https://go.k8s.io/owners

=======
>>>>>>> Update localization guidelines (#10485)
# This is the localization project for Chinese.
# Teams and members are visible at https://github.com/orgs/kubernetes/teams.

Expand Down
150 changes: 150 additions & 0 deletions content/zh/_index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
cid: "home"
---

<<<<<<< HEAD
{{< deprecationwarning >}}

{{< blocks/section id="oceanNodes" >}}
Expand Down Expand Up @@ -66,3 +67,152 @@ <h2>将超过 150 个微服务迁移到 Kubernetes 时遇到的挑战</h2>
{{< blocks/kubernetes-features >}}

{{< blocks/case-studies >}}
=======
<section id="oceanNodes">
<main>
<div class="image-wrapper"><img src="/images/flower.png"></div>
<div class="content">

<h3><a href="/docs/concepts/overview/what-is-kubernetes/">Kubernetes</a> 是用于自动部署,扩展和管理容器化应用程序的开源系统。</h3>
<p>它将组成应用程序的容器组合成逻辑单元,以便于管理和服务发现,Kubernetes 构建在 <a href="http://queue.acm.org/detail.cfm?id=2898444"> Google 15 年生产环境经验</a>基础之上,并结合来自社区的最佳创意和实践。</p>
</div>
</main>
<main>
<div class="image-wrapper"><img src="/images/scalable.png"></div>
<div class="content">

<h4>星际尺度</h4>
<p>根据同样的原则设计,允许 Google 每周运行数十亿个容器,Kubernetes 可以在不增加您的 ops 团队的情况下进行弹性扩展。</p>
</div>
</main>
<main>
<div class="image-wrapper"><img src="/images/blocks.png"></div>
<div class="content">

<h4>永不过时</h4>
<p>无论您应用运行在本地还是运行于全球任何地域,Kubernetes 的灵活性都可以随着您的需求复杂度不断增加,还可以持续、轻松地对外提供服务。</p>
</div>
</main>
<main>
<div class="image-wrapper"><img src="/images/suitcase.png"></div>
<div class="content">

<h4>随处运行</h4>
<p>Kubernetes 是开源的,可以让您自由地部署在企业内部,私有云、混合云或公有云基础架构,使您轻松将应用迁移至任何位置。</p>
</div>
</main>
</section>
<section id="video">
<div class="light-text">

<h2>Kubernetes: 最后&hellip; 它是真正的云平台</h2>
<p>Box 的联合创始人和服务架构师 Sam Ghods 发表了热情洋溢的演讲,随着使用 Kubernetes,我们首次有一个通用接口,可以建立真正的部署工具。</p>
<button id="desktopShowVideoButton" onclick="kub.showVideo()">观看视频</button>
</div>
<button id="mobileShowVideoButton" onclick="kub.showVideo()"></button>
</section>
<section id="features">
<main>

<h3 class="center">Kubernetes 特性</h3>
<div class="feature-box">
<div>

<h4><a href="/docs/concepts/configuration/manage-compute-resources-container/">自动包装</a></h4>
<p>根据资源需求和其他约束自动放置容器,同时不会牺牲可用性,混合关键和最大努力的工作负载,以提高资源利用率并节省更多资源。</p>
</div>
<div>

<h4><a href="/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller">自我修复</a></h4>
<p>重新启动失败的容器,在节点不可用时,替换和重新编排节点上的容器,终止不对用户定义的健康检查做出响应的容器,并且不会在客户端准备投放之前将其通告给客户端。</p>
</div>
</div>
<div class="feature-box">
<div>

<h4><a href="/docs/tasks/run-application/horizontal-pod-autoscale/">横向缩放</a></h4>
<p>使用简单的命令或 UI,或者根据 CPU 的使用情况自动调整应用程序副本数。</p>
</div>
<div>

<h4><a href="/docs/concepts/services-networking/service/">服务发现和负载均衡</a></h4>
<p>不需要修改您的应用程序来使用不熟悉的服务发现机制,Kubernetes 为容器提供了自己的 IP 地址和一组容器的单个 DNS 名称,并可以在它们之间进行负载均衡。</p>
</div>
</div>
<div class="feature-box">
<div>

<h4><a href="/docs/concepts/workloads/controllers/deployment/#what-is-a-deployment">自动部署和回滚</a></h4>
<p>Kubernetes 逐渐部署对应用程序或其配置的更改,同时监视应用程序运行状况,以确保它不会同时终止所有实例。 如果出现问题,Kubernetes会为您恢复更改,利用日益增长的部署解决方案的生态系统。</p>
</div>
<div>
<h4><a href="/docs/concepts/configuration/secret/">密钥</a><a href="/docs/tasks/configure-pod-container/configure-pod-configmap/">配置</a> 管理</h4>
<p>部署和更新密钥和应用程序配置,不会重新编译您的镜像,不会在堆栈配置中暴露密钥(secrets)。</p>
</div>
</div>
<div class="feature-box">
<div>
<h4><a href="/docs/concepts/storage/persistent-volumes/">存储编排</a></h4>
<p>自动安装您所选择的存储系统,无论是本地存储,如公有云提供商 <a href="https://cloud.google.com/storage/">GCP</a><a href="https://aws.amazon.com/products/storage/">AWS</a>, 还是网络存储系统 NFS, iSCSI,
Gluster, Ceph, Cinder, 或 Flocker。</p>
</div>
<div>
<h4><a href="/docs/concepts/workloads/controllers/jobs-run-to-completion/">批处理</a></h4>
<p>除了服务之外,Kubernetes还可以管理您的批处理和 CI 工作负载,如果需要,替换出现故障的容器。</p>
</div>
</div>
</main>
</section>
<section id="talkToUs">
<main>

<h3>实例探究</h3>
<div id="caseStudiesWrapper">
<div>
<p>使用Kubernetes来重塑世界上最大的教育公司</p>
<a href="/case-studies/pearson/">阅读更多</a>
</div>
<div>
<p>Kubernetes at Box: 微服务的最大优势</p>
<a href="https://blog.box.com/blog/kubernetes-box-microservices-maximum-velocity/">阅读更多</a>
</div>
<div>
<p>在 eBay 内部转移到 OpenStack 上的 Kubernetes 和容器</p>
<a href="https://www.nextplatform.com/2015/11/12/inside-ebays-shift-to-kubernetes-and-containers-atop-openstack/">阅读更多</a>
</div>
<div>
<p>将本地的集群迁移至 Kubernetes</p>
<a href="https://www.youtube.com/watch?v=6XGUTu3WhBw">观看视频</a>
</div>
</div>























<h5 style="text-align: center"><a href="/case-studies/" style="color: #3371E3; font-weight: 400">探究所有的案例</a></h5>
</main>
</section>
<div id="videoPlayer">
<iframe data-url="https://www.youtube.com/embed/of45hYbkIZs?autoplay=1" frameborder="0" allowfullscreen></iframe>
<button id="closeButton"></button>
</div>
>>>>>>> Update localization guidelines (#10485)
5 changes: 5 additions & 0 deletions content/zh/docs/_index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
---
<<<<<<< HEAD
title: 文档
=======
title: Home
weight: 5
>>>>>>> Update localization guidelines (#10485)
---
8 changes: 8 additions & 0 deletions content/zh/docs/concepts/architecture/cloud-controller.md
Original file line number Diff line number Diff line change
Expand Up @@ -237,12 +237,20 @@ rules:

以下云服务供应商为自己的云部署了CCM。

<<<<<<< HEAD
* [Digital Ocean](https://github.com/digitalocean/digitalocean-cloud-controller-manager)
* [Oracle](https://github.com/oracle/oci-cloud-controller-manager)
* [Azure](https://github.com/kubernetes/cloud-provider-azure)
* [GCP](https://github.com/kubernetes/cloud-provider-gcp)
* [AWS](https://github.com/kubernetes/cloud-provider-aws)
* [BaiduCloud](https://github.com/baidu/cloud-provider-baiducloud)
=======
* [Digital Ocean]()
* [Oracle]()
* [Azure]()
* [GCE]()
* [AWS]()
>>>>>>> Update localization guidelines (#10485)
## 群集管理

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,11 @@ Master 组件通过非安全(没有加密或认证)端口和集群的 apiser
### apiserver -> kubelet


<<<<<<< HEAD
从 apiserver 到 kubelet 的连接用于获取 pods 日志、连接(通过 kubectl)运行中的 pods,以及使用 kubelet 的端口转发功能。这些连接终止于 kubelet 的 HTTPS endpoint。
=======
从 apiserver 到 kubelet 的连接用于获取 pods 日志、连接(通过 kubectl)运行中的 pods,以及使用 kubele 的端口转发功能。这些连接终止于 kubelet 的 HTTPS endpoint。
>>>>>>> Update localization guidelines (#10485)

默认的,apiserver 不会验证 kubelet 的服务证书,这会导致连接遭到中间人攻击,因而在不可信或公共网络上是不安全的。
Expand Down
4 changes: 4 additions & 0 deletions content/zh/docs/concepts/architecture/nodes.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,11 @@ redirect_from:
### 阶段


<<<<<<< HEAD
已废弃:node 阶段已经不再使用。
=======
一废弃:node 阶段已经不再使用。
>>>>>>> Update localization guidelines (#10485)

### 条件
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,15 +17,23 @@ content_template: templates/concept
## 规划集群


<<<<<<< HEAD
查阅 [安装](/docs/setup/) 中的指导,获取如何规划、建立以及配置 Kubernetes 集群的示例。本文所列的文章称为*发行版*
=======
查阅 [选择正确解决方案](/docs/setup/pick-right-solution/) 中的指导,获取如何规划、建立以及配置 Kubernetes 集群的示例。本文所列的文章称为*发行版*
>>>>>>> Update localization guidelines (#10485)

在选择一个指南前,有一些因素需要考虑:

- 你是打算在你的电脑上尝试 Kubernetes,还是要构建一个高可用的多节点集群?请选择最适合你需求的发行版。
- **如果你正在设计一个高可用集群**,请了解[在多个 zones 中配置集群](/docs/admin/multi-cluster)
- 你的集群是在**本地**还是**云(IaaS)**上?Kubernetes 不能直接支持混合集群。作为代替,你可以建立多个集群。
<<<<<<< HEAD
- **如果你在本地配置 Kubernetes**,需要考虑哪种[网络模型](/docs/admin/networking)最适合。
=======
- **如果你在本地配置 Kubernetes**,需要考虑哪种[网络模型](/docs/admin/networking)最适合。一种自定义网络的选项是 [*OpenVSwitch GRE/VxLAN 网络*](/docs/admin/ovs-networking/),它使用 OpenVSwitch 在跨 Kubernetes 节点的 pods 之间建立起网络。
>>>>>>> Update localization guidelines (#10485)
- 你的 Kubernetes 在 **裸金属硬件** 还是 **虚拟机(VMs)**上运行?
-**只想运行一个集群**,还是打算**活动开发 Kubernetes 项目代码**?如果是后者,请选择一个活动开发的发行版。某些发行版只提供二进制发布版,但提供更多的选择。
- 让你自己熟悉运行一个集群所需的[组件](/docs/admin/cluster-components)
Expand Down
12 changes: 12 additions & 0 deletions content/zh/docs/concepts/cluster-administration/sysctl-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,10 +34,14 @@ $ sudo sysctl -a
- `kernel.msg*`(内核中SystemV消息队列相关参数),
- `kernel.sem`(内核中信号量参数),
- `fs.mqueue.*`(内核中POSIX消息队列相关参数),
<<<<<<< HEAD
- `net.*`(内核中网络配置项相关参数),如果它可以在容器命名空间里被更改。然而,也有一些特例
(例如,`net.netfilter.nf_conntrack_max`
`net.netfilter.nf_conntrack_expect_max`
可以在容器命名空间里被更改,但它们是非命名空间的)。
=======
- `net.*`(内核中网络配置项相关参数)。
>>>>>>> Update localization guidelines (#10485)
Sysctls中非命名空间级的被称为 _节点级_ ,其必须由集群管理员手动设置,要么通过节点的底层Linux分布方式(例如,通过 `/etc/sysctls.conf`),亦或在特权容器中使用Daemonset。

Expand Down Expand Up @@ -74,7 +78,11 @@ Sysctls被分为 _安全的_ 和 _不安全的_ sysctls。同一节点上的pods
sysctls。 _不安全的_ sysctls 会打上kubelet标识,在逐节点的基础上被启用,例如:

```shell
<<<<<<< HEAD
$ kubelet --experimental-allowed-unsafe-sysctls 'kernel.msg*,net.core.somaxconn' ...
=======
$ kubelet --experimental-allowed-unsafe-sysctls 'kernel.msg*,net.ipv4.route.min_pmtu' ...
>>>>>>> Update localization guidelines (#10485)
```
只有 _命名空间级_ sysctls 可以使用该方法启用。
Expand All @@ -92,7 +100,11 @@ metadata:
name: sysctl-example
annotations:
security.alpha.kubernetes.io/sysctls: kernel.shm_rmid_forced=1
<<<<<<< HEAD
security.alpha.kubernetes.io/unsafe-sysctls: net.core.somaxconn=1024,kernel.msgmax=1 2 3
=======
security.alpha.kubernetes.io/unsafe-sysctls: net.ipv4.route.min_pmtu=1000,kernel.msgmax=1 2 3
>>>>>>> Update localization guidelines (#10485)
spec:
...
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,15 @@ content_template: templates/concept

## 资源类型

<<<<<<< HEAD
*CPU**内存* 都是 *资源类型* 。资源类型具有基本单位。CPU 的单位是 core,内存的单位是 byte。

CPU和内存统称为*计算资源* ,也可以称为*资源* 。计算资源的数量是可以被请求、分配、消耗和可测量的。它们与 [API 资源](/docs/api/) 不同。 API 资源(如 Pod 和 [Service](/docs/user-guide/services))是可通过 Kubernetes API server 读取和修改的对象。
=======
*CPU**内存* 都是 *资源类型*。资源类型具有基本单位。CPU 的单位是 core,内存的单位是 byte。

CPU和内存统称为*计算资源*,也可以称为*资源*。计算资源的数量是可以被请求、分配、消耗和可测量的。它们与 [API 资源](/docs/api/) 不同。 API 资源(如 Pod 和 [Service](/docs/user-guide/services))是可通过 Kubernetes API server 读取和修改的对象。
>>>>>>> Update localization guidelines (#10485)
## Pod 和 容器的资源请求和限制

Expand Down Expand Up @@ -226,7 +232,11 @@ Kubernetes 1.5 版本中引入不透明整型资源。不透明的整数资源
**注意:** 不透明整型资源在 kubernetes 1.5 中还是 Alpha 版本。只实现了资源计量,节点级别的隔离还处于积极的开发阶段。
<<<<<<< HEAD
不透明整型资源是以 `pod.alpha.kubernetes.io/opaque-int-resource-` 为前缀的资源。API server 将限制这些资源的数量为整数。*有效* 数量的例子有 `3``3000m``3Ki`*无效* 数量的例子有 `0.5``1500m`
=======
不透明整型资源是以 `pod.alpha.kubernetes.io/opaque-int-resource-` 为前缀的资源。API server 将限制这些资源的数量为整数。*有效* 数量的例子有 `3``3000m``3Ki`*无效*数量的例子有 `0.5``1500m`
>>>>>>> Update localization guidelines (#10485)
申请使用不透明整型资源需要两步。首先,集群运维人员必须在一个或多个节点上通告每个节点不透明的资源。然后,用户必须在 Pod 中请求不透明资源。
Expand Down
12 changes: 12 additions & 0 deletions content/zh/docs/concepts/configuration/secret.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,11 @@ username.txt: 5 bytes

请注意,默认情况下,`get``describe` 命令都不会显示文件的内容。这是为了防止将 secret 中的内容被意外暴露给从终端日志记录中刻意寻找它们的人。

<<<<<<< HEAD
请参阅 [解码 secret](#解码-secret) 了解如何查看它们的内容。
=======
请参阅 [解码 secret](#decoding-a-secret) 了解如何查看它们的内容。
>>>>>>> Update localization guidelines (#10485)
#### 手动创建 Secret

Expand Down Expand Up @@ -122,6 +126,10 @@ metadata:
name: mysecret
namespace: default
resourceVersion: "164619"
<<<<<<< HEAD
=======
selfLink: /api/v1/namespaces/default/secrets/mysecret
>>>>>>> Update localization guidelines (#10485)
uid: cfee02d6-c137-11e5-8d73-42010af00002
type: Opaque
```
Expand Down Expand Up @@ -582,4 +590,8 @@ Pod 中有多个容器。但是,pod 中的每个容器必须请求其挂载卷
- 应用程序在从卷中读取 secret 后仍然需要保护 secret 的值,例如不会意外记录或发送给不信任方。
- 可以创建和使用 secret 的 pod 的用户也可以看到该 secret 的值。即使 API server 策略不允许用户读取 secret 对象,用户也可以运行暴露 secret 的 pod。
- 如果运行了多个副本,那么这些 secret 将在它们之间共享。默认情况下,etcd 不能保证与 SSL/TLS 的对等通信,尽管可以进行配置。
<<<<<<< HEAD
- 目前,任何节点的 root 用户都可以通过模拟 kubelet 来读取 API server 中的任何 secret。只有向实际需要它们的节点发送 secret 才能限制单个节点的根漏洞的影响,该功能还在计划中。
=======
- 目前,任何节点的 root 用户都可以通过模拟 kubelet 来读取 API server 中的任何 secret。只有向实际需要它们的节点发送 secret 才能限制单个节点的根漏洞的影响,该功能还在计划中。
>>>>>>> Update localization guidelines (#10485)
Original file line number Diff line number Diff line change
Expand Up @@ -357,7 +357,11 @@ based on the Ready NodeCondition is disabled.

{{< note >}}
<!--
<<<<<<< HEAD
To maintain the existing [rate limiting](/docs/concepts/architecture/nodes/)
=======
**Note:** To maintain the existing [rate limiting](/docs/concepts/architecture/nodes/)
>>>>>>> Update localization guidelines (#10485)
behavior of pod evictions due to node problems, the system actually adds the taints
in a rate-limited way. This prevents massive pod evictions in scenarios such
as the master becoming partitioned from the nodes.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,11 @@ Pod 名称和名字空间可以通过
容器创建时运行的所有服务的列表都会作为环境变量提供给容器。
这些环境变量与 Docker 链接语法相匹配。

<<<<<<< HEAD
对一个名为 *foo* ,映射到名为 *bar* 的容器端口的服务,
=======
对一个名为 *foo*,映射到名为 *bar* 的容器端口的服务,
>>>>>>> Update localization guidelines (#10485)
会定义如下变量:

```shell
Expand Down
4 changes: 4 additions & 0 deletions content/zh/docs/concepts/containers/images.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,11 @@ Kubelet会获取并且定期刷新ECR的凭证。它需要以下权限

### 使用 Azure Container Registry (ACR)
当使用[Azure Container Registry](https://azure.microsoft.com/en-us/services/container-registry/)时,可以使用admin user或者service principal认证。
<<<<<<< HEAD
任何一种情况,认证都通过标准的Docker authentication完成。本指南假设使用[azure-cli](https://github.com/azure/azure-cli)
=======
任何一种情况,认证都通过标准的Dokcer authentication完成。本指南假设使用[azure-cli](https://github.com/azure/azure-cli)
>>>>>>> Update localization guidelines (#10485)
命令行工具。

首先,需要创建仓库并获取凭证,完整的文档请参考
Expand Down
3 changes: 3 additions & 0 deletions content/zh/docs/concepts/overview/components.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,10 @@ redirect_from:
- "/docs/admin/cluster-components/"
- "/docs/admin/cluster-components.html"
content_template: templates/concept
<<<<<<< HEAD
weight: 20
=======
>>>>>>> Update localization guidelines (#10485)
---
{{% capture overview %}}
本文档概述了 Kubernetes 所需的各种二进制组件, 用于提供齐全的功能。
Expand Down

0 comments on commit c786621

Please sign in to comment.