Beanstalk クラスターの開始方法

クラスター、ノード、オブザーバビリティロールを作成するには

1. ロールを引き受けるサービスごとに信頼ポリシーファイルを作成します。クラスターロールは Amazon EKS を信頼し、ノードロールは Amazon EC2 を信頼し、オブザーバビリティロールは Amazon EKS Pod Identity を信頼します。

   $ cat > eks-trust.json <<'EOF'
   {
     "Version": "2012-10-17",
     "Statement": [{
       "Effect": "Allow",
       "Principal": {"Service": "eks.amazonaws.com"},
       "Action": ["sts:AssumeRole", "sts:TagSession"]
     }]
   }
   EOF

   $ cat > ec2-trust.json <<'EOF'
   {
     "Version": "2012-10-17",
     "Statement": [{
       "Effect": "Allow",
       "Principal": {"Service": "ec2.amazonaws.com"},
       "Action": "sts:AssumeRole"
     }]
   }
   EOF

   $ cat > pods-trust.json <<'EOF'
   {
     "Version": "2012-10-17",
     "Statement": [{
       "Effect": "Allow",
       "Principal": {"Service": "pods.eks.amazonaws.com"},
       "Action": ["sts:AssumeRole", "sts:TagSession"]
     }]
   }
   EOF

2. クラスターロールを作成し、そのポリシーをアタッチします。

   $ aws iam create-role \
       --role-name aws-elasticbeanstalk-eks-cluster-role \
       --assume-role-policy-document file://eks-trust.json
   $ for p in AmazonEKSClusterPolicy AmazonEKSNetworkingPolicy AmazonEKSComputePolicy \
            AmazonEKSBlockStoragePolicy AmazonEKSLoadBalancingPolicy AWSElasticBeanstalkEKSTagging; do
       aws iam attach-role-policy \
           --role-name aws-elasticbeanstalk-eks-cluster-role \
           --policy-arn arn:aws:iam::aws:policy/$p
   done

3. ノードロールを作成し、そのポリシーをアタッチします。

   $ aws iam create-role \
       --role-name aws-elasticbeanstalk-eks-node-role \
       --assume-role-policy-document file://ec2-trust.json
   $ for p in AmazonEKSWorkerNodeMinimalPolicy AmazonEC2ContainerRegistryPullOnly \
            AmazonSSMManagedInstanceCore; do
       aws iam attach-role-policy \
           --role-name aws-elasticbeanstalk-eks-node-role \
           --policy-arn arn:aws:iam::aws:policy/$p
   done

4. オブザーバビリティロールを作成し、そのポリシーをアタッチします。

   $ aws iam create-role \
       --role-name aws-elasticbeanstalk-eks-observability-role \
       --assume-role-policy-document file://pods-trust.json
   $ for p in CloudWatchAgentServerPolicy AWSElasticBeanstalkEKSObservability; do
       aws iam attach-role-policy \
           --role-name aws-elasticbeanstalk-eks-observability-role \
           --policy-arn arn:aws:iam::aws:policy/$p
   done

5. 3 つのロール ARNs を記録します。環境を作成するときに渡します。

   $ for r in cluster node observability; do
       aws iam get-role --role-name aws-elasticbeanstalk-eks-$r-role \
           --query 'Role.Arn' --output text
   done

1. 環境を格納する Elastic Beanstalk アプリケーションを作成します。

   $ aws elasticbeanstalk create-application \
       --application-name getting-started-cluster-app

2. 環境の作成 Cluster 階層は Beanstalk クラスターを選択します。このリクエストにはバージョンラベルがないため、Elastic Beanstalk はサンプルアプリケーションをデプロイします。

   $ aws elasticbeanstalk create-environment \
       --application-name getting-started-cluster-app \
       --environment-name getting-started-cluster-env \
       --tier Name=Cluster,Type=EKS \
       --option-settings \
           Namespace=aws:elasticbeanstalk:eks,OptionName=cluster-role,Value=cluster-role-arn \
           Namespace=aws:elasticbeanstalk:eks,OptionName=node-role,Value=node-role-arn \
           Namespace=aws:elasticbeanstalk:eks:environment,OptionName=observability-role,Value=observability-role-arn

   ロール ARN プレースホルダーを、準備したロールに置き換えます。リクエストは service-portと を省略しますload-balancer-type。Elastic Beanstalk は、これらの設定をデフォルト 8080および に解決しますALB。異なる値を選択するには、 で渡します--option-settings。完全なオプションリファレンスについては、「」を参照してくださいBeanstalk クラスター環境の設定オプション。

3. 環境の準備ができるまで待ちます。最初の環境では、Elastic Beanstalk が Amazon EKS クラスターを作成し、サンプルをデプロイするまでに 15～20 分かかることがあります。には、環境が AWS CLI を報告するまでポーリングする組み込みウェーターが用意されていますReady。ウェーターは 20 秒間隔で最大 20 回、約 6 分 40 秒ポーリングするため、最初の環境では が報告されることを想定していますMax attempts exceeded。成功が報告されるまで、再度実行します。

   $ aws elasticbeanstalk wait environment-exists \
       --environment-names getting-started-cluster-env

   ウェーターは、環境がまだ作成されているときと作成に失敗したときMax attempts exceededの両方を報告します。数回実行しても成功が報告されない場合は、環境の最近のイベントを調べ、報告されたエラーを解決してから続行してください。

   $ aws elasticbeanstalk describe-events \
       --environment-name getting-started-cluster-env \
       --query 'Events[].[EventDate,Severity,Message]' \
       --output table

4. 環境ステータス、ヘルスカラー、ヘルスステータス、URL を検査します。

   $ aws elasticbeanstalk describe-environments \
       --application-name getting-started-cluster-app \
       --environment-names getting-started-cluster-env \
       --query 'Environments[0].[Status,Health,HealthStatus,CNAME]' \
       --output table

   環境が を報告しReady、空でない を返すことを確認しますCNAME。ウェブブラウザで を開き、https://続いて CNAME を開き、サンプルアプリケーションが応答することを確認します。ロードバランサーは HTTPS でのみ応答するため、 へのリクエストはタイムアウトするまでhttp://待機します。HTTP リクエストを受け入れて Elastic Beanstalk に HTTPS にリダイレクトさせるには、「」を参照してくださいBeanstalk クラスター環境のネットワークの設定。アイドル状態の環境では、アプリケーションのヘルスを判断するためのリクエストが少なすぎるNoDataため、最初に Greyと をレポートできます。ヘルスイベントでは、このステータスが と表示されますNo Data。これはデプロイが失敗したことを示すものではありません。アプリケーションが十分な成功したリクエストを受信すると、正常性は通常 Greenと に移行しますOk。CNAME が空の場合、アプリケーションが応答しない場合、またはヘルスが障害を報告した場合は、続行する前に環境の最近のイベントを調べます。

   $ aws elasticbeanstalk describe-events \
       --environment-name getting-started-cluster-env \
       --query 'Events[].[EventDate,Severity,Message]' \
       --output table

   クラスターヘルスモデルについては、「」を参照してくださいBeanstalk クラスター環境のモニタリング。

1. イメージをポイントするアプリケーションバージョンを作成します。

   $ aws elasticbeanstalk create-application-version \
       --application-name getting-started-cluster-app \
       --version-label v1 \
       --image-configuration Source={Uri=your-image-uri}

   your-image-uri を などのイメージに置き換えます111122223333.dkr.ecr.us-east-1.amazonaws.com/my-app:v1。イメージはすでに構築されているため、バージョンにビルドステップは不要で、デプロイする準備が整います。

2. 環境にバージョンをデプロイします。

   $ aws elasticbeanstalk update-environment \
       --environment-name getting-started-cluster-env \
       --version-label v1

3. デプロイが完了し、環境がアプリケーションを提供していることを確認します。

   $ aws elasticbeanstalk describe-events \
       --environment-name getting-started-cluster-env \
       --query 'Events[].[EventDate,Severity,Message]' \
       --output table

   を開きhttps://、続いてウェブブラウザで環境の CNAME を開き、アプリケーションが応答することを確認します。そうでない場合は、デプロイの失敗のイベントをチェックし、イメージが環境の をリッスンすることを確認しますservice-port。

1. 環境を終了します。

   $ aws elasticbeanstalk terminate-environment \
       --environment-name getting-started-cluster-env

2. 環境が Terminatedステータスになるまで待ちます。 AWS CLI には、終了が完了するまでポーリングする組み込みウェーターが用意されています。このウェーターには同じ 20 試行の制限があるため、成功が報告されるまで再度実行します。

   $ aws elasticbeanstalk wait environment-terminated \
       --environment-names getting-started-cluster-env

   ウェーターは、終了がまだ進行中のときと失敗したときMax attempts exceededの両方を報告します。数回実行しても成功が報告されない場合は、環境のイベントでエラーを解決します。環境がまだ存在する間は、アプリケーションを削除しないでください。

3. Elastic Beanstalk が作成したサンプルバージョンや追加したバージョンなど、アプリケーションとそのアプリケーションバージョンを削除します。これにより、指定したコンテナイメージやそれを保持するリポジトリは削除されません。「」を参照してくださいBeanstalk クラスター環境のコンテナイメージの構築。

   $ aws elasticbeanstalk delete-application \
       --application-name getting-started-cluster-app