Armazenar pacotes Java no Artifact Registry

Iniciar o Cloud Shell

O Cloud Shell vem pré-instalado com o Google Cloud CLI e Java. A CLI gcloud fornece a linha de comando principal para o Google Cloud.

Inicie o Cloud Shell

1. Acesse o Console do Google Cloud.

   Console do Google Cloud

2. Na barra de ferramentas do console do Google Cloud, clique em Ativar o Cloud Shell:

Uma sessão do Cloud Shell é aberta dentro de um quadro inferior no console. Use esse shell para executar comandos gcloud.

Criar um repositório de pacotes Java

1. Crie o repositório:

Configure o Maven

1. Escolha um projeto Maven simples que você queira usar.

   Se você não tiver um projeto simples disponível, crie o Maven em 5 minutos.

   Este guia de início rápido pressupõe que seu projeto simples não tenha dependências parentais ou de plug-ins adicionais armazenadas no Artifact Registry. Para saber mais sobre como configurar um projeto Maven com dependências no Artifact Registry, consulte Como autenticar com um auxiliar de credenciais.

2. Para simplificar os comandos gcloud, defina o repositório padrão como quickstart-java-repo e o local padrão como us-central1. Depois que os valores forem definidos, não será necessário especificá-los nos comandos gcloud que exigem um repositório ou local.

   Para definir o repositório, execute o comando:

   gcloud config set artifacts/repository quickstart-java-repo
   

   Para definir o local, execute o comando:

   gcloud config set artifacts/location us-central1
   

   Saiba mais sobre esses comandos na documentação do gcloud config set.

3. Execute o comando a seguir para imprimir as configurações do repositório padrão quickstart-java-repo.

   gcloud artifacts print-settings mvn
   

   A saída do comando gcloud é semelhante ao snippet a seguir, em que PROJECT é o ID do projeto.

   <distributionManagement>
     <snapshotRepository>
       <id>artifact-registry</id>
       <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
     </snapshotRepository>
     <repository>
       <id>artifact-registry</id>
       <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
     </repository>
   </distributionManagement>
   
   <repositories>
     <repository>
       <id>artifact-registry</id>
       <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>true</enabled>
       </snapshots>
     </repository>
   </repositories>
   
   <build>
     <extensions>
       <extension>
         <groupId>com.google.cloud.artifactregistry</groupId>
         <artifactId>artifactregistry-maven-wagon</artifactId>
         <version>2.2.3</version>
       </extension>
     </extensions>
   </build>
   

4. Adicione as configurações ao arquivo pom.xml do seu projeto do Maven. O esboço a seguir mostra a colocação relativa de cada elemento principal. Consulte a referência do POM do Maven para saber mais sobre a estrutura do arquivo.

   <project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                         http://maven.apache.org/xsd/maven-4.0.0.xsd">
   
     <!-- Build Settings -->
     <build>
       ...
       <extensions>...</extensions>
     </build>
   
     <!-- Environment Settings -->
     <repositories>...</repositories>
     <distributionManagement>...</distributionManagement>
   </project>
   

Agora o projeto Maven pode fazer upload de pacotes para o repositório.

Configurar o Gradle

Para simplificar os comandos gcloud, defina o repositório padrão como quickstart-java-repo e o local padrão como us-central1. Depois que os valores forem definidos, não será necessário especificá-los nos comandos gcloud que exigem um repositório ou local.

Para definir o repositório, execute o comando:

gcloud config set artifacts/repository quickstart-java-repo

Para definir o local, execute o comando:

gcloud config set artifacts/location us-central1

Saiba mais sobre esses comandos na documentação do gcloud config set.

1. Adicione configurações para conectar o repositório ao arquivo build.gradle. O comando a seguir imprime configurações para adicionar ao repositório quickstart-java-repo padrão.

   gcloud artifacts print-settings gradle
   

   A saída do comando gcloud é semelhante ao exemplo a seguir, em que PROJECT é o ID do projeto.

   plugins {
     id "maven-publish"
     id "com.google.cloud.artifactregistry.gradle-plugin" version "2.2.3"
         }
   
   publishing {
     repositories {
       maven {
         url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
       }
     }
   }
   
   repositories {
     maven {
       url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
     }
   }
   

2. Verifique se o arquivo build.gradle inclui uma publicações. nesta seção. Se não houver, adicione a seção ao arquivo build.gradle.

   A seção publications é filha de publishing, conforme mostrado neste exemplo:

   publishing {
     publications {
          mavenJava(MavenPublication) {
             groupId  'maven.example.id'
             from components.java
          }
     }
     repositories {
       maven {
         url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
       }
     }
   }
   

   Também é possível adicionar a configuração do repositório aos arquivos init.gradle ou settings. Para detalhes sobre essas opções, consulte Como configurar a autenticação.

   Faça upload de um pacote para o repositório

   Para o Maven, use mvn deploy e mvn release para adicionar pacotes ao repositório.

   Para Gradle, use o comando gradle publish para fazer upload de um pacote para o repositório.

   Veja o pacote no repositório

   Para verificar se o pacote foi adicionado ao repositório:

   Console

   1. Abra a página Repositórios no console do Google Cloud.

      Abrir a página Repositórios

   2. Na lista de repositórios, clique no repositório quickstart-java-repo.

      A página Pacotes lista os pacotes no repositório.

   gcloud

   1. Para listar os pacotes do repositório quickstart-java-repo, execute o seguinte comando:

      gcloud artifacts packages list --repository=quickstart-java-repo
      

      A saída será semelhante a esta:

      Listing items under project <project-id>, location us-central1,\
      repository quickstart-java-repo.
      
      PACKAGE: maven.example.id:gradle-demo
      CREATE_TIME: 2022-01-20T22:46:07
      UPDATE_TIME: 2022-01-20T22:46:07
      

      Em que maven.example.id:gradle-demo é o ID do pacote.

      Para ver as versões de um pacote, execute o seguinte comando:

      gcloud artifacts versions list --package=PACKAGE
      

      Em que PACKAGE é o ID do pacote.