Stocker des packages Java dans Artifact Registry

Ce guide de démarrage rapide explique comment configurer un dépôt Maven Artifact Registry privé et y importer un package.

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud, cliquez sur Visite guidée :

Visite guidée

Avant de commencer

Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

Accéder au sélecteur de projet

Vérifiez que la facturation est activée pour votre projet Google Cloud.

Activez l'API Artifact Registry

Activer l'API

Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

Accéder au sélecteur de projet

Vérifiez que la facturation est activée pour votre projet Google Cloud.

Activez l'API Artifact Registry

Activer l'API

Lancer Cloud Shell

Dans ce guide de démarrage rapide, vous allez utiliser Cloud Shell, un environnement shell permettant de gérer les ressources hébergées sur Google Cloud.

Cloud Shell est préinstallé avec Google Cloud CLI et Java. gcloud CLI fournit l'interface de ligne de commande principale pour Google Cloud.

Lancez Cloud Shell :

Accédez à Google Cloud Console.

Google Cloud Console
Dans la barre d'outils de la console Google Cloud, cliquez sur Activer Cloud Shell:

Une session Cloud Shell s'ouvre dans un cadre situé en bas de la console. Cette interface système vous permet d'exécuter les commandes gcloud.

Créer un dépôt de packages Java

Créez le dépôt pour vos artefacts Java.

Créez le dépôt :

Console

Ouvrez la page Dépôts de la console Google Cloud.

Ouvrir la page "Dépôts"
Cliquez sur Créer un dépôt.
Spécifiez quickstart-java-repo comme nom de dépôt.
Sélectionnez le format Maven et le mode Standard.
Sous Type d'emplacement, sélectionnez Région, puis l'emplacement us-central1.
Cliquez sur Créer.

Le dépôt est ajouté à la liste des dépôts.

gcloud

Exécutez la commande suivante pour créer un dépôt de packages Java dans le projet actuel quickstart-java-repo à l'emplacement us-central1.

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

Exécutez la commande suivante pour vérifier que votre dépôt a bien été créé :
```
gcloud artifacts repositories list
```
Exécutez la commande gcloud artifacts pour obtenir plus d'informations sur les commandes Artifact Registry.

Configurer Maven

Choisissez un projet Maven simple que vous souhaitez utiliser.

Si vous n'avez pas de projet simple disponible, vous pouvez créer le projet Maven en 5 minutes.

Dans ce guide de démarrage rapide, nous partons du principe que votre projet simple ne comporte pas de dépendances parents ou de plug-in supplémentaires stockées dans Artifact Registry. Pour en savoir plus sur la configuration d'un projet Maven avec des dépendances dans Artifact Registry, consultez la section S'authentifier avec un assistant d'identification.
Pour simplifier les commandes gcloud, définissez le dépôt par défaut sur quickstart-java-repo et l'emplacement par défaut sur us-central1. Une fois les valeurs définies, vous n'avez pas besoin de les spécifier dans les commandes gcloud nécessitant un dépôt ou un emplacement.

Pour définir le dépôt, exécutez la commande suivante :
```
gcloud config set artifacts/repository quickstart-java-repo
```
Pour définir l'emplacement, exécutez la commande suivante :
```
gcloud config set artifacts/location us-central1
```
Pour plus d'informations sur ces commandes, consultez la documentation gcloud config set.

Exécutez la commande suivante pour imprimer les paramètres du dépôt quickstart-java-repo par défaut.

gcloud artifacts print-settings mvn

La sortie de la commande gcloud ressemble à l'extrait suivant, où PROJECT est l'ID de votre projet.

<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.1</version>
    </extension>
  </extensions>
</build>

Ajoutez les paramètres au fichier pom.xml pour votre projet Maven. La structure suivante montre le positionnement relatif de chaque élément principal. Reportez-vous à la documentation de référence POM de Maven pour plus de détails sur la structure du fichier.

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

Votre projet Maven peut maintenant importer des packages dans votre dépôt.

Configurer Gradle

Créez un projet Gradle simple pour déployer un package dans le dépôt Artifact Registry que vous avez créé. Si vous n'avez pas de build Gradle de test, vous pouvez suivre le tutoriel Gradle d'introduction pour créer un build Gradle simple.

Pour simplifier les commandes gcloud, définissez le dépôt par défaut sur quickstart-java-repo et l'emplacement par défaut sur us-central1. Une fois les valeurs définies, vous n'avez pas besoin de les spécifier dans les commandes gcloud nécessitant un dépôt ou un emplacement.

Pour définir le dépôt, exécutez la commande suivante :

gcloud config set artifacts/repository quickstart-java-repo

Pour définir l'emplacement, exécutez la commande suivante :

gcloud config set artifacts/location us-central1

Pour plus d'informations sur ces commandes, consultez la documentation gcloud config set.

Ajoutez les paramètres pour connecter le dépôt au fichier build.gradle. La commande suivante affiche les paramètres à ajouter pour le dépôt par défaut quickstart-java-repo.

gcloud artifacts print-settings gradle

La sortie de la commande gcloud ressemble à l'exemple suivant, où PROJECT est l'ID de votre projet.

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

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

Vérifiez que le fichier build.gradle inclut une section dédiée aux publications. Si ce n'est pas le cas, ajoutez-la à votre fichier build.gradle.

La section publications est un enfant de publishing, comme illustré dans l'exemple suivant:
```
publishing {
  publications {
       mavenJava(MavenPublication) {
          groupId  'maven.example.id'
          from components.java
       }
  }
  repositories {
    maven {
      url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-java-repo"
    }
  }
}
```
Vous pouvez également ajouter la configuration du dépôt à vos fichiers init.gradle ou settings. Pour en savoir plus sur ces options, consultez la page Configurer l'authentification.

Importer un package dans le dépôt

Pour Maven, vous pouvez utiliser mvn deploy et mvn release pour ajouter des packages au dépôt.

Remarque :La commande mvn archetype n'est pas compatible si elle est utilisée exclusivement à partir du dépôt Artifact Registry.

Pour Gradle, exécutez la commande gradle publish pour importer un package dans le dépôt.
Afficher le package dans le dépôt
Pour vérifier que votre package a bien été ajouté au dépôt :
Console
1. Ouvrez la page Dépôts de la console Google Cloud.
  
  Ouvrir la page "Dépôts"
2. Dans la liste des dépôts, cliquez sur le dépôt quickstart-java-repo.
  
  La page Packages répertorie les packages du dépôt.
gcloud
1. Pour lister les packages dans le dépôt quickstart-java-repo, exécutez la commande suivante :
```
gcloud artifacts packages list --repository=quickstart-java-repo
```
  Le résultat doit ressembler à ce qui suit :
```
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
```
  où maven.example.id:gradle-demo correspond à l'ID de package.
  
  Pour afficher les versions d'un package, exécutez la commande suivante :
```
gcloud artifacts versions list --package=PACKAGE
```
  Où PACKAGE correspond à l'ID de package.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

Avant de supprimer le dépôt, assurez-vous que tous les packages que vous souhaitez conserver sont disponibles à un autre emplacement.

Pour supprimer le dépôt :

Console

Ouvrez la page Dépôts de la console Google Cloud.

Ouvrir la page "Dépôts"
Dans la liste des dépôts, sélectionnez le dépôt quickstart-java-repo.
Cliquez sur Supprimer.

gcloud

Pour supprimer le dépôt quickstart-java-repo, exécutez la commande suivante :
```
gcloud artifacts repositories delete quickstart-java-repo
```
Si vous souhaitez supprimer le dépôt par défaut et les paramètres d'emplacement que vous avez définis pour la configuration gcloud active, exécutez les commandes suivantes :
```
gcloud config unset artifacts/repository
gcloud config unset artifacts/location
```

Étapes suivantes

En savoir plus sur la configuration de l'authentification
En savoir plus sur la gestion des dépôts
En savoir plus sur la gestion des packages
Consultez nos ressources sur le DevOps et découvrez notre programme de recherche.

Stocker des packages Java dans Artifact Registry

Avant de commencer

Lancer Cloud Shell

Créer un dépôt de packages Java

Console

gcloud

Configurer Maven

Configurer Gradle

Importer un package dans le dépôt

Afficher le package dans le dépôt

Console

gcloud

Effectuer un nettoyage

Console

gcloud

Étapes suivantes