PublishPipelineArtifact@1 – Folyamatösszetevők közzététele v1 feladat

Ezzel a feladatsal közzétehet (feltölthet) egy fájlt vagy könyvtárat nevesített összetevőként az aktuális futtatáshoz.

Syntax

# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # string. Required when artifactType = filepath. File share path. 
    #parallel: false # boolean. Optional. Use when artifactType = filepath. Parallel copy. Default: false.
    #parallelCount: '8' # string. Optional. Use when artifactType = filepath && parallel = true. Parallel count. Default: 8.
    #properties: # string. Custom properties.

Bevitelek

targetPath - Fájl- vagy könyvtárelérési út
Bemeneti alias: path. string. Kötelező. Alapértelmezett érték: $(Pipeline.Workspace).

Megadja a közzétenni kívánt fájl vagy könyvtár elérési útját. Lehet abszolút vagy relatív az alapértelmezett munkakönyvtárhoz képest. Tartalmazhat változókat, de a helyettesítő karakterek nem támogatottak. További információ: Összetevők az Azure Pipelinesban .

artifact - Összetevő neve
Bemeneti alias: artifactName. string.

Megadja a közzétenni kívánt összetevő nevét. Bármilyen nevet megadhat, például drop: . Ha nincs beállítva, az alapértelmezett érték a feladatra vonatkozó egyedi azonosító.

Fontos

Az összetevő neve nem tartalmazhat \, /, ", :, <, >, |, *vagy ?.

publishLocation - Összetevő közzétételi helye
Bemeneti alias: artifactType. string. Kötelező. Engedélyezett értékek: pipeline (Azure Pipelines), filepath (Fájlmegosztás). Alapértelmezett érték: pipeline.

Meghatározza, hogy az összetevőt az Azure Pipelinesban tárolja-e, vagy egy olyan fájlmegosztásba másolja, amelyet a folyamatügynökből el kell érnie.

fileSharePath - Fájlmegosztás elérési útja
string. Akkor szükséges, ha artifactType = filepath.

Megadja azt a fájlmegosztást, ahová az összetevőfájlokat másolni kell. Ilyenek lehetnek például \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber)a változók. Az összetevők linuxos vagy macOS-ügynökből fájlmegosztásba való közzététele nem támogatott, például \\server\folderName: .

parallel - Párhuzamos másolás
boolean. Választható. Használja a következőt: artifactType = filepath. Alapértelmezett érték: false.

Meghatározza, hogy a fájlok párhuzamos másolása több szál használatával a nagyobb lehetséges átviteli sebesség érdekében. Ha ez a beállítás nincs engedélyezve, a rendszer egy szálat használ.

parallelCount - Párhuzamosok száma
string. Választható. Használja a következőt: artifactType = filepath && parallel = true. Alapértelmezett érték: 8.

Megadja a párhuzamosság mértékét vagy a másolás végrehajtásához használt szálak számát. Az értéknek 1 és 128 között kell lennie.

properties - Egyéni tulajdonságok
string.

Megadja az összetevőhöz társítandó egyéni tulajdonságokat. Használjon érvényes JSON-sztringet az előtaggal user- az összes kulcson.

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

A közzététel nem támogatott a klasszikus kiadási folyamatokban.

Megjegyzés

A folyamatösszetevők közzététele a helyszínen nem támogatott. Ha Azure DevOps Server vagy TFS 2018-t használ, használja a BuildÖsszetevők közzététele parancsot. Ha Azure DevOps Server használja, a következőhöz hasonló hibaüzenet jelenik meg: Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead..

A publish és download a kulcsszavak a PublishPipelineArtifact@1 és DownloadPipelineArtifact@2 feladatok billentyűparancsai. További részletekért lásd: steps.publish and steps.download .

Tipp

A .artifactignore fájllal szabályozhatja, hogy mely fájlok lesznek közzétéve.

Problémákat tapasztalok az összetevők közzétételével kapcsolatban. Hogyan tekinthetem meg a részletes naplókat?

A folyamat részletes naplóinak engedélyezése:

1. A folyamat szerkesztése és a Változók kiválasztása
2. Új változó hozzáadása névvel System.Debug és értékkel true
3. Mentés

Mely változók érhetők el számomra?

A: $(Build.SourcesDirectory) és $(Agent.BuildDirectory) csak néhány a folyamatban használható változók közül. A változók kifejezésként vagy szkriptként érhetők el.

A változók különböző típusaival kapcsolatban lásd: Változók,előre definiált változók és klasszikus kiadási és összetevő-változók meghatározása.

A feladat lehetővé teszi, hogy összetevőket tegyek közzé az üzembehelyezési feladatban a Yaml-folyamatban, de nem tudom használni az alsóbb rétegbeli folyamatban?

A: Az üzembehelyezési feladatok nem rendelkeznek a forráságak környezetével, ezért nem alkalmasak összetevők közzétételére. Elsősorban összetevők felhasználására tervezték őket. Áthidaló megoldásként elkülönítheti ezt a logikát egy külön feladatra (az üzembehelyezési feladatok függőségeivel).

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.199.0 vagy újabb
Feladatkategória	Segédprogram

Lásd még

• Szeretné elkezdeni a buildelési összetevőket? Lásd: Összetevők az Azure Pipelinesban.