建立和管理代理程式集區 (英文)

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

代理程式集區是代理程式的集合。 您不必個別管理每個 代理程式 ，而是將代理程序組織到代理程式集區。 當您設定代理程式時，它會向單一集區註冊，而當您建立管線時，您會指定管線執行所在的集區。 當您執行管線時，它會在該集區中符合 管線需求的 代理程式上執行。

在 Azure Pipelines 中，集區的範圍會限定於整個組織;因此，您可以跨專案共用代理程序機器。

注意

代理程式集區作業會在單一代理程式上執行作業。 如果您需要在所有代理程式上執行作業，例如傳統發行管線的部署群組，請參閱 布建部署群組。

如果您是組織系統管理員，您可以在系統管理員設定中，從 [代理程式集區] 索引卷標建立和管理代理程式集區。

1. 登入您的組織 (https://dev.azure.com/{yourorganization})。

2. 選擇 [Azure DevOps]、 [組織設定]。

   

3. 選擇 [ 代理程式集區]。

   

如果您是專案小組成員，您可以從項目設定中的 [代理程式集區] 索引標籤建立和管理代理程式集區。

流覽至您的專案，然後選擇 [項目設定]、 [代理程式集區]。

預設代理程式集區

預設會提供下列代理程式集區：

• 默認 集區：使用它來註冊 您已設定的自我裝載代理程式 。

• 具有各種 Windows、Linux 和 macOS 映像的 Azure Pipelines 裝載集區。 如需可用映像及其已安裝軟體的完整清單，請參閱 Microsoft 裝載的代理程式。

  注意

  Azure Pipelines 裝載的集區會取代先前裝載的集區，這些集區的名稱對應至對應的映像。 您在先前裝載集區中擁有的任何作業都會自動重新導向至新 Azure Pipelines 裝載集區中的正確映像。 在某些情況下，您仍可能會看到舊的集區名稱，但裝載作業會在幕後使用 Azure Pipelines 集區執行。 如需詳細資訊，請參閱 2019 年 7 月 1 日 - Sprint 154 版本資訊中的單一裝載集區版本資訊。

根據預設，專案中的所有參與者都是託管集區上使用者角色的成員。 這可讓專案中的每個參與者使用 Microsoft 裝載的代理程式來撰寫和執行管線。

在管線中指定集區

YAML

若要從 Azure DevOps Services YAML 管線中的 Azure Pipelines 集區選擇 Microsoft 裝載的代理程式，請使用下表中的 YAML VM 映射卷標來指定映像的名稱。

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

若要使用不需的私人集區：

pool: MyPool

如需詳細資訊，請參閱集區的 YAML 架構。

傳統

若要在傳統編輯器中選擇集區和代理程式，請流覽至管線設定、選取所需的 Agent 集區，然後從 [代理程序規格 ] 下拉式清單中選取所需的映像。 默認 代理程式規格 為 windows-2019。 如需 Microsoft 裝載映射上所安裝軟體的詳細資訊，請參閱下表中 [傳統編輯器集區] 資料行中的對應專案。

管理集區和佇列

瀏覽器

如果您是組織系統管理員，您可以在系統管理員設定中，從 [代理程式集區] 索引卷標建立和管理代理程式集區。

1. 登入您的組織 (https://dev.azure.com/{yourorganization})。

2. 選擇 [Azure DevOps]、 [組織設定]。

   

3. 選擇 [ 代理程式集區]。

   

如果您是專案小組成員，您可以從項目設定中的 [代理程式集區] 索引標籤建立和管理代理程式集區。

流覽至您的專案，然後選擇 [項目設定]、 [代理程式集區]。

Azure DevOps CLI

列出代理程式集區 顯示代理程式集 | 區詳細數據 | 列出代理程式佇列 | 顯示代理程式佇列詳細數據

注意

此時，您可以使用 Azure CLI 來檢視代理程式集區和佇列的相關信息，但無法編輯它們。

如果這是您第一次使用 az devops pipelines 命令，請參閱 開始使用 Azure DevOps CLI。

列出代理程式集區

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

參數

• action：使用允許的用戶動作來篩選清單。 接受的值： 管理、 無、 使用
• detect：自動偵測組織。 接受的值： false、 true
• 組織或組織：Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例： https://dev.azure.com/MyOrganizationName/。
• pool-name：使用相符的集區名稱篩選清單。
• pool-type：使用集區類型的篩選清單。 接受的值： 自動化、 部署

範例

下列範例會列出數據表格式的所有集區。 此範例會使用下列預設組態： az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool list --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

顯示代理程式集區詳細數據

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

參數

• 標識碼 或 集區標識碼:(必要）集區標識碼，以列出詳細數據。
• action：使用允許的用戶動作來篩選清單。 接受的值： 管理、 無、 使用
• detect：自動偵測組織。 接受的值： false、 true
• 組織或組織：Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例： https://dev.azure.com/MyOrganizationName/。

範例

下列範例會顯示具有 VS2019 集區的託管 Windows 2019 集區詳細數據。 此範例會使用下列預設組態： az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

您也可以使用 --output table 傳回與 list 命令相同的資訊。

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

列出代理程式佇列

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

參數

• action：使用允許的用戶動作來篩選清單。 接受的值： 管理、 無、 使用
• detect：自動偵測組織。 接受的值： false、 true
• 組織或組織：Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例： https://dev.azure.com/MyOrganizationName/。
• 專案 或 p：專案的名稱或識別碼。 您可以使用 來設定預設專案 az devops configure -d project=NAME_OR_ID。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。
• queue-name：使用相符的佇列名稱 regex 篩選清單，例如 ，名稱為 'Hosted Ubuntu 1604' 的佇列 ubuntu 。

範例

下列範例會列出數據表格式的所有佇列。 此範例會使用下列預設組態： az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue list --output table
This command group is in preview. It may be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

顯示代理程式佇列詳細數據

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

參數

• id 或 queue-id：要取得相關信息之代理程式佇列的標識碼。
• action：使用允許的用戶動作來篩選清單。 接受的值： 管理、 無、 使用
• detect：自動偵測組織。 接受的值： false、 true
• 組織或組織：Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例： https://dev.azure.com/MyOrganizationName/。
• 專案 或 p：專案的名稱或識別碼。 您可以使用 來設定預設專案 az devops configure -d project=NAME_OR_ID。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。

範例

下列範例會顯示具有 VS2019 佇列之託管 Windows 2019 的佇列詳細數據。 此範例會使用下列預設組態： az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

集區用於執行作業。 了解如何為作業指定集區。

如果您有許多適用於不同小組或用途的自我裝載代理程式，您可能會想要建立其他集區，如下所述。

建立代理程式集區

以下是您可能想要建立自我裝載代理程式集區的一些典型情況：

• 您是項目的成員，而且您想要使用小組所擁有的一組機器來執行建置和部署作業。 首先，在 [項目設定] 的 [代理程式集區] 頁面上選取 [安全性]，確定您擁有在專案中建立集區的許可權。 您必須具有 管理員 istrator 角色，才能建立新的集區。 接下來，選取 [新增集區 ]，然後選取選項以建立 新的 集區。 最後 ，安裝 並設定代理程式成為該代理程式集區的一部分。

• 您是基礎結構小組的成員，而且想要設定代理程式集區以用於所有專案。 首先，在 [組織設定] 的 [代理程式集區] 頁面上選取 [安全性]，確定您擁有在專案中建立集區的許可權。 接下來，建立新的代理程式集區，然後在建立集區時，選取在所有專案中自動布建此代理程式集區的選項。 此設定可確保所有專案都能存取此代理程式集區。 最後 ，安裝 並設定代理程式成為該代理程式集區的一部分。

• 您想要與多個專案 (而非所有專案) 共用一組代理程式電腦。 首先，流覽至其中一個項目的設定、新增代理程式集區，然後選取選項以在組織層級建立 新的 集區。 接下來，移至其他每個專案，並在選取 [從組織使用現有的代理程式集區] 選項 時，在每個專案中建立集區。 最後， 安裝 並設定代理程式成為共用代理程式集區的一部分。

代理程式集區安全性

了解代理程式集區的安全性如何運作，可協助您控制代理程式的共用和使用。

角色 會定義在每個代理程式集區上，而 這些角色中的成員資格 會控管您可以在代理程式集區上執行的作業。

組織層級安全性設定

組織設定中代理程式集區的角色	目的
讀者	此角色的成員可以檢視代理程式集區和代理程式。 您通常會使用此專案來新增負責監視代理程式及其健康情況的操作員。
服務帳戶	此角色的成員可以使用組織代理程式集區，在專案中建立專案代理程式集區。 如果您遵循上述建立新專案代理程式集區的指導方針，您通常不需要在此新增任何成員。
系統管理員	除了上述所有許可權之外，此角色的成員也可以從組織代理程式集區註冊或取消註冊代理程式。 在專案中建立專案代理程式集區時，這些成員也可以參考組織代理程式集區。 最後，這些成員還可以管理組織代理程式集區所有角色的成員資格。 建立組織代理程式集區的用戶會自動新增至該集區的 管理員 istrator 角色。

[代理程式集區] 索引標籤中的 [所有代理程式集區] 節點可用來控制所有組織代理程式集區的安全性。 個別組織代理程式集區的角色成員資格會自動繼承自「所有代理程式集區」節點的角色成員資格。 根據預設，使用 TFS 或 Azure DevOps Server 時，TFS 和 Azure DevOps Server 也是「所有代理程式集區」節點的系統管理員。

專案層級安全性設定

角色也會在每個專案代理程式集區上定義，而這些角色中的成員資格會控管您可以在專案層級的代理程式集區上執行的作業。

項目設定中的代理程式集區角色	目的
讀者	此角色的成員可以檢視專案代理程式集區。 您通常會使用此專案來新增負責監視該專案代理程式集區中建置和部署作業的操作員。
User	撰寫管線時，此角色的成員可以使用專案代理程式集區。
系統管理員	除了上述所有作業之外，此角色的成員還可以管理專案代理程式集區所有角色的成員資格。 建立集區的使用者會自動新增至該集區的管理員角色。

管線權限

管線權限可控制哪些 YAML 管線有權使用代理程式集區。 管線許可權不會限制傳統管線的存取。

您可以選擇下列選項：

• 開啟所有管線的存取權，以從代理程式集區安全性索引卷標中 [管線許可權] 區段右上角的更多選項使用代理程式集區。

• 鎖定代理程式集區，只允許選取的 YAML 管線使用。 如果任何其他 YAML 管線參考代理程式集區，就會引發授權要求，該要求必須由代理程式集區管理員核准。 這不會限制來自傳統管線的存取。

無法設定 Azure Pipelines 代理程式集區的管線許可權，因為集區預設可存取所有管線。

[代理程式集區] 索引標籤中的 [安全性] 動作可用來控制專案中所有專案代理程式集區的安全性。 個別專案代理程式集區的角色成員資格，會自動繼承自您此定義的專案。 根據預設，下列群組會新增至「所有代理程式集區」的管理員角色：組建管理員、發行管理員、專案系統管理員。

常見問題集

如果我未排程維護期間，代理程式何時會執行維護？

如果沒有排程任何視窗，則該集區中的代理程式將不會執行維護作業。

什麼是維護作業？

您可以將代理程式集區設定為定期清除過時的工作目錄和存放庫。 這應該可減少代理程式用盡磁碟空間的可能性。 維護作業是在代理程式集區設定中的組織層級設定。

若要設定維護作業設定：

1. 登入您的組織 (https://dev.azure.com/{yourorganization})。

2. 選擇 [Azure DevOps]、 [組織設定]。

   

3. 選擇 [ 代理程式集區]。

   

選擇所需的集區，然後選擇 設定 來設定該代理程式集區的維護作業設定。

重要

您必須擁有 管理組建佇列 許可權，才能設定維護作業設定。 如果您沒有看到 [設定] 索引標籤或 [維護歷程記錄] 索引標籤，則沒有該許可權，預設會授與 管理員 istrator 角色。 如需詳細資訊，請參閱 代理程式集區的安全性。

設定您想要的設定，然後選擇 [ 儲存]。

選取 [維護歷程記錄 ] 以查看目前代理程式集區的維護作業歷程記錄。 您可以下載並檢閱記錄，以查看所採取的清除步驟和動作。

維護是依代理程式集區完成，而不是每部機器;因此，如果您在單一計算機上有多個代理程式集區，您仍可能會遇到磁碟空間問題。

自我裝載式代理程式集區的維護作業似乎停滯中。 原因為何？

一般而言，當維護作業等候於不再位於代理程式集區的代理程式上執行時，便會發生「停滯」。 例如，當代理程式確實離線或與代理程式通訊時發生問題時，便會發生此情況。

已排入佇列等候執行的維護作業將等候七天才會執行。 隨後，如果未執行，則會自動設定為失敗狀態。 無法變更此時間限制。

七天限制不同於維護作業逾時設定。 後者控制代理程式執行維護時可花費的分鐘數上限。 計時器會在作業開始時啟動，而不是在代理程式上排入佇列時才啟動。

我嘗試建立使用現有組織代理程式集區的專案代理程式集區，但控件呈現灰色。為什麼？

在 [建立專案代理程式集區] 對話框中，如果已由另一個專案代理程式集區參考現有的組織代理程式集區，則您無法使用現有的組織代理程式集區。 每個組織代理程式集區只能由指定專案集合內的一個專案代理程式集區參考。

我無法選取 Microsoft 裝載集區且無法將組建排入佇列。 我要如何修正此問題？

要求 Azure DevOps 組織的擁有者授與您使用集區的權限。 請參閱代理程式集區安全性。

我需要更多裝載的組建資源。 我能做什麼?

答：Azure Pipelines 集區會提供所有 Azure DevOps 組織雲端裝載的組建代理程式，並每月免費建置分鐘數。 如果您需要更多 Microsoft 裝載的組建資源，或需要平行執行更多作業，則可以：

• 在您所管理的基礎結構上裝載您自己的代理程式
• 購買其他平行作業