add ja pages

2020-05-30 15:47:59 -04:00
parent 74d006a754
commit 283572af58
114 changed files with 900 additions and 793 deletions
@@ -1,13 +1,13 @@
 ---
 title: Kubernetesのコンポーネント
-content_template: templates/concept
+content_type: concept
 weight: 20
 card: 
  name: concepts
  weight: 20
 ---

-{{% capture overview %}}
+<!-- overview -->
 Kubernetesをデプロイすると、クラスターが展開されます。
 {{< glossary_definition term_id="cluster" length="all" prepend="クラスターは、">}}

@@ -17,9 +17,9 @@ Kubernetesをデプロイすると、クラスターが展開されます。

 ![Kubernetesのコンポーネント](/images/docs/components-of-kubernetes.png)

-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## マスターコンポーネント

@@ -112,10 +112,11 @@ Kubernetesによって開始されたコンテナは、DNS検索にこのDNSサ

 [クラスターレベルログ](/docs/concepts/cluster-administration/logging/)メカニズムは、コンテナのログを、検索／参照インターフェイスを備えた中央ログストアに保存します。

-{{% /capture %}}
-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * [ノード](/ja/docs/concepts/architecture/nodes/)について学ぶ
 * [コントローラー](/docs/concepts/architecture/controller/)について学ぶ
 * [kube-scheduler](/ja/docs/concepts/scheduling/kube-scheduler/)について学ぶ
 * etcdの公式 [ドキュメント](https://etcd.io/docs/)を読む
-{{% /capture %}}
+
@@ -1,14 +1,14 @@
 ---
 reviewers:
 title: Kubernetes API
-content_template: templates/concept
+content_type: concept
 weight: 30
 card: 
  name: concepts
  weight: 30
 ---

-{{% capture overview %}}
+<!-- overview -->

 全般的なAPIの規則は、[API規則ドキュメント](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md)に記載されています。

@@ -22,9 +22,9 @@ Kubernetes APIは、システムの宣言的設定スキーマの基礎として

 Kubernetesそれ自身は複数のコンポーネントから構成されており、APIを介して連携しています。

-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## APIの変更

@@ -113,4 +113,4 @@ APIグループは、RESTのパスとシリアライズされたオブジェク
 DaemonSets、Deployments、HorizontalPodAutoscalers、Ingresses、JobsReplicaSets、そしてReplicaSetsはデフォルトで有効です。
 その他の拡張リソースは、APIサーバーの`--runtime-config`を設定することで有効化できます。`--runtime-config`はカンマ区切りの複数の値を設定可能です。例えば、deploymentsとingressを無効化する場合、`--runtime-config=extensions/v1beta1/deployments=false,extensions/v1beta1/ingresses=false`と設定します。

-{{% /capture %}}
+
@@ -1,17 +1,17 @@
 ---
 title: Kubernetesとは何か？
-content_template: templates/concept
+content_type: concept
 weight: 10
 card: 
  name: concepts
  weight: 10
 ---

-{{% capture overview %}}
+<!-- overview -->
 このページでは、Kubernetesの概要について説明します。
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->
 Kubernetesは、宣言的な構成管理と自動化を促進し、コンテナ化されたワークロードやサービスを管理するための、ポータブルで拡張性のあるオープンソースプラットホームです。

 Kubernetesは膨大で、急速に成長しているエコシステムを備えており、それらのサービス、サポート、ツールは幅広い形で利用可能です。
@@ -94,11 +94,12 @@ Kubernetesは...

 **Kubernetes** という名前はギリシャ語で *操舵手* や *パイロット* という意味があり、*知事* や[サイバネティックス](http://www.etymonline.com/index.php?term=cybernetics)の語源にもなっています。*K8s* は、8文字の「ubernete」を「8」に置き換えた略語です。

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 *   [はじめる](/docs/setup/)準備はできましたか？
 *   さらなる詳細については、[Kubernetesのドキュメント](/ja/docs/home/)を御覧ください。
-{{% /capture %}}
+


@@ -1,14 +1,14 @@
 ---
 title: アノテーション(Annotations)
-content_template: templates/concept
+content_type: concept
 weight: 50
 ---

-{{% capture overview %}}
+<!-- overview -->
 ユーザーは、識別用途でない任意のメタデータをオブジェクトに割り当てるためにアノテーションを使用できます。ツールやライブラリなどのクライアントは、このメタデータを取得できます。  
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->
 ## オブジェクトにメタデータを割り当てる

 ユーザーは、Kubernetesオブジェクトに対してラベルやアノテーションの両方またはどちらか一方を割り当てることができます。
@@ -59,9 +59,10 @@ _アノテーション_ はキーとバリューのペアです。有効なア

 `kubernetes.io/`と`k8s.io/`プレフィックスは、Kubernetesコアコンポーネントのために予約されています。  

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 [ラベルとセレクター](/docs/concepts/overview/working-with-objects/labels/)について学習してください。
-{{% /capture %}}
+

@@ -1,15 +1,15 @@
 ---
 title: 推奨ラベル(Recommended Labels)
-content_template: templates/concept
+content_type: concept
 ---

-{{% capture overview %}}
+<!-- overview -->
 ユーザーはkubectlやダッシュボード以外に、多くのツールでKubernetesオブジェクトの管理と可視化ができます。共通のラベルセットにより、全てのツールにおいて解釈可能な共通のマナーに沿ってオブジェクトを表現することで、ツールの相互運用を可能にします。

 ツール化に対するサポートに加えて、推奨ラベルはクエリ可能な方法でアプリケーションを表現します。
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->
 メタデータは、_アプリケーション_ のコンセプトを中心に構成されています。KubernetesはPaaS(Platform as a Service)でなく、アプリケーションの公式な概念を持たず、またそれを強制することはありません。
 そのかわり、アプリケーションは、非公式で、メタデータによって表現されています。単一のアプリケーションが有する項目に対する定義は厳密に決められていません。

@@ -153,4 +153,3 @@ metadata:

 MySQLの`StatefulSet`と`Service`により、MySQLとWordPressに関するより広範な情報が含まれていることに気づくでしょう。

-{{% /capture %}}
@@ -1,17 +1,17 @@
 ---
 title: Kubernetesオブジェクトを理解する
-content_template: templates/concept
+content_type: concept
 weight: 10
 card: 
  name: concepts
  weight: 40
 ---

-{{% capture overview %}}
+<!-- overview -->
 このページでは、KubernetesオブジェクトがKubernetes APIでどのように表現されているか、またそれらを`.yaml`フォーマットでどのように表現するかを説明します。
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->
 ## Kubernetesオブジェクトを理解する

 *Kubernetesオブジェクト* は、Kubernetes上で永続的なエンティティです。Kubernetesはこれらのエンティティを使い、クラスターの状態を表現します。具体的に言うと、下記のような内容が表現出来ます:
@@ -63,10 +63,11 @@ Kubernetesオブジェクトを`.yaml`ファイルに記載して作成する場
 またオブジェクトの`spec`の値も指定する必要があります。`spec`の正確なフォーマットは、Kubernetesオブジェクトごとに異なり、オブジェクトごとに特有な入れ子のフィールドを持っています。[Kubernetes API リファレンス](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)が、Kubernetesで作成出来る全てのオブジェクトに関するspecのフォーマットを探すのに役立ちます。
 例えば、`Pod`オブジェクトに関する`spec`のフォーマットは[こちら](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core)を、また`Deployment`オブジェクトに関する`spec`のフォーマットは[こちら](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#deploymentspec-v1-apps)をご確認ください。

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 * 最も重要、かつ基本的なKubernetesオブジェクト群を学びましょう、例えば、[Pod](/ja/docs/concepts/workloads/pods/pod-overview/)です。

-{{% /capture %}}
+
@@ -1,10 +1,10 @@
 ---
 title: ラベル(Labels)とセレクター(Selectors)
-content_template: templates/concept
+content_type: concept
 weight: 40
 ---

-{{% capture overview %}}
+<!-- overview -->

 _ラベル(Labels)_ はPodなどのオブジェクトに割り当てられたキーとバリューのペアです。  
 ラベルはユーザーに関連した意味のあるオブジェクトの属性を指定するために使われることを目的としています。しかしKubernetesのコアシステムに対して直接的にその意味を暗示するものではありません。  
@@ -22,10 +22,10 @@ _ラベル(Labels)_ はPodなどのオブジェクトに割り当てられたキ
 ラベルは効率的な検索・閲覧を可能にし、UIやCLI上での利用に最適です。 
 識別用途でない情報は、[アノテーション](/docs/concepts/overview/working-with-objects/annotations/)を用いて記録されるべきです。  

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## ラベルを使う動機

@@ -216,4 +216,4 @@ selector:
 ラベルを選択するための1つのユースケースはPodがスケジュールできるNodeのセットを制限することです。  
 さらなる情報に関しては、[Node選定](/ja/docs/concepts/configuration/assign-pod-node/) のドキュメントを参照してください。 

-{{% /capture %}}
+
@@ -1,11 +1,11 @@
 ---
 reviewers:
 title: 名前
-content_template: templates/concept
+content_type: concept
 weight: 20
 ---

-{{% capture overview %}}
+<!-- overview -->

 KubernetesのREST API内の全てのオブジェクトは、名前とUIDで明確に識別されます。

@@ -13,9 +13,9 @@ KubernetesのREST API内の全てのオブジェクトは、名前とUIDで明

 名前とUIDに関する正確な構文については、[識別子デザインドキュメント](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md)を参照してください。

-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## 名前

@@ -27,4 +27,4 @@ KubernetesのREST API内の全てのオブジェクトは、名前とUIDで明

 {{< glossary_definition term_id="uid" length="all" >}}

-{{% /capture %}}
+
@@ -1,18 +1,18 @@
 ---
 title: Namespace(名前空間)
-content_template: templates/concept
+content_type: concept
 weight: 30
 ---

-{{% capture overview %}}
+<!-- overview -->

 Kubernetesは、同一の物理クラスター上で複数の仮想クラスターの動作をサポートします。  
 この仮想クラスターをNamespaceと呼びます。  

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 複数のNamespaceを使う時

@@ -97,4 +97,4 @@ kubectl api-resources --namespaced=true
 kubectl api-resources --namespaced=false
 ```

-{{% /capture %}}
+
@@ -1,16 +1,16 @@
 ---
 title: Kubernetesオブジェクト管理
-content_template: templates/concept
+content_type: concept
 weight: 15
 ---

-{{% capture overview %}}
+<!-- overview -->
 `kubectl`コマンドラインツールは、Kubernetesオブジェクトを作成、管理するためにいくつかの異なる方法をサポートしています。
 このドキュメントでは、それらの異なるアプローチごとの概要を提供します。
 Kubectlを使ったオブジェクト管理の詳細は、[Kubectl book](https://kubectl.docs.kubernetes.io)を参照してください。
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## 管理手法

@@ -157,9 +157,10 @@ kubectl apply -R -f configs/
 - 宣言型オブジェクト設定は、デバッグ、そして想定外の結果が出たときに理解するのが困難です
 - 差分を利用した一部のみの更新は、複雑なマージ、パッチの操作が必要です

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 - [命令型コマンドを利用したKubernetesオブジェクトの管理](/docs/tasks/manage-kubernetes-objects/imperative-command/)
 - [オブジェクト設定（命令型）を利用したKubernetesオブジェクトの管理](/docs/tasks/manage-kubernetes-objects/imperative-config/)
@@ -169,4 +170,4 @@ kubectl apply -R -f configs/
 - [Kubectl Book](https://kubectl.docs.kubernetes.io)
 - [Kubernetes APIリファレンス](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)

-{{% /capture %}}
+