Cette page a été traduite par l'API Cloud Translation.
Switch to English

Gérer les packages Maven

Cette page décrit comment ajouter, afficher et supprimer des packages Java et des versions de packages.

La gestion des packages est disponible en version alpha. Elle n'est disponible que pour les utilisateurs alpha et peut ne pas inclure toutes les fonctionnalités disponibles pour la gestion des conteneurs. Pour demander à participer à la version alpha, remplissez le formulaire d'inscription.

Avant de commencer

  1. Si le dépôt cible n'existe pas, créez un dépôt.
  2. Vérifiez que vous disposez des autorisations requises pour le dépôt.
  3. Vérifiez que vous avez configuré l'authentification. Si vous utilisez un jeton d'accès, veillez à l'actualiser avant de vous connecter au dépôt.
  4. (Facultatif) Configurez des valeurs par défaut pour les commandes gcloud.

Ajouter des packages

Pour ajouter des packages au dépôt :

Maven

Utilisez mvn deploy et mvn release pour ajouter des packages au dépôt.

Pour déployer un projet Maven qui référence un parent, le projet doit inclure le fournisseur de wagon Artifact Registry dans un fichier d'extensions de base, comme décrit dans les instructions d'authentification.

Utilisez mvn deploy:deploy-file pour importer des artefacts compilés en dehors de Maven.

Par exemple, cet exemple de commande déploie example/external.jar et son fichier de projet example/pom.xml dans le dépôt us-central1-maven.pkg.dev/my-project/my-repo.

mvn deploy:deploy-file \
-Durl=artifactregistry://us-central1-maven.pkg.dev/my-project/my-repo \
-DpomFile=example/pom.xml -Dfile=example/external.jar

Pour configurer l'intégration avec Cloud Build, consultez la page Intégrer à Cloud Build.

Gradle

Pour réussir la publication dans le dépôt, votre fichier build.gradle doit inclure une section publications définissant les fichiers à importer.

Utilisez la commande gradle publish pour importer un package dans le dépôt.

Afficher des packages et des versions

Pour afficher les packages et les versions de package à l'aide de Google Cloud Console ou de gcloud, procédez comme suit:

Console

  1. Ouvrez la page Dépôts dans Google Cloud Console.

    Ouvrir la page "Dépôts"

  2. Dans la liste des dépôts, cliquez sur le dépôt approprié.

    La page Packages répertorie les packages du dépôt.

  3. Cliquez sur un package pour afficher ses versions.

gcloud

Pour répertorier les packages d'un dépôt, exécutez la commande suivante :

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Où :

  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.
  • LOCATION est un emplacement régional ou multirégional. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.

Pour afficher les versions d'un package, exécutez la commande suivante :

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Où :

  • PACKAGE est l'ID du package ou l'identifiant complet du package.
  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
  • LOCATION est un emplacement régional ou multirégional. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.

Certains packages peuvent inclure plusieurs fichiers WAR ou JAR. Pour répertorier tous les fichiers d'un dépôt, exécutez la commande suivante :

gcloud auth login
curl -v -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-GFE-SSL: yes" \
https://artifactregistry.googleapis.com/v1beta2/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files

Remplacez les valeurs suivantes :

  • PROJECT est l'ID de projet.
  • LOCATION est un emplacement régional ou multirégional. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.
  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.

Supprimer des packages et des versions

Pour supprimer un package, procédez comme suit :

Console

  1. Ouvrez la page Dépôts dans Google Cloud Console.

    Ouvrir la page "Dépôts"

  2. Dans la liste des dépôts, cliquez sur le dépôt approprié.

    La page Packages répertorie les packages du dépôt.

  3. Sélectionnez le package que vous souhaitez supprimer.

  4. Cliquez sur SUPPRIMER.

  5. Dans la boîte de dialogue de confirmation, cliquez sur SUPPRIMER.

gcloud

Exécutez la commande suivante :

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Où :

  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
  • LOCATION est un emplacement régional ou multirégional. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.
  • --async renvoie immédiatement une réponse, sans attendre la fin de l'opération en cours.

Pour supprimer des versions d'un package, procédez comme suit :

Console

  1. Ouvrez la page Dépôts dans Google Cloud Console.

    Ouvrir la page "Dépôts"

  2. Dans la liste des dépôts, cliquez sur le dépôt approprié.

    La page Packages répertorie les packages du dépôt.

  3. Cliquez sur un package pour afficher ses versions.

  4. Sélectionnez les versions que vous souhaitez supprimer.

  5. Cliquez sur SUPPRIMER.

  6. Dans la boîte de dialogue de confirmation, cliquez sur SUPPRIMER.

gcloud

Exécutez la commande suivante :

gcloud artifacts versions delete VERSION \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Où :

  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
  • LOCATION est un emplacement régional ou multirégional. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.
  • --async renvoie immédiatement le résultat, sans attendre la fin de l'opération en cours.

Télécharger des packages

Pour télécharger un artefact dans le cadre de votre compilation, vous devez le déclarer comme une dépendance.

Maven

Déclarez les packages que vous souhaitez télécharger dans le fichier de projet pom.xml. L'exemple suivant déclare la version 1.0 du package artifact en tant que dépendance.

<dependencies>
    <dependency>
        <groupId>group</groupId>
        <artifactId>artifact</artifactId>
        <version>1.0</version>
    </dependency>
<dependencies>

Pour en savoir plus sur les dépendances Maven, consultez l'introduction aux dépendances de Maven et la documentation de référence sur les dépendances.

Gradle

Déclarez les packages que vous souhaitez télécharger dans le fichier de projet build.gradle. L'exemple suivant déclare la version 1.0 du package artifact en tant que dépendance de compilation externe.

Pour en savoir plus sur les dépendances Gradle, consultez la documentation Gradle.

dependencies {
    compile group: 'group', name: 'artifact', version: '1.0'
}

Étape suivante