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

   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

次のステップ

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