Univerzális csomagok közzététele és letöltése az Azure Pipelines használatával

  • Cikk

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.171.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, patchvagy 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.