Armazenar módulos Go no Artifact Registry

Armazenar módulos Go no Artifact Registry

Configure um repositório particular em Go do Artifact Registry, faça upload de um módulo para ele e use o módulo como dependência.

Antes de começar

1. Faça login na sua Conta do Google.

   Se você ainda não tiver uma, inscreva-se agora.

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

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   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. Instale a CLI do Google Cloud.

6. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

   Observação: se você instalou a CLI gcloud anteriormente, verifique se tem a versão mais recente executando gcloud components update.

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

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

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

9. Ative a API Artifact Registry.

   Ative a API

10. Instale a CLI do Google Cloud.

11. Para inicializar a CLI gcloud, execute o seguinte comando:

    gcloud init

    Observação: se você instalou a CLI gcloud anteriormente, verifique se tem a versão mais recente executando gcloud components update.
12. Instale o Go 1.15 ou mais recente.
13. Instale o complemento package-go-module da CLI gcloud:
    

    gcloud components install package-go-module

Criar um repositório

Para criar e configurar um novo repositório:

1. Execute o comando abaixo para criar um novo repositório.

   gcloud artifacts repositories create REPOSITORY \
       --repository-format=go \
       --location=LOCATION \
       --description=DESCRIPTION
   

   Substitua:

   • REPOSITORY é o nome do repositório. Para cada local de repositório em um projeto, os nomes dos repositórios precisam ser exclusivos.
   • LOCATION é o local regional ou multirregional do repositório. É possível omitir essa sinalização se definir um default. Para ver uma lista de locais compatíveis, execute o comando gcloud artifacts locations list.
   • DESCRIPTION é uma descrição opcional do repositório. Não inclua dados sensíveis, porque as descrições do repositório não são criptografadas.

2. Execute o comando a seguir para ver os detalhes do repositório.

     gcloud artifacts repositories describe --location=LOCATION REPOSITORY
   

   A saída será assim:

     Encryption: Google-managed key
     Repository Size: 0.000MB
     createTime: '2022-06-03T20:20:01.644813Z'
     format: GO
     mode: STANDARD_REPOSITORY
     name: projects/my-project/locations/us-west1/repositories/my-repo
     updateTime: '2022-06-03T20:20:01.644813Z'
   

Definir padrões para comandos gcloud

É possível simplificar os comandos gcloud CLI definindo os padrões para os valores de projeto, repositório e local. Depois que os padrões forem configurados, as tags --project, --location e --repository não serão mais necessárias.

Empacotar e fazer upload de um módulo do Go

O complemento package-go-module da CLI gcloud empacota os módulos Go, permitindo que você controle a versão e faça upload para o Artifact Registry usando o comando gcloud.

Criar um módulo Go

Primeiro, crie um módulo Go simples para fazer upload ao seu repositório.

1. No seu diretório principal, crie um diretório chamado "foo" para seu módulo

   mkdir foo
   

2. Mude para o diretório do seu módulo e execute go mod init para criar um arquivo go.mod para o módulo.

     cd foo \
     go mod init example.com/foo
   

   Substitua example.com/foo pelo caminho do módulo. Consulte a Referência de módulos Go para mais informações.

3. Crie um arquivo foo.go no diretório foo com o seguinte conteúdo:

   
   package foo
   
   const HelloWorld = "Hello World!"
   

Empacotar e fazer upload do módulo

Empacote e faça upload do módulo para seu repositório:

  gcloud artifacts go upload --project=PROJECT \
      --repository=REPOSITORY \
      --location=LOCATION \
      --module-path=example.com/foo \
      --version=VERSION \
      --source=SOURCE_LOCATION

Substitua:

• PROJECT pelo ID do projeto do Google Cloud.
• REPOSITORY pelo nome do repositório em que o pacote está armazenado.
• LOCATION pelo local regional ou multirregional do repositório.
• example.com/foo pelo caminho do módulo. Consulte a Referência de módulos Go para mais informações.
• VERSION pela versão semântica do módulo no formato vX.Y.Z, em que X é a versão principal, Y é a versão secundária e Z é a versão do patch.
• SOURCE_LOCATION pelo caminho para o diretório raiz do módulo Go. Se você omitir a sinalização --source, o padrão será o diretório atual.

O upload do módulo é feito no Artifact Registry.

Para mais informações sobre a criação de módulos do Go, consulte este tutorial.

Listar módulos

Execute o comando a seguir para inspecionar o módulo do Go enviado no projeto, no repositório e no local padrão quando os valores padrão estiverem configurados:

  gcloud artifacts packages list

A saída será assim:

  Listing items under project my-project, location us-west1, repository my-repo.

  PACKAGE                   CREATE_TIME          UPDATE_TIME
  example.com/foo           2022-06-03T20:43:39  2022-06-20T20:37:40

Mais detalhes da versão do módulo

Execute o seguinte comando para exibir as versões do seu módulo no projeto, no repositório e no local padrão quando os valores padrão estiverem configurados:

  gcloud artifacts versions list --package=MODULE_PATH

A saída será assim:

  Listing items under project my-project, location us-west1, repository my-repo, package example.com/foo.

  VERSION  DESCRIPTION  CREATE_TIME          UPDATE_TIME
  v0.1.0                2022-06-03T20:43:39  2022-06-03T20:43:39
  v0.1.1                2022-06-20T20:37:40  2022-06-20T20:37:40

Fazer o download de módulos

Para importar módulos armazenados no Artifact Registry, é necessário instruir o Go a procurar dependências do Artifact Registry e ignorar o banco de dados de soma de verificação.

Configurar o ambiente Go

1. Instrua o Go a fazer o download de módulos do Artifact Registry, do proxy de módulo público do Go e da origem na ordem:

     export GOPROXY=https://LOCATION-go.pkg.dev/PROJECT/REPOSITORY,https://proxy.golang.org,direct
   

   Substitua:

   • LOCATION é o local regional ou multirregional do repositório.
   • PROJECT é o ID do projeto do Google Cloud.
   • REPOSITORY é o nome do repositório em que o pacote está armazenado.

2. Exclua seu módulo da verificação usando o banco de dados público de soma de verificação:

     export GONOSUMDB=MODULE_PATH_REGEX
   

   Substitua MODULE_PATH_REGEX pelo caminho do módulo ou um regex se quiser excluir vários módulos.

   Para impedir que o módulo example.com/foo seja verificado usando o banco de dados público de soma de verificação, execute o seguinte comando:

     export GONOSUMDB=example.com/foo
   

   Se você quiser que todos os módulos com caminhos de módulo que começam em example.com sejam excluídos da verificação usando o banco de dados público de soma de verificação, execute o seguinte comando:

     export GONOSUMDB=example.com/*
   

Autenticar no Artifact Registry

Ao fazer o download de módulos Go empacotados para usar como dependências do Artifact Registry, o binário do Go usa as credenciais no arquivo .netrc para se autenticar no Artifact Registry. Para simplificar o processo de autenticação, use o auxiliar de credenciais do Go para atualizar os tokens no arquivo .netrc para autenticação no Artifact Registry.

O Artifact Registry é compatível com os seguintes métodos de autenticação.

Credenciais de curta duração (recomendado)

Use a ferramenta auxiliar de credencial do Go do Artifact Registry para atualizar os tokens de autenticação no arquivo .netrc.

Usar uma chave de conta de serviço

Use esta opção quando não for possível usar credenciais no seu ambiente para autenticação. Adicione a chave da conta de serviço não criptografada ao arquivo .netrc.

Adicionar o auxiliar de credenciais do Go a GONOPROXY

Antes de usar o auxiliar de credencial do Go, ele precisa ser adicionado à lista de GONOPROXY para forçar o Go a fazer o download dele diretamente no GitHub. Se você tem outros módulos que quer que sejam transferidos por download diretamente da origem, adicione-os em uma lista separada por vírgulas, conforme mostrado neste exemplo:

  export GONOPROXY=MODULE_PATH1, MODULE_PATH2

Em que MODULE_PATH1 e MODULE_PATH2 são caminhos de módulo de módulos para download da origem.

Para adicionar o auxiliar de credenciais do Go à lista GONOPROXY e executá-lo para configurar as credenciais:

1. Adicionar o auxiliar de credenciais do Go ao GONOPROXY

     export GONOPROXY=github.com/GoogleCloudPlatform/artifact-registry-go-tools
   

2. Execute o seguinte comando para adicionar as credenciais do Artifact Registry ao arquivo .netrc com a ferramenta de pacote do módulo Go:

     GOPROXY=proxy.golang.org \
         go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 \
         add-locations --locations=LOCATION \
         [--json_key=path/to/service/account/key.json]
   

   Em que LOCATION é o local regional ou multirregional do seu repositório. Para adicionar vários locais, insira-os como uma lista separada por vírgulas.

   O auxiliar de credenciais do Go adiciona configurações ao arquivo .netrc para autenticação no Artifact Registry. Se você transmitir a sinalização --json_key, a chave será adicionada ao arquivo .netrc para autenticação por senha.

Usar o módulo como dependência

1. Se você estiver usando credenciais de curta duração para autenticar no Artifact Registry, precisará atualizar seu token OAuth executando o seguinte comando:

     GOPROXY=proxy.golang.org \
     go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 refresh
   

2. No diretório principal, crie um diretório chamado "bar"

     mkdir bar
   

3. Mude os diretórios para o diretório do módulo e execute go mod init para criar um arquivo go.mod para seu pacote.

     cd bar \
     go mod init example.com/bar
   

   Substitua example.com/bar pelo caminho do módulo. Consulte a Referência de módulos Go para mais informações.

4. Para exigir a versão do foo armazenada no Artifact Registry, edite o arquivo go.mod para que fique assim:

   
   module example.com/bar
   
   go 1.19
   
   require example.com/foo v0.1.0
   

   Substitua:

   • example.com/foo é o caminho do módulo obrigatório.
   • v0.1.0 é a versão armazenada no Artifact Registry.

5. Crie um arquivo main.go no diretório bar com o seguinte conteúdo:

     
     package main
   
     import (
       "fmt"
   
       foo "example.com/foo"
     )
   
     func main() {
       fmt.Println(foo.HelloWorld)
     }
   
     
   

6. Execute go mod tidy para fazer o download das dependências, incluindo o pacote foo:

     go mod tidy
   

7. Execute o módulo da barra:

     go run .
   

   A saída será assim:

     Hello World!
   

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas. Antes de remover o repositório, verifique se os módulos que você quer manter estão disponíveis em outro local.

1. Para excluir o repositório:

     gcloud artifacts repositories delete \
         --location=LOCATION \
         --project=PROJECT \
         REPOSITORY
   

   Substitua:

   • LOCATION pelo local regional ou multirregional do repositório.
   • PROJECT pelo ID do projeto do Google Cloud.
   • REPOSITORY pelo nome do repositório.

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

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

A seguir

• Saiba mais sobre como configurar a autenticação.
• Saiba mais sobre como gerenciar repositórios.
• Saiba mais sobre como gerenciar módulos Go.
• Leia nossos recursos sobre DevOps e explore o programa de pesquisa Pesquisa e avaliação de DevOps.