Orbit
Nga Taurangi Kaparetanga
Environment variables hold the configuration and secrets your app needs at build time and at runtime, such as API keys, database URLs and feature flags, without any of it living in your repository…
Kei hea Te Ngā Taurangi Ahumahi
Kei roto i ngā taurangi ahumahi te whirihora me ngā huna a tō āpaka, ka whai mahi i te wā hanga me te wā tuku, pērā i ngā kīmutunga API, ngā URL pūtabase, me ngā haki āhuatanga, kāore e noho ō rātou i roto i tō repository. E takoto nei i tēnei aratohu te wāhi e noho ai ia i roto i Orbit, me pēhea te ārarangi me te whakatakinga e mahi, te tāia o te uara hei huna, te whakakupunga whakatūtuki me te tango, me ngā hē e whakaputa ai i tētahi taurangi kore tautuhi.
Kei Hea Rātou e Noho
Tuwhera i tō kaupapa i roto i Orbit ka panga i te Env vars tab, i /orbit/<project-id>/env-vars.
Kua whakarōpū te whārangi ki ngā waahanga:
- All environments i runga ake nei: ngā taurangi a te kaupapa pūtake, e waatea ana i ia hanga.
- He waahanga ka taea te whakatūkurua mō ia ahumahi (Production, Staging, me ngā arokite e whānuitia) e tutuki ana i ngā urupare o taua ahumahi.
Kei runga ake i te rārangi he pouaka rapu me he Secrets only tātari, ko aua anō te whakatere tere i roto i tētahi rārangi roa.
Me Pēhea te Ārarangi e Mahi
| Ārarangi | He aha e āhei ana |
|---|---|
| All environments (project-wide) | Whakaritea ki ia hanga o tēnei kaupapa |
| Environment-level override | E pā ana ki taua ahumahi anake, ka riro i te uara o te kaupapa pūtake mā taua kī |
E kī atu ana te teretitara i te whārangi i te ture: kei ia hanga tonu ngā taurangi o te kaupapa pūtake, a ko ngā urupare ahumahi-taumata ka taukaha.
Ko te tūāpapa tikanga he kaupapa pūtake DATABASE_URL e tohu ana ki tētahi pūtabase whakamatau, me tētahi urupare taumata whakatupuranga e tohu ana ki te mea tūturu. Ka whaiwhai ngā hanga whakatupuranga i te pūtabase tūturu, ka whaiwhai ngā mea anō katoa i te mea whakamatau, a kāore he mea e tāpirihia e koe me te āhuatanga hei whakawhiti i ngā tukunga tohu whakatupuranga ki tētahi arokite.
Kei reira anō tētahi Available in ārai i ngā taurangi o te kaupapa pūtake, ka whakaaetia a koe ki te whakakore i ētahi momo ahumahi (production, staging, preview) mula i tētahi taurangi e kaute ana hei kaupapa pūtake.
Ko te whakamārama katoa mō te ārarangi ia ahumahi, tae atu ki te take haumaru, kei roto i Te Whakatakitaki Taurangi Ahumahi Ki ia Ahumahi.
Ka whakaritea tētahi taurangi kaupapa pūtake ki ngā hanga arokite wāhi, a ka kitea ngā URL arokite e te katoa he hononga. Ko ngā tukunga tohu pūtabase whakatupuranga, ngā kī utu kaha me ngā tohu kaiwhakahaere me whakatakoto ki te whakatupuranga anake. Ko tēnei te mea anake me pea te nuinga ko te tika i tēnei whārangi.
Te Tāpiri i tētahi Taurangi
- Titiro iho ki te Add variable tukutuku i te waewae o te Env vars tab.
- Whakauru i te KEY, hei tauira
NEXT_PUBLIC_API_URL. - Whakauru i te value.
- Tohu i tētahi Scope: All environments (project-wide), or a specific environment override.
- Mena koe i whiriwhiri ai i te kaupapa pūtake, whakamahia ngā Available in pūtton ki te tohu i ngā momo ahumahi kāore e tika te whakatutuki i tēnei taurangi.
- Tiki Mark as secret mō te mea uaua.
- Panga i Add.
Ka kōrero te tukutuku mō te mea e mahi ana koe i mua i te tīkarete: e whakaatu ana te urupare ahumahi he panui e kī atu ana ka ōkate noa ki ngā hanga o taua ahumahi, a e whakaatu ana tētahi taurangi kaupapa pūtake whakatautau he panui mo ngā momo ahumahi ka whakaritea ki a ia.
Ina Kitea ai ngā Moni
Ko te tāpiri, te whakamatau i te uaua, i te whakamatau taurangi, i te whakamatau i te taurangi kaore e whakahuatia te kawe tuku e noho ture nei. Ka whakaritea ngā taurangi ina tukurua te hanga, nō reira ka kite te moni mai i te next deployment ki muri. Tukurua muri te whakatipa i te mea i whakamatau ai koe.
E marama tonu ana a Orbit mō tēnei. Tuwhera i te whārangi taipitopito o tētahi kawe tuku, a mena kua moni te whirihora mai i te wā i hanga ai, ka kite koe i tētahi panui Environment variables updated since this deployment e kī atu ana kāore te moni e ōkate kia tukurua anō.
Ngā Huna
Tiki Mark as secret mō te mea kāore koe e whakatapiri ki tētahi korero: ngā kīmutunga API, ngā kupuheke pūtabase, ngā tohu, ngā kī hainatanga.
Ka takahitia ngā uara huna i te panel me ka āhuahia tētahi secret hūnga. E whakaatu ana ngā uara kāore he huna i tētahi (plain) tohu.
Kaore e taea e te uara o tētahi huna te panui whakamuri i muri i te tiakitanga, kaore mōu a kaore mo te tangata anō i te panel. Ka taea e koe te whakahuakina (panga i te tohu whakamatau, tuhia he uara hou, tiakina) engari kaore e taea e koe te whakahuakina. Pupuri i tō kope ake i tētahi kaiwhakahaere kupuheke i mua i te tiakitanga.
E takitaki anō a Orbit i te roa o te nohoanga o tētahi uara a e whakaatu ana i tētahi hūnga pakeke i ngā taurangi tawhito, me tētahi tohu e kī atu ana te huri. Ko tēnei he potikonga, kaore he koa.
Te Whakamatau me te Whakamutu
Panga i te tohu whakamatau kei te taha o tētahi taurangi ki te hurihuri i tōna uara. Panga Delete ki te whakamutu, a whakapae: e whakatupato ana te kōrero kua motu ngā hanga e whakawhirinaki ana, he whakaahuatanga tika o te mea ka puta i te kawe tuku a muri.
Whakakupunga Whakatūtuki me te Tango
E rua ngā pūtton i runga ake i te tab e whakahaere ana i ngā mahi nui.
Import .env ka tuwhera i tētahi pouaka whakatapiri. Whakatapiri i ngā ihirangi o tētahi .env kōnae, tohu i tētahi ārarangi, a ka kī atu a Orbit ki a koe e hia ngā taurangi i kitea me e hia ka tāia hei huna. Ka tēngia e ia ngā kī nō roto i ō rātou ingoa, nō reira ko te mea e whakahua ana i SECRET, TOKEN, KEY, PASSWORD me ētahi atu ka tāia hei huna i mua i te kaupunatanga. E whai ana tētahi Overwrite existing variables with the same key mōwhiti, kei te tūturu nei.
Download .env e whakatunga ana i tētahi template e whakahua ana i ngā ingoa taurangi anake, kāore ngā uara. I te whakaaro hei tohutohu mō tētahi hokowhitu e tutuki ana i ō rātou uara ake, kaore hei whakamuri.
Ko te tango i tētahi .env template kaore e whakauru i ngā uara, tae atu ki ngā taurangi kāore he huna. Kaore he huarahi ki te tango uara mai i Orbit. Mena me whai koe i tētahi kape o tētahi uara, tango mai i te wāhi i tuwhera ai koe i muri tuatahi.
Te Kōpī Taurangi I waenganui i ngā Ahumahi
Ko te Copy variables between environments panel e kōpī ana i tētahi huinga katoa mai i tētahi ārarangi ki tētahi atu. Tohu i tētahi From (kaupapa taumata, i tētahi ahumahi rānei) me tētahi To, tīkina te Overwrite variables that already exist in the target, ka panga i te Preview ki te kite i te tatau tika e hia ka tāpiritia, ka whakahuakina, me e hia ka karapuhia i mua i te tīkarete.
E whai ana tē Env sync check whārangi e whakataurite ana i te whakatupuranga me te whakatūtuki kī ki kī a e whakatupato ana he aha kei te kotahi noa, he aha te rerekē, me he aha te tūtika. Ko tēnei te taputapu tika mō "he aha i tika ai te whakatūtuki, engari kaore te whakatupuranga".
Te Tuhinga Taurangi I Waenganui i ngā Kaupapa
Mena he maha ngā kaupapa me te tukunga ake kotahi, whakamahia tētahi env group kāore e kōpī i te kaupapa. Haere ki Orbit, ā Env groups, hanga i tētahi rōpū, tāpiri taurangi, a honoa ngā kaupapa e hiahia ana.
Ka whakaritea ngā taurangi rōpū i te wā hanga, a ka taukaha ngā taurangi kaupapa taumata me te ahumahi ki te rōpū taurangi. Ka taea e koe te 20 rōpū i runga i tētahi kaute.
Ngā Kupu Whaimana
Ko te āhuatanga whakawhiti atu ki te pūkoro ka whakatau e tō whaimana, kaore e Orbit. E whakaritea ana e Orbit te mea katoa i roto i te ārarangi; ko te whaimana ka whakatau he aha te whakawhiti atu.
- Next.js: ngā kī e tīkina ana
NEXT_PUBLIC_ka tuhia atu ki te pukapuka pūkoro i te wā hanga. Ko te mea anō katoa ka mahue i te taha rāwaka. - Vite: ngā kī e tīkina ana
VITE_ka whakawhiti ki te pūkoro. Ko te wā hanga anake kau noa te mea anō katoa. - Node.js āpaka: ko te mea katoa i roto i te ārarangi kei
process.envi te wā hanga, me i te wā tuku ina Server mode kei te haria.
Kāore e tāia hei huna tētahi uara a ka whakatīkina anō NEXT_PUBLIC_ or VITE_. Ko te tohu huna anake e whakahaere i te mea e whakaatu ai te panel i a koe te uara; ko te tohu anake e whakahaere ai he aha te whakatupuranga a tō whaimana ki ia manuhiri pūkoro. Ko te tohu ka riro.
Te Tirotiro i Ōna Mea Hanga i Whakarangi Putake
Ko ia whārangi taipitopito kawe tuku e tuhia ana ngā keys taurangi ahumahi i whakaritea i te wā hanga, a ka rerekē mai i tō whirihora o nāianei: tāpiritia, hurihuria, whakamutu me kore e hurihuri. Ko ngā kī Teal mai i tētahi urupare ahumahi rānei, ko ngā kī pokapū mai i te kaupapa taumata. Kaore e tiakina, kaore anō e whakaatua ngā uara, engari ki te maheke i tētahi kī he SHA-256 matapona, he nui atu ki te whakaū mēnā he uara kotahi ngā ahumahi e whakahaerea kaore i te whakawhiti atu.
Ko tēnei te whakautu whānuitanga ki te "he aha te taurangi i ōkate ai ki te hanga". Tirotiro i mua i te whakamatau i tetahi mea anō.
Te Whakatika
He kore tautuhi te taurangi i te wā tuku. Tirotiro ka muri te kawe tuku te moni, ka tirotiro te ārarangi e āhei ana i tēnei ahumahi, ka tirotiro ngā ture tohu whaimana i runga ake nei. I taua raupapa.
E tika ana i te whakatupuranga engari kaore i te arokite. E tāia ana te taurangi whakatupuranga anake, i tē taurangi kaupapa pūtake rānei kua tango te preview kei raro i te Available in. He mea noa tēnei i te whakaaro.
E tika ana i te rohe engari kaore i te hanga. Kaore tō kōnae .env rohe i roto i te repository, a kaore e tika. Kaupunatanga me Import .env me tohu i te ārarangi e tika.
Kua ngaro katoa te whakatūtuki me te mea kei te whakatupuranga. Whakawhitia Inherit production env vars i Settings, kei raro i te Staging: environment variables, i te whakamahinga rānei o Copy variables between environments.