Armazene pacotes Java no Artifact Registry

Este início rápido mostra como configurar um repositório Maven do Artifact Registry privado e carregar um pacote para o mesmo.

Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Orientar-me:

Visita guiada

Antes de começar

  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.

    Go to project selector

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

  4. Enable the Artifact Registry API.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  7. Enable the Artifact Registry API.

    Enable the API

    8.

    Inicie o Cloud Shell

    Neste início rápido, vai usar a Cloud Shell, que é um ambiente de shell para gerir recursos alojados no Google Cloud.

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

    Inicie o Cloud Shell:

    1. Aceda à Google Cloud consola.

      Google Cloud consola

    2. Na Google Cloud barra de ferramentas da consola, clique em Ativar Cloud Shell:

    É aberta uma sessão do Cloud Shell num frame na parte inferior da consola. Use esta shell para executar comandos gcloud.

    Crie um repositório de pacotes Java

    Crie o repositório para os seus artefactos Java.

    1. Crie o repositório:

    Consola

    1. Abra a página Repositórios na Google Cloud consola.

      Abra a página Repositórios

    2. Clique em Criar repositório.

    3. Especifique quickstart-java-repo como o nome do repositório.

    4. Escolha Maven como formato e Padrão como modo.

    5. Em Tipo de localização, selecione Região e, de seguida, escolha a localização us-central1.

    6. Clique em Criar.

      O repositório é adicionado à lista de repositórios.

    gcloud

    1. Execute o seguinte comando para criar um novo repositório de pacotes Java no projeto atual denominado quickstart-java-repo na localização us-central1.

      gcloud artifacts repositories create quickstart-java-repo --repository-format=maven \
--location=us-central1 --description="Java package repository"

    2. Execute o seguinte comando para verificar se o repositório foi criado:

      gcloud artifacts repositories list

      Para mais informações sobre os comandos do Artifact Registry, execute o comando gcloud artifacts.

    Configure o Maven

    1. Escolha um projeto Maven simples que queira usar.

      Se não tiver um projeto simples disponível, pode criar o projeto Maven em 5 minutos.

      Este início rápido pressupõe que o seu projeto simples não tem dependências principais ou de plug-ins adicionais armazenadas no Artifact Registry. Para ver detalhes sobre a configuração de um projeto Maven com dependências no Artifact Registry, consulte o artigo Autenticação com um auxiliar de credenciais.

    2. Para simplificar os comandos gcloud, defina o repositório predefinido como quickstart-java-repo e a localização predefinida como us-central1. Depois de definir os valores, não precisa de os especificar em gcloud comandos que requerem um repositório ou uma localização.

      Para definir o repositório, execute o comando:

      gcloud config set artifacts/repository quickstart-java-repo

      Para definir a localização, execute o comando:

      gcloud config set artifacts/location us-central1

      Para mais informações sobre estes comandos, consulte a documentação gcloud config set.

    3. Execute o seguinte comando para imprimir as definições do repositório quickstart-java-repo predefinido.

      gcloud artifacts print-settings mvn

      O resultado do comando gcloud tem o seguinte aspeto: onde PROJECT é o ID do seu 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.5</version>
    </extension>
  </extensions>
</build>

    4. Adicione as definições ao ficheiro pom.xml do seu projeto Maven. O esquema seguinte mostra o posicionamento relativo de cada elemento principal. Consulte a referência POM do Maven para ver detalhes sobre a estrutura do ficheiro.

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

    O seu projeto Maven já pode carregar pacotes para o seu repositório.

    Configure o Gradle

    Crie um projeto Gradle simples para implementar um pacote no repositório do Artifact Registry que criou. Se não tiver uma compilação do Gradle de teste, pode seguir o tutorial introdutório do Gradle para criar uma compilação do Gradle simples.

    Para simplificar os comandos gcloud, defina o repositório predefinido como quickstart-java-repo e a localização predefinida como us-central1. Depois de definir os valores, não precisa de os especificar em gcloud comandos que requerem um repositório ou uma localização.

    Para definir o repositório, execute o comando:

    gcloud config set artifacts/repository quickstart-java-repo

    Para definir a localização, execute o comando:

    gcloud config set artifacts/location us-central1

    Para mais informações sobre estes comandos, consulte a documentação gcloud config set.

    1. Adicione definições para associar o repositório ao ficheiro build.gradle. O comando seguinte imprime as definições a adicionar para o repositório quickstart-java-repo predefinido.

      gcloud artifacts print-settings gradle

      O resultado do comando gcloud tem o seguinte aspeto, em que PROJECT é o ID do seu projeto.

      plugins {
  id "maven-publish"
  id "com.google.cloud.artifactregistry.gradle-plugin" version "2.2.5"
      }

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 ficheiro build.gradle inclui uma secção publications. Se não estiver, adicione-o ao ficheiro build.gradle.

      A secção publications é um elemento secundário de publishing, como mostrado no seguinte 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 pode adicionar a configuração do repositório aos ficheiros init.gradle ou settings. Para ver detalhes acerca destas opções, consulte o artigo Configurar a autenticação.

      Carregue um pacote para o repositório

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

      Para o Gradle, use o comando gradle publish para carregar um pacote para o repositório.

      Veja o pacote no repositório

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

      Consola

      1. Abra a página Repositórios na Google Cloud consola.

        Abra a página Repositórios

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

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

      gcloud

      1. Para apresentar uma lista dos pacotes no repositório quickstart-java-repo, execute o seguinte comando:

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

        O resultado será semelhante ao seguinte:

        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

        Onde PACKAGE é o ID do pacote.

    Limpar

    Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

    Antes de remover o repositório, certifique-se de que todos os pacotes que quer manter estão disponíveis noutra localização.

    Para eliminar o repositório:

    Consola

    1. Abra a página Repositórios na Google Cloud consola.

      Abra a página Repositórios

    2. Na lista de repositórios, selecione o repositório quickstart-java-repo.

    3. Clique em Eliminar.

    gcloud

    1. Para eliminar o repositório quickstart-java-repo, execute o seguinte comando:

      gcloud artifacts repositories delete quickstart-java-repo

    2. Se quiser remover as predefinições do repositório e da localização que configurou para a configuração gcloud ativa, execute os seguintes comandos:

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

    O que se segue?