Paetukutuku
Te Whakatinana i te Paetukutuku Mai i Git
Git Deploy connects a repository to a site so that every push to your chosen branch clones the code, runs your build, and publishes the result. This guide covers the initial connection, the two…
Git Deploy tē hononga tētahi pūkete ki tētahi paetukutuku kia ia wā e peia ana ki tō peka i whiriwhiria, kā kopa te code, ka rere te build, ā kātahi ka whakaputa i te hua. Ka āta whāwhā tēnei aratohu i te hononga tuatahi, i ngā āhuatanga e rua o te taha pūkete e whakaoti ai te whakatakoto, te pānui i te hitori tohu, me te kitenga buildpack e whakatau ana i te āhua o te whakawhanake a te tauprogramu Node.js.
Te Wāhi e Noho Nei a Git Deploy
Huakina Websites, pīwhiri i te paetukutuku, huakina te Advanced menu i te paetukutuku tab strip, ā kōwhiri Git Deploy. E rua ngā whārangi e pā ana e tūturu ana i te menu ōrite:
- Deploys, te hitori tohu katoa mō tēnei paetukutuku.
- Buildpack, te rautaki whakawhanake i kitenga, i ngā paetukutuku Node.js.
Ka whakaahua te whārangi Git Deploy i a ia anō: hononga tētahi pūkete ā ia wā e peia ana ki tō peka i whakaritea, ka whakatupuranga i tētahi build me te tohu.
Te Hononga ki Tētahi Pūkete
- Kōwhiri tō Provider: GitHub, GitLab, Bitbucket rānei.
- Whakauru i te Repository URL. Ko te āhua SSH te mea e hiahia ana koe, hei tauira
git@github.com:user/repo.git. - Tautokohia te Branch ki te tohu mai. Ka tīmata te āpure i
main. - Hei whakatuwhera, tautokohia tētahi Build command, hei tauira
npm run build. - Hei whakatuwhera, tautokohia tētahi Output directory, hei tauira
dist,public,.rānei, mō tētahi pūkete kua whakawhanakehia kē. - Pīwhiri Connect repo.
Waihotia te build command me te output directory ki te iti tahi mēnā he tohu kē tō pūkete, arā, he paetukutuku PHP māori noa iho, he paetukutuku static rānei.
Advanced Scripts
Ka kōpanapana Advanced, ka puta ake ngā āpure e rua ānō:
- Pre-deploy script, e rere ana i mua i te build.
- Post-deploy script, e rere ana i muri i te tohu.
Whakamahia te post-deploy hook mō ngā mea me whakatupurangatia i tēnā wā kua tū ake te code: te whakahorohoro i tētahi cache tāuprogramu, te whakatakoto i te pūtaiao raraunga, te akoakotahi anō i tētahi mahi-a-ringa.
Auto-Deploy On Push
Te pūtaki i te piko o te kāri e whakahaere ana mēnā ka whakaara i ngā peia. Ki te pukumahi, ia peia ki te peka i whakaritea kā whakatupuranga i tētahi tohu. Ki te raro, e rere anake ngā tohu ki a koe i whakatupurangatia noa iho e Deploy now.
Whakaiti i te auto-deploy i te wā o te code freeze, te tūraru rānei, kaua atu e whakatuwhiri i te hononga pūkete. Ka whakamoti i te hononga pūkete, hei tohu, ka ngaro te deploy key me te webhook secret, ā me mahi anō koe i ngā āhuatanga e rua o te taha pūkete.
Te Whakaoti i te Whakatakoto I Roto I Tō Pūkete
Arā anake te hononga pūkete i KPanel i te tīmatanga o ngā āhuatanga e toru. Kia tae atu ki tētahi tohu kua rere, ka whakaatu te whārangi i tētahi ōkiri e kī ana Complete setup: 2 steps remaining me tēnei āhuatanga katoa e hiahia ana koe.
Āhuatanga 2: Whakauru i te Deploy Key
Kua hiahia a Kapsule i te rauponga pānui kia kopa i tō pūkete. Ka whakaatu te ōkiri i tētahi kī tūmatanui me tētahi pūtaki Copy key.
Whakapiri ki ngā deploy keys o tō pūkete. Mō GitHub, ka whakaatu te ōkiri i tētahi pokatata Add to GitHub ki tō whārangi tautoko. He rauponga pānui anake te katoa; kaua e hoatu he rauponga tuhi.
Āhuatanga 3: Whakauru i te Webhook
Ko te webhook te mea e kī ai ki a Kapsule kua peia tētahi mea. Ka hoatu te ōkiri i ngā uara e toru:
| Āhuatanga | Uara |
|---|---|
| Payload URL | Tētahi URL e mutu ana i /api/git-deploy/webhook/ me te ID o tēnei paetukutuku |
| Secret | Tētahi huna whakatupurangatanga, te huanga kia pīwhiria e koe te koka mata |
| Content Type | application/json |
Kōpiri ia waahi ki ngā tautoko webhook o tō pūkete. Mō GitHub he pokatata Add webhook to GitHub. Tautokohia te content type ki JSON, ehara i te āhuatanga tūturu turikituria, kāore rānei te payload ka whakamāramahia.
Tiakina te webhook secret penei i te kupuhanga. Ki te whaiwhaihia e tētahi tangata, me te payload URL, kāore e kore, ka taea ia te whakatupuranga i te tohu o tō paetukutuku. E rua anake ngā uara i te tohu-a-tangata noa iho e kāhore e awhina ana i te paetukutuku, ā te secret kua hunaia i muri i te koka mata tae atu koe ka tonoa atu.
Te Tohu Nā Tō Ringa
Pīwhiri Deploy now i te whārangi Git Deploy kia whakawhanake ai me te tohu i te pane o te peka i whakaritea, kāore i te peia i tētahi āhuatanga. E mahi ana tēnei ahakoa te auto-deploy, arā te āhuatanga e whakaatu ai hei taputapu tika i te wā o te freeze: ka tūrangatia ngā peia, engari kāore e kore, ka taea koe te whakauru i te whakatikanga.
Te Pānui i te Hitori Tohu
Huakina Advanced, ā kātahi Deploys. Ko te whārangi e whakahua ana Deploy history ka whakaaturia ia tohu i whakatupurangatia e te webhook, e te ringa rānei, te hou nei e haere whakamua.
Ka āhuatanga ia rarangi:
- Tētahi aronga tūmataiti me te SHA āhuatanga poto, me te peka hei kiripuaki.
- Te kupu āhuatanga, Manual deploy rānei mēnā kāore he kupu āhuatanga ki te whakaatu.
- Te kaihanga, te tawhāwhā i muri nei, te roa i whakatakotoria, me te āhuatanga i whakatupuranga.
- Tētahi kiripuaki tūmataiti.
Ko ngā tūmataiti ko pending, building, deploying, success me failed. I te wā e haere whakamua ana tētahi āhuatanga, kāore e kore, ka hou te whārangi ia tekau ma rima hēkona ā ka whakaatu he Refreshing automatically kupu i raro i te tēpu, ā e āhei ana koe te waiho i te huakina ā kiteā te tohu e tāngia.
Ki te Rahua Te Tohu
Ka āhuatanga tūmataiti Error i te matau i te rarangi rahua. Pīwhiri kia whakatuwhera mai te kupu hapa tohu i roto, kāore e whakawhiti i te whārangi. Ko tēnei kupu te kupu hapa a te build anake, koia e whakahua i te kōnae, te whakahau rānei i rahua.
Ka noho koe mā tēnei āhuatanga: pānuitia te hapa, whakatūtūtia te build whakahau ōrite ki te whare, whakatika, peia. Mēnā e mahi ana te build i whea ka kore i konei, ko te rereketanga ko te wāhi tūmataiti, tētahi whaiwhai ngaro kua tūkohia noa i tō miihini, tētahi kōnae rānei i roto i tō ahuatanga mahi kāore kē i tutuki.
Kitenga Buildpack
I ngā paetukutuku Node.js, ko te whārangi Buildpack i te menu Advanced e whakaatu ana i te āhuatanga Kapsule i whakatau ai kia whakawhanake ai tō tauprogramu. Ka rere te kitenga i ngā kōnae i te pūtake pūkete, ā ko te tuatahi ka toro katoa:
| I Kitenga | Pīpiro |
|---|---|
| Custom buildpack | kapsule.config.yaml kapsule.config.yml rānei i te pūtake |
| Dockerfile buildpack | Dockerfile i te pūtake |
| Node.js | package.json me tētahi start, build dev rānei whakahau |
| Python | requirements.txt pyproject.toml rānei |
| PHP | composer.json |
| Static | index.html i te pūtake |
Mēnā kāore he āhuatanga e tutuki, ka kī te whārangi ā ka whakaaturia ngā pīpiro tautoko. Whakauru tētahi Dockerfile kapsule.config.yaml rānei kia mau koe i te whakawhanake.
Te Whakatakotonga i te Build
Pīwhiri Run build kia rāngitia. Ka pokapoka te whārangi ia tekau ma toru hēkona i te wā e haere whakamua ana tētahi pukumahi, ā ko te tēpu Recent builds e whakaatu ana i ngā pukumahi whakamutunga me ō rātou wā tīmata, momo, tūmataiti, te roa i whakatakotoria me te whiriwhiri āhuatanga i puta. Pīwhiri tētahi rarangi kia kiteā tō kupu harikoa.
Kāore e kore, e tahi anake te build kāore e kore ki te haere whakamua. Mēnā kāore e kore, ka whakatupuranga tētahi tuarua i te wā e rāngitia, e haere rānei, e kī ana A build is already in progress, arā te whakatakoto: e rua ngā build e tuhi ana i te putanga ōrite kāore e kore, ka tīnei te site kua tohu.
Te Whakatutū
Pīwhiri Disconnect me te whakaae. Ko te whakaae e whakamarama ana i te tūraru tapu: ko te Git tohu tautoko me te deploy key ka tangohia, ā te paetukutuku kōnae kāore e pānuitia. Ka noho te paetukutuku e whakaatu ana i tēnei kua tohu i muri.
Ka tīpiko i a ia ina muri ka mukua te deploy key me te webhook i ngā tautoko pūkete. Ka kore e mahi, engari ki te waiho i ngā āhuatanga tutu noa iho ka uaua ake te arotake o muri.
Whakatika Tūraru
Kāore ngā peia e whakatupuranga i tētahi āhuatanga. Taunui i te auto-deploy pūtaki tuatahi, ā kātahi i te webhook i tō pūkete. Ko te nuinga o ngā kaiwhakarato e whakaatu ana i ngā whakatupuranga o muri me ā rātou code whakahoki, e kī ana mēnā i whakawhiti te tono i tō pūkete.
Kā rahua te kopa. Kua ngaro te deploy key, kua whakapiri me tētahi pauwehe, kua whakauru rānei ki te pūkete hē. Kōpiri anō me te pūtaki Copy key kaua e kōpiri noa i te kupu nā tō ringa.
E whai i te tohu engari kāore he āhuatanga i te paetukutuku. Ko te output directory he hē pea. Mēnā ka tuhi tō build i dist ā ko te output directory he iti tahi, kāore e tae ngā kōnae whakawhanake ki te pūtake whakaaturia.
Ko te katoa e kī ana pending ā kāore e neke. Kua rāngitia te tohu engari kāore i tae ki te raurangi. Whakatupuranga tētahi noa iho Deploy now me te arotake i te whārangi Deploys mō tētahi rarangi hapa.
Te Wāhi Hei Haere
- Preview Deploys For Pull Requests ka whakauru tētahi URL ā-PR i runga i tēnei whakatakoto.
- Storing App Secrets For a Site mō ngā whakakawhiti e hiahia ana tō build me tō whakatakotonga.
- Site Activity Log ka tuhia ngā āhuatanga tautoko i konei.