Univerzális csomagok közzététele és letöltése az Azure Pipelines használatával
Azure DevOps Services
Az Univerzális csomagok segítségével bármilyen típusú fájlt csomagolhat, és megoszthatja őket a csapatával. Az Azure Pipelines univerzális csomagfeladatával különböző méretű, legfeljebb 4 TB méretű csomagokat csomagolhat, tehet közzé és tölthet le. Minden csomag egyedileg azonosítható névvel és verziószámmal. Az Azure CLI vagy az Azure Pipelines használatával csomagokat tehet közzé és használhat fel az Artifacts-hírcsatornákból.
Feljegyzés
Az univerzális csomagok csak az Azure DevOps Servicesben érhetők el.
Fájlok másolása
Az Azure Pipelines Univerzális csomagok feladata alapértelmezett közzétételi könyvtárként van $(Build.ArtifactStagingDirectory)
beállítva. Az univerzális csomag közzétételre való felkészítéséhez helyezze át a közzétenni kívánt fájlokat az adott könyvtárba. A Fájlok másolása segédprogrammal is másolhatja ezeket a fájlokat a közzétételi könyvtárba.
Univerzális csomag közzététele
Ha univerzális csomagot szeretne közzétenni az Azure Artifacts-csatornán, adja hozzá a következő feladatot a folyamat YAML-fájljához.
- task: UniversalPackages@0
displayName: Publish a Universal Package
inputs:
command: publish
publishDirectory: '$(Build.ArtifactStagingDirectory)'
vstsFeedPublish: '<projectName>/<feedName>'
vstsFeedPackagePublish: '<Package name>'
packagePublishDescription: '<Package description>'
Argumentum | Leírás |
---|---|
publishDirectory | A közzétenni kívánt fájlok helye. |
vstsFeedPublish | A közzéteendő projekt és hírcsatorna neve. Ha szervezeti hatókörű hírcsatornával dolgozik, csak a hírcsatorna nevét adja meg. |
vstsFeedPackagePublish | A csomag neve. Kisbetűsnek kell lennie. Csak betűket, számokat és kötőjeleket használjon. |
packagePublishDescription | A csomag tartalmának leírása. |
Ha csomagokat szeretne közzétenni egy Azure Artifacts-csatornán a folyamatból, a folyamatidentitásnak rendelkeznie kell a Hírcsatorna-közzétevő (Közreműködő) szerepkörével a hírcsatornán. További információ: Folyamatok engedélyei.
Külső hírcsatornán való közzétételhez először létre kell hoznia egy szolgáltatáskapcsolatot a hírcsatornával való hitelesítéshez. További információ: Szolgáltatáskapcsolat kezelése.
Csomag verziószámozása
Az univerzális csomagok a szemantikai verziókövetési specifikációt követik, és nevük és verziószámuk alapján azonosíthatók. A szemantikus verziószámok három numerikus összetevőből állnak, fő, alverzió és javítás, a következő formátumban: Major.Minor.Patch
.
Az alverziószám a korábbi verziókkal visszamenőlegesen kompatibilis új funkciók hozzáadásakor növekszik, ebben az esetben az alverziót növekteti, és visszaállítja a javítás verziószámát 0 -ra (0-ra1.4.17
1.5.0
). A fő verziószám akkor növekszik, ha jelentős változások lépnek fel, amelyek megszakíthatják a korábbi verziókkal való kompatibilitást. Ebben az esetben növeli a főverziót, és alaphelyzetbe állítja az alverziót és a javítás verziószámát 0(2.6.5
ra 3.0.0
). A javítás verziószámát növelni kell, ha csak olyan hibajavítások vagy kisebb módosítások történnek, amelyek nem befolyásolják a korábbi verziókkal való kompatibilitást (1.0.0
a következőhöz 1.0.1
).
Új csomag közzétételekor az Univerzális csomagok feladat automatikusan kiválasztja a következő főverziót, alverziót vagy javításverziót.
A csomag verziószámozásának engedélyezéséhez adjon hozzá egy bemenetet versionOption
a YAML-fájlhoz. Az új csomagverziók közzétételének lehetőségei a következők: major
, minor
, patch
vagy custom
.
A kijelölés custom
lehetővé teszi a csomagverzió manuális megadását. A többi lehetőség lekéri a legújabb csomagverziót a hírcsatornából, és 1-zel növeli a kiválasztott verziószegmenst. Tehát ha rendelkezik egy testPackage 1.0.0-s csomagokkal, és kiválasztja a fő lehetőséget, az új csomag a testPackage 2.0.0 lesz. Ha az alverziót választja, a csomag verziója 1.1.0 lesz, és ha a javítást választja, a csomag verziója 1.0.1 lesz.
Ha a custom
lehetőséget választja, az alábbiak szerint kell megadnia egy versionPublish
értéket is:
- task: UniversalPackages@0
displayName: Publish a Universal Package
inputs:
command: publish
publishDirectory: '$(Build.ArtifactStagingDirectory)'
vstsFeedPublish: '<projectName>/<feedName>'
vstsFeedPackagePublish: '<Package name>'
versionOption: custom
versionPublish: '<Package version>'
packagePublishDescription: '<Package description>'
Argumentum | Leírás |
---|---|
publishDirectory | A közzétenni kívánt fájlok helye. |
vstsFeedPublish | A közzéteendő projekt és hírcsatorna neve. Ha szervezeti hatókörű hírcsatornával dolgozik, csak a hírcsatorna nevét adja meg. |
vstsFeedPackagePublish | A csomag neve. Kisbetűsnek kell lennie. Csak betűket, számokat és kötőjeleket használjon. |
versionOption | Válasszon verziószámozási stratégiát. Beállítások: major , minor , patch . custom |
versionPublish | Az egyéni csomag verziója. |
packagePublishDescription | A csomag tartalmának leírása. |
Univerzális csomag letöltése
Ha a szervezet egy hírcsatornájából szeretne univerzális csomagot letölteni, használja az Univerzális csomag feladatot a download
következő paranccsal:
steps:
- task: UniversalPackages@0
displayName: Download a Universal Package
inputs:
command: download
vstsFeed: '<projectName>/<feedName>'
vstsFeedPackage: '<packageName>'
vstsPackageVersion: '<packageVersion>'
downloadDirectory: '$(Build.SourcesDirectory)\someFolder'
Argumentum | Leírás |
---|---|
vstsFeed | A letöltendő csomagot üzemeltető Artifacts-hírcsatorna. |
vstsFeedPackage | A letölteni kívánt csomag neve. |
vstsPackageVersion | A letöltendő csomag verziója. |
downloadDirectory | A csomag célmappája. Alapértelmezett érték: $(System.DefaultWorkingDirectory). |
Univerzális csomag külső forrásból való letöltéséhez használja a következő kódrészletet:
steps:
- task: UniversalPackages@0
displayName: Download a Universal Package
inputs:
command: download
feedsToUse: external
externalFeedCredentials: 'MSENG2'
feedDownloadExternal: 'fabrikamFeedExternal'
packageDownloadExternal: 'fabrikam-package'
versionDownloadExternal: 1.0.0
Argumentum | Leírás |
---|---|
feedsToUse | Állítsa be az értéket external külső forrásból való letöltéskor. |
externalFeedCredentials | A külső hírcsatorna szolgáltatáskapcsolatának neve. További információ: szolgáltatáskapcsolatok kezelése. |
feedDownloadExternal | A külső hírcsatorna neve. |
packageDownloadExternal | A letölteni kívánt csomagnév. |
versionDownloadExternal | A letölteni kívánt csomag verziója. |
Tipp.
Helyettesítő karakterek használatával letöltheti az univerzális csomag legújabb verzióját. További információ: A legújabb verzió letöltése.