UniversalPackages@0 – Univerzális csomagok v0-feladat

Ezzel a feladatgal letöltheti vagy csomagolhatja és közzéteheti az univerzális csomagokat.

Szintaxis

# Universal packages v0
# Download or publish Universal Packages.
- task: UniversalPackages@0
  inputs:
    command: 'download' # 'download' | 'publish'. Required. Command. Default: download.
    downloadDirectory: '$(System.DefaultWorkingDirectory)' # string. Required when command = download. Destination directory. Default: $(System.DefaultWorkingDirectory).
    #publishDirectory: '$(Build.ArtifactStagingDirectory)' # string. Required when command = publish. Path to file(s) to publish. Default: $(Build.ArtifactStagingDirectory).
  # Feed & package details
    feedsToUse: 'internal' # 'internal' | 'external'. Alias: internalOrExternalDownload. Required when command = download. Feed location. Default: internal.
    #externalFeedCredentials: # string. Alias: externalEndpoint. Optional. Use when internalOrExternalDownload = external && command = download. organization/collection connection. 
    #vstsFeed: # string. Alias: feedListDownload. Required when internalOrExternalDownload = internal && command = download. Feed. 
    #vstsFeedPackage: # string. Alias: packageListDownload. Required when internalOrExternalDownload = internal && command = download. Package name. 
    #vstsPackageVersion: # string. Alias: versionListDownload. Required when internalOrExternalDownload = internal && command = download. Version. 
    #feedDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Feed (or Project/Feed if the feed was created in a project). 
    #packageDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Package name. 
    #versionDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Version. 
  # Feed & package details
    #feedsToUsePublish: 'internal' # 'internal' | 'external'. Alias: internalOrExternalPublish. Required when command = publish. Feed location. Default: internal.
    #publishFeedCredentials: # string. Alias: externalEndpoints. Required when internalOrExternalPublish = external && command = publish. organization/collection connection. 
    #vstsFeedPublish: # string. Alias: feedListPublish. Required when internalOrExternalPublish = internal && command = publish. Destination Feed. 
    #vstsFeedPackagePublish: # string. Alias: packageListPublish. Required when internalOrExternalPublish = internal && command = publish. Package name. 
    #feedPublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Feed (or Project/Feed if the feed was created in a project). 
    #packagePublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Package name. 
    #versionOption: 'patch' # 'major' | 'minor' | 'patch' | 'custom'. Alias: versionPublishSelector. Required when command = publish. Version. Default: patch.
    #versionPublish: # string. Required when versionPublishSelector = custom && command = publish. Custom version. 
    #packagePublishDescription: # string. Optional. Use when command = publish. Description. 
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && internalOrExternalPublish = internal. Publish pipeline metadata. Default: true.
    #verbosity: 'None' # 'None' | 'Trace' | 'Debug' | 'Information' | 'Warning' | 'Error' | 'Critical'. Verbosity. Default: None.
  # Output
    #publishedPackageVar: # string. Optional. Use when command = publish. Package Output Variable.

Bevitelek

command - Parancs
string. Kötelező. Engedélyezett értékek: download, publish. Alapértelmezett érték: download.

A futtatandó NuGet-parancsot adja meg.

downloadDirectory - Célkönyvtár
string. Akkor szükséges, ha command = download. Alapértelmezett érték: $(System.DefaultWorkingDirectory).

Megadja azt a mappaelérési utat, ahol a feladat letölti a csomag tartalmát.

feedsToUse - Hírcsatorna helye
Bemeneti alias: internalOrExternalDownload. string. Akkor szükséges, ha command = download. Engedélyezett értékek: internal (Ez a szervezet/gyűjtemény) external (Másik szervezet/gyűjtemény). Alapértelmezett érték: internal.

A gyűjteményből vagy az Azure Artifacts egy másik gyűjteményéből származó hírcsatornát ad meg.

externalFeedCredentials - szervezeti/gyűjteménykapcsolat
Bemeneti alias: externalEndpoint. string. Választható. Használja a következőt: internalOrExternalDownload = external && command = download.

Megadja a kiválasztott NuGet.confighelyen található külső regisztrációs adatbázisokhoz használandó hitelesítő adatokat. A szervezet vagy gyűjtemény hírcsatornáinál hagyja üresen a elemet; a rendszer automatikusan felhasználja a build hitelesítő adatait.

vstsFeed - Takarmány
Bemeneti alias: feedListDownload. string. Akkor szükséges, ha internalOrExternalDownload = internal && command = download.

A kijelölt hírcsatornát tartalmazza. Ahhoz, hogy itt kiválaszthassa a hírcsatornát, telepítenie és licencelnie kell az Azure Artifactst. Megadja egy szervezet hatókörébe tartozó hírcsatorna FeedName értékét, a projekthatókörű hírcsatornákhoz pedig a projectName/FeedName vagy a ProjectID/FeedID értéket.

vstsFeedPackage - Csomag neve
Bemeneti alias: packageListDownload. string. Akkor szükséges, ha internalOrExternalDownload = internal && command = download.

Megadja a feladat letöltéséhez szükséges csomag nevét.

vstsPackageVersion - Változat
Bemeneti alias: versionListDownload. string. Akkor szükséges, ha internalOrExternalDownload = internal && command = download.

Megadja a csomag verzióját, vagy egy, a letöltéshez használt verziót tartalmazó változót használ. Ez a bejegyzés egy helyettesítő kifejezés is lehet, például *a legmagasabb verzió lekéréséhez. Példák: 1.* a legmagasabb verziót kapja meg az 1-es főverzióval, a 1.2.* legmagasabb javításkiadást pedig az 1-es főverzióval és a 2-es alverzióval.

feedDownloadExternal - Hírcsatorna (vagy Projekt/Hírcsatorna, ha a hírcsatorna egy projektben lett létrehozva)
string. Akkor szükséges, ha internalOrExternalDownload = external && command = download.

Egy másik szervezet/gyűjtemény hírcsatornáját adja meg.

Projekthatókörű hírcsatornák esetén az értéknek a következőnek kell lennie Project/Feed: , ahol Project a projekt neve vagy azonosítója, és Feed a hírcsatorna neve/azonosítója. A szervezeti hatókörű hírcsatornák esetében az érték csak a hírcsatorna neve lehet.

packageDownloadExternal - Csomag neve
string. Akkor szükséges, ha internalOrExternalDownload = external && command = download.

Megadja a letölteni kívánt csomag nevét.

versionDownloadExternal - Változat
string. Akkor szükséges, ha internalOrExternalDownload = external && command = download.

Megadja a csomag verzióját, vagy egy, a letöltéshez használt verziót tartalmazó változót használ. Ez a bejegyzés egy helyettesítő kifejezés is lehet, például *a legmagasabb verzió lekéréséhez. Példák: 1.* a legmagasabb verziót kapja meg az 1-es főverzióval, a 1.2.* legmagasabb javításkiadást pedig az 1-es főverzióval és a 2-es alverzióval. A helyettesítő karakterek mintáit a kiadás előtti csomagok nem támogatják.

publishDirectory - A közzéteendő fájl(ok) elérési útja
string. Akkor szükséges, ha command = publish. Alapértelmezett érték: $(Build.ArtifactStagingDirectory).

Megadja a közzéteendő fájlok listájának elérési útját.

feedsToUsePublish - Hírcsatorna helye
Bemeneti alias: internalOrExternalPublish. string. Akkor szükséges, ha command = publish. Engedélyezett értékek: internal (Ez a szervezet/gyűjtemény) external (Másik szervezet/gyűjtemény). Alapértelmezett érték: internal.

A gyűjteményből vagy az Azure Artifacts egy másik gyűjteményéből származó hírcsatornát ad meg.

publishFeedCredentials - szervezeti/gyűjteménykapcsolat
Bemeneti alias: externalEndpoints. string. Akkor szükséges, ha internalOrExternalPublish = external && command = publish.

Megadja a külső hírcsatornákhoz használandó hitelesítő adatokat.

vstsFeedPublish - Célcsatorna
Bemeneti alias: feedListPublish. string. Akkor szükséges, ha internalOrExternalPublish = internal && command = publish.

Megadja a projektet és a hírcsatorna nevét/GUID azonosítóját, amelyben közzé szeretné tenni.

publishPackageMetadata - Folyamat metaadatainak közzététele
boolean. Választható. Használja a következőt: command = publish && internalOrExternalPublish = internal. Alapértelmezett érték: true.

Társítja a buildelési/kiadási folyamat metaadatait (például a futtatási # és a forráskód adatait) a csomaghoz.

vstsFeedPackagePublish - Csomag neve
Bemeneti alias: packageListPublish. string. Akkor szükséges, ha internalOrExternalPublish = internal && command = publish.

Megadja a csomagazonosítót, amelyet közzé szeretne tenni, vagy új csomagazonosítót hoz létre, ha még soha nem tette közzé a csomag egy verzióját. A csomagneveknek kisbetűknek kell lenniük, és csak betűket, számokat és kötőjeleket (-) használhatnak.

feedPublishExternal - Hírcsatorna (vagy Projekt/Hírcsatorna, ha a hírcsatorna egy projektben lett létrehozva)
string. Akkor szükséges, ha internalOrExternalPublish = external && command = publish.

Megadja a közzéteendő külső hírcsatorna nevét.

Ha a hírcsatorna egy projektben lett létrehozva, az értéknek a következőnek kell lennie Project/Feed: , ahol Project a projekt neve vagy azonosítója, és Feed a hírcsatorna neve. Ha a hírcsatorna nem egy projektben lett létrehozva, az érték csak a hírcsatorna neve lehet.

packagePublishExternal - Csomag neve
string. Akkor szükséges, ha internalOrExternalPublish = external && command = publish.

A csomag nevét adja meg külső hírcsatornán való közzétételkor.

versionOption - Változat
Bemeneti alias: versionPublishSelector. string. Akkor szükséges, ha command = publish. Engedélyezett értékek: major (Következő fő), minor (Következő alverzió), patch (Következő javítás), custom. Alapértelmezett érték: patch.

Verziónövelési stratégiát ad meg. A custom csomagverzió manuális bevitelének értéke. Új csomagok esetén az első verzió az 1.0.0 lesz, ha megadja majora 0.1.0-t, ha megadja minor, vagy ha a 0.0.1-et adja meg patch. További információt a Szemantikus verziószámozási specifikációban talál.

versionPublish - Egyéni verzió
string. Akkor szükséges, ha versionPublishSelector = custom && command = publish.

Egyéni verziósémát ad meg a csomaghoz.

packagePublishDescription - Leírás
string. Választható. Használja a következőt: command = publish.

Megadja a csomag tartalmának leírását és/vagy a csomag ezen verziójában végrehajtott módosításokat.

verbosity - Bőbeszédűség
string. Engedélyezett értékek: None, Trace, Debug, Information, Warning, Error, . Critical Alapértelmezett érték: None.

Megadja a kimenetben megjelenített részletek mennyiségét.

publishedPackageVar - Csomag kimeneti változója
string. Választható. Használja a következőt: command = publish.

Megadja annak a változónak a nevét, amely tartalmazza a közzétett csomag nevét és verzióját.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ezzel a feladatgal letöltheti vagy csomagolhatja és közzéteheti az univerzális csomagokat.

A saját folyamatnak egy másik projektben lévő hírcsatornához kell hozzáférnie

Ha a folyamat más projektben fut, mint a hírcsatornát üzemeltető projekt, be kell állítania a másik projektet, hogy olvasási/írási hozzáférést biztosítson a buildszolgáltatáshoz. További részletekért lásd : Csomagengedélyek az Azure Pipelinesban .

Példák

Az Univerzális csomag feladat használatának legegyszerűbb módja, ha a Pipelines feladatszerkesztővel hozza létre a YAML-t. Ezután átmásolhatja a létrehozott kódot a projekt fájljába azure-pipelines.yml . Ebben a példában a minta bemutatja, hogyan hozhatja létre gyorsan a YAML-t egy GatsbyJS progresszív webalkalmazást (PWA) létrehozó folyamattal.

Az univerzális csomagok a webalkalmazások beágyazásának és verziójának hasznos módjai. A webalkalmazások univerzális csomagba való csomagolása lehetővé teszi a webhely egy adott verziójának gyors visszaállítását, és nem szükséges a webhelyet az üzembe helyezési folyamatban létrehozni.

Ez a példafolyamat bemutatja, hogyan lehet lekérni egy eszközt a projekt egyik hírcsatornájából. Az univerzális csomag feladat az eszköz letöltésére, egy build futtatására, majd ismét az Univerzális csomag feladat használatával teszi közzé a teljes lefordított GatsbyJS PWA-t egy hírcsatornában verziószámozott univerzális csomagként.

Csomag letöltése az Univerzális csomag feladattal

A mintaprojekt második feladata az Univerzális csomag feladat használatával lekér egy imagemagick nevű eszközt egy olyan hírcsatornából, amely ugyanabban a szervezetben egy másik projektben található. A rendszerképek átméretezéséhez a következő buildelési lépés az imagemagick eszközt igényli.

1. Az Univerzális csomag feladat hozzáadásához kattintson a plusz ikonra, írja be az "univerzális" szót a keresőmezőbe, majd a Hozzáadás gombra kattintva adja hozzá a feladatot a folyamathoz.

   

2. Kattintson az újonnan hozzáadott Univerzális csomag feladatra, majd a parancsra a következőhöz Download: .

3. Válassza ki az eszköz letöltéséhez használni kívánt célkönyvtárat .

4. Válasszon ki egy forráscsatornát, amely tartalmazza az eszközt, állítsa be a Csomag nevét, majd válassza a képcsatorna verziószámát.

   

5. A mezők befejezése után kattintson a YAML megtekintése elemre a létrehozott YAML megtekintéséhez.

   

6. Az Univerzális csomag feladatszerkesztője egyszerűsített YAML-t hoz létre, amely nem alapértelmezett értékeket tartalmaz. Másolja a létrehozott YAML-t a azure-pipelines.ymlfájlba a projekt git-adattárának gyökerében.

   # Download Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal download'
     inputs:
       downloadDirectory: Application
       vstsFeed: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000001'
       vstsFeedPackage: imagemagick
       vstsPackageVersion: 1.0.0
   

Csomag közzététele az Univerzális csomag feladattal

A mintafolyamat utolsó lépése az Univerzális csomag feladattal tölti fel a lépés által Run gatsby build előállított, éles üzemre kész Gatsby PWA-t egy verziószámozott univerzális csomagként. Miután bekerült a hírcsatornába, rendelkezik a teljes webhely egy állandó példányával, amely üzembe helyezhető a szolgáltatónál, és elindítható a következővel gatsby serve: .

1. Adjon hozzá egy másik Univerzális csomag feladatot a folyamat végéhez a plusz ikonra kattintva, írja be az "univerzális" kifejezést a keresőmezőbe, majd a Hozzáadás gombra kattintva adja hozzá a feladatot a folyamathoz. Ez a feladat összegyűjti a lépés által Run gatsby build előállított összes éles üzemre kész eszközt, létrehoz egy verziószámozott univerzális csomagot, és közzéteszi a csomagot egy hírcsatornában.

   

2. Állítsa a parancsot a következőre: Publish.

3. Állítsa az Elérési utat fájl(ok)ra, hogy közzétegye a GatsbyJS-projektet tartalmazó könyvtárban package.json.

4. Válasszon ki egy célcsatornát, egy csomagnevet, és állítsa be a verziószámozási stratégiát.

   

5. A szükséges mezők elvégzése után kattintson a YAML megtekintése gombra.

6. Másolja az eredményül kapott YAML-t a fájlba a azure-pipelines.yml korábbiakhoz hasonlóan. A mintaprojekt YAML-fájlja alább látható.

   # Publish Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal publish'
     inputs:
       command: publish
       publishDirectory: Application
       vstsFeedPublish: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000002' # You can also use '<projectName>/<feedName>' instead of the GUIDs
       vstsFeedPackagePublish: mygatsbysite
       packagePublishDescription: 'A test package'
   

Ez a példa bemutatja, hogyan lehet a Pipelines feladatszerkesztővel gyorsan létrehozni a YAML-t az univerzális csomag feladathoz, amelyet aztán elhelyezhet a azure-pipelines.yml fájlban. Az Univerzális csomag feladatszerkesztője támogatja az univerzális csomag tevékenység argumentumaival létrehozható összes speciális konfigurációt.

Megjegyzés

Az Azure Artifacts nem támogatja a csomagok közvetlen nézetbe való közzétételét. Először közzé kell tennie a csomagot a hírcsatornában, majd elő kell léptetnie egy nézetbe.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	2.144.0 vagy újabb
Feladatkategória	Csomag