RPM パッケージをインストールするように VM を構成する

このページでは、Artifact Registry Yum リポジトリから RPM パッケージをインストールするように VM を構成することを説明します。Artifact Registry Yum リポジトリは、yum クライアントと dnf クライアントをサポートしています。

準備

ターゲット Yum リポジトリが存在しない場合は、新しいリポジトリを作成します。非公開リポジトリ、または認証を必要としない公開リポジトリを作成できます。

Yum リポジトリにアクセスする VM を準備する

Yum リポジトリにアクセスする VM を準備するには、yum と dnf のいずれかのクライアント ツールを使用します。

非公開リポジトリ

  1. アクセス権の付与に使用するサービス アカウントを選択します。

    • Compute Engine VM の場合、これはデフォルトのサービス アカウントである場合があります。Artifact Registry は、サービス アカウントを使用する VM の Compute Engine VM サービス アカウント認証情報を自動的に取得します。
    • その他の VM の場合は、VM に代わって動作するサービス アカウントを作成または選択します。VM を構成するには、サービス アカウント キー ファイルのロケーションが必要です。既存のアカウントの鍵は、[サービス アカウント] ページで表示、作成できます。

  2. サービス アカウントにリポジトリへのアクセス権限を付与します。

  3. VM がリポジトリにアクセスできるように準備します。

    Compute Engine VM

    1. VM に cloud-platform API アクセス スコープを割り当てます。アクセス スコープの設定については、インスタンスのサービス アカウントとアクセス スコープを変更するをご覧ください。

    2. 次のコマンドを使用してパッケージ キャッシュを更新します。

      sudo yum makecache

    3. 次のコマンドを使用して、VM に Artifact Registry プラグインをインストールします。

      sudo yum install FORMAT-plugin-artifact-registry

      以下を置き換えます。

      • FORMAT は、次のいずれかに置き換えます。
        • yum（オペレーティング システムが Enterprise Linux 7 以降の場合）
        • dnf（オペレーティング システムが Enterprise Linux 8 以降の場合）

    その他の VM

    1. 次のコマンドを使用して RPM 署名鍵をインストールします。

      sudo rpm --import https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg

    2. 次の内容のファイルを /etc/yum.repos.d/artifact-registry-plugin.repo という名前で作成します。

      [ar-plugin]
name=Artifact Registry Plugin
baseurl=https://packages.cloud.google.com/yum/repos/FORMAT-plugin-artifact-registry-DISTRO-stable
enabled=1
gpgcheck=1

      以下を置き換えます。

      • FORMAT は、次のいずれかに置き換えます。
        • yum（オペレーティング システムが Enterprise Linux 7 以降の場合）
        • dnf（オペレーティング システムが Enterprise Linux 8 以降の場合）
      • DISTRO は、elX 形式の Red Hat Enterprise Linux メジャー リリースで、X は、リリース バージョンです。有効な DISTRO 値の例は el7 および el8 です。

    3. 次のコマンドを使用して Yum を更新します。

      sudo yum makecache

    4. 次のコマンドを使用して、VM に Artifact Registry プラグインをインストールします。

      yum install FORMAT-plugin-artifact-registry

      FORMAT を次のいずれかに置き換えます。

      • yum（オペレーティング システムが Enterprise Linux 7 以降の場合）
      • dnf（オペレーティング システムが Enterprise Linux 8 以降の場合）

    5. artifact-registry.conf ファイルの中の #service_account_json = "/path/to/creds.json" 行を見つけて、その行をコメント化解除し、サービス アカウント キーのパスを追加します。

      • Enterprise Linux 7 以前のオペレーティング システムの場合、構成ファイルのパスは /etc/yum/pluginconf.d/artifact-registry.conf です。
      • Enterprise Linux 8 以降のオペレーティング システムの場合、構成ファイルのパスは /etc/dnf/plugins/artifact-registry.conf です。

      構成ファイルのエントリ:

      service_account_json = "PATH_TO_SERVICE_ACCOUNT_KEY"

      PATH_TO_SERVICE_ACCOUNT_KEY は、サービス アカウント キー JSON ファイルのパスで置き換えます。

パブリック レポジトリ

リポジトリへの公開アクセスを構成します。

標準の Yum リポジトリにアクセスするように VM を構成する

Yum リポジトリにアクセスするように VM を構成するには、yum と dnf のいずれかのクライアント ツールを使用します。

  1. VM 構成コマンドを生成するには、gcloud beta artifacts print-settings yum コマンドを実行します。

    gcloud beta artifacts print-settings yum \
    --repository=REPOSITORY \
    --location=LOCATION

    以下を置き換えます。

    • REPOSITORY は、Artifact Registry リポジトリの名前です。
    • LOCATION は、リポジトリのリージョン ロケーションです。

    出力は次のようになります。

    # To configure your package manager with this repository:

# Update Yum:
sudo yum makecache

# Install the Yum credential helper:
sudo yum install yum-plugin-artifact-registry

# Configure your VM to access Artifact Registry packages using the following
# command:

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
[REPOSITORY]
name=REPOSITORY
baseurl=https://LOCATION-yum.s3nsregistry.fr/projects/PROJECT/REPOSITORY
enabled=1
repo_gpgcheck=0
gpgcheck=0
EOL

# Update Yum:
sudo yum makecache

  2. print-settings コマンドの出力から tee コマンドを使用して、リポジトリからパッケージを取得するように yum クライアント ツールを構成します。

    たとえば、プロジェクト my-project とロケーション u-france-east1 に公開 my-repo からパッケージをインストールするには、次のコマンドを使用します。

    sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
[my-repo]
name=My Repository
baseurl=https://u-france-east1-yum.s3nsregistry.fr/projects/my-project/my-repo
enabled=1
repo_gpgcheck=0
gpgcheck=0
EOL

  3. 次のコマンドを使用して、リポジトリのソースを更新します。

    sudo yum makecache

Yum はリポジトリに接続できるようになりました。

追加の Yum リポジトリを作成する場合は、/etc/yum.repos.d/ ごとに .repo ファイルを作成します。sudo yum update を再実行してリポジトリ ソースを更新します。

次のステップ