本页面介绍了如何配置虚拟机,以从 Artifact Registry Apt 代码库安装 Debian 软件包。
准备工作
如果目标 Apt 代码库不存在,请创建新的标准或远程代码库。您可以创建私有代码库或不需要身份验证的公共代码库。
准备虚拟机以访问 Apt 代码库
私有代码库
选择您将用于授予访问权限的服务帐号。
向您的服务帐号授予代码库访问权限。
准备虚拟机以访问代码库。
Compute Engine 虚拟机
Debian 虚拟机
为虚拟机分配
cloud-platform
API 访问权限范围。如需了解如何设置访问权限范围,请参阅更改实例的服务帐号和访问权限范围。使用以下命令更新 Apt:
sudo apt update
在虚拟机上安装
apt-transport-artifact-registry
软件包:sudo apt install apt-transport-artifact-registry
Ubuntu 虚拟机
使用以下命令安装 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
替换为代码库的位置。为虚拟机分配
cloud-platform
API 访问权限范围。如需了解如何设置访问权限范围,请参阅更改实例的服务帐号和访问权限范围。使用以下命令配置虚拟机以访问 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
使用以下命令更新 Apt:
sudo apt update
在虚拟机上安装
apt-transport-artifact-registry
软件包:sudo apt install apt-transport-artifact-registry
其他虚拟机
使用以下命令安装 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
替换为代码库的位置。使用以下命令配置虚拟机以访问 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
使用以下命令更新 Apt:
sudo apt update
在虚拟机上安装
apt-transport-artifact-registry
软件包:sudo apt install apt-transport-artifact-registry
在
/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 文件的路径。
公共存储库
如果您要在 Google Cloud 之外配置虚拟机,请准备好机器以访问代码库。如果您要配置 Compute Engine 虚拟机,请继续执行下一步。
使用以下命令安装公钥验证密钥:
curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add -
将
LOCATION
替换为代码库的位置。使用以下命令更新 Apt:
sudo apt update
配置虚拟机以访问标准 Apt 代码库
配置虚拟机以访问 Apt 代码库:
运行
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
将 Apt 配置为使用
print-settings
命令的输出中的echo
命令从代码库中提取软件包。例如,如需在项目
my-project
和位置us-central1
中从公共代码库my-repo
安装软件包,请使用以下命令:echo 'deb ar+https://us-central1-apt.pkg.dev/projects/my-project my-repo main'
使用以下命令更新代码库源代码:
sudo apt update
Apt 现在可以连接到代码库。
如果您创建了其他 Apt 代码库,则可以将其添加到 artifact-registry.list
文件中,然后重新运行 sudo apt update
以更新代码库来源。
配置虚拟机以访问远程 Apt 代码库
如需将虚拟机配置为仅使用远程 Apt 代码库而不是标准的上游 Apt 代码库,请在虚拟机的 /etc/apt/sources.list
文件中将标准代码库替换为您的远程代码库。
向默认 Compute Engine 服务帐号授予项目级 Artifact Registry 写入权限:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \ --role=roles/artifactregistry.writer
在您的虚拟机所在的行中,点击 SSH。
系统会打开一个包含虚拟机上的终端会话的新窗口。
打开虚拟机的
/etc/apt/sources.list
文件,并找到要替换为新远程代码库的标准代码库。删除标准代码库行,并将其替换为以下代码:
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
。
例如,以下代码将虚拟机配置为从位置
us-east1
的项目my-project
的代码库my-repo
中提取软件包,并使用buster
作为组件main
、contrib
和non-free
的上游代码库。deb ar+https://us-east1-apt.pkg.dev/remote/my-project/my-repo buster main contrib non-free
- 将
使用以下命令更新代码库源代码:
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 发送到可公开读取的代码库的请求将被拒绝。
如需将 Apt 配置为使用 HTTP 从代码库中提取软件包,请运行以下命令:
echo 'deb http://LOCATION-apt.pkg.dev/projects/PROJECT_ID REPOSITORY main' >> /etc/apt/sources.list.d/artifact-registry.list
替换以下内容:
- 将 LOCATION 替换为代码库的位置。
- 将 PROJECT_ID 替换为代码库的项目 ID。
- 将 REPOSITORY 替换为代码库名称。
例如,如需使用 HTTP 在项目
my-project
和位置us-central1
中从公共代码库my-repo
安装软件包,请使用以下命令:echo 'deb http://us-central1-apt.pkg.dev/projects/my-project my-repo main' >> /etc/apt/sources.list.d/artifact-registry.list
使用以下命令更新代码库源代码:
sudo apt update
Apt 现在可以连接到代码库。
如果您创建了其他 Apt 代码库,则可以将其添加到 artifact-registry.list
文件中,然后重新运行 sudo apt update
以更新代码库来源。