Artifact Registry に他の形式を保存する

Artifact Registry の汎用形式のリポジトリを設定し、YAML ファイルをアップロードする方法を学習します。

始める前に

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

  3. Google Cloud プロジェクトで課金が有効になっていることを確認します。

  4. Artifact Registry API を有効にします。

    API を有効にする

    5.

  5. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

  6. Google Cloud プロジェクトで課金が有効になっていることを確認します。

  7. Artifact Registry API を有効にします。

    API を有効にする

    8.

Cloud Shell を起動する

Google Cloud コンソールで、「Cloud Shell をアクティブにする」をクリックします。

Cloud Shell をアクティブにする

Google Cloud コンソールの下部で Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。

このクイックスタートでは、Cloud Shell を使用して gcloud コマンドを実行します。

汎用リポジトリを作成する

  1. ロケーション us-central1 に Generic repository という説明で quickstart-generic-repo という名前の汎用形式のリポジトリを作成するには、次のコマンドを実行します。

    gcloud artifacts repositories create quickstart-generic-repo \
    --repository-format=generic \
    --location=us-central1 \
    --description="Generic repository"

  2. リポジトリが作成されたことを確認するには、次のコマンドを実行します。

    gcloud artifacts repositories list

  3. gcloud コマンドを簡単にするために、以下のコマンドを実行して、デフォルトのリポジトリを quickstart-generic-repo に、デフォルトのロケーションを us-central1 に設定します。

    1. デフォルトのリポジトリを quickstart-generic-repo に設定するには、次のコマンドを実行します。

      gcloud config set artifacts/repository quickstart-generic-repo

    2. デフォルトのロケーションを us-central1 に設定するには、次のコマンドを実行します。

      gcloud config set artifacts/location us-central1

    デフォルト値を設定すると、gcloud コマンドでリポジトリまたはロケーションが必要な場合でも指定の必要はありません。

アーティファクトをリポジトリにアップロードする

  1. ホーム ディレクトリで、リポジトリにアップロードするファイルを作成します。

    echo "hello world" > hello.yaml

  2. ファイルをアーティファクトとしてリポジトリにアップロードするには、次のコマンドを実行します。

    gcloud artifacts generic upload \
    --source=hello.yaml \
    --package=my-package \
    --version=1.0.0

    ここで

    • hello.yaml は、アップロードするファイルのパスです。
    • my-package は、アップロードするパッケージです。
    • 1.0.0 は、アーティファクトのバージョンです。リポジトリ内の既存のバージョンは上書きできません。

リポジトリ内のアーティファクトを表示する

アーティファクトがリポジトリに追加されたことを確認するには、次のコマンドを実行してすべてのアーティファクトを一覧表示します。

gcloud artifacts files list

レスポンスには、ファイルの詳細情報が PACKAGE:VERSION:FILE_NAME という形式で含まれます。

次の例では、hello.yaml が FILE_NAME です。

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

汎用アーティファクトをダウンロードする

リポジトリから汎用アーティファクトをダウンロードするには、次のコマンドを実行します。

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

ここで

  • hello.yaml は、ダウンロードするファイルの名前です。
  • my-package は、ダウンロードするパッケージです。
  • 1.0.0 は、アーティファクトのバージョンです。

DESTINATION は、ダウンロードしたものを保存するローカル ファイル システムのディレクトリに置き換えます。ダウンロード先フォルダはすでに存在している必要があります。存在しない場合、コマンドは失敗します。

クリーンアップ

このチュートリアルで使用したリソースについて Google Cloud アカウントに課金されないようにするには、リソースを含むプロジェクトを削除するか、プロジェクトを維持してリポジトリを削除します。

プロジェクトの削除

    Delete a Google Cloud project:

    gcloud projects delete PROJECT_ID

リポジトリを削除する

リポジトリを削除する前に、保持する必要があるパッケージが別の場所で使用可能であることを確認してください。

  1. quickstart-generic-repo リポジトリを削除するには、次のコマンドを実行します。

    gcloud artifacts repositories delete quickstart-generic-repo

  2. アクティブな gcloud 構成のデフォルトのリポジトリとロケーション設定を削除するには、次のコマンドを実行します。

    gcloud config unset artifacts/repository
gcloud config unset artifacts/location

次のステップ