Los repositorios de Yum de Artifact Registry te permiten controlar qué versiones de paquetes RPM instalan tus máquinas virtuales (VMs). Puedes configurar instancias de Compute Engine o VMs externas para extraer paquetes de repositorios privados o públicos con los administradores de paquetes Yum o DNF.
Antes de comenzar
Si el repositorio de Yum de destino no existe, crea un repositorio nuevo. Puedes crear un repositorio privado o uno público que no requiera autenticación.
Prepara una VM para acceder a un repositorio de Yum
Para preparar una VM para acceder a un repositorio de Yum, usa la herramienta cliente yum o dnf:
Repositorio privado
Elige la cuenta de servicio que usarás para otorgar acceso.
- En el caso de las VMs de Compute Engine, esta podría ser la cuenta de servicio predeterminada. Artifact Registry recupera automáticamente las credenciales de cuenta de servicio de la VM de Compute Engine para cualquier VM que use una cuenta de servicio.
- Para otras VMs, crea o elige una cuenta de servicio que actúe en nombre de tu VM. Necesitarás la ubicación del archivo de claves de la cuenta de servicio para configurar la VM. Puedes ver y crear claves para cuentas existentes en la página Cuentas de servicio.
Otorga permisos de acceso al repositorio a tu cuenta de servicio.
Prepara la VM para acceder al repositorio.
VM de Compute Engine
Asigna permisos de acceso a la API de
cloud-platforma la VM. Para obtener información sobre cómo configurar los permisos de acceso, consulta Cambia la cuenta de servicio y los permisos de acceso para una instancia.Actualiza la caché del paquete con el siguiente comando:
sudo yum makecacheInstala el complemento de Artifact Registry en la VM con el siguiente comando:
sudo yum install FORMAT-plugin-artifact-registryReemplaza lo siguiente:
FORMATpor uno de los siguientes valores:yum, si tu sistema operativo es Enterprise Linux 7 o anteriordnf, si tu sistema operativo es Enterprise Linux 8 o una versión posterior
Otra VM
Instala la clave de firma de RPM con el siguiente comando:
sudo rpm --import https://packages.cloud.google.com/yum/doc/rpm-package-key.gpgCrea un archivo llamado
/etc/yum.repos.d/artifact-registry-plugin.repocon el siguiente contenido:[ar-plugin] name=Artifact Registry Plugin baseurl=https://packages.cloud.google.com/yum/repos/FORMAT-plugin-artifact-registry-DISTRO-stable enabled=1 gpgcheck=1
Reemplaza lo siguiente:
FORMATpor uno de los siguientes valores:yum, si tu sistema operativo es Enterprise Linux 7 o anteriordnf, si tu sistema operativo es Enterprise Linux 8 o una versión posterior
DISTROpor la versión principal de Red Hat Enterprise Linux en el formatoelX, en el queXes la versión de actualización. Algunos ejemplos de valoresDISTROválidos sonel7,el8,el9yel10.
Actualiza Yum con el siguiente comando:
sudo yum makecacheInstala el complemento de Artifact Registry en la VM con el siguiente comando:
yum install FORMAT-plugin-artifact-registryReemplaza
FORMATpor uno de los siguientes valores:yum, si tu sistema operativo es Enterprise Linux 7 o anteriordnf, si tu sistema operativo es Enterprise Linux 8 o una versión posterior
Busca la línea
#service_account_json = "/path/to/creds.json"en el archivoartifact-registry.conf, quita el comentario de la línea y agrega la ruta de acceso de la clave de tu cuenta de servicio.- Para los sistemas operativos Enterprise Linux 7 o versiones anteriores, la ruta de acceso
al archivo de configuración es
/etc/yum/pluginconf.d/artifact-registry.conf. - Para los sistemas operativos Enterprise Linux 8 o versiones posteriores, la ruta de acceso al archivo de configuración es
/etc/dnf/plugins/artifact-registry.conf.
Entrada del archivo de configuración:
service_account_json = "PATH_TO_SERVICE_ACCOUNT_KEY"
Reemplaza
PATH_TO_SERVICE_ACCOUNT_KEYpor la ruta de acceso al archivo JSON de la clave de tu cuenta de servicio.- Para los sistemas operativos Enterprise Linux 7 o versiones anteriores, la ruta de acceso
al archivo de configuración es
Repositorio público
Configura el acceso público al repositorio.
Configura una VM para acceder a un repositorio de Yum estándar
Para configurar una VM de modo que acceda a un repositorio de Yum, usa la herramienta cliente yum o dnf:
Genera el comando de configuración de la VM ejecutando el comando
gcloud beta artifacts print-settings yum:gcloud beta artifacts print-settings yum \ --repository=REPOSITORY \ --location=LOCATIONReemplaza lo siguiente:
REPOSITORYes el nombre del repositorio de Artifact Registry.-
LOCATIONes la ubicación regional del repositorio.
El resultado es similar a lo siguiente:
# To configure your package manager with this repository: # Update Yum: sudo yum makecache # Install the Yum credential helper: sudo yum install yum-plugin-artifact-registry # Configure your VM to access Artifact Registry packages using the following # command: sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL [REPOSITORY] name=REPOSITORY baseurl=https://LOCATION-yum.s3nsregistry.fr/projects/PROJECT/REPOSITORY enabled=1 repo_gpgcheck=0 gpgcheck=0 EOL # Update Yum: sudo yum makecache
Configura la herramienta cliente de
yumpara recuperar paquetes de tu repositorio con el comandoteedel resultado del comandoprint-settings.Por ejemplo, para instalar paquetes desde el
my-repopúblico en el proyectomy-projecty en la ubicaciónu-france-east1, usa el siguiente comando:sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL [my-repo] name=My Repository baseurl=https://u-france-east1-yum.s3nsregistry.fr/projects/my-project/my-repo enabled=1 repo_gpgcheck=0 gpgcheck=0 EOL
Actualiza las fuentes de tu repositorio con el siguiente comando:
sudo yum makecache
Yum ahora puede conectarse al repositorio.
Si creas repositorios de Yum adicionales, crea un archivo .repo para cada uno
en /etc/yum.repos.d/. Vuelve a ejecutar sudo yum update para actualizar las fuentes del repositorio.