Perustaso
Sinun tulee tutustua Rahdin selainkäyttöliittymään
Tarvitset Gitin ja GitHubin tuntemusta. Lisäksi tarvitset GitHub-tilin
Webhookit
Webhookit ovat URL-osoitteita, joilla 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, käynnistyy koonti oletushaaralle.
Tuettuja muotoja on muutamia: Generic, GitHub, GitLab ja Bitbucket. Tämä tarkoittaa, että jos sovelluksen lähdekoodi on GitLabissa, on valittava GitLab-URL-tyyppi.
Tässä esimerkissä käytämme GitHub-tyyppiä.
Salaisuuden luominen
Kun olet kirjautunut Rahtiin, napsauta vasemman reunan valikosta Workloads-pudotusvalikkoa ja siirry Secrets-sivulle. Varmista, että olet oikeassa projektissa, ja napsauta sitten Create -> Webhook secret. Kirjoita jokin sopiva nimi. Napsauta sitten Generate. Kirjaa luotu salaisuus muistiin. Lopuksi napsauta Save.
URL-osoitteen hakeminen
Tarvitset valmiiksi luodun BuildConfig-objektin tai voit luoda uuden. Jos haluat luoda uuden BuildConfigin, katso ohje artikkelista Konttikuvan luominen.
Seuraavaksi 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". Uudelle triggerille täytyy määrittää 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ästä. Siirry vasemman reunan valikosta Builds-pudotusvalikkoon 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 haarassa nimeltä main tehtävät muutokset Rahti ohittaa.
Jos haluat, että Rahdissa huomioidaan main-haaran muutokset, sinun täytyy:
- Muokata BuildConfigseja
- Laajentaa Show advanced Git options kohdassa Source
- Lisätä oikea haaran nimi (tässä tapauksessa
master) kohtaan Git reference.
GitHub
Kun olet saanut URL-osoitteen ja salaisuuden, siirry osoitteeseen https://github.com. Mene siellä repositorioon, jossa koodi sijaitsee, ja valitse Settings -> Webhooks ja napsauta "Add webhook".
Sinun tarvitsee vain täyttää kentät "Payload URL" ja "Secret" sekä vaihtaa sisältötyypiksi Application/json.
