Kiadási folyamatok és összetevőforrások

  • Cikk

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

Az Azure Pipelines segítségével számos összetevőforrásból üzembe helyezheti az összetevőket, és integrálhatja a munkafolyamatot különböző típusú összetevő-adattárakkal. A kiadások több összetevőforráshoz is csatolhatók, ahol egy elsődleges forrásként van kijelölve.

Összetevők forrásai

Az Azure Pipelines számos adattárat, forrásvezérlő eszközt és folyamatos integrációs rendszert támogat.

Kiadás létrehozásakor megadhatja az összetevő forrásának verzióját. Alapértelmezés szerint a kiadások a forrásösszetevő legújabb verzióját használják. A legújabb buildet egy adott ágból is használhatja, ha megadja a címkéket, egy adott verziót, vagy engedélyezheti a felhasználónak, hogy a kiadás létrehozásakor adja meg a verziót.

Képernyőkép arról, hogyan adhat hozzá összetevőt egy klasszikus kiadási folyamathoz.

Ha egynél több összetevőt csatol, megadhatja, hogy melyik legyen az elsődleges forrás (alapértelmezett). Az elsődleges összetevőforrás több előre definiált változó beállítására szolgál. Elnevezési kiadásokban is használható.

Képernyőkép az elsődleges forrásösszetevő beállításáról.

Feljegyzés

A Default version legördülő elemek a csatolt builddefiníció forrástípusától függenek.

  • Az adattár minden típusa támogatja a következő beállításokat: Specify at the time of release creation, Specific versionés Latest.

  • Latest from a specific branch with tags és Latest from the build pipeline default branch with tags a beállításokat a következő adattártípusok támogatják: TfsGit, GitHub, Bitbucketés GitHubEnterprise.

  • Latest from the build pipeline default branch with tags a builddefiníciók nem támogatják XAML .

A következő szakaszok bemutatják, hogyan használható a különböző típusú összetevőforrások.

Összetevők forrásai – Azure Pipelines

A kiadási folyamatot bármely Azure Pipelines-buildhez csatolhatja. Több buildelési folyamatot is összekapcsolhat, és megadhatja az alapértelmezett értékeket, és üzembehelyezési triggereket állíthat be több buildforráson. Ha bármelyik build befejeződik, az elindítja a kiadás létrehozását.

Az Azure Pipelines összetevőforrásként való használatakor az alábbi funkciók érhetők el:

Szolgáltatás Leírás
Automatikus aktiválási kiadások Az új kiadások automatikusan létrehozhatók, ha új buildösszetevő érhető el (beleértve az XAML-buildeket is). További részletekért lásd a kiadási eseményindítókat .
Összetevő változói Számos összetevőváltozó támogatott az Azure Pipelines-forrásokban.
Munkaelemek és véglegesítések Összekapcsolhatja az Azure Pipelines munkaelemeit, és azok megjelennek a kiadások részletei között. A véglegesítések git- vagy TFVC-forrásvezérlők használatakor jelennek meg.
Összetevő letöltése Alapértelmezés szerint a buildösszetevők letöltődnek a folyamatot futtató ügynökre. A szakasz egy lépését is konfigurálhatja az összetevő letöltésének kihagyásához .
Üzembe helyezési szakaszok A build összefoglalása felsorolja azokat az üzembe helyezési fázisokat, ahol az összetevő üzembe lett helyezve.

Feljegyzés

A buildelési folyamatba bele kell foglalnia egy Publish Artifacts feladatot. YAML-buildfolyamatok esetén a névcseppet tartalmazó összetevő implicit módon lesz közzétéve.

Alapértelmezés szerint a kiadások gyűjteményszintű feladat-engedélyezési hatókörrel futnak. Ez azt jelenti, hogy a kiadások hozzáférhetnek a szervezet összes projektjének erőforrásaihoz (vagy az Azure DevOps Server gyűjteményéhez). Ez akkor hasznos, ha más projektek buildösszetevőit kapcsolja össze. A projektbeállításokban a projektbeállításokban engedélyezheti a projektengedélyezési hatókör korlátozását a projekt aktuális projektjéhez , hogy korlátozza a projekt összetevőjéhez való hozzáférést.

A szervezet feladat-engedélyezési hatókörének beállítása:

  • Keresse meg a szervezeti beállításokat.
  • Válassza a Gépház a Folyamatok területen.
  • Kapcsolja be a feladatengedélyezési hatókör korlátozása aktuális projektre való váltását a kiadási folyamatok esetében, hogy a hatókört az aktuális projektre korlátozza. Ez a megfelelő biztonsági intézkedésekhez ajánlott beállítás.

Feladat-engedélyezési hatókör beállítása egy adott projekthez:

  • Lépjen a Projekt beállításaihoz.
  • Válassza a Gépház a Folyamatok területen.
  • Kapcsolja be a Feladatengedélyezési hatókör korlátozása kapcsolót az aktuális projektre a kiadási folyamatok esetében, hogy a hatókör az aktuális projektre legyen korlátozva. Ez az ajánlott beállítás, mivel növeli a folyamatok biztonságát.

Feljegyzés

Ha a hatókör szervezeti szintű projektre van beállítva, nem módosíthatja a hatókört az egyes projektekben.

A kiadásban lévő összes feladat a gyűjteményre beállított feladat-engedélyezési hatókörrel fut. Más szóval ezek a feladatok a projektgyűjtemény összes projektjében hozzáférnek az erőforrásokhoz.

Összetevőforrások – verziókövetés

Vannak olyan forgatókönyvek, amelyekben a különböző forrásvezérlőkből származó összetevőket közvetlenül, a buildelési folyamaton keresztüli továbbítás nélkül szeretné felhasználni. Példa:

  • OLYAN PHP- vagy JavaScript-alkalmazás fejlesztése, amely nem igényel explicit buildelési folyamatot.

  • A különböző verziókövetési adattárak különböző szakaszainak konfigurációit kezelheti, és ezeket a konfigurációs fájlokat közvetlenül a verziókövetésből szeretné felhasználni az üzembehelyezési folyamat részeként.

  • Az infrastruktúrát és a konfigurációt kódként kezeli, és ezeket a fájlokat egy verziókövetési adattárban szeretné kezelni.

Mivel több összetevőforrást is konfigurálhat egyetlen kiadási folyamatban, összekapcsolhat egy buildelési folyamatot, amely létrehozza az alkalmazás bináris fájljait, valamint egy verziókövetési adattárat, amely a konfigurációs fájlokat ugyanabba a folyamatba tárolja, és a két összetevőkészletet együtt használja az üzembe helyezés során.

Az Azure Pipelines támogatja a Team Foundation verziókövetési (TFVC) adattárait, a Git-adattárakat és a GitHub-adattárakat.

A kiadási folyamatot a gyűjtemény bármely projektjének Git- vagy TFVC-adattárához csatolhatja (olvasási hozzáférésre lesz szüksége ezekhez az adattárakhoz). A verziókövetési összetevők ugyanazon gyűjteményen belüli telepítésekor nincs szükség további beállításra.

Ha összekapcsol egy GitHub-adattárat, és kijelöl egy ágat, az összetevő mentése után szerkesztheti az összetevőtípusok alapértelmezett tulajdonságait. Ez különösen akkor hasznos, ha az összetevő stabil verziójának ága megváltozik, és a folyamatos kézbesítési kiadásoknak ezt az ágat kell használniuk az összetevő újabb verzióinak beszerzéséhez. Megadhatja a kivétel részleteit is, például azt, hogy a kivétel almoduljai és az LFS által követett fájlok, valamint a sekély beolvasási mélység.

TFVC-ág összekapcsolásakor megadhatja a kiadás létrehozásakor üzembe helyezendő módosításokat.

A TFVC, a Git és a GitHub összetevőforrásként való használatakor az alábbi funkciók érhetők el:

Szolgáltatás Leírás
Automatikus aktiválási kiadások Az új kiadások automatikusan létrehozhatók, ha új buildösszetevő érhető el (beleértve az XAML-buildeket is). További részletekért lásd a kiadási eseményindítókat .
Összetevő változói Számos összetevőváltozó támogatott az Azure Pipelines-forrásokban.
Munkaelemek és véglegesítések Összekapcsolhatja az Azure Pipelines munkaelemeit, ha azok megjelennek a kiadások részletei között. A véglegesítések git- vagy TFVC-forrásvezérlők használatakor jelennek meg.
Összetevő letöltése Alapértelmezés szerint a buildösszetevők letöltődnek a folyamatot futtató ügynökre. A szakasz egy lépését is konfigurálhatja az összetevő letöltésének kihagyásához .

Alapértelmezés szerint a kiadások gyűjteményszintű feladat-engedélyezési hatókörrel futnak. Ez azt jelenti, hogy a kiadások hozzáférhetnek a szervezet összes projektjének erőforrásaihoz (vagy az Azure DevOps Server gyűjteményéhez). Ez akkor hasznos, ha más projektek buildösszetevőit kapcsolja össze. A projektbeállításokban a projektbeállításokban engedélyezheti a projektengedélyezési hatókör korlátozását a projekt aktuális projektjéhez , hogy korlátozza a projekt összetevőjéhez való hozzáférést.

Összetevők forrásai – Jenkins

A Jenkins-összetevők használatához létre kell hoznia egy szolgáltatáskapcsolatot a Jenkins-kiszolgálóval való hitelesítéshez. További információkért tekintse meg a szolgáltatáskapcsolatok és a Jenkins szolgáltatáskapcsolatok kezelését. A Jenkins-projektet a buildelés utáni művelettel kell konfigurálni az összetevők közzétételéhez.

A Jenkins összetevőforrásként való használatakor a következő funkciók érhetők el:

Szolgáltatás Leírás
Automatikus aktiválási kiadások Az új kiadások automatikusan létrehozhatók, ha új buildösszetevő érhető el (beleértve az XAML-buildeket is). További részletekért lásd a kiadási eseményindítókat .
Összetevő változói Számos összetevőváltozó támogatott az Azure Pipelines-forrásokban.
Munkaelemek és véglegesítések Összekapcsolhatja az Azure Pipelines munkaelemeit, és azok megjelennek a kiadások részletei között. A véglegesítések git- vagy TFVC-forrásvezérlők használatakor jelennek meg.
Összetevő letöltése Alapértelmezés szerint a buildösszetevők letöltődnek a folyamatot futtató ügynökre. A szakasz egy lépését is konfigurálhatja az összetevő letöltésének kihagyásához .

A Jenkins-buildek által létrehozott összetevőket általában a tárházakba propagálja archiválás és megosztás céljából. Az Azure Blob Storage az egyik támogatott adattár, amely lehetővé teszi, hogy az Azure Storage-ban kiadási folyamat összetevőforrásaként közzétevő Jenkins-projekteket használjon. Az Azure Pipelines automatikusan letölti az összetevőket az Azure-ból a folyamatot futtató ügynökre. Ebben a forgatókönyvben nincs szükség kapcsolatra az ügynök és a Jenkins-kiszolgáló között. A Microsoft által üzemeltetett ügynökök a kiszolgáló internetes felfedése nélkül is használhatók.

Feljegyzés

Előfordulhat, hogy az Azure Pipelines nem tud kapcsolatba lépni a Jenkins-kiszolgálóval, ha például a vállalati hálózaton belül van. Ha ez a helyzet, integrálhatja az Azure Pipelinest a Jenkinsszel egy helyszíni ügynök beállításával, amely hozzáfér a Jenkins-kiszolgálóhoz. A Jenkins-projektek neve nem jelenik meg a buildhez való csatoláskor, de az URL-szövegmezőbe beírhatja a nevet.

Összetevők forrásai – tárolók

A tárolóalapú alkalmazások üzembe helyezésekor a rendszer először leküldi a tárolórendszerképet egy tárolóregisztrációs adatbázisba. Ezután üzembe helyezheti a tárolórendszerképet az Azure Web App for Containersben vagy egy Docker/Kubernetes-fürtön. Létre kell hoznia egy szolgáltatáskapcsolatot az Azure-ral való hitelesítéshez. További részletekért tekintse meg a szolgáltatáskapcsolatok kezelését.

Az Azure Container összetevőforrásként való használatakor az alábbi funkciók érhetők el:

Szolgáltatás Leírás
Automatikus aktiválási kiadások Az új kiadások automatikusan létrehozhatók, ha új buildösszetevő érhető el (beleértve az XAML-buildeket is). További részletekért lásd a kiadási eseményindítókat .
Összetevő változói Számos összetevőváltozó támogatott az Azure Pipelines-forrásokban.
Munkaelemek és véglegesítések Összekapcsolhatja az Azure Pipelines munkaelemeit, és azok megjelennek a kiadások részletei között. A véglegesítések git- vagy TFVC-forrásvezérlők használatakor jelennek meg.
Összetevő letöltése Alapértelmezés szerint a buildösszetevők letöltődnek a folyamatot futtató ügynökre. A szakasz egy lépését is konfigurálhatja az összetevő letöltésének kihagyásához .

Feljegyzés

Ha több összetevőforrást használ, nem támogatott egy összetevőforrás leképezése egy adott szakasz aktiválásához. A kiadás bármikor létrejön, amikor leküldés történik bármelyik összetevő-forrásba. Ha ezt szeretné, az Azure Pipelines azt javasolja, hogy a kiadási folyamatot több kiadásra ossza.

Összetevők forrásai – Azure Artifacts

Az alábbiakban néhány olyan forgatókönyvet láthat, ahol az Azure Artifacts összetevőforrásként használható:

  1. Az alkalmazás bináris fájlja közzé van téve az Azure Artifactsben, és a csomagot egy kiadási folyamatban szeretné felhasználni.
  2. Az üzembe helyezési munkafolyamat részeként további csomagokat kell tárolnia az Azure Artifactsben.

A kiadási folyamatban az Azure Artifacts használatával ki kell választania a csomag hírcsatornáját, csomagját és alapértelmezett verzióját . Dönthet úgy, hogy a csomag legújabb verzióját veszi át, egy adott verziót használ, vagy kiválasztja a verziót a kiadás létrehozásakor. Az üzembe helyezés során a rendszer letölti/kinyeri a csomagot a folyamatot futtató ügynöknek.

Az Azure Artifacts összetevőforrásként való használatakor az alábbi funkciók érhetők el:

Szolgáltatás Leírás
Automatikus aktiválási kiadások Az új kiadások automatikusan létrehozhatók, ha új buildösszetevő érhető el (beleértve az XAML-buildeket is). További részletekért lásd a kiadási eseményindítókat .
Összetevő változói Számos összetevőváltozó támogatott az Azure Pipelines-forrásokban.
Munkaelemek és véglegesítések Összekapcsolhatja az Azure Pipelines munkaelemeit, és azok megjelennek a kiadások részletei között. A véglegesítések git- vagy TFVC-forrásvezérlők használatakor jelennek meg.
Összetevő letöltése Alapértelmezés szerint a buildösszetevők letöltődnek a folyamatot futtató ügynökre. A szakasz egy lépését is konfigurálhatja az összetevő letöltésének kihagyásához .

Maven-pillanatképek kezelése

Maven-pillanatképek használatakor egyszerre több verzió is letölthető (például myApplication-2.1.0.BUILD-20190920.220048-3.jar, myApplication-2.1.0.BUILD-20190820.221046-2.jar). myApplication-2.1.0.BUILD-20190820.220331-1.jar Előfordulhat, hogy el kell távolítania a régi verziót, és csak a legújabb összetevőt kell megőriznie az üzembe helyezés előtt. Futtassa a következő PowerShell-parancsot egy rendszergazda jogú parancssorban az összes példány eltávolításához, kivéve azt, amelyik a legmagasabb lexikográfiai értékkel rendelkezik:

Get-Item "myApplication*.jar" | Sort-Object -Descending Name | Select-Object -SkipIndex 0 | Remove-Item

Feljegyzés

Legfeljebb 30 Maven-pillanatképet tárolhat a hírcsatornában. A maximális korlát elérése után az Azure Artifacts automatikusan törli a pillanatképeket 25-ös értékre. Ez a folyamat automatikusan aktiválódik minden alkalommal, amikor több mint 30 pillanatképet tesznek közzé a hírcsatornában.

Összetevőforrások – TFS-kiszolgáló

Az Azure Pipelines használatával összetevőket helyezhet üzembe TFS-kiszolgálókról anélkül, hogy a kiszolgálót az interneten is felfedezhetővé kellene tennie egy helyszíni automatizálási ügynök beállításával. Az összetevőket a rendszer letölti a helyszíni ügynökbe, majd a megadott célkiszolgálókra telepíti anélkül, hogy elhagyná a vállalati hálózatot. Ez ideális az ügyfelek számára, hogy kihasználják a helyszíni infrastruktúrájuk befektetéseit, miközben kihasználják az Azure Pipelines kiadásait.

A TFS-kiszolgálók összetevőforrásként való használatához telepítenie kell az Azure Pipelines-bővítmény TFS-összetevőit a Visual Studio Marketplace-ről, majd létre kell hoznia egy szolgáltatáskapcsolatot az Azure Pipelines-hitelesítéshez. A hitelesítés után összekapcsolhat egy TFS-buildfolyamatot a kiadási folyamathoz, és a Típus legördülő menüben válassza a Külső TFS-build lehetőséget.

A TFS-kiszolgálók összetevőforrásként való használatakor az alábbi funkciók érhetők el:

Szolgáltatás Leírás
Automatikus aktiválási kiadások Az új kiadások automatikusan létrehozhatók, ha új buildösszetevő érhető el (beleértve az XAML-buildeket is). További részletekért lásd a kiadási eseményindítókat .
Összetevő változói Számos összetevőváltozó támogatott az Azure Pipelines-forrásokban.
Munkaelemek és véglegesítések Összekapcsolhatja az Azure Pipelines munkaelemeit, és azok megjelennek a kiadások részletei között. A véglegesítések git- vagy TFVC-forrásvezérlők használatakor jelennek meg.
Összetevő letöltése Alapértelmezés szerint a buildösszetevők letöltődnek a folyamatot futtató ügynökre. A szakasz egy lépését is konfigurálhatja az összetevő letöltésének kihagyásához .

Előfordulhat, hogy az Azure Pipelines nem tud kapcsolatba lépni egy helyszíni TFS-kiszolgálóval, ha az a vállalati hálózaton belül van. Ebben az esetben integrálhatja az Azure Pipelinest a TFS-sel egy helyszíni ügynök beállításával, amely hozzáfér a TFS-kiszolgálóhoz. A buildhez való csatoláskor nem fogja látni a TFS-projektek vagy a buildfolyamatok nevét, de ezeket a változókat belefoglalhatja az URL-szövegmezőkbe. Emellett a kiadás létrehozásakor előfordulhat, hogy az Azure Pipelines nem tudja lekérdezni a TFS-kiszolgálót a buildszámokhoz. Ehelyett adja meg a kívánt build buildazonosítóját (nem a build számát) a megfelelő mezőben, vagy válassza ki a Legújabb buildet.

Összetevők forrásai – TeamCity

A TeamCity összetevőforrásként való használatához először telepítenie kell az Azure Pipelines TeamCity-összetevőit a Visual Studio Marketplace-ről.

Ha végzett, hozzon létre egy szolgáltatáskapcsolatot a TeamCity-kiszolgálóval való hitelesítéshez. Ezután összekapcsolhatja a buildösszetevőt egy kiadási folyamathoz. A TeamCity buildkonfigurációját egy művelettel kell beállítani az összetevők közzétételéhez.

A TeamCity összetevőforrásként való használatakor az alábbi funkciók érhetők el:

Szolgáltatás Leírás
Automatikus aktiválási kiadások Az új kiadások automatikusan létrehozhatók, ha új buildösszetevő érhető el (beleértve az XAML-buildeket is). További részletekért lásd a kiadási eseményindítókat .
Összetevő változói Számos összetevőváltozó támogatott az Azure Pipelines-forrásokban.
Munkaelemek és véglegesítések Összekapcsolhatja az Azure Pipelines munkaelemeit, és azok megjelennek a kiadások részletei között. A véglegesítések git- vagy TFVC-forrásvezérlők használatakor jelennek meg.
Összetevő letöltése Alapértelmezés szerint a buildösszetevők letöltődnek a folyamatot futtató ügynökre. A szakasz egy lépését is konfigurálhatja az összetevő letöltésének kihagyásához .

Előfordulhat, hogy az Azure Pipelines nem tud kapcsolatba lépni a TeamCity-kiszolgálóval, ha például a vállalati hálózaton belül van. Ebben az esetben integrálhatja az Azure Pipelinest a TeamCityvel egy helyszíni ügynök beállításával, amely hozzáfér a TeamCity-kiszolgálóhoz. A buildhez való csatoláskor nem fogja látni a TeamCity-projektek nevét, de ezt beírhatja az URL-szövegmezőbe.

Összetevő forrásának aliasa

Minden összetevő-letöltés egyediségének biztosítása érdekében a kiadási folyamathoz csatolt összetevők forrásának automatikusan meg lesz adva egy adott letöltési hely, más néven a forrás aliasa. Ez a hely a következő változóval érhető el: $(System.DefaultWorkingDirectory)\[source alias]

A forrás aliasok használata biztosítja, hogy a csatolt összetevő forrásának átnevezése ne igényelje a feladat tulajdonságainak szerkesztését, mert az ügynökben definiált letöltési hely nem változik.

Alapértelmezés szerint a forrás aliasa az aláhúzásjellel előtaggal ellátott összetevőforrás neve. Az összetevő forrásának típusától függően ez lesz a buildelési folyamat neve, a feladat neve, a projekt neve vagy az adattár neve. A forrás aliasát a kiadási folyamat összetevők lapján szerkesztheti.

Összetevő letöltése

Amikor egy üzembe helyezés befejeződött egy fázisban, a rendszer letölti az egyes forrásokból származó verziójú összetevőket a folyamatügynökbe, hogy az adott fázisban futó tevékenységek hozzáférhessenek ezekhez az összetevőkhöz. A letöltött összetevők nem törlődnek a kiadás befejezésekor. A következő kiadás indításakor azonban a rendszer törli a letöltött összetevőket, és lecseréli őket az új összetevőkészletre.

Az ügynökben egy új egyedi mappa jön létre minden kiadási folyamathoz a kiadás indításakor, és az összetevők a következő mappába lesznek letöltve:$(System.DefaultWorkingDirectory)

Az Azure Pipelines nem végez optimalizálást a változatlan összetevők letöltésének elkerülése érdekében, ha ugyanazt a kiadást újra üzembe helyezik. Emellett mivel a korábban letöltött tartalmak mindig törlődnek egy új kiadás indításakor, az Azure Pipelines nem tud növekményes letöltéseket végrehajtani az ügynökre.

Beállíthatja azonban, hogy a folyamat kihagyja az automatikus letöltést egy adott feladathoz vagy fázishoz, ha ezt szeretné.