Configurer CI/CD pour votre application Java
Prérequis
Terminez les sections précédentes de ce guide, en commençant par Conteneuriser votre application. Vous devez avoir un compte GitHub et un compte Docker pour terminer cette section.
Aperçu
Dans cette section, vous apprendrez à configurer et à utiliser GitHub Actions pour construire et pousser votre image Docker sur Docker Hub. Vous effectuerez les étapes suivantes :
- Créer un nouveau dépôt sur GitHub.
- Définir le flux de travail GitHub Actions.
- Exécuter le flux de travail.
Étape 1 : Créer le dépôt
Créez un dépôt GitHub, configurez les informations d'identification de Docker Hub et poussez votre code source.
-
Créez un nouveau dépôt sur GitHub.
-
Ouvrez les Paramètres du dépôt, et allez à Secrets et variables > Actions.
-
Créez une nouvelle Variable de dépôt nommée
DOCKER_USERNAME
avec votre ID Docker comme valeur. -
Créez un nouveau Jeton d'accès personnel (PAT) pour Docker Hub. Vous pouvez nommer ce jeton
docker-tutorial
. Assurez-vous que les autorisations d'accès incluent la lecture et l'écriture. -
Ajoutez le PAT en tant que Secret de dépôt dans votre dépôt GitHub, avec le nom
DOCKERHUB_TOKEN
. -
Dans votre dépôt local sur votre machine, exécutez la commande suivante pour changer l'origine vers le dépôt que vous venez de créer. Assurez-vous de changer
votre-nom-d-utilisateur
par votre nom d'utilisateur GitHub etvotre-dépôt
par le nom du dépôt que vous avez créé.$ git remote set-url origin https://github.com/votre-nom-d-utilisateur/votre-dépôt.git
-
Exécutez les commandes suivantes pour mettre en scène, valider et pousser votre dépôt local vers GitHub.
$ git add -A $ git commit -m "mon commit" $ git push -u origin main
Étape 2 : Configurer le flux de travail
Configurez votre flux de travail GitHub Actions pour construire, tester et pousser l'image vers Docker Hub.
-
Allez sur votre dépôt sur GitHub, puis sélectionnez l'onglet Actions. Le projet a déjà le flux de travail
maven-build
pour construire et tester votre application Java avec Maven. Si vous le souhaitez, vous pouvez éventuellement désactiver ce flux de travail car vous ne l'utiliserez pas dans ce guide. Vous allez créer un nouveau flux de travail alternatif pour construire, tester et pousser votre image. -
Sélectionnez Nouveau flux de travail.
-
Sélectionnez Configurer un flux de travail vous-même.
Cela vous amène à une page pour créer un nouveau fichier de flux de travail GitHub Actions dans votre dépôt, sous
.github/workflows/main.yml
par défaut. -
Dans la fenêtre de l'éditeur, copiez et collez la configuration YAML suivante.
name: ci on: push: branches: - main jobs: build: runs-on: ubuntu-latest steps: - name: Connexion à Docker Hub uses: docker/login-action@v3 with: username: ${{ vars.DOCKER_USERNAME }} password: ${{ secrets.DOCKERHUB_TOKEN }} - name: Configurer Docker Buildx uses: docker/setup-buildx-action@v3 - name: Construire et tester uses: docker/build-push-action@v6 with: target: test load: true - name: Construire et pousser uses: docker/build-push-action@v6 with: platforms: linux/amd64,linux/arm64 push: true target: final tags: ${{ vars.DOCKER_USERNAME }}/${{ github.event.repository.name }}:latest
Pour plus d'informations sur la syntaxe YAML pour
docker/build-push-action
, référez-vous au README de l'action GitHub.
Étape 3 : Exécuter le flux de travail
Enregistrez le fichier de flux de travail et exécutez la tâche.
-
Sélectionnez Valider les modifications... et poussez les modifications vers la branche
main
.Après avoir poussé le commit, le flux de travail démarre automatiquement.
-
Allez à l'onglet Actions. Il affiche le flux de travail.
La sélection du flux de travail vous montre le détail de toutes les étapes.
-
Lorsque le flux de travail est terminé, allez à vos dépôts sur Docker Hub.
Si vous voyez le nouveau dépôt dans cette liste, cela signifie que GitHub Actions a poussé l'image avec succès sur Docker Hub.
Résumé
Dans cette section, vous avez appris à configurer un flux de travail GitHub Actions pour votre application.
Informations connexes :
- Introduction à GitHub Actions
- Actions GitHub de construction Docker
- Syntaxe du flux de travail pour GitHub Actions
Prochaines étapes
Ensuite, apprenez comment vous pouvez tester et déboguer localement vos charges de travail sur Kubernetes avant de les déployer.