Build e rilascio automatico con Gitlab

Questa guida si concentra su GitLab CI, ma puoi adattarla con un piccolo aggiustamento a qualsiasi altra piattaforma CI/CD.

Prefazione

Assicurati di aver aggiunto la tua app per primo a Capgo, questa guida si concentra solo sulla fase di caricamento

Convenzione di commit

Innanzitutto devi iniziare a seguire la convenzione di commit Commi comuni` questo ti aiuterà a capire come il tooling debba gestire l'aggiornamento del numero di versione, ci vuole solo 5 minuti per impararlo.

GitLab CI per tag

Poi hai bisogno di creare il tuo primo GitLab per costruire automaticamente e creare tag.

Crea un file in questo percorso: .github/workflows/bump_version.yml

con questo contenuto:

name: Bump version

on:
  push:
    branches:
      - main

jobs:
  bump-version:
    if: "!startsWith(github.event.head_commit.message, 'chore(release):')"
    runs-on: ubuntu-latest
    name: "Bump version and create changelog with standard version"
    steps:
      - name: Check out
        uses: actions/checkout@v6
        with:
          fetch-depth: 0
          filter: blob:none
          token: '${{ secrets.PERSONAL_ACCESS_TOKEN }}'
      - name: Git config
        run: |
          git config --local user.name "github-actions[bot]"
          git config --local user.email "github-actions[bot]@users.noreply.github.com"
      - name: Create bump and changelog
        run: npx capacitor-standard-version
      - name: Push to origin
        run: |
          CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
          remote_repo="https://${GITHUB_ACTOR}:${{ secrets.PERSONAL_ACCESS_TOKEN }}@github.com/${GITHUB_REPOSITORY}.git"
          git pull $remote_repo $CURRENT_BRANCH
          git push $remote_repo HEAD:$CURRENT_BRANCH --follow-tags --tags

Ciò rilascerà un tag per ogni commit nella tua branch principale. E aggiungerà un'entry di changelog per ogni commit nella branch principale in CHANGELOG.md.

Non preoccuparti se non hai questo file, verrà creato per te.

Per far funzionare questo, crea un __CAPGO_KEEP_0__ e aggiungilo alle tue variabili GitLab CI/CD come PERSONAL_ACCESS_TOKEN.

Ciò è necessario per far sì che il CI possa commitare il changelog.

Quando crei il token, scegli l'expiration come never e lo scope come repo.

Infine, per far capire al tool dove è salvata la tua versione, devi creare il file .cz.toml al root del tuo repository.

E aggiungi questo all'interno:

[tool.commitizen]
name = "cz_conventional_commits"
tag_format = "$major.$minor.$patch$prerelease"
version = "0.11.5"
version_files = [
    "package.json:version",
    ".cz.toml"
]

Imposta la versione in questo file come quella che hai nel tuo package.json file.

Questo è necessario solo la prima volta, poi gli strumenti lo terranno aggiornato.

Ora puoi commitare entrambi i file e vedere comparire il tuo primo tag in GitHub!

GitHub azioni per la build

Crea un file in questo percorso: .github/workflows/build.yml

con questo contenuto:

name: Build source code and send to Capgo

on:
  push:
    tags:
      - '*'
      
jobs:
  deploy:
    runs-on: ubuntu-latest
    name: "Build code and release"
    steps:
      - name: Check out
        uses: actions/checkout@v6
      - name: Install dependencies
        id: install_code
        run: npm i
      - name: Build
        id: build_code
        run: npm run build
        env: # Remove both lines  if you don't need it
          FIREBASE_CONFIG: ${{ secrets.FIREBASE_CONFIG }} # Example of env var coming from a secret
      - name: Create Release
        id: create_release
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c production

Questo installerà e costruirà la tua dipendenza prima di inviarla a Capgo.

Se il tuo comando per la build è diverso, puoi cambiarlo in build_code To fare ciò, hai bisogno di ottenere la tua __CAPGO_KEEP_0__ chiave per __CAPGO_KEEP_1__, aggiungerla nel

To make this work, you need to get your API key for Capgo, add it in the secret of your GitHub repository Ora puoi commitare entrambi i file e vedere comparire il tuo primo tag in __CAPGO_KEEP_0__! CAPGO_TOKEN.

You can now commit this both files and see your first tag appear in GitHub!

Dovresti aggiungere le tue prove nel passo di build per assicurarti che __CAPGO_KEEP_0__ funzioni correttamente.

Vai al tuo code dashboard e controlla la tua build che è appena apparsa, ora hai il tuo sistema CI/CD.

Go To your Capgo dashboard and check your build who just appeared, you now have your CI/CD system.

Continua da Automatic build and release with Gitlab public.

Se stai utilizzando

Automatic build and release with Gitlab step. per pianificare l'automazione CI/CD, connettilo con Capgo automazione CI/CD per il flusso di lavoro del prodotto in Capgo automazione CI/CD, Capgo Costruzioni native per il flusso di lavoro del prodotto in Capgo Costruzioni native, Capgo Integrazioni per il flusso di lavoro del prodotto in Capgo Integrazioni, Integrazione CI/CD per i dettagli di implementazione in Integrazione CI/CD, e GitHub Integrazione delle azioni per i dettagli di implementazione in GitHub Integrazione delle azioni.