Build et release automatiques de l'app avec GitLab

Cet article vous guidera pour configurer votre 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 d'upload. Si vous devez ajouter votre application à Capgo, vous pouvez suivre ce guide Tutoriel.

Convention de commit

Tout d'abord, vous devez commencer à suivre la convention de commit commits conventionnels` cela aidera les outils à comprendre comment incrémenter le numéro de version ; cela s'apprend en 5 min.

GitLab CI/CD pour le Tag

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 e-mail et nom d'utilisateur GitLab dans la section script. Cette configuration déclenche le job uniquement lors des pushs sur la branche main et exclut les commits dont le message commence par « chore(release): ».

GitLab CI/CD pour le Build

Ajoutez une autre étape à votre fichier .gitlab-ci.yml pour le 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 GitLab, puis dans Settings > CI/CD > Variables, et ajoutez une variable nommée CAPGO_TOKEN avec votre clé API.

Personnalisez le script de build pour l'adapter au processus de build de votre projet, par exemple en modifiant la commande npm run build.

Conclusion

Nous y voilà ! Nous venons de franchir une étape supplémentaire dans notre parcours technique. Dans le développement logiciel moderne, la CI/CD est un facteur essentiel à prendre en compte. J'espère que ce guide sera utile à tout le monde.

Continuer avec Automatic build and release app with GitLab

Si vous utilisez Build et release automatiques de l'app avec GitLab pour planifier l'automatisation CI/CD, et le connecter avec CI/CD Capgo pour le workflow produit dans le CI/CD de Capgo, Capgo Native Build pour le workflow produit dans les Native Builds de Capgo, Intégrations Capgo pour le workflow produit dans les intégrations de Capgo, Intégration CI/CD pour le détail d'implémentation dans l'intégration CI/CD, et Intégration GitHub Actions pour les détails d'implémentation de l'intégration GitHub Actions.