Automatisches Build- und Release-Tool mit GitLab

In diesem Artikel erfahren Sie, wie Sie eine CI/CD-Pipeline mit GitLab einrichten.

Einleitung

Stellen Sie sicher, dass Sie Ihre Capacitor-Anwendung zuerst in Capgo hinzugefügt haben, da diese Anleitung nur auf die Upload-Phase fokussiert ist. Wenn Sie Ihre Anwendung in Capgo hinzufügen möchten, können Sie sich anhand dieses Tutorial.

Commit-Konvention

Zuerst müssen Sie die Commit-Konvention befolgen konventionelle Commits` dies hilft den Werkzeugen dabei, wie sie die Versionsnummer aufschlüsseln sollen, es dauert 5 Minuten, es zu lernen.`

GitLab CI/CD für Tag

Erstellen Sie ein .gitlab-ci.yml-File im Root Ihres GitLab-Repositorys mit dem folgenden Inhalt

 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

Ersetzen Sie "gitlab@yourdomain.com" und "GitLab CI/CD" durch Ihren GitLab-E-Mail-Adresse und Ihren Benutzernamen in der Skript-Sektion. Diese Konfiguration aktiviert die Arbeit nur bei Pushs auf die Hauptzweig und ausschließt Commits mit Nachrichten, die mit "chore(release):" beginnen.

GitLab CI/CD für Build

Fügen Sie einem anderen Abschnitt zu Ihrem .gitlab-ci.yml-File für den Build hinzu:

    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

Stellen Sie sicher, dass Sie Ihren Capgo API-Schlüssel (CAPGO_TOKEN) als CI/CD-Variablen in Ihrem GitLab-Projekt hinzugefügt haben. Gehen Sie zu Ihrem Projekt in GitLab, navigieren Sie zu Einstellungen > CI/CD > Variablen und fügen Sie eine Variable namens CAPGO_TOKEN mit Ihrem API-Schlüsselwert hinzu.

Anpassen Sie das Build-Skript, um es Ihren spezifischen Projekts Build-Prozess anzupassen, wie z.B. das Ändern des npm-Befehls zum Ausführen von Build-Aufgaben.

Zusammenfassung

Hier sind wir! Wir haben einen zusätzlichen Schritt in unserer Technologie-Reise unternommen. In der modernen Softwareentwicklung ist CICD ein entscheidender Faktor, der berücksichtigt werden muss. Ich hoffe, diese Anleitung macht Sinn für alle.