Apt パッケージを Artifact Registry に保存する

Apt パッケージを Artifact Registry に保存する

このクイックスタートでは、プライベート Artifact Registry Apt リポジトリを設定し、リポジトリに Debian パッケージを追加して、Debian ベースのオペレーティング システムを実行している Compute Engine VM にパッケージをインストールする方法を説明します。

このクイックスタートの手順は、Cloud Shell とこのクイックスタートで作成した VM のシェルを使用して行います。

Debian パッケージの管理の詳細については、Debian パッケージの操作をご覧ください。

始める前に

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Artifact Registry API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Artifact Registry API.

   Enable the API

Cloud Shell を起動する

Cloud Shell には、Google Cloud CLI がプリインストールされています。gcloud CLI は、Google Cloud への主要なコマンドライン インターフェースを提供します。

Cloud Shell を起動します。

1. Google Cloud Console に移動します。

   Google Cloud Console

2. Google Cloud コンソールのツールバーで、「Cloud Shell をアクティブにする」をクリックします:

コンソールの下部にあるフレーム内で Cloud Shell セッションが開きます。このシェルで gcloud コマンドを実行して、VM とリポジトリを作成します。

リポジトリを作成する

アーティファクトのリポジトリを作成します。

1. リポジトリを作成します。

   コンソール

   1. Google Cloud コンソールで [リポジトリ] ページを開きます。

      [リポジトリ] ページを開く

   2. [リポジトリを作成] をクリックします。

   3. リポジトリ名として quickstart-apt-repo を指定します。

   4. 形式として [Apt] を選択します。

   5. [ロケーション タイプ] で、[リージョン] を選択し、ロケーション us-central1 を選択します。

   6. [作成] をクリックします。

   このリポジトリがリポジトリ リストに追加されます。

   gcloud

   1. Cloud Shell で次のコマンドを実行して、ロケーション us-central1 の現在のプロジェクト quickstart-apt-repo に新しい Apt リポジトリを作成します。

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

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

      gcloud artifacts repositories list
      

これで、リポジトリにパッケージを追加できるようになりました。

パッケージをリポジトリに追加する

Google Cloud CLI を使用してパッケージをリポジトリにアップロードすることも、Cloud Storage に保存されているパッケージをインポートすることもできます。Cloud Build を使用してパッケージをビルドする場合、このビルドは Cloud Storage にパッケージを保存してインポートできます。

このクイックスタートでは、gcloud artifacts apt upload コマンドを使用してサンプル ファイルをアップロードします。

1. Cloud Shell で、次のコマンドを使用して Apt クイック リファレンス シートをダウンロードします。

   apt download apt-dpkg-ref
   

   Apt は、構成した Apt リポジトリから入手可能な最新バージョンのパッケージをダウンロードします。

   Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
   Fetched 113 kB in 0s (428 kB/s)
   

   ls を実行して、APT クイック リファレンス シートのファイル名を取得します。ファイル名は apt-dpkg-ref_5.3.1+nmu2_all.deb のようになります。

2. gcloud コマンドを簡素化するには、デフォルトのリポジトリを quickstart-apt-repo に、デフォルトのロケーションを us-central1 に設定します。値を設定した後は、リポジトリまたはロケーションを必要とする gcloud コマンドでそれらを指定する必要はありません。

   リポジトリを設定するには、次のコマンドを実行します。

   gcloud config set artifacts/repository quickstart-apt-repo
   

   ロケーションを設定するには、次のコマンドを実行します。

   gcloud config set artifacts/location us-central1
   

   これらのコマンドの詳細については、gcloud config set のドキュメントをご覧ください。

3. gcloud artifacts apt upload を実行して、パッケージをリポジトリにアップロードします。

   gcloud artifacts apt upload quickstart-apt-repo \
       --source=FILE_NAME
   

   FILE_NAME は、APT クイック リファレンス シートのパスに置き換えます。

リポジトリ内のパッケージを表示する

パッケージがリポジトリに追加されたことを確認します。

コンソール

1. Google Cloud コンソールで [リポジトリ] ページを開きます。

   [リポジトリ] ページを開く

2. リポジトリ リストで、quickstart-apt-repo リポジトリをクリックします。

   [パッケージ] ページに、リポジトリ内のパッケージが一覧表示されます。

gcloud

quickstart-apt-repo リポジトリ内のパッケージを一覧表示するには、次のコマンドを実行します。

 gcloud artifacts packages list

パッケージのバージョンを quickstart-apt-repo に表示するには、次のコマンドを実行します。

gcloud artifacts versions list --package=apt-dpkg-ref

VM を作成する

サンプル パッケージをインストールする新しい Compute Engine VM を作成します。

Cloud Shell で次のコマンドを実行して、quickstart-apt-vm という名前の VM インスタンスを作成します。

gcloud compute instances create quickstart-apt-vm \
    --image-family=debian-10 \
    --image-project=debian-cloud \
    --scopes=cloud-platform

デフォルトでは、VM にはリポジトリの操作に必要なアクセス スコープがありません。--scopes フラグによって、VM のアクセス スコープが cloud-platform に設定されます。

パッケージ マネージャーを構成する

VM にパッケージをインストールするには、作成したリポジトリをパッケージ リポジトリを定義する Apt 構成ファイルに追加します。

注: このクイックスタートで作成した VM では、Google が構築した Debian OS イメージを使用します。これには、Artifact Registry リポジトリにアクセスするためのいくつかの設定があらかじめ構成されています。Google が構築した Ubuntu イメージを使用する Compute Engine VM、Google が構築していない OS イメージを使用する VM、または Google Cloud 外部の VM を構成する場合、追加の構成手順があります。詳細については、VM 構成の手順をご覧ください。

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

   [VM インスタンス] ページを開く

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

3. gcloud init を実行して、VM で Google Cloud CLI を初期化します。

4. Apt を更新するには:

   sudo apt update
   

5. VM に Apt 認証ヘルパーをインストールして、Apt が認証を実行できるようにします。

   sudo apt install apt-transport-artifact-registry
   

6. 次のコマンドを使用して、Artifact Registry パッケージにアクセスするように VM を構成します。

   echo 'deb ar+https://us-central1-apt.pkg.dev/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list
   

   PROJECT は、実際の Google Cloud プロジェクト ID に置き換えます。

パッケージをインストールする

リポジトリに追加したパッケージをインストールします。

1. 使用可能なパッケージのリストを更新するには:

   sudo apt update
   

2. リポジトリにパッケージをインストールします。

   sudo apt install apt-dpkg-ref/quickstart-apt-repo
   

   返されたインストール情報は次の例のようになります。

   Reading package lists... Done
   Building dependency tree
   Reading state information... Done
   Selected version '5.3.1+nmu2' (Debian:10.7/stable, namespaces/my-repo/repositories/quickstart-apt-repo:quickstart
   -apt-repo [all]) for 'apt-dpkg-ref'
   The following NEW packages will be installed:
     apt-dpkg-ref
   0 upgraded, 1 newly installed, 0 to remove and 3 not upgraded.
   Need to get 113 kB of archives.
   After this operation, 128 kB of additional disk space will be used.
   Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
   Fetched 113 kB in 0s (693 kB/s)
   Selecting previously unselected package apt-dpkg-ref.
   (Reading database ... 39506 files and directories currently installed.)
   Preparing to unpack .../apt-dpkg-ref_5.3.1+nmu2_all.deb ...
   Unpacking apt-dpkg-ref (5.3.1+nmu2) ...
   Setting up apt-dpkg-ref (5.3.1+nmu2) ...
   

クリーンアップ

このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を行います。

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

リポジトリを削除するには、次の手順を行います。

コンソール

1. Google Cloud コンソールで [リポジトリ] ページを開きます。

   [リポジトリ] ページを開く

2. リポジトリ リストで、quickstart-apt-repo リポジトリを選択します。

3. [削除] をクリックします。

gcloud

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

   gcloud artifacts repositories delete quickstart-apt-repo
   

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

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

作成した VM を削除するには、次のコマンドを実行します。

gcloud compute instances delete quickstart-apt-vm

次のステップ

• Deb パッケージの操作について学習する。
• DevOps に関するリソースを読む。また、研究プログラムについて確認する。