本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Azure DevOps 連線
連線可讓您授權和建立將第三方供應商與 AWS 資源建立關聯的組態。若要將第三方儲存庫關聯為管道的來源,請使用 連線。
注意
您可以使用另一個 之間的共用連線,而不是在帳戶中建立或使用現有的連線 AWS 帳戶。請參閱 使用與其他 帳戶共用的連線。
注意
此功能不適用於亞太區域 (香港)、亞太區域 (海德拉巴)、亞太區域 (雅加達)、亞太區域 (墨爾本)、亞太區域 (大阪)、非洲 (開普敦)、中東 (巴林)、中東 (阿拉伯聯合大公國)、歐洲 (西班牙)、歐洲 (蘇黎世)、以色列 (特拉維夫) 或 AWS GovCloud (美國西部) 區域。若要參考其他可用的動作,請參閱 與 CodePipeline 的產品和服務整合。如需歐洲 (米蘭) 區域中此動作的考量,請參閱 中的備註適用於 Bitbucket Cloud、GitHub、GitHub Enterprise Server、GitLab.com, 和 GitLab 自我管理動作的 CodeStarSourceConnection 。
若要在 CodePipeline 中新增 Azure DevOps 來源動作,您可以選擇:
-
使用 CodePipeline 主控台建立管道精靈或編輯動作頁面,選擇 Azure DevOps 供應商選項。請參閱 建立 Bitbucket Cloud 的連線 (主控台) 以新增 動作。主控台可協助您建立連線資源。
-
使用 CLI 向
Azure DevOps
提供者新增CreateSourceConnection
動作的動作組態,如下所示:-
若要建立連線資源,請參閱建立 Azure DevOps (CLI) 的連線使用 CLI 建立連線資源。
-
使用 中
CreateSourceConnection
的範例動作組態適用於 Bitbucket Cloud、GitHub、GitHub Enterprise Server、GitLab.com, 和 GitLab 自我管理動作的 CodeStarSourceConnection 來新增動作,如 所示建立管道 (CLI)。
-
注意
您也可以使用設定下的開發人員工具主控台建立連線。請參閱建立連線。
開始之前:
-
您必須已建立第三方儲存庫提供者的帳戶,例如 Azure DevOps
-
您必須已建立第三方程式碼儲存庫,例如 Azure DevOps 儲存庫。
注意
Azure DevOps 連線僅提供對 Azure DevOps 帳戶所擁有之儲存庫的存取權,該儲存庫用於建立連線。
若要安裝連線,您必須擁有 Azure 帳戶的管理員許可。
建立與 Azure DevOps 的連線 (主控台)
使用這些步驟來使用 CodePipeline 主控台為您的 Azure DevOps 儲存庫新增連線動作。
步驟 1:建立或編輯管道
建立或編輯管道
-
登入 CodePipeline 主控台。
-
選擇下列其中一項。
-
選擇 以建立管道。依照建立管道中的步驟完成第一個畫面,然後選擇下一步。在來源頁面的來源提供者下,選擇 Azure DevOps。
-
選擇 編輯現有的管道。選擇編輯,然後選擇編輯階段。選擇 新增或編輯來源動作。在編輯動作頁面的動作名稱下,輸入動作的名稱。在動作提供者中,選擇 Azure DevOps。
-
-
執行以下任意一項:
-
在連線下,如果您尚未建立與供應商的連線,請選擇連線至 Azure DevOps。繼續進行步驟 2:建立 Azure DevOps 的連線。
-
在連線下,如果您已建立與供應商的連線,請選擇連線。繼續步驟 3:儲存連線的來源動作。
-
步驟 2:建立與 Azure DevOps 的連線
建立與 Azure DevOps 的連線
-
若要建立與 Azure DevOps 儲存庫的連線,請在選取提供者下選擇 Azure DevOps。在 Connection name (連線名稱) 底下,輸入您要建立的連線名稱。選擇連線至 Azure DevOps,然後繼續進行步驟 2。
-
在連線至 Azure DevOps 設定頁面上,會顯示您的連線名稱。
在 Azure DevOps 應用程式下,選擇應用程式安裝,或選擇安裝新的應用程式來建立應用程式。
注意
您只為每個 Azure DevOps 帳戶安裝應用程式一次。如果您已安裝連接器應用程式,請選擇它並移至本節的最後一個步驟。
-
如果 Microsoft 的登入頁面顯示,請使用您的登入資料登入,然後選擇繼續。
-
在應用程式安裝頁面上,訊息顯示連接器應用程式正在嘗試連線到您的 Azure DevOps 帳戶。
選擇 Grant access (授與存取權)。
-
在連線頁面上,會顯示新安裝的連線 ID。選擇 Connect (連線)。建立的連線會顯示在連線清單中。
步驟 3:儲存 Azure DevOps 來源動作
在精靈或編輯動作頁面上使用這些步驟,將來源動作與連線資訊一起儲存。
使用連線完成並儲存來源動作
-
在 Repository name (儲存庫名稱) 中,選擇第三方儲存庫的名稱。
-
如果您的動作是 anCodeConnections 動作,您可以在管道觸發下新增觸發。若要設定管道觸發組態並選擇性地使用觸發條件進行篩選,請參閱 中的更多詳細資訊使用程式碼推送或提取請求事件類型新增觸發。
-
在 Output artifact format (輸出成品格式) 中,您必須選擇成品的格式。
-
若要使用預設方法存放來自 Azure DevOps 動作的輸出成品,請選擇 CodePipeline 預設。動作會從儲存庫存取檔案,並將成品存放在管道成品存放區中的 ZIP 檔案中。
-
若要存放包含儲存庫 URL 參考的 JSON 檔案,以便下游動作可以直接執行 Git 命令,請選擇 Full clone (完整複製)。此選項只能由 CodeBuild 下游動作使用。
如果您選擇此選項,您將需要更新 CodeBuild 專案服務角色的許可,如 所示新增連線至 Bitbucket、GitHub、GitHub Enterprise Server 或 GitLab.com 的 CodeBuild GitClone 許可 GitLab.com。
-
-
在精靈上選擇下一步,或在編輯動作頁面上選擇儲存。
建立 Azure DevOps (CLI) 的連線
您可以使用 AWS Command Line Interface (AWS CLI) 來建立連線。
若要這麼做,請使用 create-connection 命令。
重要
根據預設,透過 AWS CLI 或 建立的連線 AWS CloudFormation 處於 PENDING
狀態。建立與 CLI 或 的連線後 AWS CloudFormation,請使用 主控台來編輯連線,使其成為狀態 AVAILABLE
。
建立連線
-
開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 執行 create-connection命令,
--connection-name
為您的連線指定--provider-type
和 。在此範例中,第三方供應商名稱為AzureDevOps
,而指定的連線名稱為MyConnection
。aws codeconnections create-connection --provider-type AzureDevOps --connection-name MyConnection
如果成功,此命令會傳回類似下列內容的連線 ARN 資訊。
{ "ConnectionArn": "arn:aws:codeconnections:us-west-2:
account_id
:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f" } -
使用主控台完成連線。如需詳細資訊,請參閱更新待定連線。
-
管道預設為在將程式碼推送至連線來源儲存庫時偵測變更。若要設定手動發行或 Git 標籤的管道觸發組態,請執行下列其中一項操作:
-
若要將管道觸發組態設定為僅從手動版本開始,請將以下行新增至組態:
"DetectChanges": "false",
-
若要設定管道觸發組態以使用觸發條件進行篩選,請參閱 中的更多詳細資訊使用程式碼推送或提取請求事件類型新增觸發。例如,以下內容會將 Git 標籤新增至管道 JSON 定義的管道層級。在此範例中,
release-v0
和release-v1
是要包含的 Git 標籤,而release-v2
是要排除的 Git 標籤。"triggers": [ { "providerType": "CodeStarSourceConnection", "gitConfiguration": { "sourceActionName": "Source", "push": [ { "tags": { "includes": [ "release-v0", "release-v1" ], "excludes": [ "release-v2" ] } } ] } } ]
-