Te Whakatakoto i nga Taurangi Kapawehewehe mo ia Ahuatanga

Orbit lets you decide exactly which builds see which environment variables, so production credentials never end up in a publicly reachable branch preview. This guide covers how scope and precedence…

Orbit e whakamārama ana ki a koe ko ēhea ngā tūbuild e kite ai i ēhea ngā taurangi taiao, kia kore ai ngā tohu mohio ā-whakatupuranga i te ao tūmatanui i roto i te preview pīrāngi. Ko tēnei arataki he whakaahua i te aha nei te whakakaupapa me te whakaraupapa, me pēhea te tāpiri i te taurangi hōnui-noa-iho, me pēhea te mana-whakatupuranga e oati ai, me pēhea te tirotiro i a ā te tūbuild i whakawhiwhia mai.

He Aha Tēnei e Whai Wāhi Nei

Ko te preview pīrāngi he tohu tūmatanui. Ka āhei te tangata me te hononga ki te utunga. Mēna he taurangi ka whakakaupapa ki ia taiao, ka whakauruhia ki te tūbuild o tēnei tirohanga, ā, mā te aha e mahi ai te tirohanga, mā tōu mana tohu ā-whakatupuranga e mahi.

Ko tēnā te take i te noa o tēnei whārangi. Ko te mea i raro iho nei ka whakahaere i te ture kotahi: kia noho ngā tohu huna ā-whakatupuranga ki te whakakaupapa ā-whakatupuranga, ā, kāore i tēnei wāhi.

Me Pēhea Te Whakakaupapa

Ko ia taurangi he whakakaupapa e whakatau ai i te wā e whakauruhia ai i te wā tūbuild.

Whakakaupapa	Whakauruhua ki roto i
Ia taiao (mōrearea ā-kaupapa)	Ia tūbuild o tēnei kaupapa, kia kore koe e whakatakoto herenga
He kaiwhiwhinga taiao motuhake	Ngā tūbuild o tēnā taiao noa iho

Mēnā kei te noho te tohu ōrite ki ngā taumata e rua, ka whakatū te mea ake. E takahia te kaiwhiwhinga taumata-taiao he taurangi mōrearea me te tohu ōrite. Ko te whārangi Env vars e kōrero ana i tēnei i te kupu whakatupuranga o te wāhanga Ia taiao: kei te whakawhiwhia te taurangi mōrearea ki ia tūbuild, ā, ka whakatū ngā kaiwhiwhinga taumata-taiao.

Ka taea hoki te whakatīkina te taurangi mōrearea me te kore e whakawhiwhinga. Ko te Available in whakahaere e tukuna ana atu e toru ngā momo taiao (production, staging, preview) ā, ka taea e koe te kemo i tēnei.

Te Tāpiri i te Taurangi me te Whakakaupapa

Tuwhera i tō kaupapa ki roto i te Orbit ā, pīoi i te Env vars pūranga.
Tīpako ki te puka Add variable i te mutunga.
Whakakī i te KEY me te uara.
Whakamahia te Scope tīwhana:
- All environments (project-wide) ka whakauruhu ki ia tūbuild.
- [Environment name] only ([type] override) ka whakakaupapa ki tēnā taiao noa iho.
Mēna koe i whiriwhiri i te mōrearea, whakamahia te Available in pūtona hei kemo i ngā momo taiao e kore e whakawhiwhi i tēnei taurangi.
Tīkamatia Mark as secret mō te mea e harikoa ai.
Pīoi i te Add.

I mua i te whakapainga, e kōrero ana te puka i te aha e mahi ana. E whakaatu te kaiwhiwhinga i te karaihe e kīa nei ka whakatukanga noa ki ngā tūbuild o tēnā taiao ā, ka whai tonu te taurangi mōrearea i tēnei wāhi. Ko te taurangi mōrearea kua whakatīkina e whakaatu ana tika ko ēhea ngā momo taiao ka whakauruhia.

Te Tāpiri i te Taurangi Hōnui-noa-iho

E rua ngā huarahi ōrite:

Ki te Scope tīwhana, whiriwhiri i tō taiao whakatupuranga (he tohu kōura production āna), ā, ranei
Whakamura te whakakaupapa ki te All environments ā, kemo i a staging me preview i raro i te Available in.

Kia pēwhea koe i whiriwhiri, te taurangi kaore i te noho mēnā he preview ā tīkanga ranei he whakawhiwhinga ā-ataata tūbuild.

Ko te "kaore i te noho" he kaore i te noho, ehara i te wāatea. Ko te akoranga e pānui ana i a process.env.STRIPE_SECRET_KEY i te tūbuild preview ka whakatau undefined, ā, i runga i te aha i tuhituhia ai pea ka pēhia i te wā tūbuild rānei, ka mutu, ka noho tūturu ki te peka hē. Homai ki ngā preview he uara whakamatau, kaua he uara noa iho.

Te Tauira Haumaru

Ko te tauira e whakaoti whakapūmau nei i tēnei mōmā mō te nuinga o ngā kaupapa:

Tāpiria te production tohu-pūranga kua whakakaupapahia ki te taiao whakatupuranga noa iho.
Tāpiria he taurangi me te tohu ōrite, e pupuri ana i te uara whakamātau ā tīkanga, ki te whakakaupapa mōrearea.

Ka whakatau ngā tūbuild whakatupuranga i te uara kua whakakaupapahia ā-whakatupuranga nā te mea ka whakatū te whakakaupapa ake. Ka whakatau ngā preview me te ataata i te uara whakamātau. Kaore he taurangi e kore e āhua koa i te aha, ā, kaore he tohu mohio ā-whakatupuranga e eke i te preview.

Whakamahia ki:

Ngā URL pūtaiao whakatupuranga
Ngā tohu huna āwhina-whakatutuki, mā te whakamahi i ngā tohu whakamātau mō ngā preview
Ngā tohu tuku īmēra, kia kore ai te preview e tuku īmēra ki ngā kiritaki tūturu
Ngā tohu kaiwhakahaehere me ngā tohu waitohu
Mā te aha tēnei he utu i ia karanga

Te Tīnana i ngā Taurangi Whakatupuranga Ki te Ataata

Mēna kei te karohirohi tō taiao ataata ki te whakatupuranga ā, kei te hiahia koe ki te kaiwhiwhinga i te iti iho noa, kāore koe e hiahia kia tāpiri i te katoa.

Ki te Settings, rapua te Staging: environment variables ā, whakaatu i te Inherit production env vars. Ka whakatūhonotia ngā taurangi whakatupuranga ki ngā tūbuild ataata i te whakapae iti i ngā kaiwhiwhinga motuhake ā-ataata, kia whakatū tonu i ngā mea kua whakatakotohia e koe i te ataata.

Ko te tīnana ka kōkiri i ngā uara whakatupuranga ki roto i ngā tūbuild ataata, ā, ko ngā tohu huna ā-whakatupuranga hoki. Whakaatu noa iho mēna ka pokapokahia tō taiao ataata. Ko te ataata te atinga o te whakatakoto kupu-whakarārangi me te rarangi-IP, i roto i te Staging: access protection me te Staging: IP allowlist wāhanga o te Settings. Ko te whakaatu i te tīnana mō te taiao ataata kaore i te pokapokahia e kawe whakamuri i te whakaputanga e whakāhua nei i tēnei whārangi.

Te Tiro me te Whakatika i ngā Taurangi e Noho Ana

Ko te pūranga Env vars e whakaropu ana i ngā taurangi ki:

All environments i te timatanga, e pupuri ana i ngā taurangi mōrearea
He wāhanga e taea te whakatuwhera i ia taiao, e pupuri ana i ngā kaiwhiwhinga o tēnā taiao, me te kaute i te maha

I te runga i te koronga e wāwā ana i a production me preview ā, kaore staging ka whakaore i ngā tūbuild ataata, ā, ko tēnei rarangi tohu te huarahi tere e arotake ai i te roa rarangi.

Pīoi i te āhua whakatika hei whakaroa i te uara. Kaore e taea te whakaatu i te uara āhuatanga o te taurangi huna, me te whakakapinga noa iho.

Te Kōkiri me te Whakataurite i waenga i ngā Taiao

Copy variables between environments ka kōkiri i te huinga katoa i tētahi whakakaupapa ki tētahi atu. Whiriwhiri i te From me te To, ka tīkamatia te Overwrite variables that already exist in the target (āta), ā, pīoi i te Preview hei kite i te maha ka tāpirihia, ka whakabagihia ā ka waihohia i mua i te whakapainga.

Ko te Env sync check whārangi e whakataurite ana i te whakatupuranga me te ataata tohu i tohu ā, e whakaahua ana i te mea e noho noa iho i tētahi, he uara rerekē, me te mea e tuturu tahi. Ko tēnei te turanga tuatahi tika mō te "kei te mahi te ataata ā, ehara te whakatupuranga", ā, ranei.

Ko te rereketanga o te uara i waenga i te whakatupuranga me te ataata he mea noa ā āhuatanga mō te nuinga o ngā tohu huna. E kīa ana e te whārangi whakarite. Ko te mea koe e rapu ana he tohu kei te noho i tētahi taiao ā, te kore i tētahi atu.

Te Tuku i ngā Taurangi Ki waenga i ngā Kaupapa

Mēna he maha ngā kaupapa e hiahia ana i te tohu-pūranga ōrite, whakamahia te rōpū taurangi engari kaua te whakapaipai ki ia kaupapa. Haere ki te Orbit, ā, Env groups, hangai he rōpū, tāpiri ngā taurangi, ā, honoa ngā kaupapa e hiahia ana.

Ko ngā taurangi rōpū ka whakauruhia i te wā tūbuild ā, kei te mutunga o te raupapa whakaraupapa: ka whakatū ngā taurangi kaupapa-taumata me taumata-taiao i ngā taurangi rōpū. Ka taea e koe te 20 rōpū ki te kaute.

Ko te whakakorea i te rōpū ka whakakorea i ēnei taurangi i ngā tūbuild aianei o ia kaupapa honoa. Ko ngā tūbuild kua mutu kē kaore i te whakapānga.

Te Kawenga i te Whanui

Ko te Import .env pūtona e tuwhera ana i te pouaka whakatakoto. Whakatakoto te .env kōnae, whiriwhiri i te whakakaupapa, ā, e whakaahupea ana te Orbit he maha ngā taurangi i kitea ā, he maha e tīkamatia hei tohu huna. Ko ngā tohu e whai SECRET, TOKEN, KEY, PASSWORD me ētahi kupu ōrite ka tohua aunoa. Kei reira te Overwrite existing variables with the same key whiringa, kaore i tēnei.

Download .env ka whakaputa i te tauira o ngā ingoa taurangi noa iho, kāore ngā uara, mō te tuku ki te hōmihinui e whakawhiwhia ake ai nō ā rātau.

Whiriwhiri i te whakakaupapa i te karaihe kawenga i mua i te pīoi Kawenga, kaore i muri. Ko te kawenga i te katoa whakatupuranga .env ki te whakakaupapa mōrearea e peia nei te ia tohu huna whakatupuranga ki roto i te preview tūbuild i tētahi mahi, ā, ko te whakatika ko te whakakorea ā te tāpiri whānui, kaore te whakaroa tautuhinga.

Te Tirotiro i a Ā te Tūbuild i Whakawhiwhia Mai

Ko ia whārangi taipitopito whakatupuranga e rārangi ana i ngā tohu taurangi taiao ka whakauruhia i te wā tūbuild ā, e taurite ana ki a koe tautuhinga āhuatanga: tāpirihia, whakaroa, whakakorea, hāngai noa. Ko ngā tohu tī mai i te kaiwhiwhinga taiao motuhake, ko ngā pākihiwi mai i te taumata kaupapa.

Kaore e oka ā e whakaaturia ngā uara. Ko te puhihi i te tohu he SHA-256 matamata waihanga, he nui te ake hei whakatupato e rua ngā taiao he noho i te uara ōrite kaore e whakamoha.

Mēna i whakaroa te tautuhinga i muri i te whakatupu i tēnā whakatupuranga, ka kīa te whārangi tēnei me te Environment variables updated since this deployment karaihe ā, e whakahoki koe ki te whakaaro ko te whakaroa kaore e whai hua kia tae noa ki te whakawhiwhinga whānui.

Kaore ngā whakaroa taurangi ka whai hua ki te whakatupuranga kei te noho nei tūmatanui. Ka whakauruhia i te wā e tūbuild ana. I muri i te whakaroa i te aha koe e pōhiri ana, whakataupuranga whānui.

Te Āhuatanga Āwhina

Environment Variables mō te āhuatanga pūtake, ngā tohu huna me ngā ture tohu ahuatanga
Branch Preview Deployments in Orbit mō te aha e mahi ai ngā preview tūmatanui
Viewing Build Logs mō te taurite taurangi taiao i te wā tūbuild