Administra paquetes de Debian

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

Antes de comenzar

1. Si el repositorio de Apt de destino no existe, crea un repositorio nuevo.
2. Configura las VMs 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 Estándares de nombres de paquetes de Debian.

Agrega paquetes

Modos de repositorio: Estándar

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

Puedes subir un paquete a un repositorio con Google Cloud CLI, o puedes importar un paquete que se almacena en Cloud Storage. Si compilas paquetes usando Cloud Build, la compilación puede almacenar los paquetes en Cloud Storage por ti para importar.

Es posible que las operaciones de importación o carga muy largas superen el período de vencimiento del token que gcloud CLI usa para llamar a la API. Si tienes un una gran cantidad de paquetes, considera agregarlos en lotes más pequeños cada operación de carga o importación puede completarse en menos tiempo. Consulta la documentación sobre la solución de problemas de paquetes de SO para obtener más información. información.

Carga directa

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

gcloud 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 en un repositorio de confianza.
• PACKAGES es la ruta de acceso 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 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:

   • Sube paquetes directamente a un Bucket de Cloud Storage
   • Compila paquetes con Cloud Build y almacenarlos en un bucket

2. Ejecuta el siguiente comando:

   gcloud 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 en un repositorio de confianza.
   • PACKAGES es una lista separada por comas de paquetes en en Google Cloud Storage. Para subir todos los paquetes de un directorio, usa un de directorio (*) o usa un comodín de directorio recurrente (**) para subir todos los paquetes de todos los subdirectorios.

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

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

Cuando se complete la operación de carga o importación, puedes usar el la consola de Google Cloud o gcloud CLI para ver paquetes en la repositorio y confirmar que se subieron correctamente.

Si tienes un repositorio grande con muchos paquetes, puede llevar varios minutos para regenerar el índice de paquetes de manera que los nuevos paquetes sean visibles para el cliente Apt.

Visualiza paquetes

Modos del repositorio: Estándar, remoto (vista previa)

Para ver los paquetes, debes tener los permisos en Artifact Registry Rol de lector. Artifact Registry no enumera los archivos dentro de los paquetes.

Para ver paquetes y versiones de paquetes con la consola de Google Cloud o gcloud:

Console

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

   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 un regional o multirregional location. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usar el valor predeterminado.

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 el identificador completamente calificado. para el paquete.
• REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
• LOCATION es un regional o multirregional location. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usar el valor predeterminado.

Instala paquetes

Modos del repositorio: Estándar, remoto (vista previa)

Antes de instalar los 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 especificando el nombre del repositorio configurado en Departamento

   sudo apt install PACKAGE/REPOSITORY
   

   Reemplaza los siguientes valores:

   • PACKAGE es el nombre del paquete.
   • REPOSITORY es el nombre del repositorio de Artifact Registry. Para repositorios remotos, usa el nombre del repositorio upstream estándar.

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

   sudo apt install my-package -t my-repo
   

Nota: Después de agregar o borrar paquetes, puede tardar varios minutos en volver a generar el índice del paquete, en especial si el repositorio es grande. Si no puede instalar un paquete que se agregó recientemente al repositorio espera unos minutos y vuelve a intentarlo. Para obtener información adicional, consulta la Solución de problemas con paquetes de SO documentación.

Borra paquetes

Modos de repositorio: Estándar

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 la consola de Google Cloud.

   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 quieres 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]

Dónde

• 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 un regional o multirregional location. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usar el valor predeterminado.
• --async se muestra de inmediato, sin necesidad de esperar a que se complete la operación en curso.

Sigue estos pasos para borrar versiones de un paquete:

Console

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

   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]

Dónde

• 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 un regional o multirregional location. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usar el valor predeterminado.
• --async se muestra de inmediato, sin necesidad de esperar a que se complete la operación en curso.

Para los repositorios grandes, regenerar el paquete Apt puede tardar unos minutos. índice para reflejar las eliminaciones.

¿Qué sigue?

• Más información para administrar paquetes de RPM
• Cómo descargar archivos individuales dentro de un paquete