Merge pull request #30529 from ptux/tasks/inject-data-application/distribute-credentials-secure

[ja] Translate tasks/inject-data-application/distribute-credentials-secure into Japanese

Author: k8s-ci-robot

content/ja/docs/tasks/inject-data-application/distribute-credentials-secure.md

@@ -0,0 +1,257 @@
+---
+title: Secretsで安全にクレデンシャルを配布する
+content_type: task
+weight: 50
+min-kubernetes-server-version: v1.6
+---
+
+<!-- overview -->
+このページでは、パスワードや暗号化キーなどの機密データをPodに安全に注入する方法を紹介します。
+
+## {{% heading "prerequisites" %}}
+
+
+{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
+
+### 機密データをbase64でエンコードする
+
+ユーザー名`my-app`とパスワード`39528$vdg7Jb`の2つの機密データが必要だとします。
+まず、base64エンコーディングツールを使って、ユーザ名とパスワードをbase64表現に変換します。
+ここでは、手軽に入手できるbase64プログラムを使った例を紹介します:
+
+```shell
+echo -n 'my-app' | base64
+echo -n '39528$vdg7Jb' | base64
+```
+
+出力結果によると、ユーザ名のbase64表現は`bXktYXBw`で、パスワードのbase64表現は`Mzk1MjgkdmRnN0pi`です。
+
+{{< caution >}}
+OSから信頼されているローカルツールを使用することで、外部ツールのセキュリティリスクを低減することができます。
+{{< /caution >}}
+
+
+<!-- steps -->
+
+## Secretを作成する
+
+以下はユーザー名とパスワードを保持するSecretを作成するために使用できる設定ファイルです:
+
+{{< codenew file="pods/inject/secret.yaml" >}}
+
+1. Secret を作成する
+
+    ```shell
+    kubectl apply -f https://k8s.io/examples/pods/inject/secret.yaml
+    ```
+
+1. Secretの情報を取得する
+
+    ```shell
+    kubectl get secret test-secret
+    ```
+
+    出力:
+
+    ```
+    NAME          TYPE      DATA      AGE
+    test-secret   Opaque    2         1m
+    ```
+
+1. Secretの詳細な情報を取得する:
+
+    ```shell
+    kubectl describe secret test-secret
+    ```
+
+    出力:
+
+    ```
+    Name:       test-secret
+    Namespace:  default
+    Labels:     <none>
+    Annotations:    <none>
+
+    Type:   Opaque
+
+    Data
+    ====
+    password:   13 bytes
+    username:   7 bytes
+    ```
+
+### kubectlでSecretを作成する
+
+base64エンコードの手順を省略したい場合は、`kubectl create secret`コマンドで同じSecretを作成することができます。
+
+例えば:
+
+```shell
+kubectl create secret generic test-secret --from-literal='username=my-app' --from-literal='password=39528$vdg7Jb'
+```
+
+先ほどの詳細なアプローチでは 各ステップを明示的に実行し、何が起こっているかを示していますが、`kubectl create secret`の方が便利です。
+
+
+## Volumeにある機密情報をアクセスするPodを作成する
+
+これはPodの作成に使用できる設定ファイルです。
+
+{{< codenew file="pods/inject/secret-pod.yaml" >}}
+
+1. Podを作成する:
+
+   ```shell
+   kubectl apply -f https://k8s.io/examples/pods/inject/secret-pod.yaml
+   ```
+
+1. Podの`STATUS`が`Running`であるのを確認する:
+
+   ```shell
+   kubectl get pod secret-test-pod
+   ```
+
+    出力:
+   ```
+   NAME              READY     STATUS    RESTARTS   AGE
+   secret-test-pod   1/1       Running   0          42m
+   ```
+
+1. Podの中にあるコンテナにシェルを実行する
+
+   ```shell
+   kubectl exec -i -t secret-test-pod -- /bin/bash
+   ```
+
+1. 機密データは `/etc/secret-volume` にマウントされたボリュームを介してコンテナに公開されます。
+
+   ディレクトリ `/etc/secret-volume` 中のファイルの一覧を確認する:
+   ```shell
+   # Run this in the shell inside the container
+   ls /etc/secret-volume
+   ```
+   `password`と`username` ２つのファイル名が出力される:
+   ```
+   password username
+   ```
+
+1.  `username` と `password` ファイルの中身を表示する:
+
+   ```shell
+   # Run this in the shell inside the container
+   echo "$( cat /etc/secret-volume/username )"
+   echo "$( cat /etc/secret-volume/password )"
+
+   ```
+   出力:
+   ```
+   my-app
+   39528$vdg7Jb
+   ```
+
+## Secretでコンテナの環境変数を定義する
+
+### 単一のSecretでコンテナの環境変数を定義する
+
+*  Secretの中でkey-valueペアで環境変数を定義する:
+
+   ```shell
+   kubectl create secret generic backend-user --from-literal=backend-username='backend-admin'
+   ```
+
+*  Secretで定義された`backend-username`の値をPodの環境変数`SECRET_USERNAME`に割り当てます。
+
+   {{< codenew file="pods/inject/pod-single-secret-env-variable.yaml" >}}
+
+*  Podを作成する:
+
+   ```shell
+   kubectl create -f https://k8s.io/examples/pods/inject/pod-single-secret-env-variable.yaml
+   ```
+
+*  コンテナの環境変数`SECRET_USERNAME`の中身を表示する:
+
+   ```shell
+   kubectl exec -i -t env-single-secret -- /bin/sh -c 'echo $SECRET_USERNAME'
+   ```
+
+   出力:
+   ```
+   backend-admin
+   ```
+
+### 複数のSecretからコンテナの環境変数を定義する
+
+*  前述の例と同様に、まずSecretを作成します:
+
+   ```shell
+   kubectl create secret generic backend-user --from-literal=backend-username='backend-admin'
+   kubectl create secret generic db-user --from-literal=db-username='db-admin'
+   ```
+
+*  Podの中で環境変数を定義する:
+
+   {{< codenew file="pods/inject/pod-multiple-secret-env-variable.yaml" >}}
+
+*  Podを作成する:
+
+   ```shell
+   kubectl create -f https://k8s.io/examples/pods/inject/pod-multiple-secret-env-variable.yaml
+   ```
+
+*  コンテナの環境変数を表示する:
+
+   ```shell
+   kubectl exec -i -t envvars-multiple-secrets -- /bin/sh -c 'env | grep _USERNAME'
+   ```
+   出力:
+   ```
+   DB_USERNAME=db-admin
+   BACKEND_USERNAME=backend-admin
+   ```
+
+
+## Secretのすべてのkey-valueペアを環境変数として設定する
+
+{{< note >}}
+この機能は Kubernetes v1.6 以降から利用可能
+{{< /note >}}
+
+*  複数のkey-valueペアを含むSecretを作成する
+
+   ```shell
+   kubectl create secret generic test-secret --from-literal=username='my-app' --from-literal=password='39528$vdg7Jb'
+   ```
+
+*  envFromを使用してSecretのすべてのデータをコンテナの環境変数として定義します。SecretのキーがPodの環境変数名になります。
+
+    {{< codenew file="pods/inject/pod-secret-envFrom.yaml" >}}
+
+*  Podを作成する:
+
+   ```shell
+   kubectl create -f https://k8s.io/examples/pods/inject/pod-secret-envFrom.yaml
+   ```
+
+* `username`と`password`コンテナの環境変数を表示する
+
+  ```shell
+  kubectl exec -i -t envfrom-secret -- /bin/sh -c 'echo "username: $username\npassword: $password\n"'
+  ```
+
+  出力:
+  ```
+  username: my-app
+  password: 39528$vdg7Jb
+  ```
+
+### 参考文献
+
+* [Secret](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#secret-v1-core)
+* [Volume](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#volume-v1-core)
+* [Pod](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#pod-v1-core)
+
+## {{% heading "whatsnext" %}}
+
+* [Secrets](/docs/concepts/configuration/secret/)についてもっと知る。
+* [Volumes](/docs/concepts/storage/volumes/)について知る。

content/ja/examples/pods/inject/pod-multiple-secret-env-variable.yaml

@@ -0,0 +1,19 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: envvars-multiple-secrets
+spec:
+  containers:
+  - name: envars-test-container
+    image: nginx
+    env:
+    - name: BACKEND_USERNAME
+      valueFrom:
+        secretKeyRef:
+          name: backend-user
+          key: backend-username
+    - name: DB_USERNAME
+      valueFrom:
+        secretKeyRef:
+          name: db-user
+          key: db-username

content/ja/examples/pods/inject/pod-secret-envFrom.yaml

@@ -0,0 +1,11 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: envfrom-secret
+spec:
+  containers:
+  - name: envars-test-container
+    image: nginx
+    envFrom:
+    - secretRef:
+        name: test-secret

content/ja/examples/pods/inject/pod-single-secret-env-variable.yaml

@@ -0,0 +1,14 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: env-single-secret
+spec:
+  containers:
+  - name: envars-test-container
+    image: nginx
+    env:
+    - name: SECRET_USERNAME
+      valueFrom:
+        secretKeyRef:
+          name: backend-user
+          key: backend-username