# Arotaka Tuku mō ngā Pull Request

Source: https://support.kapsulehost.com/mi-nz/site-preview

Ka whakawhiwhi nga whakaputa arokite i tētahi URL ora ake mo ia pull request, kua hangaia mai i te waehere a tēnā peka, kia taea e nga kaiarotake te pāwhiri atu ki te huringa tūturu, kaua e pānui diff me te matapae noa. Ka whakahōu tēnā arokite i tō pana i tētahi commit hou, ka horoia anō aunoa ina kati te pull request.

## Ko Hea Nga Whakaputa Arokite E Noho Ai

Whakatuwhera i **Ngā Paetukutuku**, pāwhiri i te pae, whakatuwhera i te rōpū **Environment** i te tahua maui o te pae, kātahi ka kōwhiri **Arokite**. Ko te taitara o te wharangi ko **Whakahaere Preview**.

He rerekē nga arokite i te staging. Ko te staging he kape kotahi, roa te noho, o te pae e pana ana koe ki reira i runga i te whakaaro; ko te arokite he taiao poto te noho, i hangaia mo ia pull request ka maka atu i muri mai. He maha nga rōpū e whakamahi ana i ngā mea e rua. Tirohia [Nga Taiao Staging](https://support.kapsulehost.com/mi-nz/staging-environments) mo tērā tāpae.

![Te wharangi Preview deploys mo tētahi pae i KPanel](https://support.kapsulehost.com/help/screenshots/site-preview.0fb977c9.webp)

## Whakatūtūhia Tuatahi Te Git Deploy

Ehara nga arokite i te āhuatanga motuhake. Ka whakamahi anō ratou i te kī tuku a te pae tuku (production), me tana whakahau hanga, nā reira me whai te pae i tētahi whirihoranga Git Deploy e mahi ana i mua i te taea o te whakahohe i nga arokite.

Ki te kore e whirihoratia te Git Deploy, ka kī te wharangi **Whakatūtū Git deploy i te tuatahi**, ā, ka tāpaea tētahi pātene **Haere ki Git deploy** hei utu mō te puka whakahohe. Whakarite i [Te Tuku i Tētahi Pae Mai i Git](https://support.kapsulehost.com/mi-nz/site-git-deploy), kātahi ka hoki mai.

> **Note:** Ki te hono te Git Deploy engari karekau he whakahau hanga, ka whakaatu te wharangi Preview i tētahi whakatūpato. Ka whakaaro nga arokite kua oti kē te hanga i te pātaka, me nga kōnae pūmau kei te pakiaka. He tika tēnei mo tētahi pae HTML noa, engari he hē mo tētahi mea e whakahiatoa ana, nā reira whakaritea tētahi whakahau hanga i te wharangi Git Deploy mēnā e hiahiatia ana e tō kaupapa.

## Te Whakahohe I Nga Arokite

1. I te kāri **Whakahohe tirotiro deploys**, patohia te pātaka i te āhua `owner/repo`. Ehara i te URL, ehara i te wāhitau SSH: ko nga wāhanga e rua noa, hei tauira `acme/marketing-site`.
2. Pāwhiri **Enable**.

Mēnā kāore tētahi mea e rite ana ki `owner/name`, ka whakakorehia me te karanga **Me whakatika te Repo i te āhuatanga owner/name**.

Inā whakahohetia, kātahi tonu ka whakaatu a KPanel i te huna hainatanga webhook i roto i tētahi kāri kei te upoko **Kape i tō huna webhook inaianei**, me tētahi whakatūpato e kī ana kāore koe e kite anō i tēnei.

> **Important:** Kapea te huna i mua i tō wehenga atu i te wharangi. Ka hangaia kotahi noa, kāore e taea te tango anō i muri mai. Mēnā ka ngaro i a koe, ko te whakatika he whakahanga anō, engari ka whakakore i te mea tawhito, ā, me whakahōu anō hoki e koe te webhook a tō pātaka.

## Te Tāpiri I Te Webhook Ki Tō Pātaka

Ka whakaatu te kāri kua whirihoratia i tētahi **Webhook URL** hei whakapiri ki roto i nga tautuhinga o tō pātaka, i raro i Webhooks. Whirihoratia ki:

- **URL Kawenga**: te URL webhook e whakaatuhia ana i te wharangi.
- **Huna (Secret)**: te uara kua kapea e koe.
- **Momo ihirangi**: JSON.
- **Ngā huihuinga**: nga huihuinga pull request, me nga pana (pushes), kia pakaru anō te arokite ina tāpirihia tētahi commit hou ki tētahi pull request e tuwhera tonu ana.

Ina oti tēnei, ka hangaia tētahi arokite i roto i te ruarua meneti i te whakatuwheratanga o tētahi pull request. Ka tirohia e tētahi mahi i te papamuri mō ngā mahi arokite hou i ia meneti, nā reira kāore he take ki te pēhi i tētahi mea i KPanel.

## Nga URL Arokite

Ka whiwhi ia arokite i tōna ake ingoa whakamahi i te āhua `pr-<pull-request-number>-<site-id>.kapsulecloud.app`, kua hipokina e tētahi tiwhikete wildcard, nā reira ka tukuna mā HTTPS me kore he taonga tiwhikete māu ake.

Ko te huarahi pono ki te whakatuwhera i tētahi ko te pātene **Open** i te rārangi o te arokite i roto i **Ngā arokite hou**, e mau ana i te URL tōtika i whakaritea mo tēnā hanga. Whakapiritia tēnā hono ki te pull request kia kore ai nga kaiarotake e rapu i KPanel.

## Te Pānui I Te Rārangi Ngā Arokite Hou

Ka whakarārangi te wāhanga **Ngā arokite hou** i ngā arokite hou rawa atu, ko te mea hou rawa kei mua. Ka whakaatu ia rārangi i te tau me te taitara o te pull request, te peka, te commit, me tētahi tūnga:

| Tūnga | Tikanga |
|---|---|
| BUILDING | Kei te tāraitia, kei te hangaia ināianei |
| LIVE | Kei te mahi i tōna URL arokite |
| FAILED | I hē te hanga; whakawhānuitia te rārangi hītori kia kite ai te take |
| DESTROYED | Kua horoia, i te nuinga o te wā nā te katinga o te pull request |

Pāwhiri **Pāhuri i te arokite hanga** i tētahi rārangi kia whakawhānuitia tāna putanga hanga ki te taha. Koinā te wāhi tuatahi me tirotiro ina rahua tētahi arokite, ā, ko te putanga ōrite tērā e whakaputaina e tō hanga ina mahia ā-rohe.

Mēnā kei te wātea te rārangi, ka kī te wharangi: whakatuwheratia tētahi pull request i te pātaka, ā, ka hangaia tētahi arokite i roto i te ruarua meneti.

## Te Huri I Te Huna Webhook

Pāwhiri **Whakahanga anō i te huna** i te kāri kua whirihoratia. Ka pātai a KPanel ki a koe kia whakaū, ā, ka whakamārama mārika kua mutu tonu te mahi a te huna onamata, ā, me whakahōu e koe i tāna i nga tautuhinga webhook a tō pātaka i muri mai.

Ka whakaatu kotahi tonu te huna hou, i roto i te kāri kotahi-wā ōrite i mua. Kapea, kātahi ka whakahōu i te webhook i tō pātaka. I waenganui i ēnei wā e rua, ka whakakorehia nga tukunga webhook e tae mai ana, nā reira mahia nga mahi e rua kia wawe tata tonu.

Whakahangahia anō te huna ina wehe atu tētahi tangata he mana whakahaere pātaka tōna, ina kua whakapiritia rānei te huna ki tētahi wāhi ehara i te wāhi tika, pēnei i tētahi hongere kōrero tahi, i tētahi tikiti rānei.

## Te Weherei I Nga Arokite

Pāwhiri **Disable**. Ka weherei te whirihoranga, ā, ka murua te huna kua tiakina. Ka mutu te hangaia anō o nga arokite onamata.

Whakamāmā hoki mā te muku i te webhook i tō pātaka. Ka timata ki te rahua kaua ki te mahi i tētahi mea whakararuraru, engari he haruru tētahi webhook e whakahoki ana i te hapa mō ake tonu atu i te rārangi tuku a tō pātaka.

## Nga Utu Me Te Tiaki I Te Ōkiko

Ka hangaia, ka tukuna hoki e nga arokite te waehere tūturu, nā reira ka whakamahi ratou i nga rauemi kotahi me tētahi atu whakaputanga i te pae. E rua nga tikanga e pupuri ana i tēnei kia whai mana:

- Katia nga pull request kāore koe e mahi ana ināianei. Ka horoia aunoa te arokite a tētahi pull request kua katia.
- Kaua e tuku i nga arokite ki nga tohu whakamotuhēhē production. Hoatu ki a ratou nga kī whakamātau mā te tūtohi **preview** o te ripanga [Secrets](https://support.kapsulehost.com/mi-nz/site-secrets), e noho ana tōna take kia kore ai e pōraruraru te whirihoranga arokite me te whirihoranga production.

> **Warning:** Ehara te URL arokite i te mea tūmataiti. He ingoa whakamahi tūturu, tae noa mai ki te marea, me tētahi tiwhikete whaimana, ā, ka taea e te tangata katoa he hono tōna te whakatuwhera. Kaua e whakamahi i tētahi arokite ki te arotake i tētahi mea e mau ana he raraunga kiritaki tūturu, kaua hoki e whakatō i nga taiao arokite mai i tētahi tango-raraunga production.

## Te Whakatika Raru

**Kāore he mea e hangaia ina whakatuwheratia tētahi pull request.** Tirohia nga tukunga hou rawa a te webhook i tō pātaka. Ko tētahi 401 , 403 rānei e tohu ana kāore te huna e rite, nā reira whakahangahia anō ka whakahōu i nga taha e rua. Mēnā kāore rawa he tukunga, ehara te webhook i te mea kua hono ki nga huihuinga pull request.

**Ka hangaia te arokite engari ka whakaatu i tētahi rārangi kōnae, i tētahi 404 rānei.** Kāore te kōpaki putanga i te wharangi Git Deploy e rite ana ki te wāhi e tuhi ai tō hanga. Ka tango nga arokite i tēnā tautuhinga mai i te production.

**Ka rahua te hanga i te arokite anake.** Ko te take nui rawa he taunga, he taurangi taiao rānei kei te production engari kāore rawa i tāpirihia ki te taiao arokite. Tirohia te tūtohi **preview** i te wharangi Secrets.

**Ka mutu te mahi a tētahi URL arokite.** Tirohia te tūnga kei tōna rārangi. Ko te tikanga o **DESTROYED** kua kati te pull request, ā, kua whakahokia te taiao, koinā te whanonga e hiahiatia ana.

## Ko Hea Te Haere Ināianei

- [Te Tuku i Tētahi Pae Mai i Git](https://support.kapsulehost.com/mi-nz/site-git-deploy), te whirihoranga matua e tika ana.
- [Te Tiaki I Nga Kī Huna Mō Tētahi Pae](https://support.kapsulehost.com/mi-nz/site-secrets) mo nga tohu whakamotuhēhē mō ia taiao.
- [Nga Taiao Staging](https://support.kapsulehost.com/mi-nz/staging-environments) mo tētahi kape pre-production e mau tonu ana.