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 以降がインストールされていることを確認してください。
Azure DevOps拡張機能をインストールするには、次のコマンドを実行します。
az extension add --name azure-devops既存のインストールを最新バージョンに更新するには、次を実行します。
az extension update --name azure-devops
フィードを作成する
ユニバーサル パッケージを発行する前に、それを発行するためのフィードが必要です。 フィードは、パッケージを格納および整理するコンテナーであり、アクセスできるユーザーを制御できます。 プロジェクトまたは組織のフィードを作成するには、次の手順に従います。
Azure DevOps 組織にサインインし、プロジェクトに移動します。
[成果物 ]を選択し、次に[フィードの作成 ]を選択します。
フィードの 名前 を入力します。
[ 表示] オプションを選択して、パッケージを表示できるユーザーを制御します。
フィードで nuget.org やnpmjs.com などのパブリック ソースからパッケージをプルする場合は、[一般的なパブリック ソースのパッケージを含める] を選択します。
[スコープ] で、フィードをプロジェクトのみに適用するか、組織全体に適用するかを選択します。
完了したら [作成] を選択します。
ユニバーサル パッケージの発行
フィードを作成したら、ユニバーサル パッケージを発行する準備ができました。 発行するすべてのパッケージには名前とバージョン番号が必要であり、両方とも特定の名前付け規則に従う必要があります。
- パッケージ名は、小文字、先頭、末尾に文字または数字を使用する必要があり、文字、数字、連続しないダッシュ (
-)、アンダースコア (_)、またはピリオド (.) のみを含めることができます。 - パッケージのバージョンも小文字にする必要があり、
+サフィックスで示されるビルド メタデータを含めることはできません。 詳細については、「 セマンティック バージョン管理」を参照してください。
フィードのスコープがプロジェクトか組織かに応じて、次のいずれかのコマンドを実行してユニバーサル パッケージを発行します。
プロジェクト スコープのフィード:
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 アーカイブにバンドルして、ファイル数を減らします。
発行済みパッケージを表示する
パッケージを発行したら、フィードで使用できることを確認できます。
Azure DevOps 組織にサインインしてから、プロジェクトに移動します。
[Artifacts] を選択し、ドロップダウン メニューからフィードを選択します。 発行が正常に完了した場合は、フィードでパッケージを使用できる必要があります。