Administra paquetes de Conda

Después de crear un repositorio de Conda en Artifact Registry, podrás instalar paquetes de Conda en tu nuevo repositorio. En esta página, se describe cómo instalar, ver y borrar tus paquetes de Conda.

Antes de comenzar

1. Instala y, luego, inicializa Google Cloud CLI.

   Se requiere la versión 354.0.0 o posterior de Google Cloud CLI para ejecutar comandos para repositorios de Conda. Puedes verificar la versión con el siguiente comando:

   gcloud version
   

2. Para usar la CLI de Conda en tu entorno de Cloud de Confiance , instala uno de los siguientes administradores de paquetes de Conda:

   • Conda
   • Mamba
   • Micromamba
   • Miniforge

3. Si no tienes un repositorio de Conda en Artifact Registry, crea uno.

4. (Opcional) Establece valores predeterminados para los comandos de gcloud.

Artifact Registry admite repositorios de Conda estándar y remotos. Puedes usar cualquiera de las siguientes direcciones para tus repositorios remotos.

• https://repo.anaconda.com/pkgs/main
• https://repo.anaconda.com/pkgs/r
• https://repo.anaconda.com/pkgs/msys2
• https://conda.anaconda.org/conda-forge
• https://conda.anaconda.org/bioconda

Roles obligatorios

Para obtener los permisos que necesitas para administrar paquetes de Conda, pídele a tu administrador que te otorgue los siguientes roles de IAM en el repositorio:

• Ver paquetes o archivos en paquetes: Lector de Artifact Registry (roles/artifactregistry.reader)
• Descarga o instala paquetes: Lector de Artifact Registry (roles/artifactregistry.reader)
• Agregar paquetes a un repositorio: Escritor de Artifact Registry (roles/artifactregistry.writer)
• Borrar paquetes: Administrador del repositorio de Artifact Registry (roles/artifactregistry.repoAdmin)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Administra paquetes de Conda

Después de agregar un paquete de Conda a tu repositorio de Artifact Registry, puedes instalarlo en tu entorno de Conda y ver detalles sobre él con Cloud de Confiance.

Agrega paquetes a un repositorio de Artifact Registry

Para agregar un paquete de Conda a tu repositorio de Artifact Registry, ejecuta el siguiente comando:

gcloud artifacts files upload \
    --source=PACKAGE_NAME \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Aquí:

• REPO_NAME es el ID del repositorio.
• PROJECT es el ID del proyecto que contiene el repositorio.
• LOCATION es la ubicación regional o multirregional del repositorio.

Para agregar varios paquetes a la vez, sigue estos pasos:

gcloud artifacts files upload \
    --source-directory=DIRECTORY \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Aquí:

• DIRECTORY es la dirección de una carpeta local que contiene tus paquetes de Conda.

Cómo instalar paquetes

Modos de repositorio: estándar, remoto

Para instalar la versión estable más reciente de un paquete en tu entorno de Conda, ejecuta el siguiente comando:

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

mamba install -n ENVIRONMENT_NAME PACKAGE_NAME

micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Aquí:

• ENVIRONMENT_NAME es el nombre de tu entorno de Conda. Si ya tienes un entorno activado y estás instalando el paquete directamente en el entorno, puedes omitir -n ENVIRONMENT_NAME.

• PACKAGE_NAME es el nombre de tu paquete de Conda.

  Para instalar una versión específica de un paquete en tu entorno de Conda, incluye VERSION después del nombre del paquete.

En el caso de los repositorios estándar, descargas un paquete directamente desde el repositorio.

En el caso de un repositorio remoto, descargas una copia almacenada en caché del paquete y sus dependencias. Si no existe una copia en caché, el repositorio remoto descarga el paquete de la fuente upstream y lo almacena en caché antes de entregártelo. Para verificar que el repositorio remoto recuperó los paquetes de la fuente upstream, consulta la lista de paquetes en el repositorio.

Cómo ver paquetes y versiones

Modos de repositorio: estándar, remoto

Para ver los paquetes y las versiones de paquetes con la Cloud de Confiance consola o gcloud, haz lo siguiente:

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

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

En el caso de los repositorios remotos, la lista que se devuelve solo muestra los paquetes almacenados en caché.

Enumeración de archivos

Modos de repositorio: estándar, remoto

En el caso de los repositorios remotos, la lista que se devuelve solo muestra los paquetes de Conda y los archivos de índice almacenados en caché.

Puedes enumerar los archivos de un repositorio, los archivos de todas las versiones de un paquete especificado o los archivos de una versión específica de un paquete.

Para todos los siguientes comandos, puedes establecer una cantidad máxima de archivos que se devolverán agregando la marca --limit al comando.

Para enumerar todos los archivos en el proyecto, el repositorio y la ubicación predeterminados cuando se configuran los valores predeterminados, haz lo siguiente:

gcloud artifacts files list

Para enumerar los archivos en un proyecto, un repositorio y una ubicación especificados, ejecuta el siguiente comando:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Para enumerar los archivos de todas las versiones de un paquete específico, haz lo siguiente:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Para enumerar los archivos de una versión de paquete específica, haz lo siguiente:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

Reemplaza los siguientes valores:

• LOCATION: Es la ubicación regional del repositorio.
• PROJECT: Es el Cloud de Confiance by S3NS ID del proyecto.
• REPOSITORY: Es el nombre del repositorio en el que se almacena la imagen.
• PACKAGE: Es el nombre del paquete.
• VERSION: Es la versión del paquete.

Ejemplos

Considera la siguiente información del paquete:

• Proyecto: my-project
• Repositorio: my-repo
• Ubicación del repositorio: u-france-east1
• Paquete: my-app

El siguiente comando enumera todos los archivos del repositorio my-repo en la ubicación u-france-east1 dentro del proyecto predeterminado:

gcloud artifacts files list \
    --location=u-france-east1 \
    --repository=my-repo

gcloud artifacts files list \
    --project=my-project \
    --location=u-france-east1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

Borra paquetes y versiones

Modos de repositorio: estándar, remoto

Puedes borrar un paquete y todas sus versiones, o bien borrar una versión específica. No se pueden restablecer los paquetes borrados.

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:

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

Para borrar versiones de un paquete, haz lo siguiente:

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

En el caso de los repositorios remotos, Artifact Registry borra los datos de almacenamiento en caché de los paquetes seleccionados, incluidas las versiones y los archivos de los paquetes.

¿Qué sigue?

• Obtén más información para administrar imágenes de contenedor