Azure DevOps 連線 - AWS CodePipeline

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

Azure DevOps 連線

連線可讓您授權和建立將第三方供應商與 AWS 資源建立關聯的組態。若要將第三方儲存庫關聯為管道的來源,請使用 連線。

注意

您可以使用另一個 之間的共用連線,而不是在帳戶中建立或使用現有的連線 AWS 帳戶。請參閱 使用與其他 帳戶共用的連線

注意

此功能不適用於亞太區域 (香港)、亞太區域 (海德拉巴)、亞太區域 (雅加達)、亞太區域 (墨爾本)、亞太區域 (大阪)、非洲 (開普敦)、中東 (巴林)、中東 (阿拉伯聯合大公國)、歐洲 (西班牙)、歐洲 (蘇黎世)、以色列 (特拉維夫) 或 AWS GovCloud (美國西部) 區域。若要參考其他可用的動作,請參閱 與 CodePipeline 的產品和服務整合。如需歐洲 (米蘭) 區域中此動作的考量,請參閱 中的備註適用於 Bitbucket Cloud、GitHub、GitHub Enterprise Server、GitLab.com, 和 GitLab 自我管理動作的 CodeStarSourceConnection

若要在 CodePipeline 中新增 Azure DevOps 來源動作,您可以選擇:

注意

您也可以使用設定下的開發人員工具主控台建立連線。請參閱建立連線

開始之前:

  • 您必須已建立第三方儲存庫提供者的帳戶,例如 Azure DevOps

  • 您必須已建立第三方程式碼儲存庫,例如 Azure DevOps 儲存庫。

注意

Azure DevOps 連線僅提供對 Azure DevOps 帳戶所擁有之儲存庫的存取權,該儲存庫用於建立連線。

若要安裝連線,您必須擁有 Azure 帳戶的管理員許可。

建立與 Azure DevOps 的連線 (主控台)

使用這些步驟來使用 CodePipeline 主控台為您的 Azure DevOps 儲存庫新增連線動作。

步驟 1:建立或編輯管道

建立或編輯管道
  1. 登入 CodePipeline 主控台。

  2. 選擇下列其中一項。

    • 選擇 以建立管道。依照建立管道中的步驟完成第一個畫面,然後選擇下一步。在來源頁面的來源提供者下,選擇 Azure DevOps

    • 選擇 編輯現有的管道。選擇編輯,然後選擇編輯階段。選擇 新增或編輯來源動作。在編輯動作頁面的動作名稱下,輸入動作的名稱。在動作提供者中,選擇 Azure DevOps

  3. 執行以下任意一項:

    • 連線下,如果您尚未建立與供應商的連線,請選擇連線至 Azure DevOps。繼續進行步驟 2:建立 Azure DevOps 的連線。

    • 連線下,如果您已建立與供應商的連線,請選擇連線。繼續步驟 3:儲存連線的來源動作。

步驟 2:建立與 Azure DevOps 的連線

建立與 Azure DevOps 的連線
  1. 若要建立與 Azure DevOps 儲存庫的連線,請在選取提供者下選擇 Azure DevOps。在 Connection name (連線名稱) 底下,輸入您要建立的連線名稱。選擇連線至 Azure DevOps,然後繼續進行步驟 2。

    主控台螢幕擷取畫面,顯示針對 Azure DevOps 選取的連線選項。
  2. 連線至 Azure DevOps 設定頁面上,會顯示您的連線名稱。

    Azure DevOps 應用程式下,選擇應用程式安裝,或選擇安裝新的應用程式來建立應用程式。

    注意

    您只為每個 Azure DevOps 帳戶安裝應用程式一次。如果您已安裝連接器應用程式,請選擇它並移至本節的最後一個步驟。

  3. 如果 Microsoft 的登入頁面顯示,請使用您的登入資料登入,然後選擇繼續。

  4. 在應用程式安裝頁面上,訊息顯示連接器應用程式正在嘗試連線到您的 Azure DevOps 帳戶。

    選擇 Grant access (授與存取權)

  5. 在連線頁面上,會顯示新安裝的連線 ID。選擇 Connect (連線)。建立的連線會顯示在連線清單中。

步驟 3:儲存 Azure DevOps 來源動作

在精靈或編輯動作頁面上使用這些步驟,將來源動作與連線資訊一起儲存。

使用連線完成並儲存來源動作
  1. Repository name (儲存庫名稱) 中,選擇第三方儲存庫的名稱。

  2. 如果您的動作是 anCodeConnections 動作,您可以在管道觸發下新增觸發。若要設定管道觸發組態並選擇性地使用觸發條件進行篩選,請參閱 中的更多詳細資訊使用程式碼推送或提取請求事件類型新增觸發

  3. 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

  4. 在精靈上選擇下一步,或在編輯動作頁面上選擇儲存

建立 Azure DevOps (CLI) 的連線

您可以使用 AWS Command Line Interface (AWS CLI) 來建立連線。

若要這麼做,請使用 create-connection 命令。

重要

根據預設,透過 AWS CLI 或 建立的連線 AWS CloudFormation 處於 PENDING 狀態。建立與 CLI 或 的連線後 AWS CloudFormation,請使用 主控台來編輯連線,使其成為狀態 AVAILABLE

建立連線
  1. 開啟終端機 (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" }
  2. 使用主控台完成連線。如需詳細資訊,請參閱更新待定連線

  3. 管道預設為在將程式碼推送至連線來源儲存庫時偵測變更。若要設定手動發行或 Git 標籤的管道觸發組態,請執行下列其中一項操作:

    • 若要將管道觸發組態設定為僅從手動版本開始,請將以下行新增至組態:

      "DetectChanges": "false",
    • 若要設定管道觸發組態以使用觸發條件進行篩選,請參閱 中的更多詳細資訊使用程式碼推送或提取請求事件類型新增觸發。例如,以下內容會將 Git 標籤新增至管道 JSON 定義的管道層級。在此範例中, release-v0release-v1是要包含的 Git 標籤,而 release-v2是要排除的 Git 標籤。

      "triggers": [ { "providerType": "CodeStarSourceConnection", "gitConfiguration": { "sourceActionName": "Source", "push": [ { "tags": { "includes": [ "release-v0", "release-v1" ], "excludes": [ "release-v2" ] } } ] } } ]