Amazon Elastic File System の設定

始める前に

このタスクについて

この手順では Kubernetes NFS-Client Provisioner ( Kubernetes SIGs organization)を使用して、 EFS ストレージでダイナミック・プロビジョニングをセットアップする。

EFS ファイル・システムの作成

以下のガイダンスを使用して、クラスターからアクセス可能な EFS ファイル・システムを作成します。

EC2 ダッシュボードから、以下を実行します。

1. ナビゲーション・メニューから、 「インスタンス」を選択します。
2. worker ノードを識別し、そのノードの 「インスタンス ID」 をクリックします。
3. ワーカー・ノードの VPC ID とセキュリティー・グループを取得します。
   1. ノードのインスタンスの要約で、 「VPC ID」を見つけます。 ID をテキスト・ファイルに保存します。
   2. 「セキュリティー」 タブを開き、 「セキュリティー・グループ」を見つけます。 ID をテキスト・ファイルに保存します。
4. VPC の CIDR を取得します。
   1. インスタンスの要約から、VPC ID をクリックして VPC 管理コンソールを開きます。
   2. VPC 管理コンソールから、VPC の CIDR を見つけます。 CIDR をテキスト・ファイルに保存します。
   3. VPC 管理コンソールを閉じます。
5. セキュリティー・グループのインバウンド・ルールを編集します。
   1. ナビゲーション・メニューから、「 セキュリティー・グループ」を選択します。
   2. 前のステップで特定したセキュリティー・グループを検索します。
   3. 「セキュリティー・グループ ID」をクリックします。
   4. 「インバウンド・ルール」 タブで、 「インバウンド・ルールの編集」をクリックします。
   5. ルールの末尾までスクロールし、 「ルールの追加」をクリックします。
   6. 以下の値を指定します。
      • 「タイプ」には、 NFSを指定します。
      • 「ソース」には、 「カスタム」を指定します。
      • 検索フィールドに、前のステップで確認した CIDR 値を入力します。
   7. ルールの保存をクリックしてください。
6. EFS ファイル・システムを作成します。
   1. このサイトへ https://console.aws.amazon.com/efs.
   2. 「ファイル・システムの作成」をクリックします。 次に、 「カスタマイズ」 をクリックします。
   3. 「ファイル・システム設定」 ページで、ファイル・システムに名前を付けます。 次に、「次へ」をクリックします。
   4. 「ネットワーク・アクセス (Network access)」 ページで、前の手順で確認した VPC を選択します。
   5. VPC の各アベイラビリティー・ゾーンについて、以下を行います。
      • プライベート・サブネット ID を選択します。
      • デフォルトのセキュリティー・グループを削除し、前のステップで指定したセキュリティー・グループに置き換えます。
   6. 次へ をクリックします。 その後、再度 「次へ」 をクリックします。
   7. 「レビューと作成」 ページで、 「作成」をクリックします。
7. ファイル・システムが作成されるまで待ちます。 ファイル・システムの ID を書き留めます。

プライベート・コンテナー・レジストリーへのプロビジョナー・イメージのミラーリング

Amazon Elastic File System の接続の詳細の取得

動的プロビジョニングをセットアップする前に、 Amazon Elastic File Systemの DNS 名または IP アドレスを取得する必要があります。

DNS 名 (推奨)

DNS 名は、 Amazon EFS > File systems の AWS Console から取得できます。 使用するファイル・システムを選択します。 DNS 名は 「一般」 セクションにあります。

DNS 名の形式は、 <file-storage-id>.efs.<region>.amazonaws.comです。

IP address

Amazon EFS > File systems の AWS Console から IP アドレスを取得できます。 使用するファイル・システムを選択します。 IP アドレスは 「ネットワーク」 タブにあります。

動的ストレージの構成

動的ストレージを構成するには、以下のようにします。

1. cpd-cli manage login-to-ocp コマンドを実行して、このタスクを実行するための十分な権限を持つユーザーとしてクラスターにログインします。 次に例を示します。

   cpd-cli manage login-to-ocp \
   --username=${OCP_USERNAME} \
   --password=${OCP_PASSWORD} \
   --server=${OCP_URL}

   ヒント: login-to-ocp コマンドは、 oc login コマンドと同じ入力を使用します。 詳しくは、 oc login --help を実行してください。
2. イメージをプライベート・コンテナー・レジストリーにミラーリングした場合は、グローバル・イメージ・プル・シークレットを更新して、クラスターが Kubernetes NFS-Client Provisioner イメージにアクセスできるようにします。

   グローバル・イメージ・プル・シークレットには、プライベート・コンテナー・レジストリーからイメージを プル できるアカウントの資格情報が含まれている必要があります。

   cpd-cli manage add-cred-to-global-pull-secret \
   --registry=${PRIVATE_REGISTRY_LOCATION} \
   --registry_pull_user=${PRIVATE_REGISTRY_PULL_USER} \
   --registry_pull_password=${PRIVATE_REGISTRY_PULL_PASSWORD}

3. 以下の環境変数を設定します。
   1. EFS_LOCATION を DNS 名または IP アドレス EFS サーバーに設定します。

      export EFS_LOCATION=<location>

   2. EFS_PATH を EFS エクスポート・パスに設定します。 (デフォルト・パスは /です。)

      export EFS_PATH=/

   3. PROJECT_NFS_PROVISIONER を、 Kubernetes NFS-Client Provisioner プロビジョナーをデプロイするプロジェクト (名前空間) に設定します。 推奨されるプロジェクトは nfs-provisionerですが、任意のプロジェクトを指定できます。
      重要: プロジェクトを作成するための適切なアクセス権がない場合は、既存のプロジェクト (名前空間) を指定する必要があります。 プロジェクトを作成するための適切な権限がある場合は、 cpd-cli manage setup-nfs-provisioner コマンドを実行すると、プロジェクトが自動的に作成されます。

      export PROJECT_NFS_PROVISIONER=<project-name>

   4. EFS_STORAGE_CLASS を、 EFS ストレージ・クラスに使用する名前に設定します。 推奨される名前は efs-nfs-clientです。

      export EFS_STORAGE_CLASS=efs-nfs-client

   5. NFS_IMAGE を、ご使用の Red Hat OpenShift Container Platform アーキテクチャーおよびイメージをプルする元のレジストリーの正しい値に設定します。

      アーキテクチャー	コマンド
      x86-64	Kubernetes レジストリー export NFS_IMAGE=k8s.gcr.io/sig-storage/nfs-subdir-external-provisioner:v4.0.2 プライベート・コンテナー・レジストリー export NFS_IMAGE=${PRIVATE_REGISTRY_LOCATION}/nfs-subdir-external-provisioner:v4.0.2
      ppc64le	Kubernetes レジストリー export NFS_IMAGE=gcr.io/k8s-staging-sig-storage/nfs-subdir-external-provisioner:v4.0.2 プライベート・コンテナー・レジストリー export NFS_IMAGE=${PRIVATE_REGISTRY_LOCATION}/nfs-subdir-external-provisioner:v4.0.2
      s390x	Kubernetes レジストリー export NFS_IMAGE=gcr.io/k8s-staging-sig-storage/nfs-subdir-external-provisioner:v4.0.2 プライベート・コンテナー・レジストリー export NFS_IMAGE=${PRIVATE_REGISTRY_LOCATION}/nfs-subdir-external-provisioner:v4.0.2

      ヒント: クラスターのアーキテクチャーが分からない場合は、以下のコマンドを実行します。

      1. 以下のコマンドを実行して、クラスター上のノードのリストを取得します。

         oc get nodes

         ノードの 1 つの名前をコピーします。

      2. 以下のコマンドを実行して、ノードに関する情報を取得します。

         <node-name> を適切な名前に置き換えます。

         oc get nodes <node-name> -o jsonpath='{.status.nodeInfo}' | jq

         出力には architectureが含まれます。

4. 以下のコマンドを実行して、動的プロビジョニングをセットアップします。

   cpd-cli manage setup-nfs-provisioner \
   --nfs_server=${EFS_LOCATION} \
   --nfs_path=${EFS_PATH} \
   --nfs_provisioner_ns=${PROJECT_NFS_PROVISIONER} \
   --nfs_storageclass_name=${EFS_STORAGE_CLASS} \
   --nfs_provisioner_image=${NFS_IMAGE}

5. 動的プロビジョニングが機能していることを確認します。
   1. ストレージ・クラスが作成されたことを確認します。

      oc get sc

      ストレージ・クラスのリストを調べて、 EFS ストレージ・クラスが含まれていることを確認します。 デフォルトのストレージ・クラス名は efs-nfs-clientです。

   2. nfs-client-provisioner ポッドが実行中であることを確認します。

      oc get pods -n ${PROJECT_NFS_PROVISIONER}

      ポッドの状況は Runningでなければなりません。

   3. プロビジョナーによって作成されたテスト永続ボリューム要求 (pvc) がバインドされていることを確認します。

      oc get pvc -n ${PROJECT_NFS_PROVISIONER}

      Persistent Volume Claim の状況は Boundでなければなりません。

次の作業

ストレージ・クラスを作成したので、 サービスのカスタム・セキュリティ・コンテキスト制約を作成する準備ができました。