比特桶雲連接 - AWS CodePipeline

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

比特桶雲連接

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

注意

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

若要在中新增 Bitbucket 雲端來源動作 CodePipeline,您可以選擇:

注意

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

開始之前:

  • 您必須使用第三方存儲庫的提供商(例如 Bitbucket 雲)創建了一個帳戶。

  • 您必須已經建立了第三方程式碼儲存庫,例如 Bitbucket 雲端儲存庫。

注意

Bitbucket 雲端連線僅提供對用來建立連線之 Bitbucket 雲端帳戶所擁有的儲存庫的存取權。

如果應用程式安裝在 Bitbucket Cloud 工作區中,您需要管理工作區權限。否則,安裝該應用程式的選項將不會顯示。

創建到比特桶雲(控制台)的連接

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

注意

您可以建立連至 Bitbucket Cloud 儲存庫的連線。不支援安裝式 Bitbucket 供應商類型,例如 Bitbucket 伺服器。

步驟 1:建立或編輯管道

若要建立或編輯管線
  1. 登入 CodePipeline 主控台。

  2. 選擇下列其中一項。

    • 選擇建立配管。按照「建立管道」中的步驟完成第一個畫面,然後選擇「一步」。在 [來源] 頁面的 [來源提供者] 下,選擇 [Bitbucket]。

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

  3. 執行以下任意一項:

    • 在 [連線] 下,如果您尚未建立與提供者的連線,請選擇 [Connect 線至 Bitbucket]。繼續執行步驟 2:建立與 Bitbucket 的連線。

    • 在 [連線] 下方,如果您已建立與提供者的連線,請選擇連線。繼續執行步驟 3:儲存連線的來源動作。

步驟 2:創建到比特桶雲的連接

若要建立至 Bitbucket 雲端的連線
  1. 在 [Connect 線至 Bitbucket 設定] 頁面上,輸入您的連線名稱,然後選擇 [Connect 線至 Bit bucket]。

    顯示 Connect 到 Bitbucket 按鈕的控制台屏幕截圖。

    便會出現「Bitbucket 應用程式」欄位。

  2. Bitbucket apps (Bitbucket 應用程式) 底下,選擇應用程式安裝,或選擇 Install a new app (安裝新應用程式) 以建立安裝。

    注意

    您只能為每個 Bitbucket 雲端工作區或帳戶安裝一次應用程式。如果您已經安裝了 Bitbucket 應用程序,請選擇它並轉到步驟 4。

    顯示 Connect to Bitbucket Cloud (連線至 Bitbucket Cloud) 對話方塊,並包含安裝新應用程式按鈕的主控台螢幕擷取畫面。
  3. 如果顯示 Bitbucket Cloud 的登入頁面,請使用您的認證登入,然後選擇繼續。

  4. 在應用程式安裝頁面上,會有訊息顯示 AWS CodeStar 應用程式正在嘗試連線至您的 Bitbucket 帳戶。

    若您使用的是 Bitbucket 工作區,請將 Authorize for (授權) 選項變更為工作區。僅會顯示您具有管理員存取權的工作區。

    選擇 Grant access (授與存取權)

  5. Bitbucket apps (Bitbucket 應用程式) 中,會顯示新安裝的連線 ID。選擇 Connect (連線)。建立的連線會顯示在連線清單中。

    顯示訪問請求的控制台屏幕截圖。

步驟 3:儲存您的 Bitbucket 雲端來源動作

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

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

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

  3. Output artifact format (輸出成品格式) 中,您必須選擇成品的格式。

    • 若要使用預設方法儲存來自 Bitbucket Cloud 動作的輸出成品,請選擇CodePipeline 預設值。此動作會從 Bitbucket Cloud 存放庫存取檔案,並將成品儲存在管線成品存放區中的 ZIP 檔案中。

    • 若要存放包含儲存庫 URL 參考的 JSON 檔案,以便下游動作可以直接執行 Git 命令,請選擇 Full clone (完整複製)。此選項只能由 CodeBuild 下游動作使用。

      如果您選擇此選項,則需要更新 CodeBuild 專案服務角色的權限,如中所示新增連線至 Bitbucket GitHub、 GitHub 企業伺服器或 GitLab .com 的 CodeBuild GitClone 權限

  4. 在精靈中選擇 [下一步],或在 [編輯動作] 頁面上選擇 [

創建到比特桶雲(CLI)的連接

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

注意

您可以建立連至 Bitbucket Cloud 儲存庫的連線。不支援安裝式 Bitbucket 供應商類型,例如 Bitbucket 伺服器。

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

重要

依預設,透過 AWS CLI 或建立 AWS CloudFormation 的連線處於PENDING狀態。建立與 CLI 的連線之後 AWS CloudFormation,或使用主控台編輯連線以顯示其狀態AVAILABLE

建立連線
  1. 開啟終端機 (Linux、macOS 或 Unix) 或命令提示 (Windows)。使用 AWS CLI 來執行指create-connection令,--connection-name為您的連線指定--provider-type和。在此範例中,第三方供應商名稱為 Bitbucket,而指定的連線名稱為 MyConnection

    aws codestar-connections create-connection --provider-type Bitbucket --connection-name MyConnection

    如果成功,此命令會傳回類似下列內容的連線 ARN 資訊。

    { "ConnectionArn": "arn:aws:codestar-connections: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" ] } } ] } } ]