仮想リポジトリを使用して Assured OSS パッケージにアクセスする

仮想リポジトリは、単一のリポジトリを介して複数のアップストリーム リポジトリから Assured Open Source Software（Assured OSS）パッケージにアクセスできるようにする Artifact Registry リポジトリの一種です。

仮想リポジトリは無料枠でのみサポートされています。プレミアム ティアでは、Assured OSS リポジトリが自動的にプロビジョニングされます。

リポジトリ オプションの詳細については、Assured OSS リポジトリ オプションをご覧ください。

始める前に

仮想リポジトリを使用して Assured OSS パッケージにアクセスする場合は、次の操作を行います。

  • Assured OSS のお客様有効化フォームで、使用するプロジェクトの Artifact Registry サービス エージェントの詳細を指定します。Artifact Registry サービス エージェントは、 Google Cloud サービスを操作するときに Artifact Registry の代理として動作する Google マネージド サービス アカウントです。仮想リポジトリは、このサービスを使用してアップストリーム リポジトリに対する認証を行います。サービス エージェントには、Assured OSS Artifact Registry リポジトリへの読み取りアクセス権が必要です。

  • 最初の登録時にサービス エージェントのアクセスを有効にするには、Assured OSS へのアクセスを許可するサービス アカウントの 1 つとしてサービス エージェントの詳細を含めます。

  • サービス エージェントの詳細を含めずに Assured OSS アクセスをすでに有効にしている場合は、Assured OSS の有効化ウェブサイトに戻り、サービス エージェントの有効化リクエストを詳細情報とともに作成します。

  • 既存のサービス エージェントの名前を確認する、またはプロジェクトの新しいサービス エージェントを作成する手順については、Artifact Registry サービス アカウントをご覧ください。

仮想リポジトリを設定する

  1. Assured OSS Artifact Registry リポジトリが存在する同じ Google Cloud リージョンに仮想リポジトリを作成します。サービス エージェントが Assured OSS Artifact Registry リポジトリに対する読み取りアクセス権を持つプロジェクトを使用します。

  2. policies.json ファイルに次の構成を追加して、仮想リポジトリに Assured OSS Artifact Registry リポジトリへのアクセス権を付与します。

    • Java リポジトリの構成:
    {
  "id" : "AOSS Java",
  "repository" : "projects/cloud-aoss/locations/us/repositories/cloud-aoss-java",
  "priority" : 100
}
    • Python リポジトリの構成:
    {
  "id" : "AOSS Python",
  "repository" : "projects/cloud-aoss/locations/us/repositories/cloud-aoss-python",
  "priority" : 100
}
    • Go リポジトリの構成:
    {
  "id" : "AOSS Go",
  "repository" : "projects/cloud-aoss/locations/us/repositories/assuredoss-go-free",
  "priority" : 100
}

  3. 仮想リポジトリを使用して、Java、Python、Go のパッケージをダウンロードします。パッケージのダウンロード手順については、次のトピックをご覧ください。

Assured OSS で利用できないパッケージにアクセスする

Assured OSS の Artifact Registry リポジトリで使用できないパッケージにアクセスする場合は、次の操作を行います。

  • Assured OSS は、優先リポジトリとして Assured OSS、セカンダリ リポジトリとして正規公開リポジトリ（Maven Central や PyPI など）を使用して事前構成されます。この機能（プレビュー）を使用するには、単一の URL を指定します。

    • Java の場合は https://us-maven.pkg.dev/cloud-aoss/java を使用します。
    • Python の場合は https://us-python.pkg.dev/cloud-aoss/python を使用します。
    • Go の場合は、https://us-go.pkg.dev/cloud-aoss/go を使用します。

次のステップ