本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
比特桶雲連接
連線可讓您授權並建立將第三方供應商與 AWS 資源相關聯的組態。若要將第三方存放庫與管道的來源相關聯,請使用連線。
注意
此功能不適用於亞太區域 (香港)、亞太區域 (海德拉巴)、亞太區域 (雅加達)、亞太區域 (墨爾本)、亞太區域 (大阪)、非洲 (開普敦)、中東 (巴林)、中東 (阿聯酋)、歐洲 (西班牙)、歐洲 (蘇黎世)、以色列 (特拉維夫) 或 AWS GovCloud (美國西部) 區域。若要參考其他可用動作,請參閱產品與服務整合 CodePipeline。如需在歐洲 (米蘭) 區域進行此動作的考量,請參閱中的附註CodeStarSourceConnection 適用於 Bitbucket 雲端 GitHub、 GitHub 企業伺服器、 GitLab .com 和 GitLab 自我管理動作。
若要在中新增 Bitbucket 雲端來源動作 CodePipeline,您可以選擇:
-
使用 CodePipeline 主控台「建立管線精靈」或 「編輯」動作頁面來選擇 Bitbucket 提供者選項。請參創建到比特桶雲(控制台)的連接閱以新增動作。主控台可協助您建立連線資源。
注意
您可以建立連至 Bitbucket Cloud 儲存庫的連線。不支援安裝式 Bitbucket 供應商類型,例如 Bitbucket 伺服器。
-
使用 CLI 為
Bitbucket
提供者的動作新增CreateSourceConnection
動作組態,如下所示:-
若要建立連線資源,請參創建到比特桶雲(CLI)的連接閱使用 CLI 建立連線資源。
-
使用中的
CreateSourceConnection
範例動作配置CodeStarSourceConnection 適用於 Bitbucket 雲端 GitHub、 GitHub 企業伺服器、 GitLab .com 和 GitLab 自我管理動作來新增您的動作,如中所示建立管線 (CLI)。
-
注意
您也可以使用「設定」下的「開發人員工具」主控台建立連線。請參閱建立連線。
開始之前:
-
您必須使用第三方存儲庫的提供商(例如 Bitbucket 雲)創建了一個帳戶。
-
您必須已經建立了第三方程式碼儲存庫,例如 Bitbucket 雲端儲存庫。
注意
Bitbucket 雲端連線僅提供對用來建立連線之 Bitbucket 雲端帳戶所擁有的儲存庫的存取權。
如果應用程式安裝在 Bitbucket Cloud 工作區中,您需要管理工作區權限。否則,安裝該應用程式的選項將不會顯示。
創建到比特桶雲(控制台)的連接
使用這些步驟來使用 CodePipeline 主控台為您的 Bitbucket 儲存庫新增連線動作。
注意
您可以建立連至 Bitbucket Cloud 儲存庫的連線。不支援安裝式 Bitbucket 供應商類型,例如 Bitbucket 伺服器。
步驟 1:建立或編輯管道
若要建立或編輯管線
-
登入 CodePipeline 主控台。
-
選擇下列其中一項。
-
選擇建立配管。按照「建立管道」中的步驟完成第一個畫面,然後選擇「下一步」。在 [來源] 頁面的 [來源提供者] 下,選擇 [Bitbucket]。
-
選擇編輯現有配管。選擇 [編輯],然後選擇 [編輯階段]。選擇新增或編輯來源動作。在 [編輯動作] 頁面上的 [動作名稱] 下,輸入動作的名稱。在 [動作提供者] 中,選擇 [Bitbucket]。
-
-
執行以下任意一項:
-
在 [連線] 下,如果您尚未建立與提供者的連線,請選擇 [Connect 線至 Bitbucket]。繼續執行步驟 2:建立與 Bitbucket 的連線。
-
在 [連線] 下方,如果您已建立與提供者的連線,請選擇連線。繼續執行步驟 3:儲存連線的來源動作。
-
步驟 2:創建到比特桶雲的連接
若要建立至 Bitbucket 雲端的連線
-
在 [Connect 線至 Bitbucket 設定] 頁面上,輸入您的連線名稱,然後選擇 [Connect 線至 Bit bucket]。
便會出現「Bitbucket 應用程式」欄位。
-
在 Bitbucket apps (Bitbucket 應用程式) 底下,選擇應用程式安裝,或選擇 Install a new app (安裝新應用程式) 以建立安裝。
注意
您只能為每個 Bitbucket 雲端工作區或帳戶安裝一次應用程式。如果您已經安裝了 Bitbucket 應用程序,請選擇它並轉到步驟 4。
-
如果顯示 Bitbucket Cloud 的登入頁面,請使用您的認證登入,然後選擇繼續。
-
在應用程式安裝頁面上,會有訊息顯示 AWS CodeStar 應用程式正在嘗試連線至您的 Bitbucket 帳戶。
若您使用的是 Bitbucket 工作區,請將 Authorize for (授權) 選項變更為工作區。僅會顯示您具有管理員存取權的工作區。
選擇 Grant access (授與存取權)。
-
在 Bitbucket apps (Bitbucket 應用程式) 中,會顯示新安裝的連線 ID。選擇 Connect (連線)。建立的連線會顯示在連線清單中。
步驟 3:儲存您的 Bitbucket 雲端來源動作
使用精靈或 「編輯」動作頁面上的這些步驟,將來源動作與連線資訊一起儲存。
透過連線完成並儲存來源動作
-
在 Repository name (儲存庫名稱) 中,選擇第三方儲存庫的名稱。
-
如果您的動作是動作,您可以在管線觸發器下新增觸發 CodeConnections 器。若要設定管線觸發器組態並選擇性地使用觸發程式進行篩選,請參閱中的詳細資訊篩選程式碼推送或提取要求的觸發程序。
-
在 Output artifact format (輸出成品格式) 中,您必須選擇成品的格式。
-
若要使用預設方法儲存來自 Bitbucket Cloud 動作的輸出成品,請選擇CodePipeline 預設值。此動作會從 Bitbucket Cloud 存放庫存取檔案,並將成品儲存在管線成品存放區中的 ZIP 檔案中。
-
若要存放包含儲存庫 URL 參考的 JSON 檔案,以便下游動作可以直接執行 Git 命令,請選擇 Full clone (完整複製)。此選項只能由 CodeBuild 下游動作使用。
如果您選擇此選項,則需要更新 CodeBuild 專案服務角色的權限,如中所示新增連線至 Bitbucket GitHub、 GitHub 企業伺服器或 GitLab .com 的 CodeBuild GitClone 權限。
-
-
在精靈中選擇 [下一步],或在 [編輯動作] 頁面上選擇 [儲
創建到比特桶雲(CLI)的連接
您可以使用 AWS Command Line Interface (AWS CLI) 建立連線。
注意
您可以建立連至 Bitbucket Cloud 儲存庫的連線。不支援安裝式 Bitbucket 供應商類型,例如 Bitbucket 伺服器。
若要這麼做,請使用 create-connection 命令。
重要
依預設,透過 AWS CLI 或建立 AWS CloudFormation 的連線處於PENDING
狀態。建立與 CLI 的連線之後 AWS CloudFormation,或使用主控台編輯連線以顯示其狀態AVAILABLE
。
建立連線
-
開啟終端機 (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" } -
使用主控台完成連線。如需詳細資訊,請參閱更新擱置中的連線。
-
管線預設會偵測程式碼推送至連線來源儲存庫時的變更。若要針對手動發行或 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" ] } } ] } } ]
-