From d322844be648f080dd6af59f5303f36f902b7c60 Mon Sep 17 00:00:00 2001 From: inductor Date: Wed, 26 May 2021 13:27:24 +0000 Subject: [PATCH] remove some pages --- .../manage-deployment.md | 454 ------------------ .../cluster-administration/proxies.md | 66 --- content/ja/docs/concepts/containers/images.md | 273 ----------- content/ja/docs/concepts/security/overview.md | 132 ----- .../docs/concepts/storage/storage-capacity.md | 81 ---- .../workloads/pods/ephemeral-containers.md | 147 ------ 6 files changed, 1153 deletions(-) delete mode 100644 content/ja/docs/concepts/cluster-administration/manage-deployment.md delete mode 100644 content/ja/docs/concepts/cluster-administration/proxies.md delete mode 100644 content/ja/docs/concepts/containers/images.md delete mode 100644 content/ja/docs/concepts/security/overview.md delete mode 100644 content/ja/docs/concepts/storage/storage-capacity.md delete mode 100644 content/ja/docs/concepts/workloads/pods/ephemeral-containers.md diff --git a/content/ja/docs/concepts/cluster-administration/manage-deployment.md b/content/ja/docs/concepts/cluster-administration/manage-deployment.md deleted file mode 100644 index 90f96547d5..0000000000 --- a/content/ja/docs/concepts/cluster-administration/manage-deployment.md +++ /dev/null @@ -1,454 +0,0 @@ ---- -reviewers: -- -title: リソースの管理 -content_type: concept -weight: 40 ---- - - - -アプリケーションをデプロイし、Serviceを介して外部に公開できました。さて、どうしますか？Kubernetesは、スケーリングや更新など、アプリケーションのデプロイを管理するための多くのツールを提供します。 -我々が取り上げる機能についての詳細は[設定ファイル](/ja/docs/concepts/configuration/overview/)と[ラベル](/ja/docs/concepts/overview/working-with-objects/labels/)について詳細に説明します。 - - - - - - -## リソースの設定を管理する - -多くのアプリケーションではDeploymentやServiceなど複数のリソースの作成を要求します。複数のリソースの管理は、同一のファイルにひとまとめにしてグループ化すると簡単になります(YAMLファイル内で`---`で区切る)。 -例えば: - -{{< codenew file="application/nginx-app.yaml" >}} - -複数のリソースは単一のリソースと同様の方法で作成できます。 - -```shell -kubectl apply -f https://k8s.io/examples/application/nginx-app.yaml -``` - -```shell -service/my-nginx-svc created -deployment.apps/my-nginx created -``` - -リソースは、ファイル内に記述されている順番通りに作成されます。そのため、Serviceを最初に指定するのが理想です。スケジューラーがServiceに関連するPodを、Deploymentなどのコントローラーによって作成されるときに確実に拡散できるようにするためです。 - -`kubectl apply`もまた、複数の`-f`による引数指定を許可しています。 - -```shell -kubectl apply -f https://k8s.io/examples/application/nginx/nginx-svc.yaml -f https://k8s.io/examples/application/nginx/nginx-deployment.yaml -``` - -個別のファイルに加えて、-fの引数としてディレクトリ名も指定できます: - -```shell -kubectl apply -f https://k8s.io/examples/application/nginx/ -``` - -`kubectl`は`.yaml`、`.yml`、`.json`といったサフィックスの付くファイルを読み込みます。 - -同じマイクロサービス、アプリケーションティアーのリソースは同一のファイルにまとめ、アプリケーションに関するファイルをグループ化するために、それらのファイルを同一のディレクトリに配備するのを推奨します。アプリケーションのティアーがDNSを通じて互いにバインドされると、アプリケーションスタックの全てのコンポーネントをひとまとめにして簡単にデプロイできます。 - -リソースの設定ソースとして、URLも指定できます。githubから取得した設定ファイルから直接手軽にデプロイができます: - -```shell -kubectl apply -f https://raw.githubusercontent.com/kubernetes/website/master/content/en/examples/application/nginx/nginx-deployment.yaml -``` - -```shell -deployment.apps/my-nginx created -``` - -## kubectlによる一括操作 - -`kubectl`が一括して実行できる操作はリソースの作成のみではありません。作成済みのリソースの削除などの他の操作を実行するために、設定ファイルからリソース名を取得することができます。 - -```shell -kubectl delete -f https://k8s.io/examples/application/nginx-app.yaml -``` - -```shell -deployment.apps "my-nginx" deleted -service "my-nginx-svc" deleted -``` - -2つのリソースだけを削除する場合には、コマンドラインでリソース/名前というシンタックスを使うことで簡単に指定できます。 - -```shell -kubectl delete deployments/my-nginx services/my-nginx-svc -``` - -さらに多くのリソースに対する操作では、リソースをラベルでフィルターするために`-l`や`--selector`を使ってセレクター(ラベルクエリ)を指定するのが簡単です: - -```shell -kubectl delete deployment,services -l app=nginx -``` - -```shell -deployment.apps "my-nginx" deleted -service "my-nginx-svc" deleted -``` - -`kubectl`は同様のシンタックスでリソース名を出力するので、`$()`や`xargs`を使ってパイプで操作するのが容易です: - -```shell -kubectl get $(kubectl create -f docs/concepts/cluster-administration/nginx/ -o name | grep service) -``` - -```shell -NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE -my-nginx-svc LoadBalancer 10.0.0.208 80/TCP 0s -``` - -上記のコマンドで、最初に`examples/application/nginx/`配下でリソースを作成し、`-o name`という出力フォーマットにより、作成されたリソースの名前を表示します(各リソースをresource/nameという形式で表示)。そして"service"のみ`grep`し、`kubectl get`を使って表示させます。 - -あるディレクトリ内の複数のサブディレクトリをまたいでリソースを管理するような場合、`--filename,-f`フラグと合わせて`--recursive`や`-R`を指定することでサブディレクトリに対しても再帰的に操作が可能です。 - -例えば、開発環境用に必要な全ての{{< glossary_tooltip text="マニフェスト" term_id="manifest" >}}をリソースタイプによって整理している`project/k8s/development`というディレクトリがあると仮定します。 - -``` -project/k8s/development -├── configmap -│   └── my-configmap.yaml -├── deployment -│   └── my-deployment.yaml -└── pvc - └── my-pvc.yaml -``` - -デフォルトでは、`project/k8s/development`における一括操作は、どのサブディレクトリも処理せず、ディレクトリの第1階層で処理が止まります。下記のコマンドによってこのディレクトリ配下でリソースを作成しようとすると、エラーが発生します。 - -```shell -kubectl apply -f project/k8s/development -``` - -```shell -error: you must provide one or more resources by argument or filename (.json|.yaml|.yml|stdin) -``` - -代わりに、下記のように`--filename,-f`フラグと合わせて`--recursive`や`-R`を指定してください: - -```shell -kubectl apply -f project/k8s/development --recursive -``` - -```shell -configmap/my-config created -deployment.apps/my-deployment created -persistentvolumeclaim/my-pvc created -``` - -`--recursive`フラグは`kubectl {create,get,delete,describe,rollout}`などのような`--filename,-f`フラグを扱うどの操作でも有効です。 - -また、`--recursive`フラグは複数の`-f`フラグの引数を指定しても有効です。 - -```shell -kubectl apply -f project/k8s/namespaces -f project/k8s/development --recursive -``` - -```shell -namespace/development created -namespace/staging created -configmap/my-config created -deployment.apps/my-deployment created -persistentvolumeclaim/my-pvc created -``` - -`kubectl`についてさらに知りたい場合は、[kubectlの概要](/docs/reference/kubectl/overview/)を参照してください。 - -## ラベルを有効に使う - -これまで取り上げた例では、リソースに対して最大1つのラベルを適用してきました。リソースのセットを他のセットと区別するために、複数のラベルが必要な状況があります。 - -例えば、異なるアプリケーション間では、異なる`app`ラベルを使用したり、[ゲストブックの例](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/guestbook/)のようなマルチティアーのアプリケーションでは、各ティアーを区別する必要があります。frontendというティアーでは下記のラベルを持ちます。: - -```yaml - labels: - app: guestbook - tier: frontend -``` - -Redisマスターやスレーブでは異なる`tier`ラベルを持ち、加えて`role`ラベルも持つことでしょう。: - -```yaml - labels: - app: guestbook - tier: backend - role: master -``` - -そして - -```yaml - labels: - app: guestbook - tier: backend - role: slave -``` - -ラベルを使用すると、ラベルで指定された任意の次元に沿ってリソースを分割できます。 - -```shell -kubectl apply -f examples/guestbook/all-in-one/guestbook-all-in-one.yaml -kubectl get pods -Lapp -Ltier -Lrole -``` - -```shell -NAME READY STATUS RESTARTS AGE APP TIER ROLE -guestbook-fe-4nlpb 1/1 Running 0 1m guestbook frontend -guestbook-fe-ght6d 1/1 Running 0 1m guestbook frontend -guestbook-fe-jpy62 1/1 Running 0 1m guestbook frontend -guestbook-redis-master-5pg3b 1/1 Running 0 1m guestbook backend master -guestbook-redis-slave-2q2yf 1/1 Running 0 1m guestbook backend slave -guestbook-redis-slave-qgazl 1/1 Running 0 1m guestbook backend slave -my-nginx-divi2 1/1 Running 0 29m nginx -my-nginx-o0ef1 1/1 Running 0 29m nginx -``` - -```shell -kubectl get pods -lapp=guestbook,role=slave -``` -```shell -NAME READY STATUS RESTARTS AGE -guestbook-redis-slave-2q2yf 1/1 Running 0 3m -guestbook-redis-slave-qgazl 1/1 Running 0 3m -``` - -## Canary deployments カナリアデプロイ - -複数のラベルが必要な他の状況として、異なるリリース間でのDeploymentや、同一コンポーネントの設定を区別することが挙げられます。よく知られたプラクティスとして、本番環境の実際のトラフィックを受け付けるようにするために、新しいリリースを完全にロールアウトする前に、新しい*カナリア版*のアプリケーションを過去のリリースと合わせてデプロイする方法があります。 - -例えば、異なるリリースバージョンを分けるために`track`ラベルを使用できます。 - -主要な安定板のリリースでは`track`ラベルに`stable`という値をつけることがあるでしょう。: - -```yaml - name: frontend - replicas: 3 - ... - labels: - app: guestbook - tier: frontend - track: stable - ... - image: gb-frontend:v3 -``` - -そして2つの異なるPodのセットを上書きしないようにするため、`track`ラベルに異なる値を持つ(例: `canary`)ようなguestbookフロントエンドの新しいリリースを作成できます。 - -```yaml - name: frontend-canary - replicas: 1 - ... - labels: - app: guestbook - tier: frontend - track: canary - ... - image: gb-frontend:v4 -``` - -frontend Serviceは、トラフィックを両方のアプリケーションにリダイレクトさせるために、両方のアプリケーションに共通したラベルのサブセットを選択して両方のレプリカを扱えるようにします。: - -```yaml - selector: - app: guestbook - tier: frontend -``` - -安定版とカナリア版リリースで本番環境の実際のトラフィックを転送する割合を決めるため、双方のレプリカ数を変更できます(このケースでは3対1)。 -最新版のリリースをしても大丈夫な場合、安定版のトラックを新しいアプリケーションにして、カナリア版を削除します。 - -さらに具体的な例については、[tutorial of deploying Ghost](https://github.com/kelseyhightower/talks/tree/master/kubecon-eu-2016/demo#deploy-a-canary)を参照してください。 - -## ラベルの更新 - -新しいリソースを作成する前に、既存のPodと他のリソースのラベルの変更が必要な状況があります。これは`kubectl label`で実行できます。 -例えば、全てのnginx Podを frontendティアーとしてラベル付けするには、下記のコマンドを実行するのみです。 - -```shell -kubectl label pods -l app=nginx tier=fe -``` - -```shell -pod/my-nginx-2035384211-j5fhi labeled -pod/my-nginx-2035384211-u2c7e labeled -pod/my-nginx-2035384211-u3t6x labeled -``` - -これは最初に"app=nginx"というラベルのついたPodをフィルターし、そのPodに対して"tier=fe"というラベルを追加します。 -ラベル付けしたPodを確認するには、下記のコマンドを実行してください。 - -```shell -kubectl get pods -l app=nginx -L tier -``` -```shell -NAME READY STATUS RESTARTS AGE TIER -my-nginx-2035384211-j5fhi 1/1 Running 0 23m fe -my-nginx-2035384211-u2c7e 1/1 Running 0 23m fe -my-nginx-2035384211-u3t6x 1/1 Running 0 23m fe -``` - -このコマンドでは"app=nginx"というラベルのついた全てのPodを出力し、Podのtierという項目も表示します(`-L`または`--label-columns`で指定)。 - -さらなる情報は、[ラベル](/docs/concepts/overview/working-with-objects/labels/)や[kubectl label](/docs/reference/generated/kubectl/kubectl-commands/#label)を参照してください。 - -## アノテーションの更新 - -リソースに対してアノテーションを割り当てたい状況があります。アノテーションは、ツール、ライブラリなどのAPIクライアントによって取得するための任意の非識別メタデータです。アノテーションの割り当ては`kubectl annotate`で可能です。例: - -```shell -kubectl annotate pods my-nginx-v4-9gw19 description='my frontend running nginx' -kubectl get pods my-nginx-v4-9gw19 -o yaml -``` -```shell -apiVersion: v1 -kind: pod -metadata: - annotations: - description: my frontend running nginx -... -``` - -さらなる情報は、[アノテーション](/docs/concepts/overview/working-with-objects/annotations/) や、[kubectl annotate](/docs/reference/generated/kubectl/kubectl-commands/#annotate)を参照してください。 - -## アプリケーションのスケール - -アプリケーションの負荷が増減するとき、`kubectl`を使って簡単にスケールできます。例えば、nginxのレプリカを3から1に減らす場合、下記を実行します: - -```shell -kubectl scale deployment/my-nginx --replicas=1 -``` -```shell -deployment.apps/my-nginx scaled -``` - -実行すると、Deploymentによって管理されるPod数が1となります。 - -```shell -kubectl get pods -l app=nginx -``` -```shell -NAME READY STATUS RESTARTS AGE -my-nginx-2035384211-j5fhi 1/1 Running 0 30m -``` - -システムに対してnginxのレプリカ数を自動で選択させるには、下記のように1から3の範囲で指定します。: - -```shell -kubectl autoscale deployment/my-nginx --min=1 --max=3 -``` -```shell -horizontalpodautoscaler.autoscaling/my-nginx autoscaled -``` - -実行すると、nginxのレプリカは必要に応じて自動でスケールアップ、スケールダウンします。 - -さらなる情報は、[kubectl scale](/docs/reference/generated/kubectl/kubectl-commands/#scale)、[kubectl autoscale](/docs/reference/generated/kubectl/kubectl-commands/#autoscale) and [horizontal pod autoscaler](/docs/tasks/run-application/horizontal-pod-autoscale/)を参照してください。 - - -## リソースの直接的アップデート - -場合によっては、作成したリソースに対して処理を中断させずに更新を行う必要があります。 - -### kubectl apply - -開発者が設定するリソースをコードとして管理しバージョニングも行えるように、設定ファイルのセットをソースによって管理する方法が推奨されています。 -この場合、クラスターに対して設定の変更をプッシュするために[`kubectl apply`](/docs/reference/generated/kubectl/kubectl-commands/#apply)を使用できます。 - -このコマンドは、リソース設定の過去のバージョンと、今適用した変更を比較し、差分に現れないプロパティーに対して上書き変更することなくクラスターに適用させます。 - -```shell -kubectl apply -f https://k8s.io/examples/application/nginx/nginx-deployment.yaml -deployment.apps/my-nginx configured -``` - -注意として、前回の変更適用時からの設定の変更内容を決めるため、`kubectl apply`はリソースに対してアノテーションを割り当てます。変更が実施されると`kubectl apply`は、1つ前の設定内容と、今回変更しようとする入力内容と、現在のリソースの設定との3つの間で変更内容の差分をとります。 - -現在、リソースはこのアノテーションなしで作成されました。そのため、最初の`kubectl paply`の実行においては、与えられたにゅうチョクト、現在のリソースの設定の2つの間の差分が取られ、フォールバックします。この最初の実行の間、リソースが作成された時にプロパティーセットの削除を検知できません。この理由により、プロパティーの削除はされません。 - -`kubectl apply`の実行後の全ての呼び出しや、`kubectl replace`や`kubectl edit`などの設定を変更する他のコマンドではアノテーションを更新します。`kubectl apply`した後の全ての呼び出しにおいて3-wayの差分取得によってプロパティの検知と削除を実施します。 - -### kubectl edit - -その他に、`kubectl edit`によってリソースの更新もできます。: - -```shell -kubectl edit deployment/my-nginx -``` - -このコマンドは、最初にリソースを`get`し、テキストエディタでリソースを編集し、更新されたバージョンでリソースを`apply`します。: - -```shell -kubectl get deployment my-nginx -o yaml > /tmp/nginx.yaml -vi /tmp/nginx.yaml -# yamlファイルを編集し、ファイルを保存します。 - -kubectl apply -f /tmp/nginx.yaml -deployment.apps/my-nginx configured - -rm /tmp/nginx.yaml -``` - -このコマンドによってより重大な変更を簡単に行えます。注意として、あなたの`EDITOR`や`KUBE_EDITOR`といった環境変数も指定できます。 - -さらなる情報は、[kubectl edit](/docs/reference/generated/kubectl/kubectl-commands/#edit)を参照してください。 - -### kubectl patch - -APIオブジェクトの更新には`kubectl patch`を使うことができます。このコマンドはJSON patch、JSON merge patch、戦略的merge patchをサポートしています。 -[kubectl patchを使ったAPIオブジェクトの更新](/docs/tasks/manage-kubernetes-objects/update-api-object-kubectl-patch/)や[kubectl patch](/docs/reference/generated/kubectl/kubectl-commands/#patch)を参照してください。 - -## 破壊的なアップデート - -一度初期化された後、更新できないようなリソースフィールドの更新が必要な場合や、Deploymentによって作成され、壊れている状態のPodを修正するなど、再帰的な変更を即座に行いたい場合があります。このようなフィールドを変更するため、リソースの削除と再作成を行う`replace --force`を使用してください。このケースでは、シンプルに元の設定ファイルを修正するのみです。: - -```shell -kubectl replace -f https://k8s.io/examples/application/nginx/nginx-deployment.yaml --force -``` -```shell -deployment.apps/my-nginx deleted -deployment.apps/my-nginx replaced -``` - -## サービス停止なしでアプリケーションを更新する - -ある時点で、前述したカナリアデプロイのシナリオにおいて、新しいイメージやイメージタグを指定することによって、デプロイされたアプリケーションを更新が必要な場合があります。`kubectl`ではいくつかの更新操作をサポートしており、それぞれの操作が異なるシナリオに対して適用可能です。 - -ここでは、Deploymentを使ってアプリケーションの作成と更新についてガイドします。 - -まずnginxのバージョン1.14.2を稼働させていると仮定します。: - -```shell -kubectl create deployment my-nginx --image=nginx:1.14.2 -``` -```shell -deployment.apps/my-nginx created -``` - -レプリカ数を3にします(新旧のリビジョンは混在します)。: -```shell -kubectl scale deployment my-nginx --current-replicas=1 --replicas=3 -``` -``` -deployment.apps/my-nginx scaled -``` - -バージョン1.16.1に更新するには、上述したkubectlコマンドを使って`.spec.template.spec.containers[0].image`の値を`nginx:1.14.2`から`nginx:1.16.1`に変更するだけでできます。 - -```shell -kubectl edit deployment/my-nginx -``` - -できました!Deploymentはデプロイされたnginxのアプリケーションを宣言的にプログレッシブに更新します。更新途中では、決まった数の古いレプリカのみダウンし、一定数の新しいレプリカが希望するPod数以上作成されても良いことを保証します。詳細について学ぶには[Deployment page](/docs/concepts/workloads/controllers/deployment/)を参照してください。 - - - -## {{% heading "whatsnext" %}} - -- [アプリケーションの調査とデバッグのための`kubectl`の使用方法](/docs/tasks/debug-application-cluster/debug-application-introspection/)について学んでください。 -- [設定のベストプラクティスとTIPS](/ja/docs/concepts/configuration/overview/)を参照してください。 - diff --git a/content/ja/docs/concepts/cluster-administration/proxies.md b/content/ja/docs/concepts/cluster-administration/proxies.md deleted file mode 100644 index 4738993ab0..0000000000 --- a/content/ja/docs/concepts/cluster-administration/proxies.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Kubernetesのプロキシー -content_type: concept -weight: 90 ---- - - -このページではKubernetesと併用されるプロキシーについて説明します。 - - - - -## プロキシー - -Kubernetesを使用する際に、いくつかのプロキシーを使用する場面があります。 - -1. [kubectlのプロキシー](/docs/tasks/access-application-cluster/access-cluster/#directly-accessing-the-rest-api): - - - ユーザーのデスクトップ上かPod内で稼働します - - ローカルホストのアドレスからKubernetes apiserverへのプロキシーを行います - - クライアントからプロキシー間ではHTTPを使用します - - プロキシーからapiserverへはHTTPSを使用します - - apiserverの場所を示します - - 認証用のヘッダーを追加します - -1. [apiserverのプロキシー](/docs/tasks/access-application-cluster/access-cluster/#discovering-builtin-services): - - - apiserver内で動作する踏み台となります - - これがなければ到達不可能であるクラスターIPへ、クラスターの外部からのユーザーを接続します - - apiserverのプロセス内で稼働します - - クライアントからプロキシー間ではHTTPSを使用します(apiserverの設定により、HTTPを使用します) - - プロキシーからターゲット間では利用可能な情報を使用して、プロキシーによって選択されたHTTPかHTTPSのいずれかを使用します - - Node、Pod、Serviceへ到達するのに使えます - - Serviceへ到達するときは負荷分散を行います - -1. [kube proxy](/ja/docs/concepts/services-networking/service/#ips-and-vips): - - - 各ノード上で稼働します - - UDP、TCP、SCTPをプロキシーします - - HTTPを解釈しません - - 負荷分散機能を提供します - - Serviceへ到達させるためのみに使用されます - -1. apiserverの前段にあるプロキシー/ロードバランサー: - - - 実際に存在するかどうかと実装はクラスターごとに異なります(例: nginx) - - 全てのクライアントと、1つ以上のapiserverの間に位置します - - 複数のapiserverがあるときロードバランサーとして稼働します - -1. 外部サービス上で稼働するクラウドロードバランサー: - - - いくつかのクラウドプロバイダーによって提供されます(例: AWS ELB、Google Cloud Load Balancer) - - `LoadBalancer`というtypeのKubernetes Serviceが作成されたときに自動で作成されます - - たいていのクラウドロードバランサーはUDP/TCPのみサポートしています - - SCTPのサポートはクラウドプロバイダーのロードバランサーの実装によって異なります - - ロードバランサーの実装はクラウドプロバイダーによって異なります - -Kubernetesユーザーのほとんどは、最初の2つのタイプ以外に心配する必要はありません。クラスター管理者はそれ以外のタイプのロードバランサーを正しくセットアップすることを保証します。 - -## リダイレクトの要求 - -プロキシーはリダイレクトの機能を置き換えました。リダイレクトの使用は非推奨となります。 - - - - diff --git a/content/ja/docs/concepts/containers/images.md b/content/ja/docs/concepts/containers/images.md deleted file mode 100644 index 0ad4459d79..0000000000 --- a/content/ja/docs/concepts/containers/images.md +++ /dev/null @@ -1,273 +0,0 @@ ---- -reviewers: -title: イメージ -content_type: concept -weight: 10 ---- - - -コンテナイメージはアプリケーションと依存関係のあるすべてソフトウェアをカプセル化したバイナリデータを表します。コンテナイメージはスタンドアロンで実行可能なソフトウェアをひとつにまとめ、ランタイム環境に関する想定を明確に定義しています。 - -アプリケーションのコンテナイメージを作成し、一般的には{{< glossary_tooltip text="Pod" term_id="pod" >}}で参照する前にレジストリへPushします。 - -このページではコンテナイメージの概要を説明します。 - - - -## イメージの名称 - -コンテナイメージは、`pause`、`example/mycontainer`、または`kube-apiserver`のような名前が通常つけられます。 -イメージにはレジストリのホスト名も含めることができ（例：`fictional.registry.example/imagename`）、さらにポート番号も含めることが可能です（例：`fictional.registry.example:10443/imagename`）。 - -レジストリのホスト名を指定しない場合は、KubernetesはDockerパブリックレジストリを意味していると見なします。 - -イメージ名の後に、_タグ_ を追加することができます（`docker`や`podman`のようなコマンドを利用した場合と同様）。 -タグによって同じイメージの異なるバージョンを識別できます。 - -イメージタグは大文字と小文字、数値、アンダースコア(`_`)、ピリオド(`.`)とマイナス(`-`)で構成されます。 -イメージタグでは区切り記号(`_`、`-`、`.`)を指定できる追加ルールがあります。 -タグを指定しない場合は、Kubernetesは`latest`タグを指定したと見なします。 - -{{< caution >}} -本番環境でコンテナをデプロイする場合は、`latest`タグの使用を避けるべきです。 -実行中のイメージのバージョンを追跡するのが難しく、機能しているバージョンへのロールバックがより困難になるためです。 - -かわりに、`v1.42.0`のような特定できるタグを指定してください。 -{{< /caution >}} - - -## イメージの更新 - -デフォルトのpull policyでは、{{< glossary_tooltip text="kubelet" term_id="kubelet" >}}はイメージを既に取得済みの場合、イメージのPullをスキップさせる`IfNotPresent`が設定されています。 -常にPullを強制させたい場合は、次のいずれかの方法で実行できます。 - -- コンテナの`imagePullPolicy`に`Always`を設定する -- `imagePullPolicy`を省略し、使用するイメージに`:latest`タグを使用する -- `imagePullPolicy`と使用するイメージのタグを省略する -- [AlwaysPullImages](/docs/reference/access-authn-authz/admission-controllers/#alwayspullimages)アドミッションコントローラーを有効にする - -`imagePullPolicy`が値なしで定義された場合、この場合も`Always`が設定されます。 - -## マニフェストを使ったマルチアーキテクチャイメージ - -コンテナレジストリはバイナリイメージの提供だけでなく、[コンテナイメージマニフェスト](https://github.com/opencontainers/image-spec/blob/master/manifest.md)も提供する事ができます。 -マニフェストはコンテナのアーキテクチャ固有バージョンに関するイメージマニフェストを参照できます。マニフェストの目的はイメージの名前(例:`pause`、`example/mycontainer`、`kube-apiserver`)をもたせ、様々なシステムが使用しているマシンアーキテクチャにあう適切なバイナリイメージを取得できることです。 - -Kubernetes自身は、通常コンテナイメージに`-$(ARCH)`のサフィックスを持つ名前をつけます。下位互換の為にサフィックス付きの古い仕様のイメージを生成してください。その目的は、`pause`のようなすべてのアーキテクチャのマニフェストを持つイメージと、サフィックスのあるイメージをハードコードしていた可能性のある古い仕様の設定やYAMLファイルと下位互換がある`pause-amd64`のようなイメージを生成することです。 - -## プライベートレジストリを使用する方法 - -プライベートレジストリではイメージを読み込む為にキーが必要になる場合があります。 -認証情報はいくつかの方法で提供できます。 - - - プライベートレジストリへの認証をNodeに設定する - - すべてのPodがプライベートレジストリを読み取ることができる - - クラスター管理者によるNodeの設定が必要 - - 事前にPullされたイメージ - - すべてのPodがNode上にキャッシュされたイメージを利用できる - - セットアップするためにはすべてのNodeに対するrootアクセスが必要 - - PodでImagePullSecretsを指定する - - キーを提供したPodのみがプライベートレジストリへアクセスできる - - ベンダー固有またはローカルエクステンション - - カスタムNode構成を使っている場合、あなた(または、あなたのクラウドプロバイダー)はコンテナレジストリへの認証の仕組みを組み込むことができる - -これらのオプションについて、以下で詳しく説明します。 - -### プライベートレジストリへの認証をNodeに設定する - -Node上でDockerを実行している場合、プライベートコンテナレジストリへの認証をDockerコンテナランタイムに設定できます。 - -Node構成を制御できる場合は、この方法が適しています。 - -{{< note >}} -KubernetesはDocker構成の`auths`と`HttpHeaders`セクションのみをサポートしています。 -Docker認証情報ヘルパー(`credHelpers`または`credsStore`)はサポートされていません。 -{{< /note >}} - - -Dockerは、`$HOME/.dockercfg`または`$HOME/.docker/config.json`ファイルの中に、プライベートレジストリのキーを保持します。 -下記リストの検索パスに同じファイルを配置した場合、kubeletはイメージをPullする時に認証情報プロバイダーとして利用します。 - - -* `{--root-dir:-/var/lib/kubelet}/config.json` -* `{cwd of kubelet}/config.json` -* `${HOME}/.docker/config.json` -* `/.docker/config.json` -* `{--root-dir:-/var/lib/kubelet}/.dockercfg` -* `{cwd of kubelet}/.dockercfg` -* `${HOME}/.dockercfg` -* `/.dockercfg` - -{{< note >}} -kubeletプロセスの環境では、明示的に`HOME=/root`を設定する必要がある場合があります。 -{{< /note >}} - -以下は、プライベートレジストリを使用する為にNodeを構成する推奨の手順です。この例では、デスクトップ/ノートPC上で実行します。 - - 1. 使用したい認証情報のセット毎に `docker login [server]`を実行する。これであなたのPC上の`$HOME/.docker/config.json`が更新される - 1. 使用したい認証情報が含まれているかを確認するため、エディターで`$HOME/.docker/config.json`を見る - 1. Nodeの一覧を取得 例: - - 名称が必要な場合: `nodes=$( kubectl get nodes -o jsonpath='{range.items[*].metadata}{.name} {end}' )` - - IPアドレスを取得したい場合: `nodes=$( kubectl get nodes -o jsonpath='{range .items[*].status.addresses[?(@.type=="ExternalIP")]}{.address} {end}' )` - 1. ローカルの`.docker/config.json`を上記の検索パスのいずれかにコピーする - - 例えば、これでテストを実施する: `for n in $nodes; do scp ~/.docker/config.json root@"$n":/var/lib/kubelet/config.json; done` - -{{< note >}} -本番環境用クラスターでは、構成管理ツールを使用して必要なすべてのNodeに設定を反映してください。 -{{< /note >}} - -プライベートイメージを使用するPodを作成し確認します。 -例: - -```shell -kubectl apply -f - <}} -Node構成を制御できる場合、この方法が適しています。 -クラウドプロバイダーがNodeを管理し自動的に設定を置き換える場合は、確実に機能できません。 -{{< /note >}} - -デフォルトでは、kubeletは指定されたレジストリからそれぞれのイメージをPullしようとします。 -また一方では、コンテナの`imagePullPolicy`プロパティに`IfNotPresent`や`Never`が設定されている場合、ローカルのイメージが使用されます。(それぞれに対して、優先的またはか排他的に) - -レジストリ認証の代替として事前にPullしたイメージを利用したい場合、クラスターのすべてのNodeが同じ事前にPullしたイメージを持っていることを確認する必要があります。 - -特定のイメージをあらかじめロードしておくことは高速化やプライベートレジストリへの認証の代替として利用することができます。 - -すべてのPodは事前にPullしたイメージへの読み取りアクセス権をもちます。 - -### PodでImagePullSecretsを指定する - -{{< note >}} -この方法がプライベートレジストリのイメージに基づいてコンテナを実行するための推奨の方法です。 -{{< /note >}} - -KubernetesはPodでのコンテナイメージレジストリキーの指定をサポートしています。 - -#### Docker Configを利用してSecretを作成する。 - -適切な大文字の値を置き換えて、次のコマンドを実行します。 - -```shell -kubectl create secret docker-registry --docker-server=DOCKER_REGISTRY_SERVER --docker-username=DOCKER_USER --docker-password=DOCKER_PASSWORD --docker-email=DOCKER_EMAIL -``` - -既にDocker認証情報ファイルを持っている場合は、上記のコマンドの代わりに、認証情報ファイルをKubernetes {{< glossary_tooltip text="Secrets" term_id="secret" >}}としてインポートすることができます。 -[既存のDocker認証情報に基づいてSecretを作成する](/docs/tasks/configure-pod-container/pull-image-private-registry/#registry-secret-existing-credentials) で、この設定方法を説明します. - -これは複数のプライベートコンテナレジストリを使用している場合に特に有効です。`kubectl create secret docker-registry`はひとつのプライベートレジストリにのみ機能するSecretを作成するからです。 - -{{< note >}} -Podは自分自身のNamespace内にあるimage pull secretsのみが参照可能であるため、この作業はNemespace毎に1回行う必要があります。 -{{< /note >}} - -#### PodのimagePullSecretsを参照する方法 - -これで、`imagePullSecrets`セクションをPod定義へ追加することでSecretを参照するPodを作成できます。 - -例: - -```shell -cat < pod.yaml -apiVersion: v1 -kind: Pod -metadata: - name: foo - namespace: awesomeapps -spec: - containers: - - name: foo - image: janedoe/awesomeapp:v1 - imagePullSecrets: - - name: myregistrykey -EOF - -cat <> ./kustomization.yaml -resources: -- pod.yaml -EOF -``` - -これは、プライベートレジストリを使用する各Podで行う必要があります。 - -ただし、この項目の設定は[ServiceAccount](/docs/tasks/configure-pod-container/configure-service-account/)リソースの中でimagePullSecretsを指定することで自動化することができます。 - -詳細の手順は、[ImagePullSecretsをService Accountに追加する](/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account)をクリックしてください。 - -これを各Nodeの`.docker/config.json`に組み合わせて利用できます。認証情報はマージされます。 - -## ユースケース - -プライベートレジストリを設定するためのソリューションはいくつかあります。ここでは、いくつかの一般的なユースケースと推奨される解決方法を示します。 - -1. クラスターに独自仕様でない(例えば、オープンソース)イメージだけを実行する。イメージを非公開にする必要がない - - Docker hubのパブリックイメージを利用する - - 設定は必要ない - - クラウドプロバイダーによっては、可用性の向上とイメージをPullする時間を短くする為に、自動的にキャッシュやミラーされたパプリックイメージが提供される -1. 社外には非公開の必要があるが、すべてのクラスター利用者には見せてよい独自仕様のイメージをクラスターで実行している - - ホストされたプライペートな [Dockerレジストリ](https://docs.docker.com/registry/)を使用 - - [Docker Hub](https://hub.docker.com/signup)または他の場所の上でホストされている場合がある - - 上記のように各Node上のdocker/config.jsonを手動で構成する - - または、オープンな読み取りアクセスを許可したファイヤーウォールの背後で内部向けプライベートレジストリを実行する - - Kubernetesの設定は必要ない - - イメージへのアクセスを制御できるホストされたコンテナイメージレジストリサービスを利用する - - Nodeを手動設定するよりもクラスターのオートスケーリングのほうがうまく機能する - - また、Node設定変更を自由にできないクラスターでは`imagePullSecrets`を使用する -1. 独自仕様のイメージを含むクラスターで、いくつかは厳格なアクセス制御が必要である - - [AlwaysPullImagesアドミッションコントローラー](/docs/reference/access-authn-authz/admission-controllers/#alwayspullimages)が有効化かを確認する必要がある。さもないと、全部のPodがすべてのイメージへのアクセスができてしまう可能性がある - - 機密データはイメージに含めてしまうのではなく、"Secret"リソースに移行する -1. それぞれのテナントが独自のプライベートレジストリを必要とするマルチテナントのクラスターである - - [AlwaysPullImagesアドミッションコントローラー](/docs/reference/access-authn-authz/admission-controllers/#alwayspullimages)が有効化を確認する必要がある。さもないと、すべてのテナントの全Podが全部のイメージにアクセスできてしまう可能性がある - - 認証が必要なプライベートレジストリを実行する - - それぞれのテナントでレジストリ認証を生成し、Secretへ設定し、各テナントのNamespaceに追加する - - テナントは、Secretを各NamespaceのimagePullSecretsへ追加する - -複数のレジストリへのアクセスが必要な場合、それぞれのレジストリ毎にひとつのSecretを作成する事ができます。 -Kubeletは複数の`imagePullSecrets`を単一の仮想的な`.docker/config.json`にマージします。 - -## {{% heading "whatsnext" %}} - -* [OCI Image Manifest Specification](https://github.com/opencontainers/image-spec/blob/master/manifest.md)を読みます。 diff --git a/content/ja/docs/concepts/security/overview.md b/content/ja/docs/concepts/security/overview.md deleted file mode 100644 index b50a4ea1a5..0000000000 --- a/content/ja/docs/concepts/security/overview.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -reviewers: -title: クラウドネイティブセキュリティの概要 -content_type: concept -weight: 10 ---- - - - -この概要では、クラウドネイティブセキュリティにおけるKubernetesのセキュリティを考えるためのモデルを定義します。 - -{{< warning >}} -コンテナセキュリティモデルは、実証済の情報セキュリティポリシーではなく提案を提供します。 -{{< /warning >}} - - - -## クラウドネイティブセキュリティの４C - -セキュリティは階層で考えることができます。クラウドネイティブの4Cは、クラウド、クラスター、コンテナ、そしてコードです。 - -{{< note >}} -階層化されたアプローチは、セキュリティに対する[多層防御](https://en.wikipedia.org/wiki/Defense_in_depth_(computing))のアプローチを強化します。これはソフトウェアシステムを保護するベストプラクティスとして幅広く認知されています。 -{{< /note >}} - -{{< figure src="/images/docs/4c.png" title="クラウドネイティブセキュリティの４C" >}} - -クラウドネイティブセキュリティモデルの各レイヤーは次の最も外側のレイヤー上に構築します。コードレイヤーは、強固な基盤(クラウド、クラスター、コンテナ)セキュリティレイヤーから恩恵を受けます。コードレベルのセキュリティに対応しても基盤レイヤーが低い水準のセキュリティでは守ることができません。 - -## クラウド - -いろいろな意味でも、クラウド(または同じ場所に設置されたサーバー、企業のデータセンター)はKubernetesクラスターの[トラステッド・コンピューティング・ベース](https://en.wikipedia.org/wiki/Trusted_computing_base)です。クラウドレイヤーが脆弱な(または脆弱な方法で構成されている)場合、この基盤の上に構築されたコンポーネントが安全であるという保証はありません。各クラウドプロバイダーは、それぞれの環境でワークロードを安全に実行させるためのセキュリティの推奨事項を作成しています。 - -### クラウドプロバイダーのセキュリティ - -Kubernetesクラスターを所有しているハードウェアや様々なクラウドプロバイダー上で実行している場合、セキュリティのベストプラクティスに関するドキュメントを参考にしてください。ここでは人気のあるクラウドプロバイダーのセキュリティドキュメントの一部のリンクを紹介します。 - -{{< table caption="Cloud provider security" >}} - -IaaSプロバイダー | リンク | --------------------- | ------------ | -Alibaba Cloud | https://www.alibabacloud.com/trust-center | -Amazon Web Services | https://aws.amazon.com/security/ | -Google Cloud Platform | https://cloud.google.com/security/ | -IBM Cloud | https://www.ibm.com/cloud/security | -Microsoft Azure | https://docs.microsoft.com/en-us/azure/security/azure-security | -VMWare VSphere | https://www.vmware.com/security/hardening-guides.html | - -{{< /table >}} - -### インフラのセキュリティ {#infrastructure-security} - -Kubernetesクラスターのインフラを保護するための提案です。 - -{{< table caption="Infrastructure security" >}} - -Kubernetesインフラに関する懸念事項 | 推奨事項 | ---------------------------------------------- | -------------- | -API Server(コントロールプレーン)へのネットワークアクセス| Kubernetesコントロールプレーンへのすべてのアクセスは、インターネット上での一般公開は許されず、クラスター管理に必要なIPアドレスに制限するネットワークアクセス制御リストによって制御されます。| -Nodeへのネットワークアクセス | Nodeはコントロールプレーンの特定ポート _のみ_ 接続(ネットワークアクセス制御リストを介して)を受け入れるよう設定し、NodePortとLoadBalancerタイプのKubernetesのServiceに関する接続を受け入れるよう設定する必要があります。可能であれば、それらのNodeはパブリックなインターネットに完全公開しないでください。| -KubernetesからのクラウドプロバイダーAPIへのアクセス | 各クラウドプロバイダーはKubernetesコントロールプレーンとNodeに異なる権限を与える必要があります。[最小権限の原則](https://en.wikipedia.org/wiki/Principle_of_least_privilege)に従い、管理に必要なリソースに対してクラウドプロバイダーへのアクセスをクラスターに提供するのが最善です。[Kopsドキュメント](https://github.com/kubernetes/kops/blob/master/docs/iam_roles.md#iam-roles)にはIAMのポリシーとロールについての情報が記載されています。| -etcdへのアクセス | etcd(Kubernetesのデータストア)へのアクセスはコントロールプレーンのみに制限すべきです。設定によっては、TLS経由でetcdを利用する必要があります。詳細な情報は[etcdドキュメント](https://github.com/etcd-io/etcd/tree/master/Documentation)を参照してください。| -etcdの暗号化 | 可能な限り、保存時に全ドライブを暗号化することは良いプラクティスですが、etcdはクラスター全体(Secretを含む)の状態を保持しているため、そのディスクは特に暗号化する必要があります。| - -{{< /table >}} - -## クラスター - -Kubernetesを保護する為には２つの懸念事項があります。 - -* 設定可能なクラスターコンポーネントの保護 -* クラスターで実行されるアプリケーションの保護 - -### クラスターのコンポーネント {#cluster-components} - -想定外または悪意のあるアクセスからクラスターを保護して適切なプラクティスを採用したい場合、[クラスターの保護](/docs/tasks/administer-cluster/securing-a-cluster/)に関するアドバイスを読み従ってください。 - -### クラスター内のコンポーネント(アプリケーション) {#cluster-applications} - -アプリケーションを対象にした攻撃に応じて、セキュリティの特定側面に焦点をあてたい場合があります。例:他のリソースとの連携で重要なサービス(サービスA)と、リソース枯渇攻撃に対して脆弱な別のワークロード(サービスB)が実行されている場合、サービスBのリソースを制限していないとサービスAが危険にさらされるリスクが高くなります。次の表はセキュリティの懸念事項とKubernetesで実行されるワークロードを保護するための推奨事項を示しています。 - - -ワークロードセキュリティに関する懸念事項 | 推奨事項 | ------------------------------- | --------------------- | -RBAC認可(Kubernetes APIへのアクセス) | https://kubernetes.io/docs/reference/access-authn-authz/rbac/ -認証 | https://kubernetes.io/docs/reference/access-authn-authz/controlling-access/ | -アプリケーションのSecret管理(およびetcdへの保存時に暗号化) | https://kubernetes.io/ja/docs/concepts/configuration/secret/
https://kubernetes.io/docs/tasks/administer-cluster/encrypt-data/ | -PodSecurityPolicy | https://kubernetes.io/docs/concepts/policy/pod-security-policy/ | -Quality of Service (およびクラスターリソース管理) | https://kubernetes.io/ja/docs/tasks/configure-pod-container/quality-service-pod/ | -NetworkPolicy | https://kubernetes.io/docs/concepts/services-networking/network-policies/ | -Kubernetes IngressのTLS | https://kubernetes.io/ja/docs/concepts/services-networking/ingress/#tls | - - -## コンテナ - -コンテナセキュリティは本ガイドの範囲外になります。このトピックを検索するために一般的な推奨事項とリンクを以下に示します。 - -コンテナに関する懸念事項 | 推奨事項 | ------------------------------- | -------------- | -コンテナの脆弱性スキャンとOS依存のセキュリティ | イメージをビルドする手順の一部として、既知の脆弱性がないかコンテナをスキャンする必要があります。 | -イメージの署名と実施 | コンテナイメージを署名し、コンテナの中身に関する信頼性を維持します。 | -特権ユーザーを許可しない | コンテナの構成時に、コンテナの目的を実行するために必要最低限なOS特権を持ったユーザーをコンテナ内部に作成する方法のドキュメントを参考にしてください。 | - -## コード - -アプリケーションコードは、あなたが最も制御できる主要な攻撃対象のひとつです。アプリケーションコードを保護することはKubernetesのセキュリティトピックの範囲外ですが、アプリケーションコードを保護するための推奨事項を以下に示します。 - -### コードセキュリティ - -{{< table caption="Code security" >}} - -コードに関する懸念事項 | 推奨事項 | --------------------------| -------------- | -TLS経由のアクセスのみ | コードがTCP通信を必要とする場合は、事前にクライアントとのTLSハンドシェイクを実行してください。 いくつかの例外を除いて、全ての通信を暗号化してください。さらに一歩すすめて、サービス間のネットワークトラフィックを暗号化することはよい考えです。これは、サービスを特定した2つの証明書で通信の両端を検証する相互認証、または[mTLS](https://en.wikipedia.org/wiki/Mutual_authentication)して知られているプロセスを通じて実行できます。| -通信ポートの範囲制限 | この推奨事項は一目瞭然かもしれませんが、可能なかぎり、通信とメトリクス収集に必要不可欠なサービスのポートのみを公開します。 | -サードパティに依存するセキュリティ | 既知の脆弱性についてアプリケーションのサードパーティ製ライブラリーを定期的にスキャンすることを推奨します。それぞれの言語は自動でこのチェックを実行するツールを持っています。 | -静的コード解析 | ほとんどの言語ではコードのスニペットを解析して、安全でない可能性のあるコーディングを分析する方法が提供しています。可能な限り、コードベースでスキャンして、よく起こるセキュリティエラーを検出できる自動ツールを使用してチェックを実行すべきです。一部のツールはここで紹介されています。 https://owasp.org/www-community/Source_Code_Analysis_Tools | -動的プロービング攻撃 | よく知られているいくつかのサービス攻撃をサービスに対して試すことができる自動ツールがいくつかあります。これにはSQLインジェクション、CSRF、そしてXSSが含まれます。よく知られている動的解析ツールは[OWASP Zed Attack proxy](https://owasp.org/www-project-zap/)toolです。 | - -{{< /table >}} - -## {{% heading "whatsnext" %}} - -関連するKubernetesセキュリティについて学びます。 - -* [Podのセキュリティ基準](/docs/concepts/security/pod-security-standards/) -* [PodのNetworkPolicy](/docs/concepts/services-networking/network-policies/) -* [クラスターの保護](/docs/tasks/administer-cluster/securing-a-cluster/) -* [APIアクセスコントロール](/docs/reference/access-authn-authz/controlling-access/) -* コントロールプレーンとの[通信時のデータ暗号化](/docs/tasks/tls/managing-tls-in-a-cluster/) -* [保存時のデータ暗号化](/docs/tasks/administer-cluster/encrypt-data/) -* [Kubernetes Secret](/ja/docs/concepts/configuration/secret/) diff --git a/content/ja/docs/concepts/storage/storage-capacity.md b/content/ja/docs/concepts/storage/storage-capacity.md deleted file mode 100644 index 7e2f6c34f7..0000000000 --- a/content/ja/docs/concepts/storage/storage-capacity.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: ストレージ容量 -content_type: concept -weight: 45 ---- - - - -ストレージ容量は、Podが実行されるノードごとに制限があったり、大きさが異なる可能性があります。たとえば、NASがすべてのノードからはアクセスできなかったり、初めからストレージがノードローカルでしか利用できない可能性があります。 - -{{< feature-state for_k8s_version="v1.19" state="alpha" >}} - -このページでは、Kubernetesがストレージ容量を追跡し続ける方法と、スケジューラーがその情報を利用して、残りの未作成のボリュームのために十分なストレージ容量へアクセスできるノード上にどのようにPodをスケジューリングするかについて説明します。もしストレージ容量の追跡がなければ、スケジューラーは、ボリュームをプロビジョニングするために十分な容量のないノードを選択してしまい、スケジューリングの再試行が複数回行われてしまう恐れがあります。 - -ストレージ容量の追跡は、{{< glossary_tooltip text="Container Storage Interface" term_id="csi" >}}(CSI)向けにサポートされており、CSIドライバーのインストール時に[有効にする必要があります](#enabling-storage-capacity-tracking)。 - - - -## API - -この機能には、以下の2つのAPI拡張があります。 - -- [CSIStorageCapacity](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#csistoragecapacity-v1alpha1-storage-k8s-io)オブジェクト: このオブジェクトは、CSIドライバーがインストールされた名前空間に生成されます。各オブジェクトには1つのストレージクラスに対する容量の情報が含まれ、そのストレージに対してどのノードがアクセス権を持つかが定められています。 - -- [`CSIDriverSpec.StorageCapacity`フィールド](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#csidriverspec-v1-storage-k8s-io): `true`に設定すると、Kubernetesのスケジューラーが、CSIドライバーを使用するボリュームに対してストレージ容量を考慮するようになります。 - -## スケジューリング - -ストレージ容量の情報がKubernetesのスケジューラーで利用されるのは、以下のすべての条件を満たす場合です。 - -- `CSIStorageCapacity`フィーチャーゲートがtrueである -- Podがまだ作成されていないボリュームを使用する時 -- そのボリュームが、CSIドライバーを参照し、[volume binding mode](/docs/concepts/storage/storage-classes/#volume-binding-mode)に`WaitForFirstConsumer`を使う{{< glossary_tooltip text="StorageClass" term_id="storage-class" >}}を使用している -- ドライバーに対する`CSIDriver`オブジェクトの`StorageCapacity`がtrueに設定されている - -その場合、スケジューラーはPodに対して、十分なストレージ容量が利用できるノードだけを考慮するようになります。このチェックは非常に単純で、ボリュームのサイズと、`CSIStorageCapacity`オブジェクトに一覧された容量を、ノードを含むトポロジーで比較するだけです。 - -volume binding modeが`Immediate`のボリュームの場合、ストレージドライバーはボリュームを使用するPodとは関係なく、ボリュームを作成する場所を決定します。次に、スケジューラーはボリュームが作成された後、Podをボリュームが利用できるノードにスケジューリングします。 - -[CSI ephemeral volumes](/docs/concepts/storage/volumes/#csi)の場合、スケジューリングは常にストレージ容量を考慮せずに行われます。このような動作になっているのは、このボリュームタイプはノードローカルな特別なCSIドライバーでのみ使用され、そこでは特に大きなリソースが必要になることはない、という想定に基づいています。 - -## 再スケジューリング - -`WaitForFirstConsumer`ボリュームがあるPodに対してノードが選択された場合は、その決定はまだ一時的なものです。次のステップで、CSIストレージドライバーに対して、選択されたノード上でボリュームが利用可能になることが予定されているというヒントを使用してボリュームの作成を要求します。 - -Kubernetesは古い容量の情報をもとにノードを選択する場合があるため、実際にはボリュームが作成できないという可能性が存在します。その場合、ノードの選択がリセットされ、KubernetesスケジューラーはPodに割り当てるノードを再び探します。 - -## 制限 - -ストレージ容量を追跡することで、1回目の試行でスケジューリングが成功する可能性が高くなります。しかし、スケジューラーは潜在的に古い情報に基づいて決定を行う可能性があるため、成功を保証することはできません。通常、ストレージ容量の情報が存在しないスケジューリングと同様のリトライの仕組みによって、スケジューリングの失敗に対処します。 - -スケジューリングが永続的に失敗する状況の1つは、Podが複数のボリュームを使用する場合で、あるトポロジーのセグメントで1つのボリュームがすでに作成された後、もう1つのボリュームのために十分な容量が残っていないような場合です。この状況から回復するには、たとえば、容量を増加させたり、すでに作成されたボリュームを削除するなどの手動での対応が必要です。この問題に自動的に対処するためには、まだ[追加の作業](https://github.com/kubernetes/enhancements/pull/1703)が必要となっています。 - -## ストレージ容量の追跡を有効にする {#enabling-storage-capacity-tracking} - -ストレージ容量の追跡は*アルファ機能*であり、`CSIStorageCapacity`[フィーチャーゲート](/ja/docs/reference/command-line-tools-reference/feature-gates/)と`storage.k8s.io/v1alpha1` {{< glossary_tooltip text="API group" term_id="api-group" >}}を有効にした場合にのみ、有効化されます。詳細については、`--feature-gates`および`--runtime-config` [kube-apiserverパラメータ](/docs/reference/command-line-tools-reference/kube-apiserver/)を参照してください。 - -Kubernetesクラスターがこの機能をサポートしているか簡単に確認するには、以下のコマンドを実行して、CSIStorageCapacityオブジェクトを一覧表示します。 - -```shell -kubectl get csistoragecapacities --all-namespaces -``` - -クラスターがCSIStorageCapacityをサポートしていれば、CSIStorageCapacityのリストが表示されるか、次のメッセージが表示されます。 -``` -No resources found -``` - -もしサポートされていなければ、代わりに次のエラーが表示されます。 - -``` -error: the server doesn't have a resource type "csistoragecapacities" -``` - -クラスター内で機能を有効化することに加えて、CSIドライバーもこの機能をサポートしている必要があります。詳細については、各ドライバーのドキュメントを参照してください。 - -## {{% heading "whatsnext" %}} - - - 設計に関するさらなる情報について知るために、[Storage Capacity Constraints for Pod Scheduling KEP](https://github.com/kubernetes/enhancements/blob/master/keps/sig-storage/1472-storage-capacity-tracking/README.md)を読む。 -- この機能の今後の開発に関する情報について知るために、[enhancement tracking issue #1472](https://github.com/kubernetes/enhancements/issues/1472)を参照する。 -- [Kubernetesのスケジューラー](/ja/docs/concepts/scheduling-eviction/kube-scheduler/)についてもっと学ぶ。 diff --git a/content/ja/docs/concepts/workloads/pods/ephemeral-containers.md b/content/ja/docs/concepts/workloads/pods/ephemeral-containers.md deleted file mode 100644 index 0fa45de94b..0000000000 --- a/content/ja/docs/concepts/workloads/pods/ephemeral-containers.md +++ /dev/null @@ -1,147 +0,0 @@ ---- -title: エフェメラルコンテナ -content_type: concept -weight: 80 ---- - - - -{{< feature-state state="alpha" for_k8s_version="v1.16" >}} - -このページでは、特別な種類のコンテナであるエフェメラルコンテナの概要を説明します。エフェメラルコンテナは、トラブルシューティングなどのユーザーが開始するアクションを実行するために、すでに存在する{{< glossary_tooltip term_id="pod" >}}内で一時的に実行するコンテナです。エフェメラルコンテナは、アプリケーションの構築ではなく、serviceの調査のために利用します。 - -{{< warning >}} -エフェメラルコンテナは初期のアルファ状態であり、本番クラスタには適しません。[Kubernetesの非推奨ポリシー](/docs/reference/using-api/deprecation-policy/)に従って、このアルファ機能は、将来大きく変更されたり、完全に削除される可能性があります。 -{{< /warning >}} - - - -## エフェメラルコンテナを理解する - -{{< glossary_tooltip text="Pod" term_id="pod" >}}は、Kubernetesのアプリケーションの基本的なビルディングブロックです。Podは破棄可能かつ置き換え可能であることが想定されているため、一度Podが作成されると新しいコンテナを追加することはできません。その代わりに、通常は{{< glossary_tooltip text="Deployment" term_id="deployment" >}}を使用してPodを削除して置き換えます。 - -たとえば、再現困難なバグのトラブルシューティングなどのために、すでに存在するPodの状態を調査する必要が出てくることがあります。このような場合、既存のPod内でエフェメラルコンテナを実行することで、Podの状態を調査したり、任意のコマンドを実行したりできます。 - -### エフェメラルコンテナとは何か？ - -エフェメラルコンテナは、他のコンテナと異なり、リソースや実行が保証されず、自動的に再起動されることも決してないため、アプリケーションを構築する目的には適しません。エフェメラルコンテナは、通常のコンテナと同じ`ContainerSpec`で記述されますが、多くのフィールドに互換性がなかったり、使用できなくなっています。 - -- エフェメラルコンテナはポートを持つことができないため、`ports`、`livenessProbe`、`readinessProbe`などは使えなくなっています。 -- Podリソースの割り当てはイミュータブルであるため、`resources`の設定が禁止されています。 -- 利用が許可されているフィールドの一覧については、[EphemeralContainerのリファレンスドキュメント](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#ephemeralcontainer-v1-core)を参照してください。 - -エフェメラルコンテナは、直接`pod.spec`に追加するのではなく、API内の特別な`ephemeralcontainers`ハンドラを使用して作成します。そのため、エフェメラルコンテナを`kubectl edit`を使用して追加することはできません。 - -エフェメラルコンテナをPodに追加した後は、通常のコンテナのようにエフェメラルコンテナを変更または削除することはできません。 - -## エフェメラルコンテナの用途 - -エフェメラルコンテナは、コンテナがクラッシュしてしまったり、コンテナイメージにデバッグ用ユーティリティが同梱されていない場合など、`kubectl exec`では不十分なときにインタラクティブなトラブルシューティングを行うために役立ちます。 - -特に、[distrolessイメージ](https://github.com/GoogleContainerTools/distroless)を利用すると、攻撃対象領域を減らし、バグや脆弱性を露出する可能性を減らせる最小のコンテナイメージをデプロイできるようになります。distrolessイメージにはシェルもデバッグ用のユーティリティも含まれないため、`kubectl exec`のみを使用してdistrolessイメージのトラブルシューティングを行うのは困難です。 - -エフェメラルコンテナを利用する場合には、他のコンテナ内のプロセスにアクセスできるように、[プロセス名前空間の共有](/ja/docs/tasks/configure-pod-container/share-process-namespace/)を有効にすると便利です。 - -エフェメラルコンテナを利用してトラブルシューティングを行う例については、[デバッグ用のエフェメラルコンテナを使用してデバッグする](/docs/tasks/debug-application-cluster/debug-running-pod/#debugging-with-ephemeral-debug-container)を参照してください。 - -## Ephemeral containers API - -{{< note >}} -このセクションの例を実行するには、`EphemeralContainers`[フィーチャーゲート](/ja/docs/reference/command-line-tools-reference/feature-gates/)を有効にして、Kubernetesクライアントとサーバーのバージョンをv1.16以上にする必要があります。 -{{< /note >}} - -このセクションの例では、API内でエフェメラルコンテナを表示する方法を示します。通常は、APIを直接呼び出すのではなく、`kubectl alpha debug`やその他の`kubectl`[プラグイン](/docs/tasks/extend-kubectl/kubectl-plugins/)を使用して、これらのステップを自動化します。 - -エフェメラルコンテナは、Podの`ephemeralcontainers`サブリソースを使用して作成されます。このサブリソースは、`kubectl --raw`を使用して確認できます。まずはじめに、以下に`EphemeralContainers`リストとして追加するためのエフェメラルコンテナを示します。 - -```json -{ - "apiVersion": "v1", - "kind": "EphemeralContainers", - "metadata": { - "name": "example-pod" - }, - "ephemeralContainers": [{ - "command": [ - "sh" - ], - "image": "busybox", - "imagePullPolicy": "IfNotPresent", - "name": "debugger", - "stdin": true, - "tty": true, - "terminationMessagePolicy": "File" - }] -} -``` - -すでに実行中の`example-pod`のエフェメラルコンテナを更新するには、次のコマンドを実行します。 - -```shell -kubectl replace --raw /api/v1/namespaces/default/pods/example-pod/ephemeralcontainers -f ec.json -``` - -このコマンドを実行すると、新しいエフェメラルコンテナのリストが返されます。 - -```json -{ - "kind":"EphemeralContainers", - "apiVersion":"v1", - "metadata":{ - "name":"example-pod", - "namespace":"default", - "selfLink":"/api/v1/namespaces/default/pods/example-pod/ephemeralcontainers", - "uid":"a14a6d9b-62f2-4119-9d8e-e2ed6bc3a47c", - "resourceVersion":"15886", - "creationTimestamp":"2019-08-29T06:41:42Z" - }, - "ephemeralContainers":[ - { - "name":"debugger", - "image":"busybox", - "command":[ - "sh" - ], - "resources":{ - - }, - "terminationMessagePolicy":"File", - "imagePullPolicy":"IfNotPresent", - "stdin":true, - "tty":true - } - ] -} -``` - -新しく作成されたエフェメラルコンテナの状態を確認するには、`kubectl describe`を使用します。 - -```shell -kubectl describe pod example-pod -``` - -``` -... -Ephemeral Containers: - debugger: - Container ID: docker://cf81908f149e7e9213d3c3644eda55c72efaff67652a2685c1146f0ce151e80f - Image: busybox - Image ID: docker-pullable://busybox@sha256:9f1003c480699be56815db0f8146ad2e22efea85129b5b5983d0e0fb52d9ab70 - Port: - Host Port: - Command: - sh - State: Running - Started: Thu, 29 Aug 2019 06:42:21 +0000 - Ready: False - Restart Count: 0 - Environment: - Mounts: -... -``` - -新しいエフェメラルコンテナとやりとりをするには、他のコンテナと同じように、`kubectl attach`、`kubectl exec`、`kubectl logs`などのコマンドが利用できます。例えば、次のようなコマンドが実行できます。 - -```shell -kubectl attach -it example-pod -c debugger -```