Armazenar outros formatos no Artifact Registry

Saiba como configurar um repositório de formato genérico do Artifact Registry e fazer upload de um arquivo YAML.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

  2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Ative a API Artifact Registry.

    Ative a API

    5.

  5. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  7. Ative a API Artifact Registry.

    Ative a API

    8.

Iniciar o Cloud Shell

No Console do Google Cloud, ative o Cloud Shell.

Ativar o Cloud Shell

Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

Neste guia de início rápido, você usará o Cloud Shell para executar comandos gcloud.

Criar um repositório genérico

  1. Para criar um repositório de formato genérico chamado quickstart-generic-repo em o local us-central1 com a descrição Generic repository, execute o seguinte comando:

    gcloud artifacts repositories create quickstart-generic-repo \
    --repository-format=generic \
    --location=us-central1 \
    --description="Generic repository"

  2. Para verificar se o repositório foi criado, execute o seguinte comando:

    gcloud artifacts repositories list

  3. Para simplificar os comandos do gcloud, execute os seguintes comandos para definir o padrão repositório como quickstart-generic-repo e o local padrão para us-central1

    1. Para definir o repositório padrão como quickstart-generic-repo, execute o seguinte comando:

      gcloud config set artifacts/repository quickstart-generic-repo

    2. Para definir o local padrão como us-central1, execute o seguinte comando:

      gcloud config set artifacts/location us-central1

    Depois de definir os valores, não é necessário especificá-los em gcloud. comandos que exigem um repositório ou local.

Fazer upload de um artefato para o repositório

  1. No seu diretório principal, crie um arquivo para fazer upload no seu repositório:

    echo "hello world" > hello.yaml

  2. Para fazer upload do arquivo como um artefato no repositório, execute o seguinte comando:

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

    Em que:

    • hello.yaml é o caminho do arquivo para upload;
    • my-package é o pacote a ser enviado.
    • 1.0.0 é a versão do artefato. Não é possível substituir um ou uma versão atual no repositório.

Mostrar artefatos no repositório

Para verificar se o artefato foi adicionado ao repositório, liste todos artefatos executando o seguinte comando:

gcloud artifacts files list

A resposta inclui os detalhes do arquivo no formato PACKAGE:VERSION:FILE_NAME:

No exemplo abaixo, hello.yaml é o 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

Fazer o download de um artefato genérico

Para fazer o download de um artefato genérico do repositório, execute o seguinte comando:

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

Em que:

  • hello.yaml é o nome do arquivo que será transferido por download.
  • my-package é o pacote que será transferido por download.
  • 1.0.0 é a versão do artefato.

Substitua DESTINATION pelo diretório no seu local no qual você quer salvar o download. A pasta de destino precisa ou o comando falhará.

Limpar

Para evitar cobranças dos recursos na sua conta do Google Cloud neste tutorial, exclua o projeto que contém os recursos ou manter o projeto e excluir o repositório.

Exclua o projeto

    Exclua um projeto do Google Cloud:

    gcloud projects delete PROJECT_ID

Excluir o repositório

Antes de remover um repositório, verifique se os pacotes que você quer manter estão disponíveis em outro local.

  1. Para excluir o repositório quickstart-generic-repo, execute o seguinte comando:

    gcloud artifacts repositories delete quickstart-generic-repo

  2. Se você quiser remover as configurações padrão de repositório e localização que definiu para a configuração ativa gcloud, execute os seguintes comandos:

    gcloud config unset artifacts/repository
gcloud config unset artifacts/location

A seguir