Guía de inicio rápido para Apt

En esta guía de inicio rápido, se muestra cómo configurar un repositorio de Apt de Artifact Registry, agregar un paquete de Debian al repositorio y, luego, instalar el paquete.

Sigue los pasos de esta guía de inicio rápido mediante Cloud Shell o una shell local que se ejecuta en un sistema operativo basado en Debian.

Para obtener más información sobre cómo administrar paquetes Debian, consulta Trabaja con paquetes Debian.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  4. Habilita la API Artifact Registry.

    Habilita la API

  5. Instala e inicializa el SDK de Cloud.
  6. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  7. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  8. Habilita la API Artifact Registry.

    Habilita la API

  9. Instala e inicializa el SDK de Cloud.
  10. Crea una VM nueva en la que instalarás el paquete de muestra. Ejecuta el siguiente comando y reemplaza VM_NAME por un nombre para la VM.
      gcloud compute instances create VM_NAME \
          --image-family=debian-10 \
          --image-project=debian-cloud \
          --scopes=cloud-platform
  11. Otorga permisos de acceso al repositorio a la cuenta de servicio de tu VM.

Cree un repositorio

Crea el repositorio de tus artefactos.

  1. Crea el repositorio:

    Console

    1. Abre la página Repositorios en Cloud Console.

      Abrir la página Repositorios

    2. Haz clic en Crear repositorio.

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

    4. Selecciona Apt como formato.

    5. En Tipo de ubicación, selecciona Región y, luego, elige la ubicación us-central1.

    6. Haga clic en Crear.

    El repositorio se agrega a la lista de repositorios.

    gcloud

    1. Ejecuta el siguiente comando para crear un repositorio de Apt nuevo en el proyecto actual llamado quickstart-apt-repo en la ubicación us-central1.

      gcloud artifacts repositories create quickstart-apt-repo \
          --repository-format=apt \
          --location=us-central1 \
          --description="Apt repository"
      
    2. Ejecuta el siguiente comando para verificar que se haya creado el repositorio:

      gcloud artifacts repositories list
      
    3. Para simplificar los comandos de gcloud, configura el repositorio predeterminado como quickstart-apt-repo y la ubicación predeterminada como us-central1. Una vez configurados los valores, no necesitas especificarlos en los comandos de gcloud que requieren un repositorio o una ubicación.

      Para configurar el repositorio, ejecuta el siguiente comando:

      gcloud config set artifacts/repository quickstart-apt-repo
      

      Para configurar la ubicación, ejecuta el siguiente comando:

      gcloud config set artifacts/location us-central1
      

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

Cómo configurar el administrador de paquetes

Para instalar un paquete en una VM, agrega el repositorio que creaste al archivo de configuración de Apt que define los repositorios de paquetes.

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

    Abrir la página Instancias de VM

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

  3. Ejecuta gcloud init para inicializar el SDK de Cloud en tu VM.

  4. Instala las claves de firma del repositorio de Apt con el siguiente comando:

    curl https://us-central1-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add -
    
  5. Actualización del Departamento:

    sudo apt update
    
  6. Instala el auxiliar de credenciales de Apt en la VM para permitir que Apt realice la autenticación:

    sudo apt install apt-transport-artifact-registry
    
  7. Configura tu VM para que acceda a los paquetes de Artifact Registry mediante el siguiente comando:

    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
    

    Reemplaza PROJECT por el ID del proyecto de Google Cloud.

Agrega un paquete al repositorio

Puedes subir un paquete a un repositorio mediante la herramienta de línea de comandos gcloud o puedes importar un paquete almacenado en Cloud Storage. Si compilas paquetes con Cloud Build, la compilación puede almacenarlos en Cloud Storage para que los importes.

Para esta guía de inicio rápido, debes subir un archivo de muestra con el comando gcloud beta artifacts apt upload.

  1. Descarga la hoja de referencia rápida de Apt con el siguiente comando:

    sudo apt download apt-dpkg-ref
    

    Apt descarga la versión más reciente del paquete que está 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. Ejecuta gcloud beta artifacts apt upload para subir el paquete al repositorio:

    gcloud beta artifacts apt upload quickstart-apt-repo \
        --location=us-central1 \
        --source=FILE_NAME
    

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

Visualiza el paquete en el repositorio

Verifica que tu paquete se haya agregado al repositorio.

Console

  1. Abre la página Repositorios en Cloud Console.

    Abrir la página Repositorios

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

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

gcloud

Para mostrar los paquetes en el repositorio quickstart-apt-repo, ejecuta el siguiente comando:

 gcloud artifacts packages list --repository=quickstart-apt-repo

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

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

Instale el paquete

Instala el paquete que agregaste 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 que se muestra se parece 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) ...
    

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

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

Para borrar el repositorio, haz lo siguiente:

Console

  1. Abre la página Repositorios en Cloud Console.

    Abrir la página repositorios

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

  3. Haz clic en Borrar.

gcloud

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

    gcloud artifacts repositories delete quickstart-apt-repo
    
  2. Si deseas quitar la configuración predeterminada de la ubicación y del repositorio que estableciste para la configuración activa de gcloud, ejecuta los siguientes comandos:

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

Para borrar la VM que creaste, ejecuta el siguiente comando. Reemplaza VM_NAME con el nombre de la VM.

gcloud compute instances delete VM_NAME

¿Qué sigue?