Hei, god dag!

Jeg vil dele erfaringene mine med å sette opp integrasjonen mellom GitLab og AppCenter gjennom BitBucket.

Behovet for en slik integrasjon oppsto under oppsettet av automatisk kjøring av UI-tester for et tverrplattformprosjekt på Xamarin. Detaljert tutorial er under kat!

* Om automatisering av UI-testing i tverrplattformsetting vil jeg skrive en egen artikkel hvis publikum er interessert.

Jeg har kun funnet ett slikt materiale. artikkelen. Derfor kan artikkelen min være til hjelp for noen.

Oppgave: Å sette opp automatisk kjøring av UI-tester på AppCenter når teamet vårt bruker GitLab som versjonskontrollsystem.

Problemet var at AppCenter ikke integreres direkte med GitLab. En av løsningene som ble valgt var å gå rundt via BitBucket.

Trinn

1. Vi oppretter et tomt repository på BitBucket.

Jeg ser ikke behovet for å beskrive dette nærmere 🙂

2. Vi setter opp GitLab.

Vi må sørge for at ved push/merge til repositoryet, blir endringer også lastet opp til BitBucket. For dette legger vi til en runner (eller redigerer den eksisterende .gitlab-ci.yml-filen).

Først legger vi til kommandoer i seksjonen before_scripts.

 - git config --global user.email "user@email"
 - git config --global user.name "username"

Deretter legger vi til følgende kommando i ønsket stage:

- git push --mirror https://username:password@bitbucket.org/username/projectname.git

I mitt tilfelle fikk jeg følgende fil:

before_script:
 - git config --global user.email "user@email"
 - git config --global user.name "username"

stages:
  - mirror
mirror:
  stage: mirror
  script:
    - git push --mirror https://****:*****@bitbucket.org/****/testapp.git

Vi kjører byggingen, og sjekker at våre endringer/filer ligger på BitBucket.
* som erfaringen viser, er oppsett av SSH-nøkler ikke obligatorisk. Men for sikkerhets skyld vil jeg gi algoritmen for oppsett av tilkoblingen via SSH nedenfor.

Tilkobling via SSH

Først må vi generere en SSH-nøkkel. Det er skrevet mange artikler om dette. Som eksempel kan du se på here.
De genererte nøklene ser omtrent slik ut:

Deretter den hemmelige nøkkelen må legges til som en variabel på GitLab. For dette går vi til Innstillinger > CI/CD > Miljøvariabler. Vi legger til ALT innholdet fra filen der du lagret den hemmelige nøkkelen. La oss kalle variabelen SSH_PRIVATE_KEY.
* denne filen, i motsetning til filen med den offentlige nøkkelen, vil ikke ha et filnavn.

Flott, videre må vi legge den offentlige nøkkelen til BitBucket. For dette åpner vi repositoryet, går til Innstillinger > Tilgangsnøkler.

Her klikker vi på Legg til nøkkel og limer inn innholdet fra filen med den offentlige nøkkelen (filen med .pub-utvidelsen).

Neste steget vil vi bruke nøklene i gitlab-runner. Bruk disse kommandoene, men spesifiser dine egne data i stedet for stjernesymbolene.

image: timbru31/node-alpine-git:latest

stages:
  - mirror

before_script:
  - eval $(ssh-agent -s)
  - echo "$SSH_PRIVATE_KEY" | tr -d 'r' | ssh-add - > /dev/null
  - mkdir -p ~/.ssh
  - chmod 700 ~/.ssh
  - ssh-keyscan bitbucket.org >> ~/.ssh/known_hosts
  - chmod 644 ~/.ssh/known_hosts
  - git config --global user.email "*****@***"
  - git config --global user.name "****"
  - ssh -T git@bitbucket.org

mirror:
  stage: mirror
  script:
    - git push --mirror https://****:****@bitbucket.org/*****/*.git

3. Konfigurere AppCenter

Vi lager en ny applikasjon på AppCenter.

Angi språk/plattform

Deretter går vi til seksjonen Bygg av den nettopp opprettede applikasjonen. Vi velger BitBucket og repositoriet som ble laget i trinn 1.

Flott, nå må vi konfigurere byggingen. For dette finner vi tannhjulikonet.

I prinsippet er alt intuitivt. Velg prosjektet og konfigurasjonen. Aktiver testkjøring etter byggingen hvis nødvendig. De vil bli kjørt automatisk.

I prinsippet er det alt. Det høres ikke vanskelig ut, men, selvsagt, vil ikke alt gå glatt. Derfor vil jeg beskrive noen feil jeg støtte på under arbeidet:

‘ssh-keygen’ er ikke gjenkjent som en intern eller ekstern kommando.

Dette skjer fordi stien til ssh-keygen.exe ikke er lagt til i miljøvariablene.
Det finnes to alternativer: legg til C:Program FilesGitusrbin i miljøvariablene (gjeldende etter omstart av maskinen), eller kjør konsollen fra denne katalogen.

Har AppCenter koblet seg til feil BitBucket-konto?

For å løse problemet må du koble BitBucket-kontoen fra AppCenter. Logg inn på den gale BitBucket-kontoen, gå til brukerprofilen.

Deretter går vi til Innstillinger > Tilgangsstyring > OAuth

Klikk på Tilbaketrekk for å koble kontoen fra.

Deretter må du logge på med riktig BitBucket-konto.
* I verste fall kan du også rydde nettleserens cache.

Nå går vi til AppCenter. Gå til seksjonen Bygg, klikk på Få bort BitBucket-konto.

Når den gamle kontoen er frakoblet, kobler vi AppCenter til igjen. Nå til riktig konto.

‘eval’ er ikke gjenkjent som en intern eller ekstern kommando.

Bruk i stedet kommandoen

  - eval $(ssh-agent -s)

Kommandoen:

  - ssh-agent

I noen tilfeller må du enten spesifisere full sti til C:Program FilesGitusrbinssh-agent.exe, eller legge til denne stien i systemvariablene på maskinen der runneren kjører.

AppCenter Build prøver å starte byggingen for prosjektet fra et utdatert bitBucket-repositorium.

I mitt tilfelle oppsto problemet fordi jeg jobbet med flere kontoer. Det ble løst ved å tømme cachen.

Kilde: habr.com