パイプライン成果物を発行してダウンロードする

Azure DevOps Services

Azure Pipelines を使うと、パイプライン内の以前のステージまたは別のパイプラインから成果物をダウンロードできます。 また、成果物をファイル共有に公開したり、パイプライン成果物として使用できるようにしたりすることもできます。

成果物を公開する

成果物は、YAML、クラシック エディター、または Azure CLI を使って公開できます。

steps:
- publish: $(System.DefaultWorkingDirectory)/bin/WebApp
  artifact: WebApp

steps:
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: $(System.DefaultWorkingDirectory)/bin/WebApp
    artifactName: WebApp

成果物の名前は省略可能ですが、成果物の内容を正確に反映する名前を指定することをお勧めします。 別の OS 上で実行されるジョブからその成果物を使う予定の場合は、すべてのファイル パスがターゲット環境で有効になるようにする必要があります。 たとえば、\ や * の文字を含むファイル名は、Windows ではダウンロードできません。

公開するファイルまたはフォルダーのパスは必須です。 これは絶対パスまたは $(System.DefaultWorkingDirectory) を基準にした相対パスにすることができます。

Azure Artifacts 内のパッケージは不変です。 パッケージを公開すると、そのバージョンは永続的に予約されます。 パッケージが公開されている場合、失敗したジョブを再実行しても失敗します。 "パッケージは既に存在します" というエラーを発生させずに失敗したジョブを再実行できるようにしたい場合は、条件を使って前のジョブが成功した場合にのみ実行することをお勧めします。

  jobs:
  - job: Job1
    steps:
      - script: echo Hello Job1!

  - job: Job2
    steps:
      - script: echo Hello Job2!
    dependsOn: Job1

.artifactignore を使う

.artifactignore では、.gitignore と同様の構文を使って (制限事項はほとんどありません)、成果物の公開時に無視するファイルを指定します。 .artifactignore ファイルは、必ずパイプライン成果物の公開タスクの targetPath 引数で指定したディレクトリ内に配置してください。

例: .exe ファイルを除くすべてのファイルを無視します。

**/*
!*.exe

成果物をダウンロードする

成果物は、YAML、クラシック エディター、または Azure CLI を使ってダウンロードできます。

steps:
- download: current
  artifact: WebApp

steps:
- task: DownloadPipelineArtifact@2
  inputs:
    artifact: WebApp

組織内の別のプロジェクトからパイプライン成果物をダウンロードするには、ダウンストリーム プロジェクトと成果物を生成するパイプラインの両方に対して適切な アクセス許可 が構成されていることを確認します。 既定では、ファイルは $(Pipeline.Workspace) にダウンロードされます。 成果物名が指定されていない場合は、ダウンロードされた成果物ごとにサブディレクトリが作成されます。 一致パターンを使って、ダウンロードするファイルを限定できます。 詳しくは、ファイルの一致パターンに関する記事を参照してください。

steps:
- download: current
  artifact: WebApp
  patterns: |
    **/*.js
    **/*.zip

成果物の選択

1 回のダウンロード手順で、1 つ以上の成果物をダウンロードできます。 複数の成果物をダウンロードするには、[成果物名] フィールドは空のままにして、ファイルの一致パターンを使ってダウンロードするファイルを限定します。 ** が既定のファイル一致パターンです (すべての成果物内のすべてのファイル)。

1 つの成果物

成果物名を指定する場合:

1. その特定の成果物のファイルのみがダウンロードされます。 成果物が存在しない場合、タスクは失敗します。

2. ファイルの一致パターンは、成果物のルートを基準として評価されます。 たとえば、*.jar というパターンは、成果物のルートにある .jar 拡張子を持つすべてのファイルと一致します。

次の例は、成果物 WebApp からすべての *.js をダウンロードする方法を示しています。

steps:
- download: current
  artifact: WebApp
  patterns: '**/*.js'

steps:
- task: DownloadPipelineArtifact@2
  inputs:
    artifact: WebApp
    patterns: '**/*.js'
    path: $(Build.SourcesDirectory)/bin

複数の成果物

成果物名を指定しない場合:

1. 複数の成果物をダウンロードでき、ファイルが見つからなくてもタスクは失敗しません。

2. 成果物ごとにサブディレクトリが作成されます。

3. ファイルの一致パターンでは、パターンの最初の部分が成果物名になる (または成果物名と一致する) ようにする必要があります。 たとえば、WebApp/** は、WebApp 成果物のすべてのファイルと一致します。 */*.dll というパターンは、各成果物のルートにある .dll 拡張子を持つすべてのファイルと一致します。

次の例は、すべての成果物からすべての .zip ファイルをダウンロードする方法を示しています。

steps:
- download: current
  patterns: '**/*.zip'

steps:
- task: DownloadPipelineArtifact@2
  inputs:
    patterns: '**/*.zip'

特定の成果物をダウンロードする

次の例では、特定の実行によって生成された特定のビルド バージョンからパイプライン成果物をダウンロードする方法を示します。

resources:
  pipelines:
  - pipeline: myPipeline
    project: 'xxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx'
    source: '79'
    version: '597'

steps:
- download: myPipeline
  artifact: drop
  patterns: '**'
  displayName: 'Download Pipeline Artifact'

steps:
- task: DownloadPipelineArtifact@2
  displayName: 'Download Pipeline Artifact'
  inputs:
    buildType: specific
    project: 'xxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx'
    definition: 79
    buildVersionToDownload: specific
    pipelineId: 597
    artifactName: drop

リリースおよびデプロイ ジョブの成果物

成果物は、デプロイ ジョブでのみ自動的にダウンロードされます。 既定では、成果物は $(Pipeline.Workspace) にダウンロードされます。 成果物のダウンロード タスクは、デプロイで deploy ライフサイクル フックを使う場合にのみ自動的に挿入されます。 成果物が自動的にダウンロードされないようにするには、download ステップを追加してその値を none に設定します。 通常のビルド ジョブでは、download ステップ キーワードか、パイプライン成果物のダウンロード タスクを明示的に使う必要があります。 その他の種類のフックについて詳しくは、ライフサイクル フックに関する記事を参照してください。

steps:
- download: none

ステージをまたいで成果物を使う

パイプラインのさまざまなステージで成果物にアクセスできるようにする場合、依存関係を利用して、あるステージで成果物を発行し、次のステージでダウンロードできるようになりました。 詳細については、「依存関係をステージングするステージ」を参照してください。

例

次の例では、リポジトリからスクリプト フォルダーをコピーして $(Build.ArtifactStagingDirectory) に公開します。 2 番目のステージでは、スクリプトをダウンロードして実行します。

trigger:
- main
stages:
- stage: build
  jobs:
  - job: run_build
    pool:
      vmImage: 'windows-latest'
    steps:
    - task: VSBuild@1
      inputs:
        solution: '**/*.sln'
        msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:DesktopBuildPackageLocation="$(build.artifactStagingDirectory)\WebApp.zip" /p:DeployIisAppPath="Default Web Site"'
        platform: 'Any CPU'
        configuration: 'Release'

    - task: CopyFiles@2
      displayName: 'Copy scripts'
      inputs:
        contents: 'scripts/**'
        targetFolder: '$(Build.ArtifactStagingDirectory)'

    - publish: '$(Build.ArtifactStagingDirectory)/scripts'
      displayName: 'Publish script'
      artifact: drop

- stage: test
  dependsOn: build
  jobs:
  - job: run_test
    pool:
      vmImage: 'windows-latest'
    steps:
    - download: current
      artifact: drop
    - task: PowerShell@2
      inputs:
        filePath: '$(Pipeline.Workspace)\drop\test.ps1'

ビルド成果物から移行する

パイプライン成果物は次世代のビルド成果物であり、成果物を操作する場合にお勧めの方法です。 ビルド成果物の公開タスクを使って公開された成果物は、ビルド成果物のダウンロードを使ってダウンロードすることもできますが、代わりに最新のパイプライン成果物のダウンロード タスクを使うことをお勧めします。

ビルド成果物からパイプライン成果物に移行する場合:

1. 既定では、パイプライン成果物のダウンロード タスクでは $(Pipeline.Workspace) にファイルがダウンロードされます。 これは、すべての種類の成果物に対する既定のパスであり、推奨されるパスです。

2. ビルド成果物のダウンロード タスクのファイル一致パターンは、特定の成果物が指定されているかどうかに関係なく、成果物名で始まる (または一致する) 必要があります。 パイプライン成果物のダウンロード タスクでは、成果物名が既に指定されている場合、パターンに成果物名を含めないようにしてください。 詳しくは、1 つの成果物の選択に関するページを参照してください。

例

- task: PublishPipelineArtifact@1
  displayName: 'Publish pipeline artifact'
  inputs:
    targetPath: '$(Pipeline.Workspace)'
    ${{ if eq(variables['Build.SourceBranchName'], 'main') }}:
        artifact: 'prod'
    ${{ else }}:
        artifact: 'dev'
    publishLocation: 'pipeline'

• targetPath: (必須) 公開するファイルまたはディレクトリのパス。 絶対パスか、既定の作業ディレクトリを基準とした相対パスを指定できます。 変数を含めることができますが、ワイルドカードはサポートされていません。 既定値: $(Pipeline.Workspace)。

• publishLocation: (必須) 成果物の発行場所。 成果物を Azure Pipelines に保存するか、またはパイプライン エージェントからアクセスできるファイル共有にコピーするかを選択します。 オプション: pipeline、filepath。 既定値: pipeline。

• 成果物: (必須) 公開する成果物の名前。 設定しない場合、既定値はジョブをスコープとする一意の ID です。

公開された成果物を表示する

パイプライン実行が完了したら、次の手順に従って公開された成果物を表示またはダウンロードします。

1. Azure DevOps 組織にサインインしてから、プロジェクトに移動します。

2. [パイプライン] を選択し、パイプライン実行を選んでから、[概要] タブを選択します。

3. 関連セクションで、公開された成果物を選択します。

   

4. ドロップ フォルダーを展開して成果物を見つけます。 そうすると、成果物をダウンロードして内容を調べることができます。

   

よく寄せられる質問

Q: ビルド成果物とは何ですか?

A: ビルド成果物は、ビルドによって生成されるファイルです。 ビルド成果物を公開して使用する方法について詳しくは、ビルド成果物に関する記事を参照してください。

Q: 失敗したジョブを再実行するときにパイプライン成果物を削除できますか?

A: パイプライン成果物を削除したり上書きしたりすることはできません。 失敗したジョブを再実行するときに成果物を再生成したい場合は、成果物名にジョブ ID を含めることができます。 $(system.JobId) はこの目的に適した変数です。 事前定義済みの変数について詳しくは、システム変数に関する記事を参照してください。

Q: ファイアウォールの内側にある Artifacts フィードにアクセスするにはどうすればよいですか?

A: 組織でファイアウォールまたはプロキシ サーバーを使用している場合は、Azure Artifacts のドメイン URL と IP アドレスを必ず許可してください。

関連記事

• ビルド成果物
• Azure Pipelines でのリリース
• 成果物と成果物ソースのリリース
• プライベート パッケージ フィードを使用する際にリスクを軽減する方法