Crea automaticamente e rilascia l'app con GitLab

Questa guida vi guiderà attraverso la configurazione della pipeline CI/CD con GitLab.

Premessa

Assicurarsi di aver aggiunto il proprio Capacitor app prima di tutto a Capgo, questo tutorial si concentra solo sulla fase di caricamento. Se necessario, aggiungere l'app a Capgo, potete seguire questo Tutorial.

Convenzione di commit

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

GitLab CI/CD per Tag

Creare 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

Sostituire “gitlab@yourdomain.com” e “GitLab CI/CD” con il tuo indirizzo email e nome utente 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

Aggiungere 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 chiave Capgo API (CAPGO_TOKEN) aggiunta come variabile CI/CD nel tuo progetto GitLab. Vai al tuo progetto in GitLab, naviga verso Impostazioni > CI/CD > Variabili e aggiungi una variabile denominata CAPGO_TOKEN con il valore della tua chiave API.

Personalizzare lo script di build per adattarlo al processo di build specifico del tuo progetto, come modificare il comando di esecuzione del 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 stato utile a tutti.