Almacena otros formatos en Artifact Registry

Obtén más información para configurar un repositorio de formato genérico de Artifact Registry y subir un archivo YAML.

Antes de comenzar

  1. 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.

  2. 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

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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

  5. 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

  6. Verify that billing is enabled for your Google Cloud project.

  7. 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

    8.

    Inicia 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 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. Para verificar que se haya creado el repositorio, ejecuta el siguiente comando:

      gcloud artifacts repositories list

    3. Para simplificar los comandos de gcloud, ejecuta los siguientes comandos para establecer el repositorio predeterminado en quickstart-generic-repo y la ubicación predeterminada en us-central1.

      1. Para establecer el repositorio predeterminado en quickstart-generic-repo, ejecuta el siguiente comando:

        gcloud config set artifacts/repository quickstart-generic-repo

      2. Para establecer la ubicación predeterminada en 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 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 tu artefacto se haya agregado 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 descargará.
    • my-package es el paquete que se descargará.
    • 1.0.0 es la versión del artefacto.

    Reemplaza DESTINATION por el directorio en 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 cuenta de Google Cloud 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

    1. In the Google Cloud console, go to the Manage resources page.

      Go to Manage resources

    2. In the project list, select the project that you want to delete, and then click Delete.
    3. In the dialog, type the project ID, and then click Shut down to delete the project.

    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?