3.7. AWS の特殊リージョンにクラスターをインストールする

手順

1. AWS Marketplace で OpenShift Container Platform サブスクリプションを完了します。
2. ご使用の AWS リージョンの AMI ID を記録します。インストールプロセスの一環として、クラスターをデプロイする前に、この値で install-config.yaml ファイルを更新する必要があります。

手順

1. AWS プロファイルを環境変数としてエクスポートします。

   $ export AWS_PROFILE=<aws_profile> 

   1

   Copy to Clipboard Toggle word wrap

   1

   govcloud や beijingadmin など、AWS の認証情報を格納する AWS プロファイル名。

2. カスタム AMI に関連付けるリージョンを環境変数としてエクスポートします。

   $ export AWS_DEFAULT_REGION=<aws_region> 

   1

   Copy to Clipboard Toggle word wrap

   1

   us-gov-east-1 や cn-north-1 などの AWS リージョン。

3. 環境変数として Amazon S3 にアップロードした RHCOS のバージョンをエクスポートします。

   $ export RHCOS_VERSION=<version> 

   1

   Copy to Clipboard Toggle word wrap

   1

   4.20.0 などの RHCOS VMDK バージョン。

4. Amazon S3 バケット名を環境変数としてエクスポートします。

   $ export VMIMPORT_BUCKET_NAME=<s3_bucket_name>

   Copy to Clipboard Toggle word wrap

5. containers.json ファイルを作成し、RHCOS VMDK ファイルを定義します。

   $ cat <<EOF > containers.json
   {
      "Description": "rhcos-${RHCOS_VERSION}-x86_64-aws.x86_64",
      "Format": "vmdk",
      "UserBucket": {
         "S3Bucket": "${VMIMPORT_BUCKET_NAME}",
         "S3Key": "rhcos-${RHCOS_VERSION}-x86_64-aws.x86_64.vmdk"
      }
   }
   EOF

   Copy to Clipboard Toggle word wrap

6. RHCOS ディスクを Amazon EBS スナップショットとしてインポートします。

   $ aws ec2 import-snapshot --region ${AWS_DEFAULT_REGION} \
        --description "<description>" \ 

   1

   
        --disk-container "file://<file_path>/containers.json" 

   2

   Copy to Clipboard Toggle word wrap

   1

   rhcos-${RHCOS_VERSION}-x86_64-aws.x86_64 などの RHCOS ディスクがインポートされていることの説明。

   2

   RHCOS ディスクを説明する JSON ファイルへのファイルパス。JSON ファイルには、Amazon S3 バケット名とキーが含まれている必要があります。

7. イメージインポートのステータスを確認します。

   $ watch -n 5 aws ec2 describe-import-snapshot-tasks --region ${AWS_DEFAULT_REGION}

   Copy to Clipboard Toggle word wrap

   出力例

   {
       "ImportSnapshotTasks": [
           {
               "Description": "rhcos-4.7.0-x86_64-aws.x86_64",
               "ImportTaskId": "import-snap-fh6i8uil",
               "SnapshotTaskDetail": {
                   "Description": "rhcos-4.7.0-x86_64-aws.x86_64",
                   "DiskImageSize": 819056640.0,
                   "Format": "VMDK",
                   "SnapshotId": "snap-06331325870076318",
                   "Status": "completed",
                   "UserBucket": {
                       "S3Bucket": "external-images",
                       "S3Key": "rhcos-4.7.0-x86_64-aws.x86_64.vmdk"
                   }
               }
           }
       ]
   }

   Copy to Clipboard Toggle word wrap

   SnapshotId をコピーして、イメージを登録します。

8. RHCOS スナップショットからカスタム RHCOS AMI を作成します。

   $ aws ec2 register-image \
      --region ${AWS_DEFAULT_REGION} \
      --architecture x86_64 \ 

   1

   
      --description "rhcos-${RHCOS_VERSION}-x86_64-aws.x86_64" \ 

   2

   
      --ena-support \
      --name "rhcos-${RHCOS_VERSION}-x86_64-aws.x86_64" \ 

   3

   
      --virtualization-type hvm \
      --root-device-name '/dev/xvda' \
      --block-device-mappings 'DeviceName=/dev/xvda,Ebs={DeleteOnTermination=true,SnapshotId=<snapshot_ID>}' 

   4

   Copy to Clipboard Toggle word wrap

   1

   x86_64、aarch64、s390x、または ppc64le などの RHCOS VMDK アーキテクチャータイプ。

   2

   インポートされたスナップショットの Description。

   3

   RHCOS AMI の名前。

   4

   インポートされたスナップショットからの SnapshotID。

手順

1. 必要なインストールアセットを保存するためのインストールディレクトリーを作成します。

   $ mkdir <installation_directory>

   Copy to Clipboard Toggle word wrap
   重要

   このディレクトリーは必ず作成してください。ブートストラップ X.509 証明書などの一部のインストールアセットは、有効期限が短いため、インストールディレクトリーを再利用しないでください。別のクラスターインストールの個別のファイルを再利用する必要がある場合は、それらをディレクトリーにコピーすることができます。ただし、インストールアセットのファイル名はリリース間で変更される可能性があります。インストールファイルを以前のバージョンの OpenShift Container Platform からコピーする場合は注意してください。

2. 提供されているサンプルの install-config.yaml ファイルテンプレートをカスタマイズし、ファイルを <installation_directory> に保存します。

   注記

   この設定ファイルの名前を install-config.yaml と付ける必要があります。

3. 多くのクラスターのインストールに使用できるように、install-config.yaml ファイルをバックアップします。

   重要

   インストールプロセスの次のステップで install-config.yaml ファイルを使用するため、今すぐこのファイルをバックアップしてください。

手順

1. インストールプログラムが格納されているディレクトリーで、次のコマンドを実行して、クラスターのデプロイメントを初期化します。

   $ ./openshift-install create cluster --dir <installation_directory> \ 

   1

   
       --log-level=info 

   2

   Copy to Clipboard Toggle word wrap

   1

   <installation_directory> に、カスタマイズした ./install-config.yaml ファイルの場所を指定します。

   2

   異なるインストールの詳細情報を表示するには、info ではなく、warn、debug、または error を指定します。

2. オプション: クラスターのインストールに使用した IAM アカウントから AdministratorAccess ポリシーを削除するか、無効にします。

   注記

   AdministratorAccess ポリシーが提供する昇格したパーミッションはインストール時にのみ必要です。

手順

1. 次のコマンドを実行して、kubeadmin 認証情報をエクスポートします。

   $ export KUBECONFIG=<installation_directory>/auth/kubeconfig 

   1

   Copy to Clipboard Toggle word wrap

   1

   <installation_directory> には、インストールファイルを保存したディレクトリーへのパスを指定します。

2. 次のコマンドを実行し、エクスポートされた設定を使用して oc コマンドを正常に実行できることを確認します。

   $ oc whoami

   Copy to Clipboard Toggle word wrap

   出力例

   system:admin

   Copy to Clipboard Toggle word wrap

手順

1. インストールホストで kubeadmin-password ファイルから kubeadmin ユーザーのパスワードを取得します。

   $ cat <installation_directory>/auth/kubeadmin-password

   Copy to Clipboard Toggle word wrap
   注記

   または、インストールホストで <installation_directory>/.openshift_install.log ログファイルから kubeadmin パスワードを取得できます。

2. OpenShift Container Platform Web コンソールルートをリスト表示します。

   $ oc get routes -n openshift-console | grep 'console-openshift'

   Copy to Clipboard Toggle word wrap
   注記

   または、インストールホストで <installation_directory>/.openshift_install.log ログファイルからで OpenShift Container Platform ルートを取得できます。

   出力例

   console     console-openshift-console.apps.<cluster_name>.<base_domain>            console     https   reencrypt/Redirect   None

   Copy to Clipboard Toggle word wrap

3. Web ブラウザーで前述のコマンドの出力で詳細に説明されたルートに移動し、kubeadmin ユーザーとしてログインします。