This page describes adding, viewing, and deleting RPM packages in Yum repositories. Artifact Registry Yum repositories support Yum and DNF.
Before you begin
- If the target Yum repository doesn't exist, create a new repository.
- Configure VMs to access the repository.
- (Optional) Configure defaults for gcloud commands.
- Ensure your package names in metadata meet the Fedora package naming guidelines and the Fedora package versioning guidelines.
Adding packages
Repository modes: standard
You must have both read and write permissions for the repository to add packages.
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.
Very long import or upload operations might exceed the expiry period for the token that gcloud CLI uses to call the API. If you have a very large number of packages to add, consider adding them in smaller batches so that each upload or import operation can complete in a shorter amount of time. See OS packages troubleshooting documentation for more information.
Direct upload
Use the
gcloud artifacts yum upload
command
to upload a package to an Yum repository:
gcloud artifacts yum upload REPOSITORY \
--location=LOCATION \
--source=PACKAGES
Replace the following values:
- REPOSITORY is the Artifact Registry repository name.
- LOCATION is the regional or multi-regional location of the repository.
- PACKAGES is the path to the package.
For example, to upload the package my-package.rpm
to the Yum repository
my-repo
in the location us-central1
, run:
gcloud artifacts yum upload my-repo \ --location=us-central1 \ --source=my-package.rpm
Cloud Storage
Upload the packages to Cloud Storage in one of the following ways:
- Upload packages directly to a Cloud Storage bucket
- Build packages with Cloud Build and store it in a bucket
Run the following command:
gcloud artifacts yum import REPOSITORY \ --location=LOCATION \ --gcs-source=PACKAGES
Replace the following values:
- REPOSITORY is the Artifact Registry repository name.
- LOCATION is the regional or multi-regional location of the repository.
- PACKAGES is a comma separated list of packages in
Cloud Storage. To upload all packages from a directory, use a
directory wildcard (
*
) or use a recursive directory wildcard (**) to upload all packages in all subdirectories.
For example, to upload a the package
package.rpm
and all packages in thedirectory
directory from the bucketmy-bucket
to the Yum repositorymy-repo
in the locationus-central1
, run:gcloud artifacts yum import my-repo \ --location=us-central1 \ --gcs-source=gs://my-bucket/path/to/package.rpm,gs://my-bucket/directory*
When the upload or import operation is complete, you can use the Google Cloud console or gcloud CLI to view packages in the repository and confirm that they were uploaded successfully.
If you have a large repository with a lot of packages, it might take several minutes to regenerate the package index so that the new packages are visible to the Yum client.
Viewing packages
Repository modes: standard, remote (preview)
To view packages, you must have the permissions in the Artifact Registry Reader role. Artifact Registry does not list files inside packages.
To view packages and package versions using the Google Cloud console
or gcloud
:
Console
Open the Repositories page in the Google Cloud console.
In the repository list, click the appropriate repository.
The Packages page lists the packages in the repository.
Click a package to view versions of the package.
gcloud
To list packages in a repository, run the following command:
gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]
Where
- REPOSITORY is the name of the repository. If you configured a default repository, you can omit this flag to use the default.
- LOCATION is a regional or multi-regional location. Use this flag to view repositories in a specific location. If you configured a default location, you can omit this flag to use the default.
To view versions of a package, run the following command:
gcloud artifacts versions list --package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION]
Where
- PACKAGE is the ID of the package or fully qualified identifier for the package.
- REPOSITORY is the name of the repository. If you configured a default repository, you can omit this flag to use the default.
- LOCATION is a regional or multi-regional location. Use this flag to view repositories in a specific location. If you configured a default location, you can omit this flag to use the default.
Installing packages
Repository modes: standard, remote (preview)
Before you install packages, verify that you have configured the package manager and repository correctly.
To install packages:
Install the package, specifying the name of the repository configured in Yum.
sudo yum --enablerepo=REPOSITORY install PACKAGE
Replace the following values:
- PACKAGE is the package name
- REPOSITORY is the name of the repository configured in
the
.repo
file.
For example, to install the package my-package
from the repository
my-repo
, run the command:
sudo yum --enablerepo=my-repo install my-package
Deleting packages
Repository modes: standard
Before you delete a package or package version, verify that any you have communicated or addressed any important dependencies on it.
To delete a package:
Console
Open the Repositories page in the Google Cloud console.
In the repository list, click the appropriate repository.
The Packages page lists the packages in the repository.
Select the package that you want to delete.
Click DELETE.
In the confirmation dialog box, click DELETE.
gcloud
Run the following command:
gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]
Where
- PACKAGE is the name of the package in the repository.
- REPOSITORY is the name of the repository. If you configured a default repository, you can omit this flag to use the default.
- LOCATION is a regional or multi-regional location. Use this flag to view repositories in a specific location. If you configured a default location, you can omit this flag to use the default.
--async
Return immediately, without waiting for the operation in progress to complete.
To delete versions of a package:
Console
Open the Repositories page in the Google Cloud console.
In the repository list, click the appropriate repository.
The Packages page lists the packages in the repository.
Click a package to view versions of that package.
Select versions that you want to delete.
Click DELETE.
In the confirmation dialog box, click DELETE.
gcloud
Run the following command:
gcloud artifacts versions delete VERSION \
--package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] \
[--async]
Where
- PACKAGE is the name of the package in the repository.
- REPOSITORY is the name of the repository. If you configured a default repository, you can omit this flag to use the default.
- LOCATION is a regional or multi-regional location. Use this flag to view repositories in a specific location. If you configured a default location, you can omit this flag to use the default.
--async
returns immediately, without waiting for the operation in progress to complete.
For large repositories, it can take a few minutes to regenerate the Yum package index to reflect deletions.