Cette page explique comment utiliser Cloud Build pour créer et tester des applications Java, stocker des artefacts créés dans un dépôt Maven dans Artifact Registry et générer des informations de provenance de compilation.
Avant de commencer
- Familiarisez-vous avec la création d'applications Java.
- Familiarisez-vous avec Maven.
- Préparez votre projet Java.
- Familiarisez-vous avec la rédaction d'un fichier de configuration Cloud Build.
- disposer d'un dépôt Maven dans Artifact Registry ; Si vous n'en avez pas, créez un dépôt.
- Pour exécuter les commandes
gcloud
de cette page, installez Google Cloud CLI.
Utiliser l'image maven
Vous pouvez configurer Cloud Build pour compiler des applications Java à l'aide de l'image maven
de Docker Hub.
Pour exécuter vos tâches dans l'image maven
, spécifiez l'URL de l'image et sa version avec tags dans le champ name
de votre fichier de configuration de compilation. Si vous ne spécifiez pas le tag de l'image, Cloud Build utilise l'image latest
par défaut. Cloud Build démarre l'image spécifiée dans name
en utilisant le point d'entrée par défaut de l'image. Pour ignorer le point d'entrée par défaut et appeler maven
comme point d'entrée, spécifiez mvn
dans le champ entrypoint
.
Le fichier de configuration de compilation suivant spécifie le entrypoint
pour l'image maven
et affiche la version de l'outil de compilation:
steps:
- name: maven:3.3-jdk-8
entrypoint: mvn
args: ['--version']
Configurer les compilations Java
Dans le répertoire racine de votre projet, créez un fichier de configuration de compilation nommé
cloudbuild.yaml
.Exécuter des tests:
maven
fournitmaven test
, qui télécharge les dépendances, crée les applications et exécute tous les tests spécifiés dans votre code source. Le champargs
d'une étape de compilation prend une liste d'arguments et la transmet à l'image à laquelle le champname
fait référence.Dans votre fichier de configuration de compilation, ajoutez
test
au champargs
pour appelertest
dansmaven
:steps: - name: maven:3.3-jdk-8 entrypoint: mvn args: ['test']
Empaqueter l'application : pour empaqueter votre application dans un fichier JAR pour votre image
maven
, spécifiez la commandepackage
dans le champargs
. La commandepackage
génère un fichier JAR dans/workspace/target/
.L'étape de compilation suivante permet d'empaqueter votre application Java :
steps: - name: maven:3.3-jdk-8 entrypoint: mvn args: ['package','-Dmaven.test.skip=true']
Importer dans Artifact Registry:
Dans votre fichier de configuration de compilation, utilisez le champ
mavenArtifacts
pour spécifier le chemin d'accès à votre application et votre dépôt Maven dans Artifact Registry:artifacts: mavenArtifacts: - repository: 'https://location-maven.pkg.dev/project-id/repository-name' path: 'app-path' artifactId: 'build-artifact' groupId: 'group-id' version: 'version'
Remplacez les valeurs suivantes :
- location: emplacement de votre dépôt dans Artifact Registry.
- project-id: ID du projet Google Cloud contenant votre dépôt Artifact Registry.
- repository-name: nom de votre dépôt Maven dans Artifact Registry.
- app-path: chemin d'accès à l'application empaquetée.
- build-artifact: nom du fichier de package créé à partir de l'étape de compilation.
- group-id: identifie votre projet de manière unique parmi tous les projets Maven, au format
com.mycompany.app
. Pour en savoir plus, consultez le guide Maven sur les conventions d'attribution de noms. - version: numéro de version de votre application, formaté en chiffres et en points (
1.0.1
, par exemple).
Facultatif: Activer la génération de la provenance
Cloud Build peut générer des métadonnées de certification de compilation SLSA (Supply chain Levels for Software Artifacts (SLSA)) vérifiables pour vous aider à sécuriser votre pipeline d'intégration continue.
Pour activer la génération de la provenance, ajoutez
requestedVerifyOption: VERIFIED
à la sectionoptions
du fichier de configuration.Démarrez votre compilation: manuellement ou à l'aide de déclencheurs de compilation.
Une fois la compilation terminée, vous pouvez afficher les détails du dépôt dans Artifact Registry.
Vous pouvez également afficher les métadonnées de provenance des compilations et en valider la provenance.
Étapes suivantes
- Découvrez comment afficher les résultats de la compilation.
- Découvrez comment protéger les builds.
- Découvrez comment effectuer des déploiements bleu-vert sur Compute Engine.
- Découvrez comment créer et conteneuriser des applications Java.
- Découvrez comment déployer une application sur Cloud Run.
- Découvrez comment déployer une application sur GKE.
- Découvrez comment résoudre les erreurs de compilation.