Azure Pipelines でユニバーサル パッケージを発行およびダウンロードする

Azure Artifacts フィードにユニバーサル パッケージを発行するには、次のタスクをパイプラインの YAML ファイルに追加します。

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    packagePublishDescription: '<Package description>'

パイプラインから Azure Artifacts フィードにパッケージを発行するには、フィードでパイプラインの ID をフィード発行者 (共同作成者) になるように設定する必要があります。 詳細については、「 Pipelines のアクセス許可」を参照してください。

外部フィードに発行する場合は、まず、フィードで認証するためのサービス接続を作成しておく必要があります。 詳細については、「サービス接続の管理」を参照してください。

ユニバーサル パッケージを発行するには、ユニバーサル パッケージタスクをパイプラインに追加し、次のように必須フィールドに入力します。

• コマンド: 発行

• [Path to file(s) to publish] (発行するファイルへのパス): 発行するファイルのリストへのパス。 既定値:$(Build.ArtifactStagingDirectory)。

• フィードの場所: 現在の組織または別の組織の Azure Artifacts フィードに発行します。

• [Destination feed] (宛先フィード): 発行先にするフィードを選択します。

• パッケージ名: 既存のパッケージを選択するか (そのパッケージの新しいバージョンを発行する場合)、新しいパッケージ名を入力します (新しいパッケージの最初のバージョンを発行する場合)。

  

パイプラインから Azure Artifacts フィードにパッケージを発行するには、ビルドをフィード パブリッシャー (共同作成者) として実行する ID を設定します。 プロジェクト コレクション スコープを使用して実行するようにビルド パイプラインが構成されている場合は、プロジェクト コレクション ビルド サービス ID をフィードのフィード発行者 (共同作成者) として追加します。

ビルド パイプラインがプロジェクト スコープを使用して実行するように構成されている場合は、プロジェクト ビルド サービスの ID にフィードへの共同作成者アクセス権を付与する必要があります。 パイプライン エディターを開いて [オプション] タブをチェックすると、ビルドが実行されるスコープを確認できます。フィードのアクセス許可の詳細については、フィードのアクセス許可によるパッケージの管理を参照してください。

外部フィードに発行する場合は、まず、そのフィードをポイントするサービス接続を作成しておく必要があります。 詳細については、「サービス接続の管理」を参照してください。

パッケージのバージョン管理を有効にするには、YAML ファイルに versionOption 入力を追加します。 新しいパッケージ バージョンを発行する際のオプションは、major、minor、patch、または custom です。

custom を選択すると、パッケージのバージョンを手動で指定できるようになります。 その他のオプションでは、フィードから最新のパッケージ バージョンが取得され、選択したバージョン セグメントを 1 ずつ増分します。 そのため、testPackage 1.0.0 があるときに、major オプションを選択すると、新しいパッケージは testPackage 2.0.0 になります。 minor オプションを選択すると、パッケージ バージョンは 1.1.0 になり、patch オプションを選択すると、パッケージ バージョンは 1.0.1 になります。

custom オプションを選択した場合は、次のように versionPublish 値を指定する必要があります。

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    versionOption: custom
    versionPublish: '<Package version>'
    packagePublishDescription: '<Package description>'

ユニバーサル パッケージ タスクのフォームからバージョン管理戦略を選択するか、[カスタム] を選択してパッケージのバージョンを手動で入力します。

組織のフィードからユニバーサル パッケージをダウンロードする場合は、次のように download コマンドを指定したユニバーサル パッケージ タスクを使用します。

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    vstsFeed: '<projectName>/<feedName>'
    vstsFeedPackage: '<packageName>'
    vstsPackageVersion: '<packageVersion>'
    downloadDirectory: '$(Build.SourcesDirectory)\someFolder'

ユニバーサル パッケージを外部ソースからダウンロードする場合は、次のスニペットを使用します。

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    feedsToUse: external
    externalFeedCredentials: 'MSENG2'
    feedDownloadExternal: 'fabrikamFeedExternal'
    packageDownloadExternal: 'fabrikam-package'
    versionDownloadExternal: 1.0.0

ユニバーサル パッケージをダウンロードするには、パイプラインにユニバーサル パッケージ タスクを追加して、必須フィールドに次のように入力します。

• コマンド: ダウンロード
• [Destination directory] (宛先ディレクトリ): パッケージのダウンロード先のフォルダー パス。 既定値: $(System.DefaultWorkingDirectory)。
• フィードの場所: 自分の組織または別の組織のフィードからユニバーサル パッケージをダウンロードします。
• フィード: ダウンロード元にするフィード。
• パッケージ名: ダウンロードするパッケージの名前。
• バージョン: ダウンロードするパッケージのバージョン。