Ü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 .
Feljegyzés
A felügyelt DevOps-készletek ügynökkészleteinek kezelése az Azure Portalon történik. Ha felügyelt DevOps-készleteket használ, olvassa el az első felügyelt DevOps-készlet létrehozása című témakört.
Az Azure Pipelinesban a készletek a teljes szervezetre kiterjednek; így megoszthatja az ügynökgépeket projektek között.
Az Azure DevOps Serverben az ügynökkészletek hatóköre a teljes kiszolgálóra kiterjed; így megoszthatja az ügynökgépeket projektek és gyűjtemények 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.
Jelentkezzen be a szervezetbe (
https://dev.azure.com/{yourorganization}).Válassza az Azure DevOps szervezeti beállításait.
Válassza az Ügynökkészletek lehetőséget.
Jelentkezzen be a projektgyűjteménybe (
http://your-server/DefaultCollection).Válassza az Azure DevOps gyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOps gyűjteménybeállításait.
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.
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.
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
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.
Készletek és üzenetsorok kezelése
Ha Ön szervezeti rendszergazda, az ügynökkészleteket a rendszergazdai beállítások ügynökkészletek lapján hozhatja létre és kezelheti.
Jelentkezzen be a szervezetbe (
https://dev.azure.com/{yourorganization}).Válassza az Azure DevOps szervezeti beállításait.
Válassza az Ügynökkészletek lehetőséget.
Jelentkezzen be a projektgyűjteménybe (
http://your-server/DefaultCollection).Válassza az Azure DevOps gyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOps gyűjteménybeállításait.
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.
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.
Készlet törléséhez lépjen az Ügynökkészletek listájára, és válassza a További beállítások, Törlés lehetőséget.
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 rendszergazdai szerepkörre van szükség. 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.
Ö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 rendszergazdai szerepkörre van szükség. 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 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 Projektcsoport beállításai között. 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.
Ö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 rendszergazdai szerepkörrel rendelkező csoport tagja a Minden készletben. Ezután hozzon létre egy Új projektügynök-készletet a projektbeállítások között, és válassza ki az új szervezeti ügynökkészlet létrehozásának lehetőségét. Ennek eredményeképpen létrejön egy szervezeti és egy projektszintű ügynökkészlet is. 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 a Minden készlet csoport tagja rendszergazdai 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 ki a megfelelő projektügynök-készletek 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 rendelkezik egy készlettel, 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 szeretne megosztani egy ügynökgép-készletet, 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ását a készlet létrehozásakor. Ezután lépjen a többi projektre, és hozzon létre egy készletet mindegyikben, 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 ú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 a készlet rendszergazdai szerepköréhez. |
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 rendszergazdai 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észlet rendszergazdájának 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 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étól. Alapértelmezés szerint a következő csoportok lesznek hozzáadva a "Minden ügynökkészlet" rendszergazdai szerepköréhez: Rendszergazdák létrehozása, 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: Rendszergazdák létrehozása, Kiadási rendszergazdák, Projektgazdák.
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:
Jelentkezzen be a szervezetbe (
https://dev.azure.com/{yourorganization}).Válassza az Azure DevOps szervezeti beállításait.
Válassza az Ügynökkészletek lehetőséget.
Jelentkezzen be a projektgyűjteménybe (
http://your-server/DefaultCollection).Válassza az Azure DevOps gyűjteménybeállításait.
Válassza az Ügynökkészletek lehetőséget.
Válassza az Azure DevOps gyűjteménybeállításait.
Válassza az Ügynökkészletek 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 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 Beállítások lapot vagy a Karbantartási előzmények lapot, akkor nem rendelkezik ezzel az engedéllyel, amelyet alapértelmezés szerint a rendszergazdai 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: