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.
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.
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.
# 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.
#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
#FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.
#StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.
# 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.
#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
#FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.
# 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.
#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.
# Publish Build Artifacts v1
# Publish build artifacts to Azure Pipelines/TFS or a 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.
#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.
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.
publishLocation
- Összetevő közzétételi helye
Bemeneti alias: ArtifactType
. string
. Kötelező. Engedélyezett értékek: Container
(Azure Pipelines/TFS) 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.
FileCopyOptions
- Fájlmásolási beállítások
string
. Választható. Használja a következőt: ArtifactType = FilePath
.
További beállításokat ad át a Robocopy parancsnak. Például a rekurzív minimatch minta **/*
.
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.