Esta página se ha traducido con Cloud Translation API.

Almacenar otros formatos en Artifact Registry

Consulta cómo configurar un repositorio de formato genérico de Artifact Registry y subir un archivo YAML.

Antes de empezar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

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

Abrir Cloud Shell

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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

Crear un repositorio genérico

Para crear un repositorio de formatos 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"

Para verificar que se ha creado el repositorio, ejecuta el siguiente comando:
```
gcloud artifacts repositories list
```
Para simplificar los comandos de gcloud, ejecuta los siguientes comandos para definir el repositorio predeterminado como quickstart-generic-repo y la ubicación predeterminada como us-central1.
1. Para definir el repositorio predeterminado como quickstart-generic-repo, ejecuta el siguiente comando:
```
gcloud config set artifacts/repository quickstart-generic-repo
```
2. Para definir la ubicación predeterminada en us-central1, ejecuta el siguiente comando:
```
gcloud config set artifacts/location us-central1
```
Una vez que se hayan definido los valores, no será necesario especificarlos en los comandos de gcloud que requieran un repositorio o una ubicación.

Subir un artefacto al repositorio

En tu directorio principal, crea un archivo que quieras subir a tu repositorio:
```
echo "hello world" > hello.yaml
```
Para subir el archivo como artefacto al repositorio, ejecuta el siguiente comando:
```
gcloud artifacts generic upload \
    --source=hello.yaml \
    --package=my-package \
    --version=1.0.0
```
Donde:
- hello.yaml es la ruta del archivo que se va a subir.
- my-package es el paquete que se va a subir.
- 1.0.0 es la versión del artefacto. No puedes sobrescribir una versión que ya esté en el repositorio.

Ver artefactos en el repositorio

Para verificar que el artefacto se ha añadido 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

Descargar 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

Donde:

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.

Sustituye DESTINATION por el directorio del sistema de archivos local en el que quieras guardar la descarga. La carpeta de destino debe existir o el comando fallará.

Limpieza

Para evitar que se apliquen cargos en tu Google Cloud cuenta por los recursos utilizados en este tutorial, elimina el proyecto que contiene los recursos o conserva el proyecto y elimina el repositorio.

Eliminar el proyecto

Precaución: Eliminar un proyecto tiene los siguientes efectos:

Se elimina todo el contenido del proyecto. Si has usado un proyecto que ya existía para las tareas de este documento, cuando lo elimines, también se eliminará cualquier otro trabajo que hayas realizado en él.
Se pierden los IDs de proyecto personalizados. Cuando creaste este proyecto, es posible que hayas creado un ID de proyecto personalizado que quieras usar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, elimina los recursos seleccionados dentro del proyecto en lugar de eliminar todo el proyecto.

Si tienes previsto consultar varias arquitecturas, tutoriales o guías de inicio rápido, reutilizar los proyectos puede ayudarte a no superar los límites de cuota de proyectos.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

Eliminar el repositorio

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

Para eliminar el repositorio quickstart-generic-repo, ejecuta el siguiente comando:
```
gcloud artifacts repositories delete quickstart-generic-repo
```
Si quieres quitar los ajustes predeterminados de repositorio y ubicación que has configurado para la configuración gcloud activa, ejecuta los siguientes comandos:
```
gcloud config unset artifacts/repository
gcloud config unset artifacts/location
```

Siguientes pasos

Más información sobre los artefactos genéricos