App di costruzione e rilascio automatico con GitLab

Questa guida ti guiderà attraverso la configurazione del flusso di lavoro CI/CD con GitLab.

Premessa

Assicurati di aver aggiunto la tua Capacitor app prima a Capgo, questo tutorial si concentra solo sulla fase di caricamento. Se hai bisogno di aggiungere la tua app a Capgo, puoi seguire questo Tutorial.

Convenzione di commit

Innanzitutto, è necessario iniziare a seguire la convenzione di commit comuni commit` ciò aiuterà gli strumenti a comprendere come aggiornare il numero di versione, ci vuole solo 5 minuti per impararlo.

GitLab CI/CD per Tag

Crea un file .gitlab-ci.yml nella radice del tuo repository GitLab con il seguente contenuto

 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

Sostituisci "gitlab@yourdomain.com" e "GitLab CI/CD" con il tuo indirizzo email e nome utente di GitLab nella sezione dello script. Questa configurazione attiva il lavoro solo per le push sul ramo principale e esclude i commit con messaggi che iniziano con "chore(release):".

GitLab CI/CD per Build

Aggiungi un'altra fase al tuo file .gitlab-ci.yml per 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

Assicurati di avere la tua Capgo API chiave (CAPGO_TOKEN) aggiunta come variabile CI/CD nel tuo progetto di GitLab. Vai al tuo progetto in GitLab, naviga a Impostazioni > CI/CD > Variabili, e aggiungi una variabile denominata CAPGO_TOKEN con il valore della tua API chiave.

Personalizza lo script di build per adattarlo al processo di build specifico del tuo progetto, come modificare il comando di build npm.

Conclusioni

Ecco! Abbiamo fatto un passo in più nel nostro percorso tecnologico. Nella moderna sviluppo software, il CICD è un fattore essenziale da considerare. Spero quindi che questo manuale sia comprensibile a tutti.