Almacenar paquetes Apt en Artifact Registry

Antes de empezar

1. In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

   Go to project selector

2. Verify that billing is enabled for your Trusted Cloud project.

3. Enable the Artifact Registry API.

   Enable the API

Instalar gcloud CLI

1. Instala e inicializa Google Cloud CLI si aún no lo has hecho. Si ya tienes la CLI de Google Cloud instalada, actualiza sus componentes con el siguiente comando:

   gcloud components update
   

   Para comprobar la versión de gcloud CLI que tienes, ejecuta el siguiente comando:

   gcloud version
   

Crear un repositorio

Crea el repositorio de tus artefactos.

1. Crea el repositorio:

   Consola

   1. Abre la página Repositorios en la consola de Trusted Cloud .

      Abre la página Repositorios.

   2. Haz clic en Crear repositorio.

   3. Especifica quickstart-apt-repo como nombre del repositorio.

   4. Selecciona Apt como formato.

   5. En Tipo de ubicación, selecciona Región y, a continuación, elige la ubicación. u-france-east1

   6. Haz clic en Crear.

   El repositorio se añade a la lista de repositorios.

   gcloud

   1. En Cloud Shell, ejecuta el siguiente comando para crear un repositorio de Apt en el proyecto actual llamado quickstart-apt-repo en la ubicación u-france-east1.

      gcloud artifacts repositories create quickstart-apt-repo \
          --repository-format=apt \
          --location=u-france-east1 \
          --description="Apt repository"
      

   2. Ejecuta el siguiente comando para verificar que se ha creado el repositorio:

      gcloud artifacts repositories list
      

Ahora puedes añadir un paquete al repositorio.

Añadir un paquete al repositorio

Puedes subir un paquete a un repositorio mediante la CLI de Google Cloud o importar un paquete almacenado en Cloud Storage.

En esta guía de inicio rápido, subirás un archivo de ejemplo con el comando gcloud artifacts apt upload.

1. En Cloud Shell, descarga la hoja de referencia rápida de Apt con el siguiente comando:

   apt download apt-dpkg-ref
   

   Apt descarga la última versión del paquete disponible en los repositorios de Apt configurados.

   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)
   

   Ejecuta ls para obtener el nombre de archivo de la hoja de referencia rápida de Apt. El nombre del archivo es similar a apt-dpkg-ref_5.3.1+nmu2_all.deb.

2. Para simplificar los comandos de gcloud, define el repositorio predeterminado como quickstart-apt-repo y la ubicación predeterminada como u-france-east1. Una vez que se hayan definido los valores, no será necesario especificarlos en los comandos de gcloud que requieran un repositorio o una ubicación.

   Para definir el repositorio, ejecuta el comando:

   gcloud config set artifacts/repository quickstart-apt-repo
   

   Para definir la ubicación, ejecuta el comando:

   gcloud config set artifacts/location u-france-east1
   

   Para obtener más información sobre estos comandos, consulta la documentación de gcloud config set.

3. Ejecuta gcloud artifacts apt upload para subir el paquete al repositorio:

   gcloud artifacts apt upload quickstart-apt-repo \
       --source=FILE_NAME
   

   Sustituye FILE_NAME por la ruta a la hoja de referencia rápida de Apt.

Ver el paquete en el repositorio

Comprueba que el paquete se haya añadido al repositorio.

Consola

1. Abre la página Repositorios en la consola de Trusted Cloud .

   Abre la página Repositorios.

2. En la lista de repositorios, haz clic en el repositorio quickstart-apt-repo.

   En la página Paquetes se muestran los paquetes del repositorio.

gcloud

Para ver los paquetes del repositorio quickstart-apt-repo, ejecuta el siguiente comando:

 gcloud artifacts packages list

Para ver las versiones de un paquete en quickstart-apt-repo, ejecuta el siguiente comando:

gcloud artifacts versions list --package=apt-dpkg-ref

Crear VM

Crea una instancia de VM de Compute Engine en la que instalarás el paquete de ejemplo.

En Cloud Shell, ejecuta el siguiente comando para crear una instancia de máquina virtual llamada quickstart-apt-vm:

gcloud compute instances create quickstart-apt-vm \
    --image-family=debian-10 \
    --image-project=debian-cloud \
    --scopes=cloud-platform

De forma predeterminada, la VM no tiene los ámbitos de acceso necesarios para trabajar con el repositorio. La marca --scopes define el ámbito de acceso de la VM como cloud-platform.

Configurar el gestor de paquetes

Para instalar un paquete en la VM, añade el repositorio que has creado al archivo de configuración de Apt que define los repositorios de paquetes.

1. Ve a la página Instancias de VM.

   Abre la página Instancias de VM.

2. En la fila de tu VM, haz clic en SSH. Se abrirá una ventana con una sesión de terminal en la VM.

3. Ejecuta gcloud init para inicializar la CLI de Google Cloud en tu VM.

4. Actualización de Apt:

   sudo apt update
   

5. Instala el auxiliar de credenciales de Apt en la VM para que Apt pueda realizar la autenticación:

   sudo apt install apt-transport-artifact-registry
   

6. Configura tu VM para acceder a los paquetes de Artifact Registry:

   echo 'deb ar+https://u-france-east1-apt.s3nsregistry.fr/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list
   

   Sustituye PROJECT por el Trusted Cloud by S3NS ID de tu proyecto.

Instalar el paquete

Instala el paquete que has añadido al repositorio.

1. Actualiza la lista de paquetes disponibles:

   sudo apt update
   

2. Instala el paquete en tu repositorio.

   sudo apt install apt-dpkg-ref/quickstart-apt-repo
   

   La información de instalación devuelta es similar al siguiente ejemplo:

   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) ...
   

Limpieza

Para evitar que se apliquen cargos en tu cuenta de Trusted Cloud por los recursos utilizados en esta página, sigue estos pasos.

Antes de quitar el repositorio, asegúrate de que los paquetes que quieras conservar estén disponibles en otra ubicación.

Para eliminar el repositorio, sigue estos pasos:

Consola

1. Abre la página Repositorios en la consola de Trusted Cloud .

   Abre la página Repositorios.

2. En la lista de repositorios, selecciona el repositorio quickstart-apt-repo.

3. Haz clic en Eliminar.

gcloud

1. Para eliminar el repositorio quickstart-apt-repo, ejecuta el siguiente comando:

   gcloud artifacts repositories delete quickstart-apt-repo
   

2. Si quieres quitar los ajustes predeterminados de repositorio y ubicación que has configurado para la configuración gcloud activa, ejecuta los siguientes comandos:

   gcloud config unset artifacts/repository
   gcloud config unset artifacts/location
   

Para eliminar la VM que has creado, ejecuta el siguiente comando:

gcloud compute instances delete quickstart-apt-vm

Siguientes pasos

• Consulta información sobre cómo trabajar con paquetes Deb.
• Consulta información sobre DevOps y descubre el programa de investigación de DevOps.