分享方式:


管理服務連線

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

本文涵蓋 Azure Pipelines 中的服務連線。 服務連線是 Azure Pipelines 與您用來在作業中執行工作的外部或遠端服務之間的已驗證連線。

例如,您的管線可能會使用下列服務連線類別:

  • Azure 訂用帳戶,用於 Azure 網站部署工作。
  • 不同的組建伺服器或文件伺服器,例如與 GitHub 存放庫的標準 GitHub Enterprise Server 服務連線。
  • 在線持續整合環境,例如 Jenkins 服務連線,以持續整合 Git 存放庫。
  • 安裝在遠端電腦上的服務,例如 Azure Resource Manager 服務連線到具有受控服務識別的 Azure 虛擬機。
  • 外部服務,例如 Docker 登錄、Kubernetes 叢集或 Maven 存放庫的服務連線。

本文的第一個部分說明如何建立、檢視、編輯和使用服務連線。 本文的第二個部分提供 Azure Pipelines 服務連線類型的參考

必要條件

  • Azure DevOps 專案和管線。
  • 適當的指派使用者角色,用來建立、檢視、使用或管理服務連線。 如需詳細資訊,請參閱 服務連線許可權

建立服務連線

若要建立 Azure Pipelines 的服務連線:

  1. 在您的 Azure DevOps 專案中,選取 [項目設定>服務連線]。

  2. 選取 [ 新增服務連線],選取您需要的服務連線類型,然後選取 [ 下一步]。

  3. 選擇驗證方法,然後選取 [ 下一步]。

  4. 輸入服務連線的參數。 參數會根據 服務連線類型和 驗證方法而有所不同。

    根據服務連線類型和驗證方法,可能會有驗證連線的連結。 驗證連結會搭配使用對外部服務的 REST 呼叫與您所輸入的資訊,並指出呼叫是否成功。

  5. 輸入 服務連接名稱 ,以用於工作屬性中的服務連線。

  6. 或者,輸入 [描述]。

  7. 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。

    如果您未選取此選項,您稍後必須明確 授權每個管線使用服務連線

  8. 選取 [儲存] 或 [驗證並儲存]。

下列範例顯示 Azure 訂用帳戶的 Azure Resource Manager 連線。 您可以使用服務連線名稱作為MyAzureSubscription1 管線工作中或對等的訂用帳戶名稱值。

[新增 Azure 服務連線] 畫面的螢幕快照,其中包含受控識別。

若要建立 Azure Pipelines 的服務連線:

  1. 在您的 Azure DevOps 專案中,選取 [項目設定>服務連線]。

  2. 選取 [ 新增服務連線],選取您需要的服務連線類型,然後選取 [ 下一步]。

  3. 選擇驗證方法,然後選取 [ 下一步]。

  4. 輸入服務連線的參數。 參數會根據 服務連線類型和 驗證方法而有所不同。

    根據服務連線類型和驗證方法,可能會有驗證連線的連結。 驗證連結會搭配使用對外部服務的 REST 呼叫與您所輸入的資訊,並指出呼叫是否成功。

  5. 輸入 服務連接名稱 ,以用於工作屬性中的服務連線。

  6. 或者,輸入 [描述]。

  7. 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。

    如果您未選取此選項,您稍後必須明確 授權每個管線使用服務連線

  8. 選取 [儲存] 或 [驗證並儲存]。

下列範例顯示 Azure 訂用帳戶的 Azure Resource Manager 連線。 您可以使用服務連線名稱作為azureSubscription管線工作中或對等的訂用帳戶名稱值。

[新增 Azure 服務連線] 畫面的螢幕快照。

檢視服務連線

若要檢視服務連線的相關信息,請從項目選取 [項目設定>服務連線],然後選取您想要檢視的服務連線。

  • [概觀] 索引標籤會顯示服務連線的詳細數據,例如連線類型、建立者和驗證類型。

    Azure Resource Manager 概觀頁面的螢幕快照。

  • [使用量歷程記錄] 索引標籤會顯示服務連線歷程記錄使用量的詳細數據。

    Azure Resource Manager 使用量歷程記錄的螢幕快照。

  • [ 核准和檢查 ] 索引標籤會顯示 允許管線階段使用服務連線的核准和檢查 。 若要新增核准和檢查,請選取 + 符號或 新增

    Azure Resource Manager 核准和檢查的螢幕快照。

編輯服務連線

  • 若要編輯服務連線屬性,請選取 服務連線頁面上的 [編輯 ]。 您可以編輯的參數取決於服務連線類型和驗證方法。

  • 您也可以在 [其他選項] 選單上選取 [安全性] 或 [刪除]。 如需管理安全性許可權的詳細資訊,請參閱 設定服務連線許可權

  • 若要編輯現有的核准和檢查,請從 [核准和檢查] 索引標籤上核准旁邊的 [更多選項] 功能選取。

編輯 Azure Resource Manager 服務連線方式的螢幕快照。

使用服務連線

若要在管線中使用服務連線:

  • 針對 YAML 管線,請使用程式代碼中的連線名稱作為 azureSubscription 或其他連線名稱值。

    YAML 服務連線設定的螢幕快照。

  • 針對 [傳統管線],選取 Azure 訂用帳戶中的連線名稱,或管線工作中的其他連線名稱設定。

    傳統服務連線設定的螢幕快照。

授權管線

  • 若要授權所有管線使用服務連線,請選取 [允許所有管線在聯機屬性中使用此聯機 ] 選項。

  • 若要授權單一管線使用服務連線:

    1. 選取 管線頁面上的 [執行管線 ] 以將手動組建排入佇列。
    2. 此管線需要許可權才能繼續執行之前存取資源訊息。 選取 訊息旁的 [檢視 ]。
    3. 在 [ 等候檢閱] 畫面上,選取 [ 允許],然後在確認畫面上,再次選取 [ 允許 ]。

    此動作會將管線明確新增為服務連線的授權使用者。

一般服務連線類型

Azure Pipelines 預設支援下列服務連線類型。 您也可以建立自己的 自定義服務連線

服務連線類型 描述
Azure 傳統 透過認證或憑證連線到您的 Azure 訂用帳戶。
Azure Repos/Team Foundation Server 聯機到 DevOps 組織或集合中的 Azure Repos。
Azure Resource Manager 聯機到 Azure 資源。
Azure 服務匯流排 聯機到 Azure 服務匯流排 佇列。
Bitbucket Cloud 線上到 Bitbucket Cloud 存放庫。
貨物 線上到 Cargo 套件存放庫。
Chef 線上到 Chef 存放庫。
Docker 主機 線上到 Docker 主機。
Docker 登錄 透過 Docker Hub、Azure Container Registry 或其他來源連線到 Docker 登錄。
通用 連接到泛型伺服器。
GitHub 線上到 GitHub 存放庫。
GitHub Enterprise Server 聯機到 GitHub Enterprise 存放庫。
傳入 Webhook 線上到連入 Webhook。
Jenkins 線上到 Jenkins 伺服器。
Jira 線上到 Jira 伺服器。
Kubernetes 線上到 Kubernetes 叢集。
Maven 線上到 Maven 存放庫。
npm \(英文\) 線上到 npm 存放庫。
NuGet (英文) 線上到 NuGet 伺服器。
其他 Git 線上到 Git 存放庫。
Python 套件下載 線上至 Python 存放庫以進行下載。
Python 套件上傳 線上至 Python 存放庫以進行上傳。
Service Fabric 聯機到 Azure Service Fabric 叢集。
SSH 透過SSH連線到主機。
Subversion 線上到 Apache Subversion 存放庫。
Visual Studio App Center 線上到 Visual Studio App Center 伺服器。

Azure 傳統服務連線

使用下列參數,使用 Azure 認證或 Azure 管理憑證,定義及保護與Microsoft Azure 訂用帳戶的連線。

參數 描述
驗證方法 必要。 選取 [認證] 或 [憑證型]。
Environment 必要。 選取 [Azure 雲端]、 [Azure Stack] 或其中一個定義訂用帳戶的預先 定義 Azure Government 雲端
訂用帳戶識別碼 必要。 Azure 訂用帳戶的 GUID 類似識別碼(而非訂用帳戶名稱)。 您可以從 Azure 入口網站 複製訂用帳戶標識碼。
訂用帳戶名稱 必要。 Microsoft Azure 訂用帳戶的名稱。
使用者名稱 認證驗證的必要專案。 公司或學校帳戶的用戶名稱(例如 @fabrikam.com)。 Microsoft帳戶(例如 @live 或 @hotmail) 不支援。
密碼 認證驗證的必要專案。 指定用戶的密碼。
管理憑證 憑證式驗證的必要專案。 從發行設定 XML 檔案或 Azure 入口網站 複製管理憑證金鑰的值。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

針對憑證驗證,選取 [ 驗證 ] 以驗證您的聯機資訊。

如果您的訂用帳戶是在 Azure Government Cloud定義,請確定您的應用程式符合相關的合規性需求,再設定服務連線。

Azure Repos

使用基本或令牌型驗證連線到 Azure DevOps 組織或專案集合。 使用下列參數來定義及保護與另一個 Azure DevOps 組織的連線。

參數 描述
驗證方法 選取 [令牌型] 或 [基本身份驗證]。
線上 URL 必要。 DevOps 組織或專案集合的URL。
使用者名稱 基本身份驗證的必要專案。 要連線至服務的用戶名稱。
密碼 基本身份驗證的必要專案。 所指定使用者的密碼。
個人存取權杖 令牌型驗證的必要專案。 要用來向服務進行驗證的令牌。 深入了解
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

選取 [ 驗證 ] 以驗證您的連線資訊。

如需詳細資訊,請參閱 使用 Azure DevOps 的個人存取令牌驗證存取權。

Azure Resource Manager 服務連線

如需建立 Azure Resource Manager 服務連線的相關信息,請參閱 使用 Azure Resource Manager 服務連線連線連線連線至 Azure。

Azure 服務匯流排 服務連線

若要增強安全性,請使用發行至 Azure 服務匯流排 v2 工作,而不是使用 Azure 服務匯流排 服務連線,將訊息傳送至 Azure 服務匯流排。 此版本的工作支援Microsoft Entra ID 和工作負載身分識別同盟。

Bitbucket Cloud 服務連線

使用 OAuth 搭配 授與授權 或使用者名稱和密碼搭配 基本身份驗證 ,以定義 Bitbucket Cloud 的連線。 若要讓管線持續運作,您的存放庫存取權必須保持作用中。

參數 描述
驗證方法 選取 [授與授權] 或 [基本身份驗證]。
OAuth 組態 授與授權的必要專案。 Bitbucket 的 OAuth 連線。
使用者名稱 基本身份驗證的必要專案。 要連線至服務的用戶名稱。
密碼 基本身份驗證的必要專案。 所指定使用者的密碼。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

選取 [驗證] 或 [授權] 來驗證您的連線資訊。

貨物服務連線

使用下列參數來定義及保護與 Cargo 成品存放庫的連線。

參數 描述
驗證方法 選擇成品存放庫的驗證方法:基本用戶名稱/密碼(包括 Azure DevOps PAT)授權值(包括 crates.io 令牌)。
存放庫 URL 必要。 存放庫的 URL。 針對 crates.io,請使用 https://crates.io
使用者名稱 選取 [基本身份驗證] 時為必要專案。 連接到端點的用戶名稱。 如果使用個人存取令牌或授權值驗證方法,此值可以是任意值。
密碼 選取 [基本身份驗證] 時為必要專案。 連線到端點的密碼。 個人存取令牌適用於 Azure DevOps Services 組織。
Token 選取 [授權值驗證] 時為必要專案。
服務連線名稱 服務連線的名稱
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

Chef 服務連線

使用下列參數來定義及保護與 Chef 自動化伺服器的連線

參數 描述
伺服器 URL 必要。 Chef 自動化伺服器的 URL。
節點名稱(使用者名稱) 必要。 要連接的節點名稱。 此參數通常是您的用戶名稱。
用戶端金鑰 必要。 Chef .pem 檔案中指定的索引鍵。
服務連線名稱 服務連線的名稱
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

Docker 主機服務連線

使用下列參數來定義及保護與 Docker 主機的連線。

參數 描述
伺服器 URL 必要。 Docker 主機的 URL。
CA 憑證 必要。 用來向主機進行驗證的受信任證書頒發機構單位憑證。
[MSSQLSERVER 的通訊協定內容] 必要。 用來向主機進行驗證的客戶端憑證。
機碼 必要。 Docker key.pem 檔案中指定的金鑰。
服務連線名稱 服務連線的名稱
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

如需保護 Docker 主機連線的詳細資訊,請參閱 保護 Docker 精靈套接字

Docker 登錄服務連線

您可以建立 Docker 容器登錄的服務連線。

選取登錄類型:

Docker Hub 或其他

輸入下列參數,以定義 Docker Hub 登錄或 其他人的連線。

參數 描述
Docker 登錄 必要。 Docker 登錄的 URL。
Docker 識別碼 必要。 Docker 帳戶用戶的標識碼。
Docker 密碼 必要。 Docker 識別碼的密碼。 (Docker Hub 需要 PAT 而非密碼。
電子郵件 選擇性。 要接收通知的電子郵件位址。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

您可以選取 [ 驗證 ] 來驗證認證,再輸入其餘的參數。

Azure Container Registry

Azure DevOps Server 中無法使用 Azure Container Registry。

您可以使用服務主體、受控識別工作負載身分識別同盟驗證類型來聯機到 Azure Container Registry。

服務主體驗證類型

輸入下列參數,以使用服務主體定義與 Azure Container Registry 的連線。

參數 描述
訂用帳戶 必要。 Azure 訂用帳戶,其中包含要用於服務連線建立的容器登錄。
Azure Container Registry 必要。 要用於建立服務連線的 Azure Container Registry。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。
受控識別驗證類型

輸入下列參數,以使用 受控服務識別來定義與 Azure Container Registry 的連線

參數 描述
訂用帳戶識別碼 必要。 Azure 訂用帳戶的 GUID 類似識別碼(而非訂用帳戶名稱)。 您可以從 Azure 入口網站 複製訂用帳戶標識碼。
訂用帳戶名稱 必要。 Microsoft Azure 訂用帳戶的名稱。
租用戶識別碼 必要。 Microsoft Entra ID 租使用者的 GUID 類似標識碼。 您可以從 Azure 入口網站 複製租使用者標識碼。
Azure Container Registry 登入伺服器 必要。 Azure Container Registry 的登入伺服器。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。
工作負載身分識別同盟驗證類型

輸入下列參數,以使用 工作負載身分識別同盟來定義與 Azure Container Registry 的連線。

參數 描述
訂用帳戶 必要。 Azure 訂用帳戶,其中包含用於服務連線建立的容器登錄。
Azure Container Registry 必要。 用來建立服務連線的 Azure Container Registry 實例。
連線名稱 必要。 用來在工作屬性中參考服務連線的名稱。 針對 YAML 管線,請使用名稱作為 腳本中的 azureSubscription 或其他連線名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

一般服務連線

使用下列參數來定義及保護任何一般服務或應用程式的連線。

參數 描述
伺服器 URL 必要。 服務的 URL。
使用者名稱 選擇性。 要連線至服務的用戶名稱。
密碼/令牌金鑰 選擇性。 指定之使用者名稱的密碼或存取令牌。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

GitHub 服務連線

使用下列參數來定義 GitHub 存放庫的連線。

參數 描述
選擇授權 必要。 授與授權個人存取令牌
Token 個人存取令牌授權的必要專案。 您的 GitHub 個人存取令牌 (PAT)。
授與授權 授與授權的必要專案。 用來連線至服務的 OAuth 組態。 例如,選取 [AzurePipelines ] 以連線 Azure Pipeline。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

注意

如果您選取 [選擇授權] 選項的 [授與授權] 選項,對話框會顯示開啟 GitHub 簽署頁面的 [授權] 按鈕。 如果您選取 [ 個人存取令牌],請將它貼到 [令牌 ] 文本框中。 對話框會顯示令牌的建議範圍: 存放庫、使用者、admin:repo_hook。 如需詳細資訊,請參閱 建立命令行使用的 存取令牌,然後完成下列步驟以在配置檔中註冊 GitHub 帳戶。

  1. 在 Azure Pipelines 頁面標題右側,從您的帳戶名稱開啟您的 用戶設定
  2. 選擇 [ 個人存取令牌]。
  3. 選取 [ 新增 ],然後輸入建立令牌所需的資訊。

如需詳細資訊,請參閱 成品來源 - 版本控制

GitHub Enterprise Server 服務連線

使用下列參數來定義 GitHub Enterprise 存放庫的連線。

提示

其他 Git 伺服器和標準 GitHub 服務連線有特定的服務連線

參數 描述
選擇授權 必要。 個人存取令牌用戶名稱和密碼OAuth2
伺服器 URL 必要。 服務的 URL。
接受不受信任的 TLS/SSL 憑證 設定此選項可讓用戶端接受自我簽署憑證,而不是在 Azure Pipelines 服務角色或裝載 代理程式的電腦中安裝憑證。
Token 個人存取令牌授權的必要專案。
使用者名稱 使用者名稱和密碼驗證的必要專案。 要連線至服務的用戶名稱。
密碼 使用者名稱和密碼驗證的必要專案。 所指定使用者的密碼。
OAuth 組態 OAuth2 授權的必要專案。 您可以使用現有的 OAuth 組態,或建立新的組態。
GitHub Enterprise Server 組態 URL URL 會從 OAuth 組態擷取。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

注意

如果您選取 [ 個人存取令牌 ],則必須將 PAT 貼到 [令牌 ] 文本框中。 對話框會顯示令牌的建議範圍: 存放庫、使用者、admin:repo_hook。 如需詳細資訊,請參閱 建立命令行使用的 存取令牌,然後完成下列步驟以在配置檔中註冊 GitHub 帳戶。

  1. 在 Azure Pipelines 頁面標題右側,從您的帳戶名稱開啟您的 用戶設定
  2. 選擇 [ 個人存取令牌]。
  3. 選取 [ 新增 ],然後輸入建立令牌所需的資訊。

連入 WebHook 服務連線

使用下列參數來建立傳入的 Webhook 服務連線。

參數 描述
WebHook 名稱 必要。 WebHook 的名稱。
祕密 選擇性。 用來向 WebHook 進行驗證的秘密。
HTTP 標頭 選擇性。 傳送總和檢查碼的標頭名稱。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

Jenkins 服務連線

使用下列參數來定義 Jenkins 服務的連線。

參數 描述
伺服器 URL 必要。 Jenkins 伺服器的 URL。
接受不受信任的 TLS/SSL 憑證 設定此選項可讓用戶端接受自我簽署憑證,而不是在 Azure Pipelines 服務角色或裝載 代理程式的電腦中安裝憑證。
使用者名稱 必要。 要連線至服務的用戶名稱。
密碼 必要。 所指定使用者的密碼。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

您可以選取 [ 驗證 ] 來驗證認證,再輸入其餘的參數。

如需詳細資訊,請參閱 Azure Pipelines 與 JenkinsArtifact 來源整合 - Jenkins

Jira 服務連線

使用下列參數來定義與 Jira 服務的連線。

參數 描述
伺服器 URL 必要。 Jira 伺服器的 URL。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

Kubernetes 服務連線

當您定義 Kubernetes 叢集的連線時,請使用下列參數。 從下列選項中選擇 [驗證] 方法

  • Kubeconfig
  • 服務帳戶
  • Azure 訂用帳戶

Kubeconfig 選項

參數 描述
Kubeconfig 必要。 kubeconfig 檔案的內容。
叢集內容 選擇性。 要用來識別叢集之 kubeconfig 檔案內的內容。
Accept untrusted certificates 設定此選項可讓用戶端接受自我簽署憑證。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

服務帳戶選項

參數 描述
伺服器 URL 必要。 叢集的 API 伺服器 URL。
祕密 與要用於部署之服務帳戶相關聯的秘密。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

使用下列命令來擷取伺服器 URL。

kubectl config view --minify -o 'jsonpath={.clusters[0].cluster.server}'

使用下列命令序列來擷取連線和驗證叢集所需的 Secret 物件。

kubectl get serviceAccounts <service-account-name> -n <namespace> -o 'jsonpath={.secrets[*].name}'

在下列命令中,將 取代 service-account-secret-name 為上一個命令的輸出。

kubectl get secret <service-account-secret-name> -n <namespace> -o json

將 YAML 窗體中擷取的 Secret 物件複製並貼到 [秘密] 文字欄位中。

注意

使用服務帳戶選項時,請確定 RoleBinding 存在,這會授與所需服務帳戶的許可權editClusterRole。 這是必要的,讓 Azure Pipelines 可以使用服務帳戶,在所選的命名空間中建立物件。

Azure 訂用帳戶選項

參數 描述
Azure 訂用帳戶 必要。 包含要用於服務連線建立之叢集的 Azure 訂用帳戶。
Cluster Azure Kubernetes Service 叢集的名稱。
Namespace 叢集中Namespace。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

針對已啟用 Azure RBAC 的叢集,ServiceAccount 會連同 RoleBinding 物件一起在所選命名空間中建立,讓建立的 ServiceAccount 只能在所選的命名空間上執行動作。

針對已停用 Azure RBAC 的叢集,ServiceAccount 會在所選的命名空間中建立,但所建立的 ServiceAccount 具有全叢集許可權(跨命名空間)。

注意

此選項會列出服務連線建立者可跨不同 Azure 租使用者存取 的所有訂用帳戶。 如果您看不到來自其他 Azure 租使用者的訂用帳戶,請檢查這些租使用者中的 Microsoft Entra 許可權。

Maven 服務連線

當您定義並保護與 Maven 存放庫的連線時,請使用下列參數。

參數 描述
驗證方法 必要。 選取 [用戶名稱] 和 [密碼] 或 [驗證令牌]。
登錄 URL 必要。 Maven 存放庫的 URL。
登錄標識碼 必要。 符合 Maven 嘗試連線之存放庫/鏡像之 ID 元素的伺服器識別碼。
使用者名稱 當連線類型為 [用戶名稱] 和 [密碼] 時,則為必要專案。 驗證的用戶名稱。
密碼 當連線類型為 [用戶名稱] 和 [密碼] 時,則為必要專案。 使用者名稱的密碼。
個人存取權杖 當連線類型為 驗證令牌時,為必要專案。 要用來向服務進行驗證的令牌。 深入了解
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

npm 服務連線

當您定義並保護與 npm 伺服器的連線時,請使用下列參數。

參數 描述
驗證方法 必要。 選取 [用戶名稱] 和 [密碼] 或 [驗證令牌]。
登錄 URL 必要。 Maven 存放庫的 URL。
使用者名稱 當連線類型為 [用戶名稱] 和 [密碼] 時,則為必要專案。 驗證的用戶名稱。
密碼 當連線類型為 [用戶名稱] 和 [密碼] 時,則為必要專案。 使用者名稱的密碼。
個人存取權杖 已選取必要的 驗證令牌 。 要向服務或登錄進行驗證的個人存取令牌 (PAT)。 PAT 適用於支持它們的存放庫,例如 https://registry.npmjs.org DevOps Services 組織或 Azure DevOps Server。 如需詳細資訊,請參閱 使用個人存取令牌
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

NuGet 服務連線

當您定義並保護與 NuGet 伺服器的連線時,請使用下列參數。

參數 描述
驗證方法 必要。 選取 [ApiKey]、 [外部 Azure Pipelines] 或 [ 基本身份驗證]。
摘要 URL 必要。 NuGet 伺服器的 URL。
ApiKey 線上類型為 ApiKey 時為必要專案。 驗證金鑰。
個人存取權杖 當連線類型為 外部 Azure Pipelines 時,為必要專案。 用來向其他 Azure 服務組織或 Azure DevOps Server 上的 NuGet 摘要進行驗證的令牌。 服務。 如需詳細資訊,請參閱 使用個人存取令牌
使用者名稱 當連線類型為 基本身份驗證時,則為必要專案。 驗證的用戶名稱。
密碼 當連線類型為 基本身份驗證時,則為必要專案。 使用者名稱的密碼。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

若要設定 NuGet 向 Azure Artifacts 和其他 NuGet 存放庫進行驗證,請參閱 NuGet 驗證

其他 Git 服務連線

使用下列參數來定義及保護與外部 Git 存放庫伺服器的連線。 GitHub 和 GitHub Enterprise Server 有特定的服務連線

參數 描述
Git 存放庫 URL 必要。 Git 存放庫伺服器的 URL。
嘗試從 Azure Pipelines 存取此 Git 伺服器 核取時,Azure Pipelines 會在佇列管線執行之前嘗試連線到存放庫。 您可以使用無法公開存取的存放庫,停用此設定來改善效能。 當無法公開存取其他 Git 存放庫時,CI 觸發程式將無法運作。 您只能啟動手動或排程的管線執行。
使用者名稱 選擇性。 要連線到 Git 存放庫伺服器的用戶名稱。
密碼/令牌 選擇性。 指定之使用者名稱的密碼或存取令牌。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

如需詳細資訊,請參閱 成品來源

Python 套件下載服務連線

當您定義並保護 Python 存放庫的連線以下載 Python 套件時,請使用下列參數。

參數 描述
驗證方法 必要。 選取 [用戶名稱] 和 [密碼] 或 [驗證令牌]。
用於下載的 Python 存放庫 URL 必要。 Python 摘要的 URL。
個人存取權杖 當連線類型為 驗證令牌時,為必要專案。 用來向支援 Python 摘要和 DevOps Services 組織的個人存取令牌 (PAT) 進行驗證。 如需詳細資訊,請參閱 使用個人存取令牌
使用者名稱 當連線類型為 [用戶名稱] 和 [密碼] 時,則為必要專案。 驗證的用戶名稱。
密碼 當連線類型為 [用戶名稱] 和 [密碼] 時,則為必要專案。 使用者名稱的密碼。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

Python 套件上傳服務連線

當您定義並保護 Python 存放庫的連線以上傳 Python 套件時,請使用下列參數。

參數 描述
驗證方法 必要。 選取 [用戶名稱] 和 [密碼] 或 [驗證令牌]。
用於上傳的 Python 存放庫 URL 必要。 Python 摘要的 URL。
EndpointName 必要。 用於對應項上傳的唯一存放庫。 不允許空格和特殊字元。
個人存取權杖 請參閱 使用個人存取令牌
使用者名稱 當連線類型為 [用戶名稱] 和 [密碼] 時,則為必要專案。 驗證的用戶名稱。
密碼 當連線類型為 [用戶名稱] 和 [密碼] 時,則為必要專案。 使用者名稱的密碼。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

Service Fabric 服務連線

建立 Service Fabric 叢集的服務連線時,您有三個選項可用於驗證方法: 憑證型Microsoft Entra 認證或使用 gMSA 的 Windows 安全性。

憑證式驗證選項

參數 描述
叢集端點 必要。 叢集的用戶端連線端點。 在值前面加上 tcp://。 此值會覆寫發行配置檔。
伺服器證書查閱 當連線類型為憑證型或Microsoft Entra 認證時,請選取 [指紋] 或 [一般名稱]。
伺服器憑證指紋(s) 當連線類型為憑證式Microsoft Entra 認證,而伺服器認證查閱為指紋時,則為必要專案。 用來驗證叢集身分識別之叢集憑證的指紋。 此值會覆寫發行配置檔。 以逗號分隔多個指紋(',')
用戶端憑證 當連線類型為 憑證型別時,為必要專案。 叢集用戶端憑證檔案的Base64編碼。 您可以使用下列 PowerShell 腳本來編碼憑證: [System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes("C:\path\to\certificate.pfx"))
使用者名稱 連接類型Microsoft Entra 認證時為必要專案。 驗證的用戶名稱。
密碼 連接類型Microsoft Entra 認證時為必要專案。 當驗證方法是以憑證為基礎時為選擇性。 憑證密碼。
擔保 選擇性。 選取此選項可略過 Windows 安全性驗證。
叢集SPN 選擇性。 如果已選取 [不安全],則適用。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

Microsoft Entra 認證驗證選項

參數 描述
叢集端點 必要。 叢集的用戶端連線端點。 在值前面加上 tcp://。 此值會覆寫發行配置檔。
伺服器證書查閱 選取 指紋一般名稱
伺服器憑證指紋(s) 當連線類型為憑證式Microsoft Entra 認證,而伺服器認證查閱為指紋時,則為必要專案。 用來驗證叢集身分識別之叢集憑證的指紋。 此值會覆寫發行配置檔。 以逗號分隔多個指紋(',')
伺服器憑證一般名稱(s) 伺服器證書查閱是 一般名稱時的必要專案。 用來驗證叢集身分識別之叢集憑證的一般名稱。 此值會覆寫發行配置檔。 以逗號分隔多個通用名稱(',')
用戶端憑證 當連線類型為 憑證型別時,為必要專案。 叢集用戶端憑證檔案的Base64編碼。 您可以使用下列 PowerShell 腳本來編碼憑證: [System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes("C:\path\to\certificate.pfx"))
密碼 連接類型Microsoft Entra 認證時為必要專案。 當驗證方法是以憑證為基礎時為選擇性。 憑證密碼。
擔保 選擇性。 選取此選項可略過 Windows 安全性驗證。
叢集SPN 選擇性。 如果已選取 [不安全],則適用。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

使用 gMSA 驗證選項的 Windows 安全性

參數 描述
叢集端點 必要。 叢集的用戶端連線端點。 在值前面加上 tcp://。 此值會覆寫發行配置檔。
擔保 選擇性。 選取此選項可略過 Windows 安全性驗證。
叢集SPN 選擇性。 gMSA 帳戶的完整網域 SPN。 只有在停用 [不安全] 選項時,才適用此參數。 如需搭配叢集使用 gMSA 的詳細資訊,請參閱 使用 gMSA 設定 Windows 安全性
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

SSH 服務連線

當您使用安全殼層 (SSH) 定義及保護遠端主機的連線時,請使用下列參數。

參數 描述
Host name 必要。 遠端主電腦或IP位址的名稱。
連接埠號碼 必要。 遠端主電腦的埠號碼。 預設值為埠 22。
私密金鑰 如果使用這種類型的驗證,則為私鑰檔案的整個內容。
使用者名稱 必要。 連接到遠端主電腦時要使用的用戶名稱。
密碼/複雜密碼 如果使用keypair作為認證,則為指定使用者名稱的密碼或複雜密碼。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

如需詳細資訊,請參閱 SSH 工作透過 SSH 複製檔案。

Subversion 服務連線

當您定義並保護與 Subversion 存放庫的連線時,請使用下列參數。

參數 描述
Subversion 存放庫 URL 必要。 Subversion 存放庫的 URL。
接受不受信任的 TLS/SSL 憑證 選取此選項可讓SVN用戶端接受自我簽署的SSL伺服器憑證,而不需要將它們安裝到 Azure DevOps 服務角色,並建置 Agent 計算機。
領域名稱 如果 Subversion 外部的服務連線,則為必要專案。 如果您在組建或發行管線中使用多個認證,請使用此參數來指定包含服務連線所指定認證的領域。
使用者名稱 必要。 要連線至服務的用戶名稱。
密碼 必要。 所指定使用者的密碼。
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

您可以透過幾種方式找到領域名稱:

  • 如果您透過 HTTP 或 HTTPS 存取存放庫:在不儲存認證的情況下,在網頁瀏覽器中開啟存放庫。 它會在驗證對話框中使用領域名稱。

  • 使用 svn 命令行。 如果您儲存認證,請執行 例如 svn info https://svnserver/repo 領域名稱會在要求您輸入密碼時顯示。

  • 如果您儲存認證以存取存放庫,請在使用者配置檔的 Subversion 驗證快取區段中尋找其中一個檔案中的領域名稱。 例如~ /.subversion/auth/svn/simpleC:\Users\yourname\Application Data\Subversion\auth\svn.simple

Visual Studio App Center 服務連線

當您定義及保護與 Visual Studio App Center 的連線時,請使用下列參數。

參數 描述
伺服器 URL 必要。 App Center 服務的 URL。
API 權杖 必要。 要用來向服務進行驗證的令牌。 如需詳細資訊,請參閱 API 檔
連線名稱 必要。 您用來在工作屬性中參考服務連線的名稱。 如果您使用 YAML,請使用名稱作為 腳本中的 azureSubscription 或對等的訂用帳戶名稱值。
描述 選擇性。 服務連線的描述。
安全性 選擇性。 選取 [ 授與所有管線 的訪問許可權] 以允許所有管線使用此聯機。 如果您未選取此選項,您必須明確授權使用該選項的每個管線的服務連線。

其他服務連線的擴充功能

其他服務連線類型和工作可以安裝為延伸模組。 請參閱下列可透過擴充功能取得的服務連線範例:

  • System Center Virtual Machine Manager (SCVMM) 整合。 線上到 SCVMM 伺服器以佈建虛擬機,並對其執行動作,例如:

    • 管理檢查點
    • 啟動與停止虛擬機器 (VM)
    • 執行 PowerShell 指令碼
  • VMware 資源部署。 從 Visual Studio Team Services 或 Team Foundation Server 連線到 VMware vCenter Server,以布建、啟動、停止或快照 VMware 虛擬機。

  • Power Platform Build Tools。 使用Microsoft Power Platform 建置工具,將與建置Microsoft Power Platform 上的應用程式相關的一般建置和部署工作自動化。 安裝擴充功能之後, Power Platform 服務連線類型具有下列屬性。

    參數 描述
    連線名稱 必要。 您用來在工作屬性中參考此服務連線的名稱。
    伺服器 URL 必要。 Power Platform 實例的 URL。 範例: https://contoso.crm4.dynamics.com
    租用戶識別碼 必要。 要驗證的租用戶標識碼(也稱為 Azure 入口網站 中的目錄標識符)。 https://aka.ms/buildtools-spn如需顯示租使用者識別碼並設定應用程式識別碼和相關聯客戶端密碼的文稿,請參閱 。 應用程式用戶也必須 在 CDS 中建立
    應用程式識別碼 必要。 Azure 應用程式 用來驗證的標識碼。
    應用程式識別碼的客戶端密碼 必要。 與上述應用程式識別碼相關聯的服務主體客戶端密碼,用來證明身分識別。

您也可以建立自己的 自定義服務連線

說明與支援