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 に代わって動作するサービス アカウントをcreateまたは選択します。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 ファイルのパスで置き換えます。

パブリック レポジトリ

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

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

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

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

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

   以下を置き換えます。

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

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

   # 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.pkg.dev/projects/PROJECT/REPOSITORY
   enabled=1
   repo_gpgcheck=0
   gpgcheck=0
   EOL
   
   # Update Yum:
   sudo yum makecache
   

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

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

   sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
   [my-repo]
   name=My Repository
   baseurl=https://us-central1-yum.pkg.dev/projects/my-project/my-repo
   enabled=1
   repo_gpgcheck=0
   gpgcheck=0
   EOL
   

   注: repo_gpgcheck を使用した Yum リポジトリ レベルの GPG 検証は、Artifact Registry リポジトリではサポートされていません。Artifact Registry リポジトリは HTTPS を介して（SSL 証明書を使用して）提供され、HTTPS を介した提供は信頼性が高いと見なされます。

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

   sudo yum makecache
   

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

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

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

プレビュー

このプロダクトまたは機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 一般提供前のプロダクトと機能は「現状のまま」ご利用いただけますが、サポートが制限される場合があります。 詳しくは、リリース ステージの説明をご覧ください。

標準のアップストリーム Yum リポジトリの代わりにリモート Yum リポジトリのみを使用するように VM を構成するには、VM のリポジトリ リストの標準リポジトリをリモート リポジトリに置き換えます。

標準のリポジトリが個別のリポジトリ ファイル（.repo）ではなく構成ファイルで定義されている場合は、構成ファイル内のエントリを削除してリモートに置き換えるか、新しいリポジトリ ファイルを /etc/yum.repos.d/ ディレクトリに定義できます。

警告: Yum の構成ファイルでリポジトリの並べ替えか削除を行うと、深刻な結果が生じる可能性があります。標準リポジトリを削除すべきかどうかがわからない場合は、リモートの Yum リポジトリをバックアップとして使用するように Yum を構成できます。

1. [VM インスタンス] ページに移動します。

2. VM がある行で [SSH] をクリックします。VM のターミナル セッションで新しいウィンドウが開きます。

3. VM の /etc/yum.repos.d/ フォルダを開き、標準のアップストリーム リポジトリを含む適切なリポジトリ ファイル（.repo）を見つけます。これはベース リポジトリと呼ばれることもあります。ベース リポジトリは、Yum リポジトリ名に [base] または [baseos] が含まれていることで識別できます。

4. ベース リポジトリを完全に置き換えるには、[base] 以下のデフォルト設定を削除します。

5. [base] の下に以下を追加します。

   [base]
   name=YUM_REPOSITORY_NAME
   baseurl=https://LOCATION-yum.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME
   enabled=1
   gpgcheck=1
   

   以下を置き換えます。

• YUM_REPOSITORY_NAME は、リモートの Yum リポジトリの 1 語の一意のリポジトリ ID に置き換えます。この名前は、構成を削除した場合はアップストリーム リポジトリ名と一致させることができ、リモート リポジトリとして識別する別の名前を指定することもできます。
• REPOSITORY_NAME は、人が読めるリポジトリ名に置き換えます。
  • LOCATION は、リモート リポジトリのリージョンまたはマルチリージョンのロケーションに置き換えます。
• PROJECT_ID は、VM のプロジェクト ID に置き換えます。
• REMOTE_REPOSITORY_NAME は、リモート リポジトリに付けた名前に置き換えます。

注: repo_gpgcheck を使用した Yum リポジトリ レベルの GPG 検証は、Artifact Registry リポジトリではサポートされていません。Artifact Registry リポジトリは HTTPS を介して（SSL 証明書を使用して）提供され、HTTPS を介した提供は信頼性が高いと見なされます。

リモート Yum リポジトリをバックアップとして使用する

プレビュー

このプロダクトまたは機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 一般提供前のプロダクトと機能は「現状のまま」ご利用いただけますが、サポートが制限される場合があります。 詳しくは、リリース ステージの説明をご覧ください。

標準アップストリームを第一の選択肢として保持し、リモート リポジトリをいざというときの代替案として追加する場合は、標準アップストリームをリポジトリ ファイルに保持し、新しいリポジトリ ファイルを /etc/yum.repos.d フォルダに作成できます。

フォルダに新しい /etc/yum.repos.d ファイルを作成するには、次のコマンドを実行します。

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
[YUM_REPOSITORY_NAME]
name=REPOSITORY_NAME
baseurl=https://LOCATION-yum.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME
enabled=1
gpgcheck=1
EOF

以下を置き換えます。

• YUM_REPOSITORY_NAME は、リモートの Yum リポジトリの 1 語の一意のリポジトリ ID に置き換えます。
• REPOSITORY_NAME は、人が読めるリポジトリ名に置き換えます。
  • LOCATION は、リモート リポジトリのリージョンまたはマルチリージョンのロケーションに置き換えます。
• PROJECT_ID は、VM のプロジェクト ID に置き換えます。
• REMOTE_REPOSITORY_NAME は、リモート リポジトリに付けた名前に置き換えます。

たとえば、次のコマンドは、Yum がリポジトリ my-repo をインストールする際に、プロジェクト my-project とロケーション us-east1 でリポジトリ my-repo をフェッチするように VM を構成します。

注: YUM_REPOSITORY_NAME と Artifact Registry の REMOTE_REPOSITORY_NAME は異なっていてもかまいませんが、YUM_REPOSITORY_NAME は Error Reporting で使用されるため、リポジトリ名と同じにしておくと便利です。

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
[my-repo]
name=My Repository
baseurl=https://us-east1-yum.pkg.dev/remote/my-project/my-repo
enabled=1
gpgcheck=1
EOF

次のステップ

• パッケージの管理について確認する