Administrar paquetes Debian

En esta página, se describe cómo agregar, ver y borrar paquetes de Debian en repositorios de Apt.

Antes de comenzar

  1. Si el repositorio de Apt de destino no existe, crea un repositorio nuevo.
  2. Configura las VM para acceder al repositorio.
  3. (Opcional) Configura valores predeterminados para los comandos de gcloud.
  4. Asegúrate de que los nombres de tus paquetes en los metadatos cumplan con los estándares de nombres de paquetes de Debian.

Agrega paquetes

Debes tener permisos de lectura y escritura para que el repositorio agregue paquetes.

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.

Carga directa

Usa el comando gcloud beta artifacts apt upload para subir un paquete a un repositorio de Apt:

gcloud beta artifacts apt upload REPOSITORY \
    --location=LOCATION \
    --source=PACKAGES

Reemplaza los siguientes valores:

  • REPOSITORY es el nombre del repositorio de Artifact Registry.
  • LOCATION es la ubicación regional o multirregional del repositorio.
  • PACKAGES es la ruta al paquete.

Por ejemplo, para subir el paquete my-package.deb al repositorio de Apt my-repo en la ubicación us-central1, ejecuta lo siguiente:

gcloud beta artifacts apt upload my-repo \
    --location=us-central1 \
    --source=my-package.deb

Cloud Storage

  1. Sube los paquetes a Cloud Storage de una de las siguientes maneras:

    • Subir paquetes directamente a un depósito de Cloud Storage
    • Compila paquetes con Cloud Build y almacénalos en un bucket
  2. Ejecuta el siguiente comando:

    gcloud beta artifacts apt import REPOSITORY \
        --location=LOCATION \
         --gcs-source=PACKAGES
    

    Reemplaza los siguientes valores:

    • REPOSITORY es el nombre del repositorio de Artifact Registry.
    • LOCATION es la ubicación regional o multirregional del repositorio.
    • PACKAGES es una lista separada por comas de paquetes en Cloud Storage. Para subir todos los paquetes de un directorio, usa un comodín de directorio (*) o un comodín de directorio recurrente (**) a fin de subir todos los paquetes de todos los subdirectorios.

    Por ejemplo, para subir un paquete package.rpm y todos los paquetes en el directorio directory del bucket my-bucket al repositorio de Apt my-repo en la ubicación us-central1, ejecuta:

    gcloud beta artifacts apt import my-repo \
       --location=us-central1 \
       --gcs-source=gs://my-bucket/path/to/package.deb,gs://my-bucket/directory*
    

Visualiza paquetes

Para ver los paquetes, debes tener los permisos en la función de lector de Artifact Registry.

Para ver paquetes y versiones de paquetes con Google Cloud Console o gcloud, haz lo siguiente:

Console

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

    Abrir la página Repositorios

  2. En la lista de repositorios, haz clic en el repositorio correspondiente.

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

  3. Haz clic en un paquete para ver las versiones de este.

gcloud

Para enumerar los paquetes en un repositorio, ejecuta el siguiente comando:

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Donde

  • REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
  • LOCATION es una ubicación regional o multirregional. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usarla.

Para ver las versiones de un paquete, ejecuta el siguiente comando:

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Donde

  • PACKAGE es el ID del paquete o identificador completamente calificado del paquete.
  • REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
  • LOCATION es una ubicación regional o multirregional. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usarla.

Instala paquetes

Antes de instalar paquetes, verifica que hayas configurado el administrador de paquetes y el repositorio de forma correcta.

Para instalar un paquete en el repositorio, haz lo siguiente:

  1. Actualiza la lista de paquetes disponibles:

    sudo apt update
    
  2. Instala el paquete y especifica el nombre del repositorio configurado en Apt.

    sudo apt install PACKAGE/REPOSITORY
    

    Reemplaza los siguientes valores:

    • PACKAGE es el nombre del paquete.
    • REPOSITORY es el nombre del repositorio de Artifact Registry.

    Por ejemplo, para instalar el paquete my-package desde el repositorio my-repo, ejecuta el comando:

    sudo apt install my-package -t my-repo
    

Borra paquetes

Antes de borrar un paquete o una versión de un paquete, verifica que se haya comunicado o abordado cualquier dependencia importante en este.

Para borrar un paquete, haz lo siguiente:

Console

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

    Abrir la página Repositorios

  2. En la lista de repositorios, haz clic en el repositorio correspondiente.

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

  3. Selecciona el paquete que deseas borrar.

  4. Haz clic en BORRAR.

  5. En el cuadro de diálogo de confirmación, haz clic en BORRAR.

gcloud

Ejecuta el siguiente comando:

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Donde

  • PACKAGE es el nombre del paquete en el repositorio.
  • REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
  • LOCATION es una ubicación regional o multirregional. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usarla.
  • --async se muestra de inmediato, sin necesidad de esperar a que se complete la operación en curso.

Para borrar versiones de un paquete:

Console

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

    Abrir la página Repositorios

  2. En la lista de repositorios, haz clic en el repositorio correspondiente.

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

  3. Haz clic en un paquete para ver sus versiones.

  4. Selecciona las versiones que deseas borrar.

  5. Haz clic en BORRAR.

  6. En el cuadro de diálogo de confirmación, haz clic en BORRAR.

gcloud

Ejecuta el siguiente comando:

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

Donde

  • PACKAGE es el nombre del paquete en el repositorio.
  • REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
  • LOCATION es una ubicación regional o multirregional. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usarla.
  • --async se muestra de inmediato, sin necesidad de esperar a que se complete la operación en curso.

¿Qué sigue?