Store Apt packages in Artifact Registry
This quickstart shows you how to set up a private Artifact Registry Apt repository, add a Debian package to the repository, and install the package on a Compute Engine VM running a Debian-based operating system.
You perform steps in this quickstart using Cloud Shell and in the shell on the VM that you create in this quickstart.
To learn more about managing Debian packages, see Working with Debian packages.
Before you begin
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Artifact Registry API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Artifact Registry API.
Launch Cloud Shell
Cloud Shell comes preinstalled with the Google Cloud CLI. The gcloud CLI provides the primary command-line interface for Google Cloud.
Launch Cloud Shell:
Go to Google Cloud console.
On the Google Cloud console toolbar, click Activate Cloud Shell:
A Cloud Shell session opens inside a frame lower on the console.
You'll use this shell to run the gcloud
commands to create a VM and a
repository.
Create a repository
Create the repository for your artifacts.
Create the repository:
Console
Open the Repositories page in the Google Cloud console.
Click Create Repository.
Specify
quickstart-apt-repo
as the repository name.Select Apt as the format.
Under Location Type, select Region and then choose the location
us-central1
.Click Create.
The repository is added to the repository list.
gcloud
In Cloud Shell, run the following command to create a new Apt repository in the current project named
quickstart-apt-repo
in the locationus-central1
.gcloud artifacts repositories create quickstart-apt-repo \ --repository-format=apt \ --location=us-central1 \ --description="Apt repository"
Run the following command to verify that your repository was created:
gcloud artifacts repositories list
You can now add a package to the repository.
Add a package to the repository
You can upload a package to a repository using the Google Cloud CLI, or you can import a package that is stored in Cloud Storage. If you build packages using Cloud Build, the build can store the packages in Cloud Storage for you to import.
For this quickstart, you upload a sample file using the gcloud artifacts apt
upload
command.
In Cloud Shell, download the Apt quick reference sheet with the command:
apt download apt-dpkg-ref
Apt downloads the latest version of the package that is available from your configured Apt repositories.
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)
Run
ls
to get the filename of the Apt quick reference sheet. The filename is similar toapt-dpkg-ref_5.3.1+nmu2_all.deb
.To simplify
gcloud
commands, set the default repository toquickstart-apt-repo
and the default location tous-central1
. After the values are set, you do not need to specify them ingcloud
commands that require a repository or a location.To set the repository, run the command:
gcloud config set artifacts/repository quickstart-apt-repo
To set the location, run the command:
gcloud config set artifacts/location us-central1
For more information about these commands, see the gcloud config set documentation.
Run the
gcloud artifacts apt upload
to upload the package to the repository:gcloud artifacts apt upload quickstart-apt-repo \ --source=FILE_NAME
Replace
FILE_NAME
with the path to the Apt quick reference sheet.
View the package in the repository
Verify that your package was added to the repository.
Console
Open the Repositories page in the Google Cloud console.
In the repository list, click the quickstart-apt-repo repository.
The Packages page lists the packages in the repository.
gcloud
To list the packages in the quickstart-apt-repo
repository, run the command:
gcloud artifacts packages list
To view versions for a package in quickstart-apt-repo
, run the command:
gcloud artifacts versions list --package=apt-dpkg-ref
Create a VM
Create a new Compute Engine VM where you'll install the sample package.
In Cloud Shell, run the following command to create a VM instance
named quickstart-apt-vm
:
gcloud compute instances create quickstart-apt-vm \
--image-family=debian-10 \
--image-project=debian-cloud \
--scopes=cloud-platform
By default, the VM does not have the required access scopes for
working with the repository. The --scopes
flag sets the access scope
for the VM to cloud-platform
.
Configure the package manager
To install a package on the VM, add the repository you created to the Apt configuration file that defines package repositories.
Go to the VM instances page.
In the row with your VM, click SSH. A new window opens with a terminal session on the VM.
Run
gcloud init
to initialize the Google Cloud CLI on your VM.Update Apt:
sudo apt update
Install the Apt credential helper on the VM to enable Apt to perform authentication:
sudo apt install apt-transport-artifact-registry
Configure your VM to access Artifact Registry packages using the following command:
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
Replace PROJECT with your Google Cloud project ID.
Install the package
Install the package that you added to the repository.
Update the list of available packages:
sudo apt update
Install the package in your repository.
sudo apt install apt-dpkg-ref/quickstart-apt-repo
The returned installation information looks like the following example:
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) ...
Clean up
To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.
Before you remove the repository, ensure that any packages you want to keep are available in another location.
To delete the repository:
Console
Open the Repositories page in the Google Cloud console.
In the repository list, select the quickstart-apt-repo repository.
Click Delete.
gcloud
To delete the
quickstart-apt-repo
repository, run the following command:gcloud artifacts repositories delete quickstart-apt-repo
If you want to remove the default repository and location settings that you configured for the active
gcloud
configuration, run the following commands:gcloud config unset artifacts/repository gcloud config unset artifacts/location
To delete the VM you created, run the following command:
gcloud compute instances delete quickstart-apt-vm
What's next
- Learn about working with Deb packages.
- Read our resources about DevOps and explore our research program.