Freigeben über


PublishBuildArtifacts@1: Aufgabe "Buildartefakte v1 veröffentlichen"

Verwenden Sie diese Aufgabe in einer Buildpipeline, um Buildartefakte in Azure Pipelines, TFS oder einer Dateifreigabe zu veröffentlichen.

Wenn Sie Azure DevOps Services verwenden, empfehlen wir die Verwendung von Pipelineartefakten herunterladen und Pipelineartefakte veröffentlichen, um eine höhere Leistung zu erzielen.

Verwenden Sie diese Aufgabe in einer Buildpipeline, um Buildartefakte in Azure Pipelines, TFS oder einer Dateifreigabe zu veröffentlichen.

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.

Eingaben

PathtoPublish - Pfad zur Veröffentlichung
string. Erforderlich. Standardwert. $(Build.ArtifactStagingDirectory).

Gibt den zu veröffentlichenden Ordner- oder Dateipfad an. Dies kann ein vollqualifizierter Pfad oder ein Pfad relativ zum Stamm des Repositorys sein. Platzhalter werden nicht unterstützt. Variablen werden unterstützt. Beispiel: $(Build.ArtifactStagingDirectory). Weitere Informationen finden Sie unter Artefakte in Pipelines – Übersicht.


ArtifactName - Artefaktname
string. Erforderlich. Standardwert. drop.

Gibt den Namen des Artefakts an, das am Veröffentlichungsort erstellt werden soll. Die folgenden Sonderzeichen sind nicht zulässig: +, %, , {, }


publishLocation - Artefaktveröffentlichungsort
Eingabealias: ArtifactType. string. Erforderlich. Zulässige Werte: Container (Azure Pipelines), FilePath (Eine Dateifreigabe). Standardwert. Container.

Gibt an, ob das Artefakt in Azure Pipelines (Container) gespeichert oder in eine Dateifreigabe (FilePath) kopiert werden soll, auf die über den Build-Agent zugegriffen werden muss. Weitere Informationen finden Sie unter Artefakte in Azure Pipelines.


publishLocation - Artefaktveröffentlichungsort
Eingabealias: ArtifactType. string. Erforderlich. Zulässige Werte: Container (Azure Pipelines/TFS), FilePath (Eine Dateifreigabe). Standardwert. Container.

Gibt an, ob das Artefakt in Azure Pipelines (Container) gespeichert oder in eine Dateifreigabe (FilePath) kopiert werden soll, auf die über den Build-Agent zugegriffen werden muss. Weitere Informationen finden Sie unter Artefakte in Azure Pipelines.


MaxArtifactSize - Maximale Artefaktgröße
string. Standardwert. 0.

Maximales Limit für die Größe von Artefakten, die in Bytes veröffentlicht werden sollen. Setzen Sie 0, wenn Sie kein Limit festlegen möchten.


TargetPath - Dateifreigabepfad
string. Erforderlich, wenn ArtifactType = FilePath.

Gibt den Pfad zur Dateifreigabe an, in die Sie die Dateien kopieren möchten. Der Pfad muss ein vollqualifizierter Pfad oder ein gültiger Pfad relativ zum Stammverzeichnis Ihres Repositorys sein. Das Veröffentlichen von Artefakten von einem Linux- oder macOS-Agent in einer Dateifreigabe wird nicht unterstützt. Beispiel: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).


Parallel - Paralleles Kopieren
boolean. Optional. Verwenden Sie , wenn ArtifactType = FilePath. Standardwert. false.

Gibt an, ob Dateien parallel mit mehreren Threads kopiert werden sollen, um den potenziellen Durchsatz zu erhöhen. Wenn diese Einstellung nicht aktiviert ist, wird ein einzelner Thread verwendet.


ParallelCount - Parallele Anzahl
string. Optional. Verwenden Sie , wenn ArtifactType = FilePath && Parallel = true. Standardwert. 8.

Gibt den Grad an Parallelität (die Anzahl der Threads) an, die zum Ausführen der Kopie verwendet werden. Der Wert muss mindestens 1 und darf nicht größer als 128 sein. Wählen Sie einen Wert basierend auf den CPU-Funktionen des Build-Agents aus.


StoreAsTar - Tarieren des Artefakts vor dem Hochladen
boolean. Standardwert. false.

Fügt vor dem Hochladen alle Dateien aus dem Veröffentlichungspfad zu einem Tar-Archiv hinzu. Dadurch können Sie die UNIX-Dateiberechtigungen beibehalten. Verwenden Sie extractTars die OptiondownloadBuildArtifacts , um die heruntergeladenen Elemente automatisch zu extrahieren. Diese Einstellung wird unter Windows-Agents ignoriert.


FileCopyOptions - Optionen zum Kopieren von Dateien
string. Optional. Verwenden Sie , wenn ArtifactType = FilePath.

Übergibt zusätzliche Optionen an den Robocopy-Befehl. Ein Beispiel ist das rekursive Minimatch-Muster **/*.


Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Hinweis

Sie können Bin, App_Data und andere von IIS reservierte Ordnernamen nicht als Artefaktnamen verwenden, da dieser Inhalt nicht als Reaktion auf Webanforderungen bereitgestellt wird. Weitere Informationen finden Sie unter Ordnerstruktur für ASP.NET-Webprojekte.

Beispiele

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

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Keine
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Einstellbare Variablen Any
Agent-Version 1.91.0 oder höher
Aufgabenkategorie Hilfsprogramm

Weitere Informationen