AWSSupport-TroubleshootCodeDeploy - AWS Systems Manager 自動化 Runbook 參考

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWSSupport-TroubleshootCodeDeploy

Description (描述)

AWSSupport-TroubleshootCodeDeploy執行手冊可協助診斷 Amazon 彈性運算雲端 (Amazon EC2) 執行個體上AWS CodeDeploy部署失敗的原因。runbook 會輸出步驟來協助您解決問題或進一步疑難排解。也提供的CodeDeploy最佳作法，以協助您避免未來發生類似問題。

此 Runbook 可以幫助您解決以下問題：

  • CodeDeploy代理程式未安裝或未在 Amazon EC2 執行個體上執行

  • 亞馬遜 EC2 執行個體沒有附加 AWS Identity and Access Management (IAM) 執行個體設定檔

  • 連接到 Amazon EC2 執行個體的 IAM 執行個體設定檔沒有必要的 Amazon 簡單儲存服務 (Amazon S3) 許可

  • 遺失存放在 Amazon S3 中的修訂版，或使用的 Amazon S3 儲存貯AWS 區域體與 Amazon EC2 執行個體不同

  • 應用程式規格 (AppSpec) 檔案問題

  • 「文件已存在於位置」錯誤

  • CodeDeploy受管理生命週期事件掛接

  • 客戶管理的生命週期事件掛接

  • 部署期間的擴充事件

運行此自動化（控制台）

文件類型

 自動化

擁有者

Amazon

平台

Linux,macOS, Windows

參數

  • AutomationAssumeRole

    類型：字串

    說明：(選用) 允許系統管理員自動化代表您執行動作的 AWS Identity and Access Management (IAM) 角色的 Amazon 資源名稱 (ARN)。如果未指定角色，系統管理員自動化會使用啟動此 runbook 的使用者的權限。

  • DeploymentId

    類型：字串

    描述：（必要）失敗的部署 ID。

  • InstanceId

    類型：字串

    說明：(必填) 部署失敗之 Amazon EC2 執行個體的 ID。

必要的 IAM 許可

此AutomationAssumeRole參數需要下列動作才能成功使用 runbook。

  • codedeploy:GetDeployment

  • codedeploy:GetDeploymentTarget

  • ec2:DescribeInstances

文件步驟

  • aws:executeAwsApi-驗證為DeploymentId和InstanceId參數提供的值。

  • aws:executeScript-從 Amazon EC2 執行個體收集資訊，例如執行個體狀態和 IAM 執行個體設定檔詳細資訊。

  • aws:executeScript-檢閱指定的部署，並傳回部署失敗原因的分析。