Te Whiringa i a Koe Build Command me te Output Directory

Getting Orbit to build your project correctly comes down to a handful of fields in Settings: install command, build command, output directory, root directory and Node.js version. Left blank they are…

Ko te whakatūtuki i a Kapsule Orbit kia hanga tika ai tō kaupapa e hāngai ana ki te maha iti o ngā āpure i roto i Settings: te whakahaeretanga whakauru, te whakahaeretanga hanga, te wharefakahau putanga, te wharefakahau pakiaka me te putanga Node.js. Mēnā ka waiho anō, ka tūtei motuhake, ā, ko te nuinga o ngā raru tuatahi-whakatūpuranga ka puta i tētahi uara tūteinga motuhake e kore e ōrite ana ki te mea e tuhinga iho ai e tō papa ake.

Te Wāhi Hei Rapu i ngā Settings

Whakatuwhera tō kaupapa i Kapsule Orbit, haere ki te Settings tab, ka kitea ai e koe te Build settings card.

Āpure	He aha tana mahi	Whakatūāpure mēnā ka waiho anō
Whakahaeretanga whakauru	Ka pēhea ka whakauruhia ngā āwhina i mua i te hanga	`npm ci (auto-detected)`
Whakahaeretanga hanga	Te whakahaeretanga e whakaputa ai i tō putanga	`npm run build (auto-detected)`
Wharefakahau putanga	Te kōpaki e whakapuakina ai e Kapsule Orbit i muri i te hanga	`dist (auto-detected)`
Wharefakahau pakiaka	Mo ngā monorepos, te āpārangi kōpaki e mau ai tō taupare	`/ (monorepo subdirectory)`
Node.js version	Te putanga nui Node hei hanga me te rere	Platform default

Me waiho anō tētahi āpure hei whakaae ki a Kapsule Orbit kia tūteinga motuhake. Pīaho Save i te Build settings card kia whakamahia ai.

Build settings card i ngā Settings kaupapa Kapsule Orbit

Ko te whakarereke i tētahi setting hanga e kore ai e whakarereke i te whakatūpuranga kei te ora tonutanga. Ko te setting hou e mahi ai mai i te whakatūpuranga panui. Whakatūpurangia anō i muri i te penapena, ā, ki te kore, e kore he mea te ahua kua puta mai.

Ngā Taunoa Anga

Next.js

Tokohia ngā aratau a Next.js i Kapsule Orbit, ā, ko te whakatau i te tahi hē te raru tuatahi-whakatūpuranga e hirahira rawa atu.

Putanga tūturu (output: 'export' i next.config.js):

Whakahaeretanga hanga: npm run build
Wharefakahau putanga: out
Aratau kaimahi: off

Aratau kaimahi (SSR rānei ISR), hei nui ake i ngā taupare Next.js:

Whakakaha Server mode i Settings, i raro i Runtime
Whakahaeretanga hanga: npm run build
Wharefakahau putanga: .next

Ki te kore te server mode i te mana, ka whakapuakina he taupare kaimahi-ine hei kōnae tūturu. Ko te whārangi kāinga ka utua te nuinga, ā, ko ia huarahi hihiri e 404. Mēnā koia tō tohu, koia tō take: whakakaha server mode me te whakatūpuranga anō i mua i te whakarereke i tētahi atu mea.

Astro

Ko te kōpaki putanga a Astro he dist i ia aratau. Ko te mea e rereke ana ko te mea mō te āea e tika ai te server mode rānei kāore.

output: 'static', te taunoa: wharefakahau putanga dist, server mode off
output: 'server' rānei output: 'hybrid': wharefakahau putanga dist, server mode on
Whakahaeretanga hanga: npm run build, rānei astro build

Vite (React, Vue, Svelte)

Whakahaeretanga hanga: npm run build, rānei vite build
Wharefakahau putanga: dist

Ka tuhinga tonu a Vite ki dist ki te kore koe i whakakāhui i build.outDir i vite.config.ts. Ki te mea koe, whakatakitaki te wharefakahau putanga kia ōrite ai.

SvelteKit

Whakahaeretanga hanga: npm run build
Wharefakahau putanga: build

Ko te āea e tika ai te server mode e whakawhirinaki ana ki tō āwhina: e kore e tika te āwhina tūturu, engari ka tika te āwhina Node.

Nuxt 3

Whakahaeretanga hanga: npm run build
Wharefakahau putanga: .output
Server mode: on

Remix

Whakahaeretanga hanga: npm run build
Wharefakahau putanga: build
Server mode: on

Express rānei he Node API Māori

Whakahaeretanga hanga: npm run build
Wharefakahau putanga: dist
Server mode: on

Ka whakatakoto te server mode i npm start i muri i te hanga, ā, me tipatopatia e koe he start script me te timatanga o te kaimahi.

Create React App

Kua maumahara ki te muri te Create React App i te pūtaiao me kore he whakatauranga pai mō te kaupapa hou, engari ka hangaia pai ngā mea e tū ana.

Whakahaeretanga hanga: npm run build
Wharefakahau putanga: build

Plain HTML rānei he Static Site Generator

Me waiho anō te whakahaeretanga whakauru ki te kore he package.json
Me waiho anō te whakahaeretanga hanga hei whakapuaki i te tūrangawhare hei te kāore, rānei whakatakitaki i te whakahaeretanga o tō kaiwhakatūnga
Wharefakahau putanga: . mō te takiwa pakiaka, rānei tētahi kōpaki e tuhinga iho ai e te kaiwhakatūnga

Node.js Version

Tāuru te putanga nui tonutanga: 18, 20 rānei 22. Ko te āpure hint e kī ana kāore. Ko tētahi atu mea, pēnei i 20.11.0 rānei v20, e kore he mea e tīkina e te āpure nei.

Ko te putanga e whai ana ki te hanga me, mēnā he server mode on, ki te whakatakitakinga hoki.

Kō te putanga engari kāore e whakawhirinaki ki te taunoa. He āwhina e hiahia ana i te putanga hou Node ka hinga i te whakauru me te hapa kāore i te kī "wrong Node version" i te nuinga o te wā, ā, kō te kō te whakatautohe e muku atu i tēnei awe katoa.

Monorepos

Whakatakitaki te Root directory ki te huarahi o tō taupare, hei tauira apps/web. Ka whakawhiti a Kapsule Orbit ki tērā kōpaki i mua i te rere o tō whakahaeretanga whakauru me te hanga, ā, ka tohaina te wharefakahau putanga ki a ia.

Ko te āpure hint e whakatupu ana i te tuarua, he mahinga whai ake: ko ngā pukumahi ka rereke atu i tērā huarahi ka mutu motuhake. He monorepo me te whā kaupapa Kapsule Orbit e hangaia anō te wai e pahemo ai te tohu, e tiaki ai i te wā me ngā meneti hanga.

Ka taea e ia āhuatanga te whakakāhui i te wharefakahau pakiaka motuhake, i raro i te Staging: build overrides i Settings, he mea pai mēnā ka hanga te staging i tētahi ahuatanga atu.

Staging Overrides

Mēnā he āhuatanga staging tō kaupapa, ka whakaatu te Settings he Staging: build overrides āpure me ngā āpure ōrite. Mēnā ka waiho anō tētahi āpure, ka tango i te uara kaupapa-taumata, nō reira ka taea e koe te whakarereke i te whakahaeretanga hanga mō te staging, hei tauira ki npm run build:staging, me te waiho anō i a ia atu.

Ko te staging e rua ngā whakatakitakinga e pā ana kei tēnei taupunga: he rīpeka, he kupuhipa whakamātau, he rarangi IP whakamātau, te whakahoki anō ki te hapa, me te Inherit production env vars tūritori.

Build Cache

Ka kōkiri a Kapsule Orbit i node_modules i waenga i ngā hanga i te Liftoff me Apex plans. Ko te whārangi whakatautohe whakatūpuranga e whakaatu ana Cache hit rānei Cold build, tahi ki te wā whakauru, nō reira ka kite koe he mea pai te cache ki tō kaupapa.

Kia pakikipakikitia te whakauru katoa, whakatuwhera Settings, pīaho Clear build cache, me te whakatūtuki.

E kore te whakakore i te build cache e taea te whakahoki, ā, ka rere te whakatūpuranga panui mō ia āhuatanga te whakauru katoa mai i te kore. Ki te monorepo nui he hanga māhorahora, nō reira me mahi kia mahaki rānei kāore hei whakahoki tuhamatuha.

Ngā Raru Noa

"Whakapia te hanga engari he 404 te whakaatu ā-pae." Kua hē te wharefakahau putanga: ka whakapuakina e Kapsule Orbit tētahi kōpaki e kore nei tō putanga hanga. Titiro ki te kōpaki e hanga ai tō hanga. Ka tuhinga e Vite dist, ka tuhinga e Next.js static export out, e Next.js server mode ka whakamahi .next, Create React App me Remix ka tuhinga build, Nuxt ka tuhinga .output.

"404 anake ki ngā huarahi hihiri, ka pai te whārangi kāinga." Kua off te server mode ki te taupare e hiahia ana. Titiro ki te āpārangi Next.js i runga ake nei.

"Module not found" i te whakatūpuranga tuatahi. Ē tika ana te whakauru i te kore i te rere, rānei i te rere me tētahi kaiwhakauru kete atu i tō whakamahi tonutanga. Whakatakitaki te whakahaeretanga whakauru: npm ci, yarn install --frozen-lockfile, rānei pnpm install --frozen-lockfile. Titiro anō kua toea e koe he whakamarama: mēnā he package-lock.json me yarn.lock i te tūrangawhare, e kore pea te kaiwhakauru tūteinga motuhake he mea tika.

"Whakamarama roaroa." npm ci me ngā ōrite frozen-lockfile e kore e mahi mēnā ka rerekē te whakamarama ki package.json. Whakatakitaki tō kaiwhakauru kete tonutanga me te toea i te whakamarama hōu. Ko tēnei te hapa tuatahi-whakatūpuranga e nui ake, ā, e kore koe e whakahoki tonutanga, hei aha ai koe e rangirua ai.

"Ko te tahi anake o aku taupare i te monorepo e whakatūpuranga." Koia te wharefakahau pakiaka e mahia ai tana mahi. Me hiahia he Kapsule Orbit kaupapa motuhake me tā ia wharefakahau pakiaka.

"Kua hē te Node.js version." Whakatakitaki te Node.js version āpure ki te putanga nui tonutanga.

Ka takahi te hanga i te mahuika rānei ka kī te pīhi i te kōpaki. E rua āhuatanga te rohe o te miihini hanga: ko Launch ka 1 vCPU, 1 GB RAM me 4 GB disk; Liftoff ka 2, 2 GB me 8 GB; Apex ka 4, 4 GB me 16 GB. Ko te tāpiri NODE_OPTIONS=--max-old-space-size=2048 hei taurangi āhuatanga anake ka tautoko i te rohe tino RAM o te miihini. Titiro Orbit Plan Limits.

Āhuatanga E Whai Ake

Supported Frameworks and Runtimes in Orbit
Troubleshooting Failed Builds
Environment Variables mō te whakatunga wā-hanga