Dieser Artikel wird Sie durch die Einrichtung einer CI/CD-Pipeline mit GitLab führen.
Vorwort
Stellen Sie sicher, dass Sie Ihre Capacitor-App zuerst zu Capgo hinzugefügt haben. Dieses Tutorial konzentriert sich nur auf die Upload-Phase. Wenn Sie Ihre App zu Capgo hinzufügen müssen, können Sie diesem Tutorial folgen.
Commit-Konvention
Zunächst müssen Sie damit beginnen, der Commit-Konvention conventional commits zu folgen. Dies wird dem Tooling helfen zu verstehen, wie die Versionsnummer erhöht werden soll. Es dauert nur 5 Minuten, es zu erlernen.
GitLab CI/CD für Tags
Erstellen Sie eine .gitlab-ci.yml-Datei im Hauptverzeichnis Ihres GitLab-Repositorys mit folgendem 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” im Skriptabschnitt durch Ihre GitLab-E-Mail und Ihren Benutzernamen. Diese Konfiguration löst den Job nur bei Pushes zum Hauptzweig aus und schließt Commits mit Nachrichten, die mit “chore(release):” beginnen, aus.
GitLab CI/CD für Build
Fügen Sie Ihrer .gitlab-ci.yml-Datei eine weitere Stufe für den Build hinzu:
stages: - deploy
deploy: stage: deploy only: - tags # Dieser Job wird nur für Tag-Pushes ausgeführt 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 # Definieren Sie dies in Ihren GitLab-Projekteinstellungen environment: name: production
Stellen Sie sicher, dass Sie Ihren Capgo API-Schlüssel (CAPGO_TOKEN) als CI/CD-Variable 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.
Passen Sie das Build-Skript an den spezifischen Build-Prozess Ihres Projekts an, z.B. durch Ändern des npm run build Befehls.
Fazit
Hier sind wir! Wir haben einen weiteren Schritt in unserer technischen Reise unternommen. In der modernen Softwareentwicklung ist CI/CD ein wesentlicher Faktor, der berücksichtigt werden muss. Ich hoffe, diese Anleitung ist für jeden nachvollziehbar.