配置虚拟机以安装 Debian 软件包

本页介绍了如何配置虚拟机以从 Artifact Registry Apt 代码库安装 Debian 软件包。

准备工作

如果目标 Apt 代码库不存在，请创建标准或远程代码库。您可以创建私有代码库，也可以创建无需身份验证的公共代码库。

准备虚拟机以访问 Apt 代码库

私有仓库

  1. 选择您将用于授予访问权限的服务账号。

    • 对于 Compute Engine 虚拟机，这可能是默认服务账号。Artifact Registry 会自动为使用服务账号的任何虚拟机检索 Compute Engine 虚拟机服务账号凭据。
    • 对于其他虚拟机，请创建或选择一个服务账号来代表虚拟机执行操作。您需要服务账号密钥文件所在的位置，才能配置虚拟机。您可以在服务账号页面上查看现有账号的密钥并为其创建密钥。

  2. 向您的服务账号授予代码库访问权限。

  3. 准备虚拟机以访问代码库。

    Compute Engine 虚拟机

    Debian VM

    1. 向虚拟机分配 cloud-platform API 访问权限范围。如需了解如何设置访问权限范围，请参阅更改实例的服务账号和访问权限范围。

    2. 使用以下命令更新 Apt：

      sudo apt update

    3. 在虚拟机上安装 apt-transport-artifact-registry 软件包：

      sudo apt install apt-transport-artifact-registry

    Ubuntu VM

    1. 使用以下命令安装 Apt 代码库签名密钥：

      curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add - && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

      将 LOCATION 替换为代码库的单区域或多区域位置。

    2. 向虚拟机分配 cloud-platform API 访问权限范围。如需了解如何设置访问权限范围，请参阅更改实例的服务账号和访问权限范围。

    3. 使用以下命令将虚拟机配置为访问 Artifact Registry 软件包：

      echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list

    4. 使用以下命令更新 Apt：

      sudo apt update

    5. 在虚拟机上安装 apt-transport-artifact-registry 软件包：

      sudo apt install apt-transport-artifact-registry

    其他虚拟机

    1. 使用以下命令安装 Apt 代码库签名密钥：

      curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add - && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

      将 LOCATION 替换为代码库的单区域或多区域位置。

    2. 使用以下命令将虚拟机配置为访问 Artifact Registry 软件包：

      echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list

    3. 使用以下命令更新 Apt：

      sudo apt update

    4. 在虚拟机上安装 apt-transport-artifact-registry 软件包：

      sudo apt install apt-transport-artifact-registry

    5. 在 /etc/apt/apt.conf.d/90artifact-registry 文件中找到 #Service-Account-JSON "/path/to/creds.json"; 行，然后取消注释该行并添加服务账号密钥的路径。

      配置文件条目：

      Service-Account-JSON  "PATH_TO_SERVICE_ACCOUNT_KEY";

      将 PATH_TO_SERVICE_ACCOUNT_KEY 替换为服务账号密钥 JSON 文件的路径。

公共代码库

  1. 配置对代码库的公共访问权限。

  2. 如果您是在 Google Cloud之外配置虚拟机，请准备好您的机器以访问代码库。如果您要配置 Compute Engine 虚拟机，请继续执行下一步。

    使用以下命令安装公共签名验证密钥：

    curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add -

    将 LOCATION 替换为代码库的单区域或多区域位置。

  3. 使用以下命令更新 Apt：

    sudo apt update

配置虚拟机以访问标准 Apt 代码库

配置虚拟机以访问 Apt 仓库：

  1. 运行 gcloud beta artifacts print-settings apt 命令生成虚拟机配置命令：

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

    替换以下内容：

    • LOCATION 是代码库的单区域或多区域位置。
    • REPOSITORY 是 Artifact Registry 制品库的名称。

    输出类似于以下内容：

    # To configure your package manager with this repository:

# Update Apt:
sudo apt update

# Install the Apt credential helper:
sudo apt install apt-transport-artifact-registry

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

echo "deb ar+https://LOCATION-apt.pkg.dev/projects/PROJECT REPOSITORY main" | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list

# Update Apt:
sudo apt update

  2. 配置 Apt 以使用 print-settings 命令输出中的 echo 命令从代码库提取软件包。

    例如，如需在项目 my-project 的 us-west1 位置从公共代码库 my-repo 安装软件包，请使用以下命令：

    echo 'deb ar+https://us-west1-apt.pkg.dev/projects/my-project my-repo main'

  3. 使用以下命令更新代码库源：

    sudo apt update

Apt 现在可以连接到代码库。

如果您创建了其他 Apt 代码库，可以将其添加到 artifact-registry.list 文件中，然后重新运行 sudo apt update 以更新代码库源。

配置虚拟机以访问远程 Apt 代码库

如需将虚拟机配置为仅使用远程 Apt 代码库（而非标准上游 Apt 代码库），请在虚拟机的 /etc/apt/sources.list 文件中将标准代码库替换为远程代码库。

  1. 向默认的 Compute Engine 服务账号授予对项目级 Artifact Registry 的写入权限：

     gcloud projects add-iam-policy-binding PROJECT_ID \
   --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
   --role=roles/artifactregistry.writer

  2. 转到“虚拟机实例”页面。

  3. 在虚拟机所在的行中，点击 SSH。

    系统会打开一个新窗口，其中包含虚拟机上的终端会话。

  4. 打开虚拟机的 /etc/apt/sources.list 文件，然后找到要替换为新远程代码库的标准代码库。

  5. 删除标准代码库行，并将其替换为以下内容：

    deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS

    替换以下内容：

    • LOCATION 替换为远程代码库的单区域或多区域位置。
    • 将 PROJECT_ID 替换为虚拟机的项目 ID。
    • 将 REMOTE_REPOSITORY_NAME 替换为您为远程仓库指定的名称。
    • 将 UPSTREAM_REPOSITORY_NAME 替换为远程设备的上游仓库的名称。
    • 将 COMPONENTS 替换为组件名称的空格分隔列表。

    例如，以下代码会将虚拟机配置为使用 buster 作为组件 main、contrib 和 non-free 的上游代码库，从位置 us-east1 的项目 my-project 中的代码库 my-repo 提取软件包。

    deb ar+https://us-east1-apt.pkg.dev/remote/my-project/my-repo buster main contrib non-free

  6. 使用以下命令更新代码库源：

    sudo apt update

    Apt 现在可以连接到代码库。

将远程 Apt 代码库用作备用

如果您想将标准上游保留为首选项，并将远程代码库添加为后备选项，则可以在 sources.list 文件中保留标准上游，并将远程代码库附加到 sources.list 文件的末尾，或在 sources.list.d 文件夹中创建新列表。

如需在 sources.list.d 文件夹中创建新的 artifact-registry.list 文件，请运行以下命令：

echo 'deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list

替换以下内容：

  • LOCATION 是代码库的单区域或多区域位置。
  • 将 PROJECT_ID 替换为虚拟机的项目 ID。
  • 将 REMOTE_REPOSITORY_NAME 替换为您为远程仓库指定的名称。
  • 将 UPSTREAM_REPOSITORY_NAME 替换为远程的源代码库的名称。
  • 将 COMPONENTS 替换为组件名称的空格分隔列表。

如果您创建了其他 Apt 代码库，可以将其添加到 artifact-registry.list 或 sources.list 文件中，然后重新运行 sudo apt update 以更新代码库源。

配置对 Apt 代码库的 HTTP 访问权限

如果您使用的是不支持 SSL 加密的旧版客户端工具，则可以配置对 Apt 仓库的公开访问权限，并通过 HTTP 访问该仓库。如果请求中包含身份验证令牌，系统会拒绝发送到可公开读取的代码库的 HTTP 请求。

  1. 配置对代码库的公共访问权限。

  2. 如需配置 Apt 以使用 HTTP 从代码库提取软件包，请运行以下命令：

     echo 'deb http://LOCATION-apt.pkg.dev/projects/PROJECT_ID \
 REPOSITORY main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list

    替换以下内容：

    • LOCATION 是代码库的单区域或多区域位置。
    • PROJECT_ID 是代码库的项目 ID。
    • REPOSITORY 是代码库名称。

    例如，如需使用 HTTP 从项目 my-project 中的公共代码库 my-repo 和位置 us-west1 安装软件包，请使用以下命令：

    echo 'deb http://us-west1-apt.pkg.dev/projects/my-project my-repo main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list

  3. 使用以下命令更新代码库源：

    sudo apt update

Apt 现在可以连接到代码库。

如果您创建了其他 Apt 代码库，可以将其添加到 artifact-registry.list 文件中，然后重新运行 sudo apt update 以更新代码库源。

后续步骤