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. 記錄三個角色 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. 等待環境準備就緒。第一個環境可能需要 15 到 20 分鐘的時間，而 Elastic Beanstalk 會建立 Amazon EKS 叢集並部署範例。 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。在 Web 瀏覽器中開啟https://後接 CNAME，並確認範例應用程式回應。負載平衡器僅在 HTTPS 上回應，因此請求會http://等到逾時。若要接受 HTTP 請求，並讓 Elastic Beanstalk 將其重新導向至 HTTPS，請參閱 設定 Beanstalk 叢集環境的聯網。閒置環境一開始可以報告 Grey和 ，NoData因為它收到的請求太少，無法判斷應用程式運作狀態；運作狀態事件會將此狀態顯示為 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

   在 Web 瀏覽器中開啟 ，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