PublishBuildArtifacts@1 – Build-összetevők közzététele v1 feladat

Ezzel a feladatsal egy buildelési folyamatban közzéteheti a buildösszetevőket az Azure Pipelinesban, a TFS-ben vagy egy fájlmegosztásban.

Az Azure DevOps Services használata esetén javasoljuk, hogy folyamatösszetevők letöltését és a folyamatösszetevők közzétételét a gyorsabb teljesítmény érdekében.

Szintaxis

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #MaxArtifactSize: '0' # string. Max Artifact Size. Default: 0.
    #TargetPath: # 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.
  # Advanced
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.

Bemenetek

PathtoPublish - közzétételi útvonal
string. Szükséges. Alapértelmezett érték: $(Build.ArtifactStagingDirectory).

Megadja a közzétenni kívánt mappát vagy fájl elérési útját. Ez lehet teljesen minősített elérési út vagy az adattár gyökeréhez viszonyított elérési út. Helyettesítő karakterek nem használhatók. változók támogatottak. Példa: $(Build.ArtifactStagingDirectory). További információ: Folyamatok összetevői – áttekintés.

ArtifactName - összetevő neve
string. Szükséges. Alapértelmezett érték: drop.

Megadja a közzétételi helyen létrehozni kívánt összetevő nevét. A következő speciális karakterek nem engedélyezettek: +, %, {, }

publishLocation - Összetevő közzétételi helye
Bemeneti alias: ArtifactType. string. Szükséges. Engedélyezett értékek: Container (Azure Pipelines), FilePath (Fájlmegosztás). Alapértelmezett érték: Container.

Megadja, hogy az összetevőt az Azure Pipelinesban (Tárolóban) tárolja, vagy a buildügynökből elérhető fájlmegosztásba (FilePath) másolja. A bemeneti alias: ArtifactType a publishLocation alternatív neve, és felcserélhető. További információért lásd: Artefaktumok az Azure Pipelines.

MaxArtifactSize - összetevő maximális mérete
string. Alapértelmezett érték: 0.

A bájtokban közzéteendő összetevők méretének maximális korlátja. Ha nem szeretne korlátot beállítani, 0 értéket adjon meg.

TargetPath - fájlmegosztási útvonal
string. ArtifactType = FilePathesetén kötelező.

Megadja annak a fájlmegosztásnak az elérési útját, ahová a fájlokat másolni szeretné. Az elérési útnak teljesen minősített vagy érvényes elérési útnak kell lennie az adattár gyökérkönyvtárához képest. Az összetevők linuxos vagy macOS-ügynökből fájlmegosztásba való közzététele nem támogatott. Példa: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - párhuzamos másolási
boolean. Opcionális. Használja a ArtifactType = FilePath. Alapértelmezett érték: false.

Megadja, 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 egyetlen szálat használ.

ParallelCount - Párhuzamos szám
string. Opcionális. Használja a ArtifactType = FilePath && Parallel = true. Alapértelmezett érték: 8.

Megadja a másolás végrehajtásához használt párhuzamosság mértékét (a szálak számát). Az értéknek legalább 1 és 128-nál nem nagyobbnak kell lennie. Válasszon egy értéket a buildügynök CPU-képességei alapján.

StoreAsTar - Az összetevő kátrányozása a feltöltése előtt
boolean. Alapértelmezett érték: false.

Feltöltés előtt hozzáadja az összes fájlt a közzétételi útvonalról egy tar archívumhoz. Ez lehetővé teszi a UNIX-fájlengedélyek megőrzését. A letöltött elemek automatikus kinyeréséhez használja extractTarsDownloadBuildArtifacts feladatot. Ezt a beállítást a rendszer figyelmen kívül hagyja a Windows-ügynököknél.

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ők és gyakori feladattulajdonságok.

Kimeneti változók

Nincs.

Megjegyzések

Megjegyzés

Nem használhatja Bin, App_Data és az IIS által fenntartott egyéb mappaneveket összetevőnévként, mert ez a tartalom nem szolgál ki webes kérésekre válaszul. További részletekért tekintse meg ASP.NET webes projektmappa-struktúrát.

Példák

steps:
- task: CopyFiles@2
  inputs:
    contents: '_buildOutput/**'
    targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: $(Build.ArtifactStagingDirectory)
    artifactName: MyBuildOutputs

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build
Futtatás bekapcsolva	Ügynök, DeploymentGroup
Követelmények	Egyik sem
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ármely
Változók beállítása	Bármely
Ügynök verziója	1.91.0 vagy újabb
Tevékenységkategória	Hasznosság

Lásd még

• Fájlegyeztetési minták referenciája
• Hogyan tehetem közzé az összetevőket
• Megtudhatja, hogyan használható részletes naplókhibaelhárítási.