Ügynökkészletek létrehozása és kezelése
Azure DevOps Services | Azure DevOps Server 2020-| 2019 Azure DevOps Server | TFS 2018
Megjegyzés
A Microsoft Team Foundation Server (TFS) 2018-ban és a korábbi verziókban a buildelési és kiadási folyamatokat definícióknak, a futtatásokatbuildeknek, a szolgáltatáskapcsolatokatszolgáltatásvégpontoknak, a fázisokatkörnyezeteknek, a feladatokatpedig fázisoknak nevezzük.
Az ügynökkészlet ügynökök gyűjteménye. Ahelyett, hogy egyenként kezelned kell az ügynököket, ügynökkészletekbe kell rendezni az ügynököket. A TFS-ben a készletek hatóköre a teljes kiszolgálóra kiterjed; így megoszthatja az ügynökkészletet projektgyűjtemények és projektek között.
Az ügynöksor hozzáférést biztosít egy projekten belüli ügynökkészlethez . Build- vagy kiadási folyamat létrehozásakor meg kell adnia, hogy melyik üzenetsort használja. Az üzenetsorok hatóköre a projektre terjed ki a TFS 2017-es és újabb verziójában, így csak a projekt buildelési és kiadási folyamataiban használhatja őket.
Ha több projekttel szeretne megosztani egy ügynökkészletet, mindegyik projektben létre kell hoznia egy ügynöksort, amely ugyanarra az ügynökkészletre mutat. Bár a projektek több üzenetsora is használhatja ugyanazt az ügynökkészletet, egy projekten belül több üzenetsor nem használhatja ugyanazt az ügynökkészletet. Emellett minden ügynöksor csak egy ügynökkészletet használhat.
Az ügynökkészlet ügynökök gyűjteménye. Ahelyett, hogy egyenként kezelned kell az ügynököket, ügynökkészletekbe kell rendezni az ügynököket. Amikor konfigurál egy ügynököt, az egyetlen készletben van regisztrálva, és folyamat létrehozásakor 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 hatóköre a teljes szervezetre kiterjed; így megoszthatja az ügynökgépeket a projektek között.
A Azure DevOps Server az ügynökkészletek hatóköre a teljes kiszolgálóra kiterjed, így az ügynökgépeket több projektben és gyűjteményben is megoszthatja.
Megjegyzés
Az ügynökkészlet-feladatok egyetlen ügynökön futtatnak egy feladatot. Ha minden ügynökön futtatnia kell egy feladatot, például a klasszikus kiadási folyamatok üzembehelyezési csoportját, tekintse meg az üzembehelyezési csoportok kiépítését.
Az ügynökkészleteket a rendszergazdai beállítások ügynökkészletek lapján hozhatja létre és kezelheti.
Ha Ön szervezeti rendszergazda, a rendszergazdai beállítások ügynökkészletek lapján hozhat létre és kezelhet ügynökkészleteket.
Válassza az Azure DevOpsszervezeti beállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOpsgyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOpsgyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Beállítások (fogaskerék ikon) >Ügynöksorok lehetőséget.
Válassza a Készletek kezelése lehetőséget.
A projektbeállításokban az ügynöksorok lapon hozhat létre és kezelhet ügynöksorokat.
Ha Ön projektcsapattag, a projektbeállítások ügynökkészletek lapján hozhat létre és kezelhet ügynöksorokat.
Lépjen a projekthez, és válassza a Projektbeállítások, Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Projektbeállítások, Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Projektbeállítások, Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Beállítások (fogaskerék ikon) >Ügynöksorok 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ő rendszerképek és a telepített szoftverek teljes listáját a Microsoft által üzemeltetett ügynökökben találja.
Megjegyzés
Az Azure Pipelines üzemeltetett készlete lecseréli a korábbi üzemeltetett készleteket, amelyek nevei a megfelelő rendszerképekhez lettek leképezve. Az előző üzemeltetett készletekben lévő összes feladat automatikusan a megfelelő rendszerképre lesz átirányítva az új, üzemeltetett Azure Pipelines-készletben. Bizonyos esetekben előfordulhat, hogy a régi készletnevek továbbra is megjelennek, 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 az önállóan üzemeltetett készlet kibocsátási megjegyzéseiben.
Alapértelmezés szerint a projekt összes közreműködője a felhasználói 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
A YAML-folyamatok a 2019-es és újabb Azure DevOps Server támogatottak.
Ha ki szeretne választani egy Microsoft által üzemeltetett ügynököt az Azure DevOps Services YAML-folyamat Azure Pipelines-készletéből, adja meg a rendszerkép nevét a táblázatYAML 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észletekYAML-sémáját.
Készletek és üzenetsorok kezelése
Az ügynökkészleteket a rendszergazdai beállítások ügynökkészletek lapján hozhatja létre és kezelheti.
Ha Ön szervezeti rendszergazda, a rendszergazdai beállítások ügynökkészletek lapján hozhat létre és kezelhet ügynökkészleteket.
Válassza az Azure DevOpsszervezeti beállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOpsgyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOpsgyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Beállítások (fogaskerék ikon) >Ügynöksorok lehetőséget.
Válassza a Készletek kezelése lehetőséget.
A projektbeállításokban az ügynöksorok lapon hozhat létre és kezelhet ügynöksorokat.
Ha Ön projektcsapattag, a projektbeállítások ügynökkészletek lapján hozhat létre és kezelhet ügynöksorokat.
Lépjen a projekthez, és válassza a Projektbeállítások, Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Projektbeállítások és az Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Projektbeállítások és az Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Beállítások (fogaskerék ikon) >Ügynöksorok lehetőséget.
A készletek feladatok futtatására szolgálnak. Tudnivalók 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ábbiakban leírtak szerint.
Ügynökkészletek létrehozása
Íme néhány tipikus helyzet, amikor saját üzemeltetésű ü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 a buildelési és üzembehelyezési feladatok futtatásához. Először győződjön meg arról, hogy rendelkezik a projektben a készletek létrehozására vonatkozó engedélyekkel. Ehhez válassza a Biztonság lehetőséget az ügynökkészletek oldalán a projektbeállításokban. Új készletek létrehozásához rendszergazdai szerepkörre van szükség. Ezután válassza a Készlet hozzáadása lehetőséget, és válassza ki azt a lehetőséget, hogy szervezeti szinten hozzon létre egy új készletet. 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 szeretne létrehozni egy ügynökkészletet, amely minden projektben használható. Először ellenőrizze, hogy tagja-e egy csoportnak az Összes ügynökkészletrendszergazdai szerepkörrel rendelkező csoportjában. Ehhez nyissa meg az ügynökkészletek lapját a szervezeti beállítások között. Ezután hozzon létre egy új ügynökkészletet , és válassza a megfelelő ügynökkészletek automatikus kiépítésé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épkészletet, de nem mindegyiket. Először lépjen az egyik projekt beállításaihoz, 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 bennük egy készletet, 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észei legyenek.
Ön egy projekt tagja, és a csapat tulajdonában lévő gépek készletét szeretné használni a buildelési és üzembehelyezési feladatok futtatásához. Először győződjön meg arról, hogy tagja egy csoportnak a Minden készletbenrendszergazdai szerepkörrel. Ezután hozzon létre egy Új projektügynök-készletet a projektbeállításokban, és válassza az Új szervezeti ügynökkészlet létrehozása lehetőséget. Ennek eredményeképpen egy szervezeti és egy projektszintű ügynökkészlet is létrejön. 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 szeretne létrehozni egy ügynökkészletet, amely minden projektben használható. Először győződjön meg arról, hogy tagja egy csoportnak a Minden készletbenrendszergazdai szerepkörrel. Ezután hozzon létre egy új szervezeti ügynökkészletet a rendszergazdai beállítások között, és válassza a megfelelő projektügynök-készletek automatikus kiépítését az összes projektben a készlet létrehozásakor. Ez a beállítás biztosítja, hogy minden projekt rendelkezik egy készletkel, amely a szervezeti ügynökkészletre mutat. A rendszer létrehoz egy készletet a meglévő projektekhez, és a jövőben ezt fogja tenni, amikor új projektet hoz létre. Végül telepítse és konfigurálja az ügynököket, hogy az adott ügynökkészlet része legyen.
Több projekttel rendelkező ügynökgép-készletet szeretne megosztani, de nem mindegyiket. Először hozzon létre egy projektügynök-készletet az egyik projektben, és válassza az új szervezeti ügynökkészlet létrehozása lehetőséget a készlet létrehozásakor. Ezután lépjen a többi projektre, és hozzon létre bennük egy készletet, miközben kiválasztja a meglévő szervezeti ügynökkészlet használatát. Végül telepítse és konfigurálja az ügynököket, hogy a megosztott ügynökkészlet része legyen.
Ü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 ezekben a szerepkörökben a tagság határozza meg, hogy milyen műveleteket hajthat végre egy ügynökkészleten.
| 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. Ezt általában olyan operátorok hozzáadására használják, amelyek az ügynökök és állapotuk figyelé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 itt nem kell tagokat felvennie. |
| Rendszergazda | A fenti engedélyeken kívül a szerepkör tagjai regisztrálhatnak vagy törölhetnek ügynököket a szervezeti ügynökkészletből. Hivatkozhatnak a szervezeti ügynökkészletre is, amikor projektügynök-készletet hoz létre egy projektben. Végül a szervezeti ügynökkészlet összes szerepkörének tagságát is kezelhetik. A szervezeti ügynökkészletet létrehozó felhasználó automatikusan hozzá lesz adva a készlet rendszergazdai szerepköréhez. |
Az Ügynökkészletek lap Minden ügynökkészlet csomópontja 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 szerepköreitől. TFS vagy Azure DevOps Server használatakor a TFS és Azure DevOps Server-rendszergazdák alapértelmezés szerint a "Minden ügynökkészlet" csomópont rendszergazdái is.
A szerepkörök az egyes projektügynök-készleteken is meg vannak határozva, é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 buildelési és üzembehelyezési feladatainak figyeléséért felelősek. |
| Felhasználó | Ennek a szerepkörnek a tagjai használhatják a projektügynök-készletet a folyamatok létrehozásakor. |
| Rendszergazda | A fenti műveleteken kívül a szerepkör tagjai kezelhetik a projektügynök-készlet összes szerepkörének tagságát. A készletet létrehozó felhasználó automatikusan hozzá lesz adva a készlet rendszergazdai szerepköréhez. |
Az Ügynökkészletek lap Minden ügynökkészlet csomópontja 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 a "Minden ügynökkészlet" csomópont szerepköreitől. Alapértelmezés szerint a következő csoportok lesznek hozzáadva a "Minden ügynökkészlet" rendszergazdai szerepköréhez: Build Rendszergazdák, Kiadási rendszergazdák, Projektgazdák.
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" rendszergazdai szerepköréhez: Build Rendszergazdák, Kiadási rendszergazdák, Projektgazdák.
GYIK
Ha nem ütemezek karbantartási időszakot, mikor fognak az ügynökök karbantartást futtatni?
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 törlésére. Ez csökkenti annak lehetőségét, hogy az ügynökök elfogyjanak a lemezterületen. A karbantartási feladatok a projektgyűjtemény vagy a szervezet szintjén vannak konfigurálva az ügynökkészlet beállításaiban.
A karbantartási feladatok beállításainak konfigurálása:
Válassza az Azure DevOpsszervezeti beállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOpsgyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOpsgyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Lépjen a projekthez, és válassza a Beállítások (fogaskerék ikon) >Ügynöksorok lehetőséget.
Válassza a Készletek kezelése lehetőséget.
Válassza ki a kívánt készletet, és válassza a Beállítások lehetőséget az ügynökkészlet karbantartási feladatok beá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 Beállítások vagy a Karbantartás előzményei lapot, nem rendelkezik ezzel az engedéllyel, amely alapértelmezés szerint a rendszergazdai szerepkörnek van megadva. További információ: Ü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 az elvégzett tisztítási lépéseket és műveleteket.
A karbantartás ügynökkészletenként történik, nem gépenként; Így ha több ügynökkészlete van egyetlen gépen, akkor is előfordulhat, hogy lemezterület-problémákba ütközik.
A saját üzemeltetésű ügynökkészletem karbantartási feladata elakadtnak tűnik. Miért?
A karbantartási feladatok általában "elakadnak", amikor egy olyan ügynökön futnak, amely már nem szerepel az ügynökkészletben. Ez akkor fordul elő, ha például az ügynököt szándékosan offline állapotba hozták, vagy ha problémák merülnek fel a vele való kommunikáció során.
A várólistára helyezett karbantartási feladatok futtatása hét napot vár. Ezt követően a rendszer automatikusan sikertelen állapotra állítja őket, ha nem futnak. Ez az időkorlát nem módosítható.
A hétnapos korlát eltér a karbantartási feladatok időtúllépési beállításától. Ez utóbbi szabályozza, hogy az ügynök legfeljebb hány percet tölthet karbantartással. Az időzítő a feladat indításakor indul el, nem akkor, ha a feladat egy ügynökön van várólistán.
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ökkészlet. Minden szervezeti ügynökkészletre csak egy projektügynökkészlet hivatkozhat egy adott projektgyűjteményen belül.
Nem tudok kiválasztani egy Microsoft által üzemeltetett készletet, és nem tudom várólistára helyezni a buildet. Hogyan kijavítani?
Kérje meg az Azure DevOps-szervezet tulajdonosát, hogy adjon engedélyt a készlet használatára. Lásd : Ügynökkészletek biztonsága.
Több üzemeltetett builderőforrásra van szükségem. Mi a teendő?
Válasz: Az Azure Pipelines-készlet minden Azure DevOps-szervezet számára 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: