Almacena otros formatos en Artifact Registry

Almacena otros formatos en Artifact Registry

Aprende a configurar un repositorio de formato genérico de Artifact Registry y a subir un archivo YAML.

Antes de comenzar

Accede a tu Google Cloud cuenta. 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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Roles obligatorios

Para obtener los permisos que necesitas para crear y administrar repositorios de paquetes de Artifact Registry, pídele a tu administrador que te otorgue el rol de IAM de administrador de Artifact Registry (roles/artifactregistry.admin) en tu proyecto. 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.

Inicia Cloud Shell

En la Google Cloud consola, activa Cloud Shell.

Activa Cloud Shell

En la parte inferior de la Google Cloud consola, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

En esta guía de inicio rápido, usarás Cloud Shell para ejecutar comandos de gcloud.

Crea un repositorio genérico

1. Para crear un repositorio de formato genérico llamado quickstart-generic-repo en la ubicación us-central1 con la descripción Generic repository, ejecuta el siguiente comando:

   gcloud artifacts repositories create quickstart-generic-repo \
       --repository-format=generic \
       --location=us-central1 \
       --description="Generic 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, ejecuta los siguientes comandos para configurar el repositorio predeterminado como quickstart-generic-repo y la ubicación predeterminada como us-central1.

   1. Para configurar el repositorio predeterminado como quickstart-generic-repo, ejecuta el siguiente comando:

      gcloud config set artifacts/repository quickstart-generic-repo
      

   2. Para configurar la ubicación predeterminada como us-central1, ejecuta el siguiente comando:

      gcloud config set artifacts/location us-central1
      

   Una vez configurados los valores, no necesitas especificarlos en los comandos de gcloud que requieren un repositorio o una ubicación.

Sube un artefacto al repositorio

1. En tu directorio principal, crea un archivo para subirlo a tu repositorio:

   echo "hello world" > hello.yaml
   

2. Para subir el archivo como un artefacto al repositorio, ejecuta el siguiente comando:

   gcloud artifacts generic upload \
       --source=hello.yaml \
       --package=my-package \
       --version=1.0.0
   

   Aquí:

   • hello.yaml es la ruta del archivo que se va a subir.
   • my-package es el paquete que se debe subir.
   • 1.0.0 es la versión del artefacto. No puedes reemplazar una versión existente en el repositorio.

Visualiza artefactos en el repositorio

Para verificar que se haya agregado el artefacto al repositorio, puedes enumerar todos los artefactos ejecutando el siguiente comando:

gcloud artifacts files list

La respuesta incluye los detalles del archivo en el formato PACKAGE:VERSION:FILE_NAME.

En el siguiente ejemplo, hello.yaml es el FILE_NAME:

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

Descarga un artefacto genérico

Para descargar un artefacto genérico de tu repositorio, ejecuta el siguiente comando:

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

Aquí:

• hello.yaml es el nombre del archivo que se va a descargar.
• my-package es el paquete que se va a descargar.
• 1.0.0 es la versión del artefacto.

Reemplaza DESTINATION por el directorio de tu sistema de archivos local en el que deseas guardar la descarga. La carpeta de destino ya debe existir o el comando fallará.

Limpia

Para evitar que se apliquen cargos a tu Google Cloud cuenta por los recursos usados en este instructivo, borra el proyecto que contiene los recursos, o conserva el proyecto y borra el repositorio.

Borra el proyecto

Precaución: Borrar un proyecto tiene estas consecuencias:

• Se borra todo su contenido. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los IDs personalizados de los proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID personalizado del proyecto que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto, en lugar de todo el proyecto.

Si planeas explorar varios instructivos, arquitecturas o guías de inicio rápido, reutilizar proyectos puede ser útil para no exceder los límites de cuota de los proyectos.

Borra un Google Cloud proyecto:

gcloud projects delete PROJECT_ID

Borra el repositorio

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

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

   gcloud artifacts repositories delete quickstart-generic-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
   

¿Qué sigue?

• Obtén más información sobre los artefactos genéricos.