From 0a861fc4fe112ce0fd54b9ebbd55c0b287af6dfd Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Sat, 1 Aug 2020 02:10:02 +0900 Subject: [PATCH 1/5] Copy tasks/administer-cluster/enabling-service-topology.md from en/ directory. --- .../enabling-service-topology.md | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 content/ja/docs/tasks/administer-cluster/enabling-service-topology.md diff --git a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md new file mode 100644 index 0000000000..998bb8b2e5 --- /dev/null +++ b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md @@ -0,0 +1,56 @@ +--- +reviewers: +- andrewsykim +- johnbelamaric +- imroc +title: Enabling Service Topology +content_type: task +--- + + +This page provides an overview of enabling Service Topology in Kubernetes. + + + +## {{% heading "prerequisites" %}} + + {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} + + + + +## Introduction + +_Service Topology_ enables a service to route traffic based upon the Node +topology of the cluster. For example, a service can specify that traffic be +preferentially routed to endpoints that are on the same Node as the client, or +in the same availability zone. + +## Prerequisites + +The following prerequisites are needed in order to enable topology aware service +routing: + + * Kubernetes 1.17 or later + * {{< glossary_tooltip text="Kube-proxy" term_id="kube-proxy" >}} running in iptables mode or IPVS mode + * Enable [Endpoint Slices](/docs/concepts/services-networking/endpoint-slices/) + +## Enable Service Topology + +{{< feature-state for_k8s_version="v1.17" state="alpha" >}} + +To enable service topology, enable the `ServiceTopology` and `EndpointSlice` feature gate for all Kubernetes components: + +``` +--feature-gates="ServiceTopology=true,EndpointSlice=true" +``` + + +## {{% heading "whatsnext" %}} + + +* Read about the [Service Topology](/docs/concepts/services-networking/service-topology) concept +* Read about [Endpoint Slices](/docs/concepts/services-networking/endpoint-slices) +* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) + + From 1f547cfe17bc5acec97383aec77ea9b37f2754c8 Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Sat, 1 Aug 2020 02:03:51 +0900 Subject: [PATCH 2/5] Translate tasks/administer-cluster/enabling-service-topology into Japanese. --- .../enabling-service-topology.md | 39 +++++++------------ 1 file changed, 14 insertions(+), 25 deletions(-) diff --git a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md index 998bb8b2e5..39259dac58 100644 --- a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md +++ b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md @@ -1,15 +1,10 @@ --- -reviewers: -- andrewsykim -- johnbelamaric -- imroc -title: Enabling Service Topology +title: Serviceトポロジーを有効にする content_type: task --- -This page provides an overview of enabling Service Topology in Kubernetes. - +このページでは、Kubernetes上でServiceトロポジーを有効にする方法の概要について説明します。 ## {{% heading "prerequisites" %}} @@ -19,38 +14,32 @@ This page provides an overview of enabling Service Topology in Kubernetes. -## Introduction +## はじめに -_Service Topology_ enables a service to route traffic based upon the Node -topology of the cluster. For example, a service can specify that traffic be -preferentially routed to endpoints that are on the same Node as the client, or -in the same availability zone. +*Serviceトポロジー*は、クラスターのノードのトポロジーに基づいてトラフィックをルーティングできるようにする機能です。たとえば、あるServiceのトラフィックに対して、できるだけ同じノードや同じアベイラビリティゾーン上にあるエンドポイントを優先してルーティングするように指定できます。 -## Prerequisites +## 前提 -The following prerequisites are needed in order to enable topology aware service -routing: +トポロジーを考慮したServiceのルーティングを有効にするには、以下の前提を満たしている必要があります。 - * Kubernetes 1.17 or later - * {{< glossary_tooltip text="Kube-proxy" term_id="kube-proxy" >}} running in iptables mode or IPVS mode - * Enable [Endpoint Slices](/docs/concepts/services-networking/endpoint-slices/) + * Kubernetesバージョン1.17以降である + * {{< glossary_tooltip text="Kube-proxy" term_id="kube-proxy" >}}がiptableモードまたはIPVSモードで稼働している + * [Endpoint Slice](/docs/concepts/services-networking/endpoint-slices/)を有効にしている -## Enable Service Topology +## Serviceトポロジーを有効にする {{< feature-state for_k8s_version="v1.17" state="alpha" >}} -To enable service topology, enable the `ServiceTopology` and `EndpointSlice` feature gate for all Kubernetes components: +Serviceトポロジーを有効にするには、すべてのKubernetesコンポーネントで`ServiceTopology`と`EndpointSlice`フィーチャーを有効にする必要があります。 ``` --feature-gates="ServiceTopology=true,EndpointSlice=true" ``` - ## {{% heading "whatsnext" %}} - -* Read about the [Service Topology](/docs/concepts/services-networking/service-topology) concept -* Read about [Endpoint Slices](/docs/concepts/services-networking/endpoint-slices) -* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) +* [Serviceトポロジー](/docs/concepts/services-networking/service-topology)のコンセプトについて読む +* [Endpoint Slice](/docs/concepts/services-networking/endpoint-slices)について読む +* [アプリケーションをServiceに接続する](/ja/docs/concepts/services-networking/connect-applications-service/)を読む From c053943ddc30bc83b30f1ac47972aadd08a8ffe0 Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Sun, 2 Aug 2020 18:32:46 +0900 Subject: [PATCH 3/5] Fix a link text. --- .../docs/tasks/administer-cluster/enabling-service-topology.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md index 39259dac58..fbf4aa00e9 100644 --- a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md +++ b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md @@ -40,6 +40,6 @@ Serviceトポロジーを有効にするには、すべてのKubernetesコンポ * [Serviceトポロジー](/docs/concepts/services-networking/service-topology)のコンセプトについて読む * [Endpoint Slice](/docs/concepts/services-networking/endpoint-slices)について読む -* [アプリケーションをServiceに接続する](/ja/docs/concepts/services-networking/connect-applications-service/)を読む +* [サービスとアプリケーションの接続](/ja/docs/concepts/services-networking/connect-applications-service/)を読む From e132712e52e76d8f846b4c0b1c80001b6da37ce4 Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Sun, 2 Aug 2020 19:59:16 +0900 Subject: [PATCH 4/5] Apply suggestions from code review Co-authored-by: Naoki Oketani --- .../tasks/administer-cluster/enabling-service-topology.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md index fbf4aa00e9..f2bba2c22f 100644 --- a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md +++ b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md @@ -4,7 +4,7 @@ content_type: task --- -このページでは、Kubernetes上でServiceトロポジーを有効にする方法の概要について説明します。 +このページでは、Kubernetes上でServiceトポロジーを有効にする方法の概要について説明します。 ## {{% heading "prerequisites" %}} @@ -30,7 +30,7 @@ content_type: task {{< feature-state for_k8s_version="v1.17" state="alpha" >}} -Serviceトポロジーを有効にするには、すべてのKubernetesコンポーネントで`ServiceTopology`と`EndpointSlice`フィーチャーを有効にする必要があります。 +Serviceトポロジーを有効にするには、すべてのKubernetesコンポーネントで`ServiceTopology`と`EndpointSlice`フィーチャーゲートを有効にする必要があります。 ``` --feature-gates="ServiceTopology=true,EndpointSlice=true" @@ -42,4 +42,3 @@ Serviceトポロジーを有効にするには、すべてのKubernetesコンポ * [Endpoint Slice](/docs/concepts/services-networking/endpoint-slices)について読む * [サービスとアプリケーションの接続](/ja/docs/concepts/services-networking/connect-applications-service/)を読む - From 4e1f3f2e9cdc7592326f1f85ab7075594ea0764e Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Sun, 2 Aug 2020 19:59:16 +0900 Subject: [PATCH 5/5] Change a link to a Japanese docs. --- .../docs/tasks/administer-cluster/enabling-service-topology.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md index f2bba2c22f..304e0937a6 100644 --- a/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md +++ b/content/ja/docs/tasks/administer-cluster/enabling-service-topology.md @@ -38,7 +38,7 @@ Serviceトポロジーを有効にするには、すべてのKubernetesコンポ ## {{% heading "whatsnext" %}} -* [Serviceトポロジー](/docs/concepts/services-networking/service-topology)のコンセプトについて読む +* [Serviceトポロジー](/ja/docs/concepts/services-networking/service-topology)のコンセプトについて読む * [Endpoint Slice](/docs/concepts/services-networking/endpoint-slices)について読む * [サービスとアプリケーションの接続](/ja/docs/concepts/services-networking/connect-applications-service/)を読む