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

Ezt a feladatot egy buildfolyamatban használva 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 a gyorsabb teljesítmény érdekében használja a Folyamatösszetevők letöltése és a Folyamatösszetevők közzététele lehetőséget.

Syntax

# 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.

Bevitelek

PathtoPublish - Közzététel elérési útja
string. Kötelező. 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 teljes elérési út vagy az adattár gyökeréhez viszonyított elérési út. Helyettesítő karakterek nem használhatók. A változók támogatottak. Példa: $(Build.ArtifactStagingDirectory). További információ: Összetevők folyamatokban – áttekintés.

ArtifactName - Összetevő neve
string. Kötelező. Alapértelmezett érték: drop.

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

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

Meghatározza, hogy az összetevőt az Azure Pipelinesban (Tárolóban) tárolja-e, vagy egy fájlmegosztásba (FilePath) másolja, amelyet a buildügynökből kell elérni. További információ: Összetevők az Azure Pipelinesban.

MaxArtifactSize - Műtermék maximális mérete
string. Alapértelmezett érték: 0.

A bájtban 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ás elérési útja
string. Akkor szükséges, ha ArtifactType = FilePath.

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á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 egyetlen 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 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 ki egy értéket a buildügynök CPU-képességei alapján.

StoreAsTar - Az összetevő kátrányozása feltöltés 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. Használja extractTars aDownloadBuildArtifacts feladat beállítását a letöltött elemek automatikus kinyeréséhez. Ezt a beállítást a windowsos ügynökök figyelmen kívül hagyják.

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

Megjegyzés

Az IIS által lefoglalt Bin, App_Data és egyéb mappaneveket nem használhatja összetevőnévként, mert ez a tartalom nem szolgál ki webes kérésekre adott válaszként. További részletekért lásd : ASP.NET Webes projekt mappaszerkezete .

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:	Ü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	1.91.0 vagy újabb
Feladatkategória	Segédprogram

Lásd még

• Fájlegyeztetési minták referenciája
• Hogyan a feladat használatával tegye közzé az összetevőket
• Megtudhatja, hogyan használhat részletes naplókata hibaelhárításhoz.