GitHubi rakendus

Autonomy GitHubi rakendus seob hoidla projektiga. See käivitab projekti pull request'i plaani igal pull request'il, muudab @autonomy kommentaari käivitusteks ja teatab tulemusest GitHubi kontrollina.

Töövoofailist alustatud käivituste kohta vaata GitHub Actions. Pull request'i plaani seadistamise kohta vaata Pull request'ide testimine.

Seadistamine

1. Ava Organization → Integrations → GitHub ja ühenda GitHub. Ainult omanikele ja administraatoritele.
2. Paigalda rakendus oma GitHubi organisatsioonile või kontole ja vali hoidlad.
3. Anna rakendusele küsitud õigused: Checks (lugemine ja kirjutamine), Pull requests (lugemine ja kirjutamine), Contents (lugemine), Deployments (lugemine).
4. Vali igale hoidlale selle projekt. Hoidla käivitused, testiplaanid ja keskkonnad tulevad sellest projektist. Hoidla teise projekti viimine tühjendab selle vaikeseaded.
5. Kommenteeri pull request'il @autonomy help, et kontrollida, kas rakendus kuulab.

Küsi käivitust kommentaaris

Maini @autonomy või alusta rida tekstiga /autonomy ja ütle, mida käivitada:

@autonomy test the checkout flow against the Vercel preview
@autonomy run plans "Signup", "Checkout" on staging and preview
@autonomy test this PR using https://deploy-preview-128.example.com
@autonomy rerun only the failed scenarios
@autonomy help

Autonomy loeb kommentaari kõigepealt fikseeritud grammatika abil. Kui selle põhjal ei selgu, milliseid testjuhtumeid mõtlesid, palub ta valiku teha AI-l, kuid ainult nende testjuhtumite ja keskkondade seast, mis hoidla projektis olemas on.

Selgesõnalised alistamised

Verbid test, run, rerun, qa ja check muudavad käsu loomulikuks ja neid eiratakse, nagu ka sõnu on, in, against ja using keskkonna nime ees. browser, chrome ja desktop tähendavad veebi; iphone ja ipad tähendavad iOS-i; mobile tähendab iOS-i ja Androidi.

preview sihib pull request'i uusimat eelvaate juurutust. rerun … failed käivitab uuesti ainult selle, mis eelmisel korral ei läbinud.

Kuidas sihtmärk valitakse

1. Kommentaaris olev selgesõnaline URL.
2. Kommentaaris nimetatud keskkond.
3. Pull request'i eelvaate juurutus, kui küsisid preview.
4. Keskkond, mille harumuster vastab pull request'i harule.
5. Hoidla vaikeseade.
6. Projekti vaikekeskkond.
7. Testjuhtumi enda vaikekeskkond.

Mida tagasi saad

Kommentaaris küsitud käivitus hoiab pull request'il ajakohasena ühte kommentaari: käsku, millest ta aru sai, seda, kes küsis, ning tabelit testjuhtumi, sihtmärgi, platvormide ja tulemusega ning lingiga igale käivitusele. Iga commit'i automaatsed käivitused teatavad tulemusest ainult kontrolli kaudu.

Igal päringul on ka üks kontroll nimega Autonomy QA, näiteks Autonomy QA: 2 passed, 1 failed of 3. Selle lõpptulemus on kirjeldatud lehel Pull request'ide testimine: läbikukkunud käivitus annab tulemuse failure, käivitus, mis ei saanud alata, annab tulemuse neutral. Ka kommentaar, mida Autonomy ei saanud käivitada, lõpeb tulemusega neutral, nii et trükiviga ei blokeeri kunagi liitmist.

Kontrollil on nupud Re-run failed ja Re-run all.

Piirangud

• Käivitusi saavad alustada ainult kaastöötajad. Kommenteerija peab olema hoidla omanik, liige või kaastöötaja. Botte eiratakse.
• AI ei saa sihtmärke välja mõelda. See valib projekti testjuhtumite ja keskkondade seast ning iga URL peab olema sinu kommentaaris kirjas.
• Production on kaitstud. Toodangu moodi keskkonda kasutatakse ainult siis, kui kirjutasid selle nime välja.
• Sihtmärgid peavad olema avalikud HTTPS-aadressid. Loopback-aadressid, privaatsed IP-d, .local hostid ja mandaatidega URL-id lükatakse tagasi.
• Ebaselged päringud lükatakse tagasi. Kui Autonomy pole kindel, mida mõtlesid, vastab ta oletamise asemel soovitusega.
• Ühe päringu kohta kuni 8 käivitust. Käsk, mis alustaks rohkem, lükatakse tagasi, mitte ei kärbita.

Alusta käivitusi CI-st või oma tööriistadest

Organisatsiooni API-võtmega kutsu run.trigger täpselt ühega väljadest testCaseId või testPlanId ning kas salvestatud environmentSlug või selgesõnaliste targets väärtustega. Muutvad päringud kannavad oma idempotentsusvõtit JSON-kehas.

1{2  "testPlanId": "...",3  "environmentSlug": "preview",4  "branch": "feature/checkout",5  "pr": "123",6  "idempotencyKey": "github:123456789:1"7}

1{2  "runIds": [3    "..."4  ],5  "planGroupRunId": "...",6  "environment": {7    "slug": "preview",8    "name": "Preview"9  }10}

Jälgi iga käivitust run.get abil, kuni selle status on lõplik. Vaata Käivitused ja välised tõendid.

Tõrkeotsing

Kommenteerimisel ei juhtu midagi

Kontrolli, et rakendus on hoidlasse paigaldatud, et hoidlal on projekt, et oled omanik, liige või kaastöötaja ning et mainimine on @autonomy või rida algab tekstiga /autonomy.

Kommentaar ütleb, et testjuhtumit ei leitud

Nimeta see täpselt kujul plans:"Exact Name" või sea projektile pull request'i plaan, et paljal käsul oleks midagi käivitada. Otsitakse ainult hoidla projektist.

Käivitus kasutas vale keskkonda

Käi läbi loend jaotises „Kuidas sihtmärk valitakse“. Selgesõnaline url: või env: võidab alati.