Perustaso
Sinun tulee tutustua Rahdin selainkäyttöliittymään
Tarvitset Gitin ja GitHubin tuntemusta. Lisäksi GitHub-käyttäjätili on pakollinen
Webhookit
Webhookit ovat URL-osoitteita, joiden avulla voidaan käynnistää toimintoja järjestelmässä. Rahti tukee webhookeja uudelleenkoonnin käynnistämiseen. Tämä tarkoittaa, että jokainen BuildConfig kuuntelee tiettyä URL-osoitetta, joka sisältää salaisuuden (tästä lisää myöhemmin), ja kun tähän URL-osoitteeseen tehdään kutsu, oletushaaralle käynnistyy koonti.
Tuettuja muotoja on muutamia: Generic, GitHub, GitLab ja Bitbucket. Tämä tarkoittaa, että jos sovelluksen lähdekoodi on GitLabissa, GitLab-URL-tyyppi on valittava.
Tässä esimerkissä käytämme GitHub-tyyppiä.
Salaisuuden luominen
Kun olet kirjautunut Rahtiin, napsauta vasemman reunan valikosta avattavaa Workloads-luetteloa ja siirry Secrets-sivulle. Varmista, että olet oikeassa projektissa, ja napsauta sitten Create -> Webhook secret. Kirjoita mikä tahansa sopiva nimi. Napsauta sitten Generate. Kirjoita luotu salaisuus muistiin. Lopuksi napsauta Save.
URL-osoitteen hakeminen
Tarvitset valmiiksi luodun BuildConfig-objektin tai voit luoda uuden. Jos haluat luoda uuden BuildConfigin, katso artikkeli Konttikuvan luominen.
Nyt sinun täytyy muokata build configia (Actions -> Edit BuildConfig) ja lisätä triggeri. Tee tämä napsauttamalla "Trigger" muokkaussivun alaosassa kohdassa "Advanced options". Napsauta sitten "Add trigger". Uudella triggerillä täytyy olla tyyppi; tässä tapauksessa se on "GitHub". Se tarvitsee myös salaisuuden, joten valitse edellisessä vaiheessa luomasi salaisuus.
Kun BuildConfig on määritetty, voit hakea URL-osoitteen selainkäyttöliittymän kautta. Siirry vasemman reunan valikosta avattavaan Builds-luetteloon ja valitse BuildConfigs. Kohdassa Webhooks näet vaihtoehdon "Copy URL with Secret". Napsauta sitä, niin URL-osoite kopioituu leikepöydälle.
Oletushaarojen nimet eivät täsmää
Sinun täytyy varmistaa, että haarojen nimet täsmäävät Rahdin ja GitHubin välillä. Rahdissa oletushaaran nimi on master, mutta GitHubissa oletushaaran nimi on main. Tämä tarkoittaa, että—oletusarvoisesti—GitHubin main-haarassa tehtävät muutokset Rahti ohittaa.
Jos haluat, että main-haaran muutokset poimitaan Rahdissa, sinun tulee:
- Muokata BuildConfigseja
- Laajentaa Show advanced Git options kohdassa Source
- Lisätä oikea haaran nimi (tässä tapauksessa
master) kohtaan Git reference.
GitHub
Kun sinulla on URL-osoite ja salaisuus, siirry osoitteeseen https://github.com. Siellä sinun tulee mennä repositorioon, jossa koodi on, ja kohdassa Settings -> Webhooks napsauttaa "Add webhook".
Sinun tarvitsee vain täyttää kentät "Payload URL" ja "Secret" sekä vaihtaa sisältötyypiksi Application/json.
