PublishBuildArtifacts@1 — publikowanie artefaktów kompilacji w wersji 1

Użyj tego zadania w potoku kompilacji, aby opublikować artefakty kompilacji w usłudze Azure Pipelines, TFS lub udziale plików.

Jeśli używasz Azure DevOps Services, zalecamy użycie funkcji Pobierz artefakty potoku i Publikowanie artefaktów potoku w celu uzyskania szybszej wydajności.

Składnia

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

Dane wejściowe

PathtoPublish - Ścieżka do opublikowania
string. Wymagane. Wartość domyślna: $(Build.ArtifactStagingDirectory).

Określa folder lub ścieżkę pliku do opublikowania. Może to być w pełni kwalifikowana ścieżka lub ścieżka względem katalogu głównego repozytorium. Symbole wieloznaczne nie są obsługiwane. Zmienne są obsługiwane. Przykład: $(Build.ArtifactStagingDirectory). Aby uzyskać więcej informacji, zobacz Artefakty w potokach — omówienie.

ArtifactName - Nazwa artefaktu
string. Wymagane. Wartość domyślna: drop.

Określa nazwę artefaktu do utworzenia w lokalizacji publikowania. Następujące znaki specjalne są niedozwolone: +, %, , {}

publishLocation - Lokalizacja publikowania artefaktów
Alias wejściowy: ArtifactType. string. Wymagane. Dozwolone wartości: Container (Azure Pipelines), FilePath (Udział plików). Wartość domyślna: Container.

Określa, czy artefakt ma być przechowywany w usłudze Azure Pipelines (kontener), czy skopiować go do udziału plików (FilePath), który musi być dostępny z agenta kompilacji. Aby uzyskać więcej informacji, zobacz Artifacts in Azure Pipelines (Artefakty w usłudze Azure Pipelines).

MaxArtifactSize - Maksymalny rozmiar artefaktu
string. Wartość domyślna: 0.

Maksymalny limit rozmiaru artefaktów do opublikowania w bajtach. Umieść wartość 0, jeśli nie chcesz ustawić żadnego limitu.

TargetPath - Ścieżka udziału plików
string. Wymagane, gdy ArtifactType = FilePath.

Określa ścieżkę do udziału plików, w którym chcesz skopiować pliki. Ścieżka musi być w pełni kwalifikowaną ścieżką lub prawidłową ścieżką względem katalogu głównego repozytorium. Publikowanie artefaktów z agenta systemu Linux lub macOS do udziału plików nie jest obsługiwane. Przykład: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - Kopiowanie równoległe
boolean. Opcjonalny. Użyj polecenia , gdy ArtifactType = FilePath. Wartość domyślna: false.

Określa, czy pliki mają być kopiowane równolegle przy użyciu wielu wątków w celu zwiększenia potencjalnej przepływności. Jeśli to ustawienie nie jest włączone, zostanie użyty pojedynczy wątek.

ParallelCount - Liczba równoległych
string. Opcjonalny. Użyj polecenia , gdy ArtifactType = FilePath && Parallel = true. Wartość domyślna: 8.

Określa stopień równoległości (liczba wątków) używanych do wykonania kopii. Wartość musi być co najmniej 1, a nie większa niż 128. Wybierz wartość opartą na możliwościach procesora CPU agenta kompilacji.

StoreAsTar - Posuń artefakt przed przekazaniem
boolean. Wartość domyślna: false.

Dodaje wszystkie pliki ze ścieżki publikowania do archiwum tar przed przekazaniem. Dzięki temu można zachować uprawnienia do plików systemu UNIX. Użyj extractTars opcji zadaniaDownloadBuildArtifacts , aby automatycznie wyodrębnić pobrane elementy. To ustawienie jest ignorowane w agentach systemu Windows.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

Uwaga

Nie można używać bin, App_Data i innych nazw folderów zarezerwowanych przez usługi IIS jako nazwy artefaktu, ponieważ ta zawartość nie jest obsługiwana w odpowiedzi na żądania sieci Web. Aby uzyskać więcej informacji, zobacz ASP.NET Web Project Folder Structure (Struktura folderów projektu sieci Web ).

Przykłady

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

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	1.91.0 lub nowszy
Kategoria zadania	Narzędzie

Zobacz też

• Odwołanie do wzorców dopasowywania plików
• Jak mogę użyć tego zadania do publikowania artefaktów
• Dowiedz się, jak używać pełnych dzienników do rozwiązywania problemów.