Tere, tere päevast!

Soovin rääkida oma kogemusest GitLabi ja AppCenteri integreerimise seadistamisel BitBucketiga.

Sellise integreerimise vajadus tekkis automaatsete UI testide käivitamise seadistamisel plokiahelatööstuses Xamarin. Üksikasjalik õpetus allpool!

* Kui publik huvitub, teen eraldi artikli UI testimise automatiseerimisest mitme platvormi tingimustes.

Sellist materjali leidsin ainult ühe artiklit. Seetõttu võib minu artikkel kedagi aidata.

Ülesanne: Seada automaatsete UI testide käivitamine AppCenteris, kui meie meeskond kasutab GitLabit versioonihaldussüsteemina.

Probleem selgus, et AppCenter ei integreeru otse GitLabiga. Üks lahendustest oli valitud ringtee kaudu BitBucket.

Sammud

1. Loome BitBucketis tühja repot.

Ma ei näe vajadust seda täpsemalt kirjeldada 🙂

2. Seame üles GitLabi

Me peame tagama, et push/merge reposse kaasa tuleb ka BitBucketi. Selleks lisame runneri (või redigeerime olemasolevat .gitlab-ci.yml faili).

Esmalt lisame käsud before_scripts sektsiooni

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

Seejärel lisame järgmise käsu vajalikku etappi:

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

Minu puhul sai järgnev fail

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

Käivitame build'i, kontrollime, et meie muudatused/failid on BitBucketis.
* nagu praktika näitas, SSH võtmete seadistamine ei ole kohustuslik. Kuid igaks juhuks annan allpool välja SSH kaudu ühenduse seadistamise algoritmi.

SSH kaudu ühendamine

Esmalt tuleb genereerida SSH võtmed. Sellest on kirjutatud palju artikleid. Näiteks võite vaadata siit.
Genereritud võtmed näevad välja umbes sellised:

Edasi salajane võtme peab lisama muutujana GitLabi. Selleks läheme seadetesse > CI/CD > Keskkonnamuutujad. Lisame KÕIK faili sisu, kuhu salvestasite salajase võtme. Nimetame muutuja SSH_PRIVATE_KEY.
* see fail, erinevalt avaliku võtme failist, ei saa laienemist

Suurepärane, edasi tuleb lisada avalik võti BitBucketisse. Selleks avame repot, läheme seadete juurde > Juurdepääsu võtmed.

Siin vajutame Lisa võtme ja kleepime avaliku võtme faili sisu (fail, millel on .pub laiend).

Järgmine samm on võtmete kasutamine gitlab-runneris. Kasutage neid käske, kuid asendage tähtedega oma andmed

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. AppCenteri seadistamine

Loome uue rakenduse AppCenteris.

Määrame keele/platvorma

Seejärel läheme just loodud rakenduse Build sektsiooni. Valime seal BitBucketi ja Eelmisel etapil loodud hoidla.

Suurepärane, nüüd peame seadistama build'i. Selle jaoks otsime hammasratta ikooni

Põhimõtteliselt on seal kõik intuitiivselt arusaadav. Valime projekti ja konfiguratsiooni. Vajadusel lülitame sisse testide käivitamise pärast build'i. Need käivitatakse automaatselt.

Põhimõtteliselt on see kõik. Kõlab mitte keeruliselt, aga loomulikult ei suju kõik sujuvalt. Seetõttu kirjeldan mõningaid vigu, millega olen oma töö käigus kokku puutunud:

‘ssh-keygen’ ei ole tunnustatud sisemise ega välise käskuna.

See tekib seetõttu, et teed ssh-keygen.exe-le ei ole lisatud keskkonnamuutujatesse.
On kaks võimalust: lisage C:Program FilesGitusrbin Enviroment Variables'i (rakendub pärast masina taaskäivitamist), või käivitage konsool sellest kataloogist.

AppCenter ei ole ühendatud õige BitBucketi kontoga?

Probleemi lahendamiseks tuleb BitBucketi konto AppCenterist eemaldada. Logime vale BitBucketi kontoga sisse ja läheme kasutaja profiili.

Seejärel läheme seadistustesse Settings > Access Management > OAuth

Klickige Revoke, et konto eemaldada.

Pärast seda tuleb siseneda õigele BitBucketi kontole
* Viimase abinõuna on soovitatav ka brauseri vahemälu tühjendada

Nüüd läheme AppCenterisse. liigume Build sektsiooni, klõpsame Disconnect BitBucket account

Kui vana konto on eemaldatud, seome AppCenteri uuesti. Nüüd õige kontoga.

‘eval’ ei ole tunnustatud sisemise ega välise käskuna

Kasutagem selle asemel käsku

  - eval $(ssh-agent -s)

Käsku:

  - ssh-agent

Mõnel juhul võib olla vajalik kas märkida täielik tee C:Program FilesGitusrbinssh-agent.exe, või lisada see tee süsteemi muutujatesse masinas, kus runner töötleb

AppCenter Build üritab käivitada build'i projekti jaoks mitteaktuaalsest bitBucketi hoidlast

Minu puhul tekkis probleem seetõttu, et töötasin mitme kontoga. Probleem lahendati vahemälu kustutamisega.

Allikas: habr.com