本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CodeCommit 來源動作參考
在配置的 CodeCommit 存儲庫和分支上進行新的提交時啟動管道。
如果您使用控制台建立或編輯管道,請 CodePipeline 建立一個 CodeCommit CloudWatch 事件規則,以便在存放庫中發生變更時啟動管道。
您必須先建立存 CodeCommit 放庫,然後才能透過 CodeCommit 動作連接管道。
偵測到程式碼變更之後,您有下列選擇將程式碼傳遞給後續動作:
-
預設 — 設定 CodeCommit 來源動作以輸出具有提交淺層副本的ZIP檔案。
-
完整複製 — 設定來源動作,將 Git URL 參考輸出至儲存庫,以供後續動作使用。
目前,Git URL 參考只能由下游 CodeBuild 動作用來複製存放庫和相關的 Git 中繼資料。嘗試將 Git URL 引用傳遞給非CodeBuild 操作會導致錯誤。
動作類型
-
類別:
Source
-
擁有者:
AWS
-
提供者:
CodeCommit
-
版本:
1
組態參數
- RepositoryName
-
必要:是
要偵測來源變更的儲存庫名稱。
- BranchName
-
必要:是
要偵測來源變更的分支名稱。
- PollForSourceChanges
-
必要:否
PollForSourceChanges
控制是否 CodePipeline 輪詢 CodeCommit存放庫中的來源變更。我們建議您改用 E CloudWatch vents 來偵測來源變更。如需有關配置 CloudWatch 事件的詳細資訊,請參閱移轉輪詢管線 (CodeCommit 來源) (CLI)或移轉輪詢管線 (CodeCommit 來源) (AWS CloudFormation 範本)。重要
如果您打算配置 CloudWatch 事件規則,則必須將其設定
PollForSourceChanges
為以false
避免重複的管線執行。此參數的有效值:
-
true
:如果設置,則 CodePipeline 輪詢您的存儲庫以進行源更改。注意
如果省略
PollForSourceChanges
,則 CodePipeline 預設會輪詢儲存庫以進行來源變更。此行為同於包含PollForSourceChanges
且設定為true
。 -
false
:如果設定,則 CodePipeline 不會輪詢您的儲存庫是否有來源變更。如果您想要設定 CloudWatch 事件規則以偵測來源變更,請使用此設定。
-
- OutputArtifactFormat
-
必要:否
輸出成品格式。值可以是
CODEBUILD_CLONE_REF
或CODE_ZIP
。如果未指定,預設值為CODE_ZIP
。重要
CODEBUILD_CLONE_REF
此選項只能由 CodeBuild下游動作使用。如果您選擇此選項,則需要將
codecommit:GitPull
權限新增至您的 CodeBuild 服務角色,如中所示新增 CodeCommit來源動作的 CodeBuild GitClone 權限。您還需要將codecommit:GetRepository
權限添加到 CodePipeline服務角色,如中所示將許可新增至 CodePipeline 服務角色。如需說明如何使用「完整複製」選項的教學課程,請參閱教學課程:搭 CodeCommit 配管線來源使用完整複製。
Input artifacts (輸入成品)
-
人工因素數目:
0
-
描述:輸入成品不適用於此動作類型。
輸出成品
-
人工因素數目:
1
-
描述:此動作的輸出成品是一個ZIP檔案,其中包含已配置儲存庫的內容,並在指定為管線執行的來源修訂版本的確認時進行分支。從存放庫產生的成品是 CodeCommit 動作的輸出成品。中的原始程式碼提交 ID 會顯示 CodePipeline 為觸發管線執行的來源修訂。
輸出變數
設定時,此動作會產生變數,供管道中的下游動作的動作組態所參考。即使此動作沒有命名空間,此動作產生的變數仍可視為輸出變數。您可以設定動作的命名空間,讓這些變數可供下游動作的組態使用。
如需詳細資訊,請參閱變數參考。
- CommitId
-
觸發管線執行的 CodeCommit 提交 ID。提交IDs是完整SHA的提交。
- CommitMessage
-
與觸發管道執行的遞交相關聯的描述訊息 (如果有的話)。
- RepositoryName
-
執行觸發管線之提交的 CodeCommit 儲存庫名稱。
- BranchName
-
進行來源變更之 CodeCommit 儲存庫的分支名稱。
- AuthorDate
-
遞交的撰寫日期 (時間戳記格式)。
如需 Git 中的作者和遞交者之間差異的詳細信息,請參閱 Scott Chacon 和 Ben Straub 共同撰寫的 Pro Git 中的檢視提交的歷史記錄
。 - CommitterDate
-
遞交的遞交日期 (時間戳記格式)。
如需 Git 中的作者和遞交者之間差異的詳細信息,請參閱 Scott Chacon 和 Ben Straub 共同撰寫的 Pro Git 中的檢視提交的歷史記錄
。
動作組態範例
預設輸出人工因素格式的範例
完整複製輸出假影格式的範例
另請參閱
以下相關資源可協助您使用此動作。
-
教學課程:建立簡單管道 (CodeCommit儲存庫)— 本教學課程提供範例應用程式規格檔案,以及範例 CodeDeploy 應用程式和部署群組。使用本教學建立管道,其中包含部署到 Amazon EC2 執行個體的 CodeCommit 來源。