PublishPipelineArtifact@1 — zadanie Publikowanie artefaktów potoku w wersji 1

To zadanie służy do publikowania (przekazywania) pliku lub katalogu jako nazwanego artefaktu dla bieżącego przebiegu.

Składnia

# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # 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.
    #properties: # string. Custom properties.

Dane wejściowe

targetPath - Ścieżka pliku lub katalogu
Alias wejściowy: path. string. Wymagane. Wartość domyślna: $(Pipeline.Workspace).

Określa ścieżkę pliku lub katalogu do opublikowania. Może być bezwzględny lub względny względem domyślnego katalogu roboczego. Może zawierać zmienne, ale symbole wieloznaczne nie są obsługiwane. Aby uzyskać więcej informacji, zobacz Artifacts in Azure Pipelines (Artefakty w usłudze Azure Pipelines ).

artifact - Nazwa artefaktu
Alias wejściowy: artifactName. string.

Określa nazwę artefaktu do opublikowania. Może to być dowolna wybrana nazwa, na przykład drop. Jeśli nie zostanie ustawiona, wartość domyślna to unikatowy identyfikator o określonym zakresie zadania.

Ważne

Nazwa artefaktu nie może zawierać \, , ></:|"*lub .?

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

Określa, czy artefakt ma być przechowywany w usłudze Azure Pipelines, czy skopiować go do udziału plików, który musi być dostępny z agenta potoku.

fileSharePath - Ścieżka udziału plików
string. Wymagane, gdy artifactType = filepath.

Określa udział plików, w którym są kopiowane pliki artefaktów. Może to obejmować zmienne, na przykład \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). Publikowanie artefaktów z agenta systemu Linux lub macOS do udziału plików nie jest obsługiwane, na przykład \\server\folderName.

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 jeden 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 lub liczbę używanych wątków do wykonania kopii. Wartość musi należeć do zakresu od 1 do 128.

properties - Właściwości niestandardowe
string.

Określa właściwości niestandardowe do skojarzenia z artefaktem. Użyj prawidłowego ciągu JSON z prefiksem user- dla wszystkich kluczy.

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

Publikowanie nie jest obsługiwane w potokach wydania klasycznego.

Uwaga

Publikowanie artefaktów potoku nie jest obsługiwane w środowisku lokalnym. Jeśli używasz Azure DevOps Server lub TFS 2018, użyj funkcji Publikuj artefakty kompilacji. Jeśli używasz go w Azure DevOps Server, zostanie wyświetlony komunikat o błędzie podobny do Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead..

Słowa publish kluczowe i download są skrótami do zadań PublishPipelineArtifact@1 i DownloadPipelineArtifact@2. Aby uzyskać więcej informacji, zobacz steps.publish and steps.download .

Porada

Za pomocą pliku artifactignore można kontrolować, które pliki zostaną opublikowane.

Mam problemy z publikowaniem artefaktów. Jak wyświetlić szczegółowe dzienniki?

Aby włączyć szczegółowe dzienniki dla potoku:

1. Edytuj potok i wybierz pozycję Zmienne
2. Dodawanie nowej zmiennej o nazwie System.Debug i wartości true
3. Zapisz

Które zmienne są dostępne dla mnie?

1: $(Build.SourcesDirectory) i $(Agent.BuildDirectory) to tylko kilka zmiennych, których można użyć w potoku. Zmienne są dostępne jako wyrażenia lub skrypty.

Zobacz Definiowanie zmiennych, wstępnie zdefiniowanych zmiennych oraz zmiennych wydania klasycznego i artefaktów , aby dowiedzieć się więcej o różnych typach zmiennych.

Zadanie umożliwia mi publikowanie artefaktów w zadaniu wdrażania w potoku yaml, ale nie mogę go używać w potoku podrzędnym?

1: Zadania wdrażania nie mają kontekstu gałęzi źródłowych i dlatego nie są odpowiednie do publikowania artefaktów. Zostały one zaprojektowane głównie do korzystania z artefaktów. Obejściem byłoby odizolowanie tej logiki do oddzielnego zadania (z zależnościami dla zadań wdrażania).

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja 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	2.199.0 lub nowsza
Kategoria zadania	Narzędzie

Zobacz też

• Chcesz rozpocząć pracę z artefaktami kompilacji? Zobacz Artefakty w usłudze Azure Pipelines.