Azure Artifacts フィードからユニバーサル パッケージを発行する

Azure DevOps サービス

ユニバーサル パッケージを使用すると、NuGet、npm、Python パッケージなどの形式を超えて、さまざまな種類のファイルとパッケージの内容を格納できます。 Azure CLIを使用して、コマンド ラインから直接発行できます。 ユニバーサル パッケージは最大 4 TiB で、名前とバージョンを含める必要があります。 この記事では、ユニバーサル パッケージを Azure Artifacts フィードに発行する方法について説明します。

必須コンポーネント

製品 要件
Azure DevOps - Azure DevOps 組織
- Azure DevOps プロジェクト
- Azure CLIをインストールします。
- バージョン 0.14.0 以降 Azure DevOps 拡張機能をインストールします。

Azure DevOps 拡張機能をインストールする

Azure CLIのAzure DevOps拡張機能を使用すると、コマンド ラインからAzure DevOpsサービスを管理できます。 インストールする前に、Azure CLI バージョン 2.10.1 以降がインストールされていることを確認してください。

  1. Azure DevOps拡張機能をインストールするには、次のコマンドを実行します。

    az extension add --name azure-devops
    
  2. 既存のインストールを最新バージョンに更新するには、次を実行します。

    az extension update --name azure-devops
    

フィードを作成する

ユニバーサル パッケージを発行する前に、それを発行するためのフィードが必要です。 フィードは、パッケージを格納および整理するコンテナーであり、アクセスできるユーザーを制御できます。 プロジェクトまたは組織のフィードを作成するには、次の手順に従います。

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

  2. [成果物 ]を選択し、次に[フィードの作成 ]を選択します。

  3. フィードの 名前 を入力します。

  4. [ 表示] オプションを選択して、パッケージを表示できるユーザーを制御します。

  5. フィードで nuget.org npmjs.com などのパブリック ソースからパッケージをプルする場合は、[一般的なパブリック ソースのパッケージを含める] を選択します。

  6. [スコープ] で、フィードをプロジェクトのみに適用するか、組織全体に適用するかを選択します。

  7. 完了したら [作成] を選択します。

    Azure DevOps Services で新しいフィードを作成する方法を示すスクリーンショット。

ユニバーサル パッケージの発行

フィードを作成したら、ユニバーサル パッケージを発行する準備ができました。 発行するすべてのパッケージには名前とバージョン番号が必要であり、両方とも特定の名前付け規則に従う必要があります。

  • パッケージ名は、小文字、先頭、末尾に文字または数字を使用する必要があり、文字、数字、連続しないダッシュ (-)、アンダースコア (_)、またはピリオド (.) のみを含めることができます。
  • パッケージのバージョンも小文字にする必要があり、 + サフィックスで示されるビルド メタデータを含めることはできません。 詳細については、「 セマンティック バージョン管理」を参照してください。
  1. フィードのスコープがプロジェクトか組織かに応じて、次のいずれかのコマンドを実行してユニバーサル パッケージを発行します。

    • プロジェクト スコープのフィード:

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      
    • 組織スコープのフィード:

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      

メモ

パッケージに非常に多くのファイル (100K 以上) が含まれている場合、発行が失敗する可能性があります。 この場合は、ファイルを ZIP または TAR アーカイブにバンドルして、ファイル数を減らします。

発行済みパッケージを表示する

パッケージを発行したら、フィードで使用できることを確認できます。

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

  2. [Artifacts] を選択し、ドロップダウン メニューからフィードを選択します。 発行が正常に完了した場合は、フィードでパッケージを使用できる必要があります。

    新しく発行されたユニバーサル パッケージを示すスクリーンショット。