Application de build et de mise en production automatique avec GitLab

Cet article vous guidera sur la mise en place de la configuration de pipeline CI/CD 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 conventionnels ` cela aidera les outils à comprendre comment mettre à jour le numéro de version, c'est 5 min à apprendre.

GitLab CI/CD pour Tag

Créez un fichier .gitlab-ci.yml dans le répertoire 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@votre-domaine.com » et « GitLab CI/CD » par votre adresse e-mail et votre nom d'utilisateur GitLab dans la section script. Cette configuration déclenche uniquement la tâche lors des push vers la branche principale et exclut les commits avec des messages commençant 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 de 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 correspondre au processus de construction spécifique de votre projet, tel que 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 a du sens pour tout le monde.

Continuez de la section suivante : Application de build et de release automatique avec GitLab

Si vous utilisez Application de build et de release automatique avec GitLab pour planifier l'automatisation du CICD, connectez-la à Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Builds natifs pour le flux de travail du produit dans Capgo Builds natifs Intégrations Capgo pour le flux de travail du produit dans les Intégrations Capgo Intégration CI/CD pour le détail d'implémentation dans l'Intégration CI/CD Intégration d'actions GitHub pour le détail d'implémentation dans l'Intégration d'actions GitHub