Application de build et de déploiement automatique avec GitLab

Cet article vous guidera sur la mise en place de la configuration de la pipeline d'intégration/déploiement continu avec GitLab.

Avant-propos

Assurez-vous d'avoir ajouté votre application Capacitor en premier lieu à Capgo, cet article se concentre uniquement sur la phase d'upload. Si vous avez besoin d'ajouter votre application à Capgo, vous pouvez suivre ce Guide de tutoriel.

Convention de commit

Tout d'abord, vous devez commencer à suivre la convention de commit commits conventionnelsCela aidera les outils à comprendre comment mettre à jour le numéro de version, ce sera de 5 minutes à apprendre.

GitLab CI/CD pour Tag

Créez un fichier .gitlab-ci.yml dans le répertoire root de votre dépôt GitLab avec le contenu suivant

 stages:
      - tag

 bump_version:
   stage: tag
   only:
     - main
  except:
    variables:
  - $CI_COMMIT_MESSAGE =~ /^chore\(release\):/
  script:
   - git config --global user.email "gitlab@yourdomain.com"
   - git config --global user.name "GitLab CI/CD"
   - git checkout $CI_COMMIT_REF_NAME
   - git pull origin $CI_COMMIT_REF_NAME
   - npx capacitor-standard-version
   - git push origin $CI_COMMIT_REF_NAME --tags

Remplacez « gitlab@votre domaine.com» et « GitLab CI/CD » par votre adresse e-mail et votre nom d'utilisateur GitLab dans la section de script. Cette configuration déclenche uniquement la tâche lors des push vers la branche principale et exclut les commits dont les messages commencent par « chore(release): ».

GitLab CI/CD pour Build

Ajoutez une autre étape à votre fichier .gitlab-ci.yml pour la build :

    stages:
      - deploy

   deploy:
     stage: deploy
     only:
       - tags  # This job will only run for tag pushes
     script:
       - apt-get update -qy && apt-get install -y nodejs npm
       - npm install -g @capgo/cli
       - npm ci
       - npm run build
       - npx @capgo/cli bundle upload -a $CAPGO_TOKEN -c production
     variables:
       FIREBASE_CONFIG: $FIREBASE_CONFIG  # Define this in your GitLab project settings
     environment:
       name: production

Assurez-vous d'avoir ajouté votre clé Capgo API (CAPGO_TOKEN) en tant que variable CI/CD dans votre projet GitLab. Allez dans votre projet sur GitLab, naviguez jusqu'à Paramètres > CI/CD > Variables, et ajoutez une variable nommée CAPGO_TOKEN avec la valeur de votre clé API.

Personnalisez le script de construction pour qu'il corresponde au processus de construction spécifique de votre projet, comme la modification de la commande de construction npm.

Conclusion

Voilà ! Nous avons fait un pas supplémentaire dans notre parcours technologique. Dans le développement logiciel moderne, le CICD est un facteur essentiel à prendre en compte. J'espère donc que ce guide est compréhensible pour tout le monde.