PublishBuildArtifacts@1 — zadanie publikowania 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 usług Azure DevOps Services, zalecamy użycie pobieranie artefaktów 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

ścieżka PathtoPublish - do publikowania
string. To jest 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ędna 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. To jest wymagane. Wartość domyślna: drop.

Określa nazwę artefaktu, który ma zostać utworzony w lokalizacji publikowania. Następujące znaki specjalne są niedozwolone: +, %, {, }

publishLocation - Lokalizacja publikowania artefaktów
Alias wejściowy: ArtifactType. string. To jest 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 kopiowany do udziału plików (FilePath), który musi być dostępny z poziomu agenta kompilacji. Alias wejściowy: ArtifactType jest alternatywną nazwą i publishLocation może być używany zamiennie. Aby uzyskać więcej informacji, zobacz Artifacts in Azure Pipelines.

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

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

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

Określa ścieżkę do udziału plików, do którego 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 uzyskania większej potencjalnej przepływności. Jeśli to ustawienie nie jest włączone, zostanie użyty pojedynczy wątek.

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

Określa stopień równoległości (liczbę wątków) używanych do wykonywania kopiowania. Wartość musi wynosić co najmniej 1 i nie być większa niż 128. Wybierz wartość na podstawie możliwości procesora CPU agenta kompilacji.

StoreAsTar - Smoła artefakt przed przesłaniem
boolean. Wartość domyślna: false.

Dodaje wszystkie pliki ze ścieżki publikowania do archiwum tar przed przekazaniem. Pozwala to na zachowanie uprawnień do plików systemu UNIX. Użyj extractTars opcji zadaniaDownloadBuildArtifacts , aby automatycznie wyodrębnić pobrane elementy. To ustawienie jest ignorowane w przypadku agentów systemu Windows.

Opcje sterowania zadania

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

Zmienne wyjściowe

Żaden.

Uwagi

Uwaga / Notatka

Nie można używać nazw folderów Bin, App_Data i innych zarezerwowanych przez usługi IIS jako nazwy artefaktów, ponieważ ta zawartość nie jest obsługiwana w odpowiedzi na żądania sieci Web. Aby uzyskać więcej informacji, zobacz strukturę folderów projektu internetowego ASP.NET .

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, klasyczna kompilacja
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.91.0 lub nowsza
Kategoria zadań	Użyteczność

Zobacz także

• 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 na potrzeby rozwiązywania problemów z .