Ügynökkészletek létrehozása és kezelése

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Az ügynökkészletek ügynökök gyűjteményei. Ahelyett, hogy minden ügynököt külön kezel, ügynökkészletekbe rendezheti az ügynököket. Amikor konfigurál egy ügynököt, az egyetlen készlettel van regisztrálva, és amikor létrehoz egy folyamatot, meg kell adnia azt a készletet, amelyben a folyamat fut. A folyamat futtatásakor a folyamat egy olyan ügynökön fut a készletből, amely megfelel a folyamat igényeinek .

Az Azure Pipelinesban a készletek a teljes szervezetre kiterjednek; így megoszthatja az ügynökgépeket projektek között.

Feljegyzés

Az ügynökkészlet-feladatok egyetlen ügynökön futtatnak feladatot. Ha minden ügynökön futtatnia kell egy feladatot, például egy központi telepítési csoportot a klasszikus kiadási folyamatokhoz, tekintse meg az üzembehelyezési csoportok kiépítését.

Ha Ön szervezeti rendszergazda, az ügynökkészleteket a rendszergazdai beállítások ügynökkészletek lapján hozhatja létre és kezelheti.

1. Jelentkezzen be a szervezetbe (https://dev.azure.com/{yourorganization}).

2. Válassza az Azure DevOps szervezeti beállításait.

   

3. Válassza az Ügynökkészletek lehetőséget.

   

Ha Ön projektcsapat-tag, az ügynökkészleteket a projektbeállítások ügynökkészletek lapján hozhatja létre és kezelheti.

Lépjen a projekthez, és válassza a Projektbeállítások, Ügynökkészletek lehetőséget.

Alapértelmezett ügynökkészletek

Alapértelmezés szerint a következő ügynökkészletek vannak megadva:

• Alapértelmezett készlet: Ezzel regisztrálhatja a saját üzemeltetésű ügynököket , amelyeket beállított.

• Az Azure Pipelines által üzemeltetett készlet különböző Windows, Linux és macOS rendszerképekkel rendelkezik. Az elérhető képek és a telepített szoftverek teljes listáját a Microsoft által üzemeltetett ügynökökben találja.

  Feljegyzés

  Az Azure Pipelines által üzemeltetett készlet lecseréli azokat a korábbi üzemeltetett készleteket, amelyek nevei a megfelelő rendszerképekhez lettek leképezve. Az előző üzemeltetett készletekben végzett feladatok automatikusan a megfelelő rendszerképre kerülnek az új Azure Pipelines által üzemeltetett készletben. Bizonyos esetekben előfordulhat, hogy továbbra is megjelennek a régi készletnevek, de a háttérben az üzemeltetett feladatok az Azure Pipelines-készlet használatával futnak. További információkért tekintse meg a 2019. július 1- Sprint 154 kibocsátási megjegyzéseit.

Alapértelmezés szerint a projekt összes közreműködője a Felhasználó szerepkör tagja a üzemeltetett készletekben. Ez lehetővé teszi, hogy a projekt minden közreműködője a Microsoft által üzemeltetett ügynökökkel hoz létre és futtasson folyamatokat.

Készlet kijelölése a folyamatban

YAML

Ha microsoftos ügynököt szeretne választani az Azure DevOps Services YAML-folyamat Azure Pipelines-készletéből, adja meg a rendszerkép nevét a táblázat YAML virtuálisgép-rendszerképcímkéjének használatával.

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

Igény nélküli privát készlet használata:

pool: MyPool

További információkért tekintse meg a készletek YAML-sémáját.

Klasszikus

Ha készletet és ügynököt szeretne választani a klasszikus szerkesztőben, keresse meg a folyamatbeállításokat, válassza ki a kívánt ügynökkészletet, majd a kívánt képet az Ügynök specifikációja legördülő listából. Az alapértelmezett ügynökspecifikáció a Windows-2019. A Microsoft által üzemeltetett rendszerképekre telepített szoftverről további információt a táblázat Klasszikus szerkesztőkészlet oszlopában található megfelelő bejegyzésben talál.

Készletek és üzenetsorok kezelése

Böngésző

Ha Ön szervezeti rendszergazda, az ügynökkészleteket a rendszergazdai beállítások ügynökkészletek lapján hozhatja létre és kezelheti.

1. Jelentkezzen be a szervezetbe (https://dev.azure.com/{yourorganization}).

2. Válassza az Azure DevOps szervezeti beállításait.

   

3. Válassza az Ügynökkészletek lehetőséget.

   

Ha Ön projektcsapat-tag, az ügynökkészleteket a projektbeállítások ügynökkészletek lapján hozhatja létre és kezelheti.

Lépjen a projekthez, és válassza a Projektbeállítások, Ügynökkészletek lehetőséget.

Azure DevOps parancssori felület

Ügynökkészletek listázása Ügynökkészlet részleteinek | megjelenítése Ügynöksorok megjelenítése ügynöksor részleteinek megjelenítése | |

Feljegyzés

Jelenleg megtekintheti az ügynökkészletekkel és üzenetsorokkal kapcsolatos információkat, de nem szerkesztheti őket az Azure CLI használatával.

Ha először használ az devops pipelines parancsokat, tekintse meg az Azure DevOps parancssori felület használatának első lépéseit.

Ügynökkészletek listázása

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

Paraméterek

• művelet: A lista szűrése engedélyezett felhasználói művelettel. Elfogadott értékek: kezelés, nincs, használat
• észlelés: Automatikusan észleli a szervezetet. Elfogadott értékek: hamis, igaz
• szervezet vagy szervezet: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet az az devops configure -d organization=ORG_URL használatával konfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy git-konfiguráción keresztül veszi fel. Példa: https://dev.azure.com/MyOrganizationName/.
• készletnév: Szűrje a listát egyező készletnévvel.
• készlet típusa: A lista szűrése készlettípussal. Elfogadott értékek: automatizálás, üzembe helyezés

Példa

Az alábbi példa az összes táblaformátumú készletet felsorolja. Ez a példa a következő alapértelmezett konfigurációt használja: 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

Ügynökkészlet részleteinek megjelenítése

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

Paraméterek

• azonosító vagy készletazonosító: (Kötelező) a készlet azonosítója a részletek listázásához.
• művelet: A lista szűrése engedélyezett felhasználói művelettel. Elfogadott értékek: kezelés, nincs, használat
• észlelés: Automatikusan észleli a szervezetet. Elfogadott értékek: hamis, igaz
• szervezet vagy szervezet: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet az az devops configure -d organization=ORG_URL használatával konfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy git-konfiguráción keresztül veszi fel. Példa: https://dev.azure.com/MyOrganizationName/.

Példa

Az alábbi példa a vs2019-készlettel rendelkező üzemeltetett Windows 2019 készletadatait mutatja be. Ez a példa a következő alapértelmezett konfigurációt használja: 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
}

Azt is használhatja --output table , hogy ugyanazt az információt adja vissza, mint a list parancs.

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

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

Ügynöki üzenetsorok listázása

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

Paraméterek

• művelet: A lista szűrése engedélyezett felhasználói művelettel. Elfogadott értékek: kezelés, nincs, használat
• észlelés: Automatikusan észleli a szervezetet. Elfogadott értékek: hamis, igaz
• szervezet vagy szervezet: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet az az devops configure -d organization=ORG_URL használatával konfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy git-konfiguráción keresztül veszi fel. Példa: https://dev.azure.com/MyOrganizationName/.
• projekt vagy p: A projekt neve vagy azonosítója. Az alapértelmezett projektet konfigurálhatja a következővel az devops configure -d project=NAME_OR_ID: . Kötelező, ha nincs alapértelmezettként konfigurálva, vagy git-konfiguráción keresztül veszi fel.
• queue-name: Szűrje a listát egyező regex üzenetsornévvel, például ubuntu a "Hosted Ubuntu 1604" nevű üzenetsorra.

Példa

Az alábbi példa az összes üzenetsort táblázatformátumban sorolja fel. Ez a példa a következő alapértelmezett konfigurációt használja: 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

Ügynöksor részleteinek megjelenítése

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

Paraméterek

• id vagy queue-id: Az ügynök üzenetsorának azonosítója, amelyről információt kaphat.
• művelet: A lista szűrése engedélyezett felhasználói művelettel. Elfogadott értékek: kezelés, nincs, használat
• észlelés: Automatikusan észleli a szervezetet. Elfogadott értékek: hamis, igaz
• szervezet vagy szervezet: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet az az devops configure -d organization=ORG_URL használatával konfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy git-konfiguráción keresztül veszi fel. Példa: https://dev.azure.com/MyOrganizationName/.
• projekt vagy p: A projekt neve vagy azonosítója. Az alapértelmezett projektet konfigurálhatja a következővel az devops configure -d project=NAME_OR_ID: . Kötelező, ha nincs alapértelmezettként konfigurálva, vagy git-konfiguráción keresztül veszi fel.

Példa

Az alábbi példa az üzemeltetett Windows 2019 és a VS2019 üzenetsor üzenetsorának adatait jeleníti meg. Ez a példa a következő alapértelmezett konfigurációt használja: 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"
}

A készletek feladatok futtatására szolgálnak. További információ a feladatok készleteinek megadásáról.

Ha sok saját üzemeltetésű ügynököt használ különböző csapatoknak vagy célokra, érdemes lehet további készleteket létrehoznia az alábbiak szerint.

Ügynökkészletek létrehozása

Íme néhány tipikus helyzet, amikor önkiszolgáló ügynökkészleteket szeretne létrehozni:

• Ön egy projekt tagja, és a csapat tulajdonában lévő gépek készletét szeretné használni buildelési és üzembehelyezési feladatok futtatásához. Először győződjön meg arról, hogy rendelkezik a projekt készleteinek létrehozására vonatkozó engedélyekkel. Ehhez válassza a Biztonság lehetőséget az ügynökkészletek lapján a Projekt beállításai között. Új készletek létrehozásához Rendszergazda istrator szerepkört kell használnia. Ezután válassza a Készlet hozzáadása lehetőséget, és válassza ki az új készlet létrehozásának lehetőségét. Végül telepítse és konfigurálja az ügynököket, hogy az adott ügynökkészlet része legyen.

• Ön az infrastruktúra-csapat tagja, és egy ügynökkészletet szeretne beállítani az összes projektben való használatra. Először győződjön meg arról, hogy rendelkezik a projektben a készletek létrehozásához szükséges engedélyekkel, ha a Szervezet beállításai között az ügynökkészletek lapján a Biztonság lehetőséget választja. Ezután hozzon létre egy Új ügynökkészletet , és válassza az ügynökkészlet automatikus kiépítésének lehetőségét az összes projektben a készlet létrehozásakor. Ez a beállítás biztosítja, hogy minden projekt hozzáférhessen ehhez az ügynökkészlethez. Végül telepítse és konfigurálja az ügynököket, hogy az adott ügynökkészlet része legyen.

• Több projekttel szeretne megosztani egy ügynökgép-készletet, de nem mindegyiket. Először keresse meg az egyik projekt beállításait, vegyen fel egy ügynökkészletet, és válassza ki azt a lehetőséget, hogy szervezeti szinten hozzon létre egy új készletet. Ezután lépjen a többi projektre, és hozzon létre egy készletet mindegyikben, miközben kiválasztja a szervezet meglévő ügynökkészletének használatát. Végül telepítse és konfigurálja az ügynököket úgy, hogy a megosztott ügynökkészlet része legyen.

Az ügynökkészletek biztonsága

Az ügynökkészletek biztonságának megismerése segít szabályozni az ügynökök megosztását és használatát.

A szerepkörök az egyes ügynökkészleteken vannak meghatározva, és az ezekben a szerepkörökben lévő tagság határozza meg, hogy milyen műveleteket hajthat végre egy ügynökkészleten.

Szervezeti szintű biztonsági beállítások

Szerepkör egy ügynökkészleten a szervezeti beállításokban	Cél
Olvasó	A szerepkör tagjai megtekinthetik az ügynökkészletet és az ügynököket is. Ezt általában olyan operátorok hozzáadására használja, amelyek az ügynökök és állapotuk monitorozásáért felelősek.
Szolgáltatásfiók	Ennek a szerepkörnek a tagjai a szervezeti ügynökkészlet használatával hozhatnak létre projektügynök-készletet egy projektben. Ha a fenti irányelveket követve hoz létre új projektügynök-készleteket, általában nem kell tagokat felvennie ide.
Rendszergazda	A fenti engedélyek mellett a szerepkör tagjai regisztrálhatják vagy törölhetik az ügynökök regisztrációját a szervezeti ügynökkészletből. A projekten belüli projektügynök-készlet létrehozásakor a szervezeti ügynökkészletre is hivatkozhatnak. Végül a szervezeti ügynökkészlet összes szerepköréhez is kezelhetik a tagságot. A szervezeti ügynökkészletet létrehozó felhasználó automatikusan hozzáadódik az adott készlethez tartozó Rendszergazda istrator szerepkörhöz.

Az Ügynökkészletek lapon található Minden ügynökkészlet csomópont az összes szervezeti ügynökkészlet biztonságának szabályozására szolgál. Az egyes szervezeti ügynökkészletek szerepkör-tagságai automatikusan öröklődnek a "Minden ügynökkészlet" csomópontétól. Alapértelmezés szerint a TFS és az Azure DevOps Server rendszergazdái szintén a "Minden ügynökkészlet" csomópont rendszergazdái a TFS vagy az Azure DevOps Server használatakor.

Projektszintű biztonsági beállítások

A szerepkörök az egyes projektügynök-készleteken is definiálva vannak, és az ezekben a szerepkörökben lévő tagságok szabályozzák, hogy milyen műveleteket hajthat végre egy ügynökkészleten a projekt szintjén.

Szerepkör egy ügynökkészleten a projektbeállításokban	Cél
Olvasó	A szerepkör tagjai megtekinthetik a projektügynök-készletet. Ez általában olyan operátorok hozzáadására használható, amelyek a projektügynök-készlet összeállítási és üzembehelyezési feladatainak monitorozásáért felelősek.
User	A szerepkör tagjai használhatják a projektügynök-készletet a folyamatok létrehozásakor.
Rendszergazda	A fenti műveleteken kívül ennek a szerepkörnek a tagjai kezelhetik a projektügynök-készlet összes szerepkörének tagságát. A készletet létrehozó felhasználó automatikusan hozzáadódik a készlet Rendszergazda istrator szerepköréhez.

Folyamatengedélyek

A folyamatengedélyek szabályozzák, hogy mely YAML-folyamatok jogosultak ügynökkészlet használatára. A folyamatengedélyek nem korlátozzák a hozzáférést a klasszikus folyamatokból.

Az alábbi lehetőségek közül választhat:

• Nyissa meg az összes folyamat hozzáférését az ügynökkészlet használatához az ügynökkészlet biztonsági lapjának Folyamatengedélyek szakaszának jobb felső sarkában található további lehetőségek közül.

• Zárolja az ügynökkészletet, és csak a kiválasztott YAML-folyamatok használhatják. Ha bármely más YAML-folyamat az ügynökkészletre hivatkozik, a rendszer engedélyezési kérelmet küld, amelyet egy ügynökkészletnek Rendszergazda istratornak kell jóváhagynia. Ez nem korlátozza a klasszikus folyamatokhoz való hozzáférést.

Az Azure Pipelines-ügynökkészlet folyamatengedélyei nem konfigurálhatók, mivel a készlet alapértelmezés szerint minden folyamat számára elérhető.

Az Ügynökkészletek lapon található Biztonsági művelet a projekt összes projektügynökkészletének biztonságát szabályozza. Az egyes projektügynök-készletek szerepkör-tagságai automatikusan öröklődnek az itt meghatározottaktól. Alapértelmezés szerint a következő csoportok lesznek hozzáadva a "Minden ügynökkészlet" Rendszergazda istrator szerepköréhez: Build Rendszergazda istrators, Release Rendszergazda istrators, Project Rendszergazda istrators.

GYIK

Ha nem ütemezek karbantartási időszakot, mikor fognak az ügynökök karbantartást végrehajtani?

Ha nincs ütemezve ablak, akkor a készletben lévő ügynökök nem futtatják a karbantartási feladatot.

Mi az a karbantartási feladat?

Az ügynökkészletek konfigurálhatók az elavult munkakönyvtárak és adattárak rendszeres tisztítására. Ez csökkenti annak lehetőségét, hogy az ügynökök elfogyjanak a lemezterület. A karbantartási feladatok szervezeti szinten vannak konfigurálva az ügynökkészlet beállításaiban.

A karbantartási feladatok beállításainak konfigurálása:

1. Jelentkezzen be a szervezetbe (https://dev.azure.com/{yourorganization}).

2. Válassza az Azure DevOps szervezeti beállításait.

   

3. Válassza az Ügynökkészletek lehetőséget.

   

Válassza ki a kívánt készletet, és válassza a Gépház az ügynökkészlet karbantartási feladatbeállításainak konfigurálásához.

Fontos

A karbantartási feladatok beállításainak konfigurálásához rendelkeznie kell a Build üzenetsorok kezelése engedéllyel. Ha nem látja a Gépház lapot vagy a Karbantartáselőzmények lapot, nem rendelkezik ezzel az engedéllyel, amelyet alapértelmezés szerint a Rendszergazda istrator szerepkör kap. További információ: Az ügynökkészletek biztonsága.

Konfigurálja a kívánt beállításokat, és válassza a Mentés lehetőséget.

Válassza a Karbantartási előzmények lehetőséget az aktuális ügynökkészlet karbantartási feladatelőzményeinek megtekintéséhez. A naplók letöltésével és áttekintésével megtekintheti a tisztítási lépéseket és a végrehajtott műveleteket.

A karbantartás ügynökkészletenként történik, nem gépenként; így ha több ügynökkészlete van egy gépen, akkor is előfordulhat, hogy lemezterület-problémákba ütközik.

Úgy tűnik, hogy a saját üzemeltetésű ügynökkészletem karbantartási feladata elakadt. Miért?

A karbantartási feladatok általában akkor „akadnak el”, ha egy olyan ügynökön való futásra várnak, amely már nincs az ügynökkészletben. Ez például akkor fordul elő, ha az ügynököt szándékosan offline állapotúvá állították, vagy ha problémák merülnek fel a vele történő kommunikációval.

A futtatási várólistára helyezett karbantartási feladatok hét napig várakoznak. Ezt követően, ha nem futottak, automatikusan meghiúsult állapotúra állítja őket a rendszer. Ez az időkorlát nem módosítható.

A hétnapos korlát nem azonos a karbantartási feladat időtúllépésére vonatkozó beállítással. Utóbbi az ügynök általi karbantartás maximális időtartamát szabályozza. Az időzítő nem a feladat ügynökön való várólistára helyezésekor indul el, hanem a feladat indulásakor.

Egy meglévő szervezeti ügynökkészletet használó projektügynök-készletet próbálok létrehozni, de a vezérlők szürkén jelennek meg. Miért?

A "Projektügynök-készlet létrehozása" párbeszédpanelen nem használhat meglévő szervezeti ügynökkészletet, ha már hivatkozik rá egy másik projektügynök-készlet. Minden szervezeti ügynökkészletre csak egy projektügynök-készlet hivatkozhat egy adott projektcsoporton belül.

Nem tudok a Microsoft által üzemeltetett készletet kiválasztani, és nem tudom várólistára helyezni a buildemet. Hogyan oldhatom meg ezt a problémát?

Kérje meg a saját Azure DevOps-szervezetének tulajdonosát, hogy biztosítson Önnek hozzáférést a készlethez. Lásd: Az ügynökkészletek biztonsága.

Több üzemeltetett builderőforrásra van szükségem. Mit tehetek?

Válasz: Az Azure Pipelines-készlet minden Azure DevOps-szervezetnek biztosít felhőben üzemeltetett buildügynököket és ingyenes buildelési perceket havonta. Ha több Microsoft által üzemeltetett builderőforrásra van szüksége, vagy több feladatot kell párhuzamosan futtatnia, akkor a következőkre van lehetősége:

• Saját ügynököket üzemeltethet az Ön által kezelt infrastruktúrán
• További párhuzamos feladatok vásárlása