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
- Si le dépôt cible n'existe pas, créez un dépôt.
- Vérifiez que vous disposez des autorisations requises pour le dépôt.
- 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.
- (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
Ouvrez la page Dépôts dans Google Cloud Console.
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.
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
Ouvrez la page Dépôts dans Google Cloud Console.
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.
Sélectionnez le package que vous souhaitez supprimer.
Cliquez sur SUPPRIMER.
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
Ouvrez la page Dépôts dans Google Cloud Console.
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.
Cliquez sur un package pour afficher ses versions.
Sélectionnez les versions que vous souhaitez supprimer.
Cliquez sur SUPPRIMER.
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
- En savoir plus sur la gestion des packages npm
- En savoir plus sur la gestion des images de conteneurs