Orbit
Te Hononga i te GitHub Repo
Before Orbit can deploy anything from GitHub you install the Kapsule Orbit GitHub App on your GitHub account or organisation and choose which repositories it can see. This guide walks through the…
Kia taea ai e Kapsule Orbit te tūmitumita ētahi mea mai i GitHub me tāpiri tuatahi i te Kapsule Orbit GitHub App ki tō pūkete GitHub, ki tō iwi rānei, ka tohu i ngā repo e taea e ia te kite. Ka haere tēnei aratohu i roto i te tāpiri, te tohu i tētahi repo, te hanga i te kaupapa, me te mea me mahi ina kore e puta tētahi repo e manako ana koe.
I mua i te Tīmatanga
Me whai mana koe hei tāpiri i tētahi GitHub App ki te pūkete, ki te iwi rānei e puta ai te repo. I runga i tētahi pūkete takitahi he mea noa tēnei. I runga i tētahi iwi me noho koe hei kaiwhakahaere, me whakae rānei tētahi kaiwhakahaere i tō inoi tāpiri mai i ngā tautuhinga o te iwi.
Paenga 1: Tāpiri i te Kapsule Orbit GitHub App
- I roto i KPanel, pīkia Orbit i te taha maui.
- Pīkia New project.
- Waiho te aratau i te Import Git Repo.
- I te paenga 1, pīkia Connect GitHub.
Ka tukuna koe ki GitHub hei tāpiri i te Kapsule Orbit app. Ka ui a GitHub ki te wāhi hei tāpiri (tō pūkete takitahi rānei tō iwi) ka ui rānei ki te whakatae i All repositories rānei Only select repositories.
Tohu Only select repositories ka tīkia ngā repo anake e whakamanahau ana koe hei tūmitumita. Ka taea e koe te tāpiri i ētahi atu i muri mai i GitHub kāore e whakawhiti, e hanga anō rānei i tētahi mea i roto i Orbit, ā, ka iti te whakapakariri o te hononga.
Ka mutu mai, ka tukuna koe e GitHub ki KPanel. Ka whakaatu te paenga 1 i Just connected, ā, ka uta ngā repo ki te paenga 2.
Paenga 2: Tohu i tētahi Repo
Ka puta ō repo e taea ai hei rārangi. Pīkia Select ki te tahi e whakamanahau ana koe hei tūmitumita. Ko ngā repo rua he Private tūtohu; ka tūmitumita a Orbit i ngā repo tūmatanui me ngā repo rua.
Ka tohua, ka whakaatu te repo i tētahi Selected tūtohu, ā, he Change hononga hei tohu i tētahi atu.
Mēnā Kāore e Puta Tētahi Repo
Ka taea noa e Orbit te rārangi i a ia e kite ai te GitHub App. Mēnā kāore tētahi repo e manako ana koe:
- Pīkia Reconnect GitHub i te paenga 1 hei tūtaka i te ia āhuatanga tāpiri, me whakatūwhera rānei github.com/settings/installations tika atu.
- Whakatūwhera te Kapsule Orbit whakamahinga me tāpiri i te repo e nui i Repository access.
- Hoki ki KPanel. Ka anui anō te rārangi.
Mēnā e whakaatu ana te pūtaiao No repos accessible, ka tāpiria te app engari kāore ia i whakaaetia ki ngā repo. Whakatūwhera ngā tautuhinga GitHub App me whakatae ki te irotahi o tēnei.
Ētahi atu take noa:
- Ko te repo he mea ā te iwi kāore koe i tāpiri ai i te app. Ko te tāpiri i te app ki tō pūkete takitahi kāore e āwhina i ngā repo iwi.
- Kua kāore anō tēnei kaiwhakahaere iwi i whakaaetia i tō inoi tāpiri. Kia whakaae rātou, ka noho te app ēngari ka kite i te kore.
- I whakawhiti, i whakarenarena rānei te repo i muri i te tāpiri i te app. Tūtakahia te ia āhuatanga tāpiri hei whakahou i a ia e kite ai a Orbit.
Paenga 3: Whakatūhia tō Kaupapa
E tohua ana tētahi repo, e ui ana te paenga 3 ki a rua mara:
| Mara | He aha tana mahi |
|---|---|
| Project Name | Te ingoa whakaatu i KPanel, hei tauira my-app |
| Deploy URL | Te āhuatanga i raro i kaps.run, koia my-app ka huri ki my-app.kaps.run |
Pīkia Create project. Ka kona a Orbit i te repo, ka raupatu i tō tuatahi hanga, ka whakataki i a koe ki te tirohanga kaupapa i te taea e koe te titiro i te ia ā-ā-ā.
Ka tautuhia te Deploy URL slug i te hanga anake ā kāore e taea te whakarereke i muri. Mēnā e hiahia ana koe i tētahi wāhi tūmatanui rerekē i muri, whakahoahoa i tētahi rohe ā-take, kaua e mātai noa i te slug. Tīro Adding a Custom Domain to Your Project.
Te Mea e Whakatūtuhia Automatika e Orbit
E hanga ana te kaupapa, ka whakarite i te pīkia-hei-tūmitumita mō koe. Kāore he webhook hei whakatureture i te ringa:
- Ko ngā pīkia ki tō paenga whakaputa e raupatu i tētahi tūmitumita whakaputa.
- Mēnā kua āhei Branch previews, ko ngā pīkia ki tētahi paenga kē e hanga i tētahi tirohanga tūturu i
branch-<branch-name>.kaps.run. Tīro Branch Preview Deployments in Orbit. - Ka takohia te mahi tono hiki, koia he tirohanga tūmitumita e whakaatu i te nama PR e puta ai.
- E tuturu, e whakaropuia rānei tētahi tono hiki, ka okioki tana tirohanga, me te whakakatoa i te rokiroki i roto i te iwa tahi rā.
Te Whakawāea i ngā Tūmitumita ki GitHub Actions
Mēnā e rere ana koe i ngā whakamatautau i GitHub Actions ka taea e koe te mahi a Orbit kia tatari. I Settings, ka CI required checks, whakauru i ngā ingoa mahi Actions tika, he whakawehea koma, hei tauira build,test,lint. Me whakapau āpiti ngā tohu ingoa i mua i te tūmitumita whakaputa i te pīkia i puta. E whakakāore noa a Orbit i te tūmitumita mēnā ka hapa te CI.
Ka pā tēnei ki te paenga whakaputa anake.
Te Whakahoahoa Anō, te Whakarereketanga i tō Whakamahinga
Hei whakareke i ngā repo e taea ai e Orbit te kite:
- Pīkia Orbit, ka New project.
- I te paenga 1, pīkia Reconnect hei tūtaka i te ia āhuatanga whakamahinga GitHub App.
Ā, whakahaere tika te whakamahinga i github.com/settings/installations. Ka tukuna ngā whakareke i konei i te wā ka rarangi anō a Orbit i ō repo.
Te Whakawehe GitHub
I te paenga 1 o New project, pīkia Disconnect.
Ka tango te whakawehe i te hononga i waenganui i tō Kapsule pūkete me GitHub. Ka pupuritia ō kaupapa me o rātou hītori tūmitumita, ā, ka haere tonu te tūmitumita nowhea e whakahaere ana i te toka, ēngari ka tu ngā tūmitumita i pīkia i te pīkia ki a ā au rānei e tū anō. Ka haere tonu te whakahoahoa pīkia, nā te mea ka tiki i te whāinga paenga i roto i te hononga kaihāpai: mēnā kua ngaro te hononga, ka hapa tētahi karanga pīkia me tēnei hapa kaore e tūmitumita i te kupu kōhanga.
Pānui e Hononga ana
- Deploying Your Project mō te ia rerekē tūmitumita katoa me ngā kuaha e whakahaere ai
- Configuring Your Build Command and Output Directory mēnā ka hapa te tuatahi hanga, e whakahaere rānei i te mea e kore
- Connecting a GitLab Repo me Connecting a Bitbucket Repo mō ētahi atu kaihāpai