Construction et Lancement Automatique d'Apps avec GitLab

Cet article vous guidera sur la configuration du pipeline CI/CD avec GitLab.

Préface

Assurez-vous d’avoir d’abord ajouté votre application Capacitor à Capgo, ce tutoriel se concentre uniquement sur la phase de téléchargement. Si vous devez ajouter votre application à Capgo, vous pouvez suivre ce Tutorial.

Convention de commit

Tout d’abord, vous devez commencer à suivre la convention de commit conventional commits qui aidera les outils à comprendre comment augmenter le numéro de version, c’est 5 minutes à apprendre.

GitLab CI/CD pour les Tags

Créez un fichier .gitlab-ci.yml à la racine 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@yourdomain.com” et “GitLab CI/CD” par votre email et nom d’utilisateur GitLab dans la section script. Cette configuration déclenche le job uniquement lors des push sur la branche principale et exclut les commits dont les messages commencent par “chore(release):”.

GitLab CI/CD pour la Construction

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

    stages:
      - deploy

   deploy:
     stage: deploy
     only:
       - tags  # Ce job ne s'exécutera que pour les push de tags
     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  # Définissez ceci dans les paramètres de votre projet GitLab
     environment:
       name: production

Assurez-vous d’avoir ajouté votre clé API Capgo (CAPGO_TOKEN) comme variable CI/CD dans votre projet GitLab. Allez dans votre projet dans GitLab, naviguez vers 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 correspondre au processus de construction spécifique de votre projet, comme la modification de la commande npm run build.

Conclusion

Nous y voilà ! Nous avons franchi une étape 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.