Te Whakatinana i Tō Kaupapa

Once a repository is connected, Orbit deploys on every push to your production branch: it clones the commit, installs dependencies, runs your build, packages the output and starts serving it. This…

Kia tae ana te pūkete ki te hononga, ka whakatupuranga ā-Kapsule Orbit i ia tūkipunga ki tō rāngai whakatupuranga: ka kōkiri i te whakatukunga, ka whakarite i ngā whakawhitiwhiti, ka āhei i tō hanga, ka pūkete i te huaputa me te timata whakamahinga. Ka āta whakamārama tēnei aratohu i te haupūtanga whakatupuranga katoa, me pēhea te whakaputa i tētahi mā te ringa, me ngā whakahaere e whakatau ai mehemea ka tae te whakatupuranga ki te mataaho.

Me Pēhea Te Mahi O Ngā Whakatupuranga Aunoa

Ia tūkipunga ki te rāngai kua tautuhia hei Production branch i roto Settings, ā, Git, ka whakatupurangatia. Ka mahi ā-Kapsule Orbit:

Ka whakatangia te kaupapa tūkipunga mai i GitHub, GitLab, Bitbucket rānei.
Ka āwhaitia te whakatupuranga me te tohu i tētahi tuwhera hanga.
Ka kōkiri i tō pūkete ki taua whakatukunga tino.
Ka whakaora i tō node_modules kua haumia mēnā kei te āwhina te haumitanga hanga i tō mahere.
Ka āhei i tō whakahae whakarite (npm ci, yarn install rānei pnpm install, i kite i tō konae raka).
Ka āhei i tō whakahae hanga.
Ka pūkete i te whakahuahua huaputa ki tētahi mea whakatupuranga me te tukuake.
Ka whakatika te āhuatanga kia whakamahinga ai te mea whakatupuranga hou.

Ka whakaata te whārangi taipitopito whakatupuranga i ēnei nei hei Build phases ingoa: Clone, Cache restore, Install, Cache save, Build, Upload, Done. Ka oti te nuinga o ngā kaupapa i te kotahi ki te toru meneti.

Te tirohanga whakahuihuinga Kapsule Orbit e whakaata ana i te hanga o muri

Ngā Āhuatanga Whakatupuranga

Āhuatanga	Tikanga
Queued	E tīhoi ana mō tētahi tuwhera hanga. Ka whakaata te whārangi whakatupuranga i tō wāhi i roto i te āwhau
Awaiting approval	I āwhitia nā te mea kei te Require approval for production. Me whakaae tētahi tangata ki a ia
Building	E whakarite ana i ngā whakawhitiwhiti me te āhei i tō whakahae hanga
Deploying	Ka oti te hanga, e āwhitia ana te mea whakatupuranga hou ki mua i te whakawhiti
Succeeded (e whakaatuhia nei hei Live)	E whakamahinga ana i te whakawhiti. Ka mahia te whakatupuranga mā tētahi CURRENT tohu
Failed	He hapa i te hanga rānei i te tohe whakatupuranga. Tukuake te āhuataki kia kite ai kē
Cancelled	Tīhia i mua i te whakaotinga, e koe anō rānei e tētahi tūkipunga hou ki tō rāngai ōrite
Rolled back	I whakakāore e tētahi whakahokenga ki tētahi hanga o mua

Te Tirotiro i tētahi Hanga E Haere Tonu Ana

Ko te Overview kaupapa ka whakaata i te hanga o nāianei mā tētahi āhuataki whakawhiti ora i roto i te Latest build opurua. Pāwhiri i Full details kia whakatūwhera i te whārangi taipitopito whakatupuranga, ka tāpiri anō i tētahi pae aronga hanga, he wā tūtakitaki, te wāhi āwhau, me te whakapoto wā hanga whakawehewhia i te wā /help/screenshots/orbit-deploying.png.

Mēnā kei a koe te āhea kia nui atu i tētahi hanga whakatahi me he āwhea katoa nei, ka whakaatau te whārangi i tēnei tika: e whakaata ana i te maha o ō tuwhera hanga whakatahi e whakamahina ana, ā, ka timata te whakatupuranga āpitopitohia i te wā ka whakawhitia tētahi. Ka kite koe i ia hanga e rere ana puta noa i ō kaupapa katoa i Kapsule Orbit, ā, Queue.

Te Whakaputa Whakatupuranga Mā Te Ringa

E whā ngā āhuatanga hei whakatupurangatia me te kore he tūkipunga whakatukunga hou.

Whakatupurangatia Anō Te Whakatukunga O Muri

Whakatūwhera i te kaupapa.
Whakatūwhera i te Deployments ripa.
Pāwhiri i te whakatupuranga e hiahia ana koe, kia whakatūwhera i tana whārangi taipitopito.
Pāwhiri i Retry build. Whakamahia More retry options, ā, Retry with cleared cache, mēnā kei te whakapae koe he haumitanga kua whakatokotoko.

Whakatupurangatia Inaianei

Ka piki te pūmau Deploy now i te ripa Deployments, ka āwhaitia tētahi hanga hou o te upoko o nāianei o tō rāngai whakatupuranga.

Whakatūtaki i tētahi Whakatupuranga

Ka tukituki tae tōkupū he whakatupuranga. Ka kōpī ā-Kapsule Orbit te whakatukunga i te wā ka tūtaki, nō reira te hanga ka āhei ake, ko te whakatukunga i whakaaetia e koe, ehara i a āu tae mai ki te takutaku.

Kopikopinga Whakatupuranga

Ko te kopikopinga whakatupuranga he URL ngaro ka āwhaitia he hanga i te wā ka tuku tētahi āhuataki POST ki a ia. Whakamahia rātou ki te hanga anō mai i tētahi CMS pūkoro, tētahi tohu cron, tētahi pīpalini CI rānei. Whakaritea ki te ripa Hooks o te kaupapa. Tirohia Triggering Deployments Via Deploy Hooks.

Ngā Whakatakotoranga Hanga

Ka kite ā-Kapsule Orbit i ngā taunoa e pai ana mō te nuinga o ngā kaupapa. Whakatohu tētahi i ērā i Settings, ā, Build settings:

Āhuatanga	Takenga ki te whakaao	Whakahua
Install command	`npm ci (auto-detected)`	`npm ci`, `yarn install --frozen-lockfile`, `pnpm install`
Build command	`npm run build (auto-detected)`	`npm run build`, `next build`, `vite build`, `astro build`
Output directory	`dist (auto-detected)`	`dist`, `.next`, `out`, `build`, `.output`
Root directory	`/ (monorepo subdirectory)`	`apps/web`
Node.js version	Platform default	`18`, `20`, `22`

Waiho te āhuatanga ā-hoki kia pupuri i te uara i kite aunoa. Ko te taipitopito katoa, tae atu ai ki ngā uara ia-kaupapa me ngā hē ka take kia rahua te whakatupuranga tuatahi, kei Configuring Your Build Command and Output Directory.

Ko te whakatakotoranga Root directory he mahi nui ake i te whakatika i te whakaharikoa mahi anake. Ka tukitukia ngā āhuataki kua whakatika noa i ngā konae ki waho tērā ara ka whakapātitia aunoa, nō reira te monorepo karekare he hanga i ia whakatukunga.

Te Whakatau Me He Whakatupuranga Ka Āheia

E tonutanga te Kapsule Orbit i ngā kara tino rerekē. Kei Settings ngā āhuatanga.

Ngā Raka Whakatupuranga

Whakamahia tētahi raka ki te aukati i te whakatupuranga i roto i te āhuatanga tūkino, te wāhi whakarite rānei te raka whakatukunga.

Whakatūwhera i te kaupapa.
Pāwhiri i Lock deploys.
Tāpiri i tētahi take waiwai rānei.

I te wā kua rakia, ka whakapātitia aunoa ngā whakatupuranga tūkipunga me te karanga me Production deploys are locked mā tō take. Ka mahi tonu ngā whakatupuranga mā te ringa, he mahi ahu hoki tēnei: ka aukati te raka i ngā whakatupuranga he pokapū anake, karekare te whakatika e ngana koe ki te tuku. Pāwhiri i Unlock deploys kia whakawhitia.

Whakaae-Āhuatanga Mō Te Whakatupuranga

Whakakapia te Require approval for production i raro i Deploy protection. Ka mutu tonu ngā whakatupuranga whakatupuranga tūkipunga ki Awaiting approval kia whakatūwhera tētahi tangata i te whakatupuranga me te pāwhiri i Approve rānei Reject. Karekare te āhuataki Panel deploys me ngā kopikopinga whakatupuranga.

Whakarite Kia Pai Te Whakatupuranga Taumata Tuatahi

Ka āwhiti Require staging success before production tētahi whakatupuranga tūkipunga kia whakatupu te āhuataki taumata i te whakatukunga ōrite. Ka taea tonu te whakaae mā te ringa kia karo ai te tatari.

Ngā Whakatakotoranga CI e Āhuatakina

Ka whakahaere whakatupuranga ki tō CI ake i CI required checks. I GitHub, āwhitia ngā kupu ingoa mahi Actions whakawehewhia e comma me kia harikoa katoa. I GitLab, ka tatari tētahi uara ehara i te ā-hoki mō te pīpalini katoa. He rahua CI ka anuanu te whakatupuranga Kapsule Orbit aunoa.

Te Rārangi Aukati Whakatupuranga

Ka pāhekoheko Deploy freeze schedule i ngā whakatupuranga tūkipunga ki waho i ngā whakaao waiwai: tētahi pāenga pokapokane, tētahi wāhitanga waiwai rānei, tokorua rānei. Ko ngā wā katoa i UTC. Karekare te āhuataki manual deploys me ngā kopikopinga whakatupuranga.

Ia whakahaere i runga ake nei ki te aukati aukati pokapokane anake i ngā whakatupuranga tūkipunga. Ka haere tika tonu ngā kopikopinga whakatupuranga me ngā whakatupuranga pūmau Panel. Mēnā he tōnuhanga i tētahi kopikopinga URL, karekare ētahi o ēnei whakatakotoranga ka mutu i a ia āwhaitia he hanga. Whakatīhau i ngā kopikopinga URL whānui. Tīhaua te kopikopinga URL me te whare pikitanga āwhina.

Te Whakapātiti Hanga Karekare E Hiahia Ana Koe

Ignored paths: ngā tauira purongo whakawehewhia e comma. Mēnā ka ōrite ia konae i tētahi tūkipunga, ka whakapātitia te hanga. *.md,docs/** ka aukati i ngā whakatukunga taipitopito kia kaupapa ā-whakatupuranga.
Branch ignore patterns: ka whakapātitia ngā tūkipunga mai i ngā rāngai ōrite tino. dependabot/*,renovate/* ko te āhuataka noa.
Git tag deploys: whakatupurangatia ki te whakatupuranga i te wā ka tūkipungahia tētahi tohu ōrite, whakamahia tētahi purongo whānui me v*.

Haumitanga Hanga

Ka haumia ā-Kapsule Orbit node_modules i waenganui i ngā hanga i te roto o ngā mahere Liftoff me Apex. I te wā ka whakamahina tētahi haumitanga, ka whakaata te whakatupuranga mā tētahi Cache hit tohu me te tohu Install kua poto harikoa. Ka whakaata tētahi hanga marama me Cold build i tāu.

Kia pakikitia tētahi whakarite katoa, whakatūwhera i Settings, ā, Clear build cache, me te whakatika. Ka āhei te whakatupuranga nā ia āhuataki kaupapa mai i te whakarite katoa.

Mēnā he rahua hanga i tētahi āhuataki karekare koe e mārama ai, me ka pai te whakatukunga i a koe ki te ā-ā, tohu i a ia me te haumitanga whakawhitia i mua i te timata te whakatika i tētahi. Ko tētahi pūtake noa kāore e mārama te haumitanga kua whakatokotoko.

I Te Wā He Hē Te Whakatupuranga

Ka taea ā-Kapsule Orbit te hopu i tētahi whakatupuranga kino mā koe kāore noa i tua te mataaho:

Auto-rollback on failure ka whakaora i te whakatupuranga mōhiotanga o muri aunoa mēnā he rahua te whakatupuranga whakatupuranga.
Health check ka tiki i tētahi ara i ōhia e koe i muri i ia whakatupuranga whakatupuranga. Ko te āhuataki ehara-2xx i roto i te 15 hēkona ka whakaora te whakatupuranga mōhiotanga o mua.
Smoke tests ka āhei i ngā āhuataki GET ki te 10 ara, karekare noa, i muri i ia whakatupuranga pai me te kawe rapu-kore rānei. I te āhuataki auto-rollback, he rahua smoke test ka whakahokenga te whakatupuranga.

Kia whakahokenga āhuataki e koe anō, tirohia Rolling Back a Deployment. Kia whakaata ai āu i te āhuataki he rahua he hanga, tirohia Troubleshooting Failed Builds.