Hifadhi mradi wako kwenye GitHub

GitHub ni mahali wasanidi programu huhifadhi msimbo, pamoja na historia ya kila badiliko. Unganisha mradi wa MonstarX na hazina ya GitHub (folda ya mradi kwenye GitHub) na vyote viwili vitaenda sambamba, pande zote mbili: kile MonstarX inachounda hutumwa huko kama commit, na kile wewe au msanidi programu mnachofanyia commit huko kinarudi kwenye MonstarX.

Ni muhimu msanidi programu anapotaka kufanyia kazi msimbo kwenye kihariri chake mwenyewe, kampuni yako inapohifadhi msimbo wote kwenye GitHub, au unapochapisha kutoka GitHub — kama Railway inavyofanya, kwa mfano.

Ninawezaje kuunganisha akaunti yangu ya GitHub?

Unaunganisha GitHub mara moja kwa akaunti yako yote ya MonstarX, kutoka Mipangilio›Miunganisho au kutoka kitufe cha GitHub katika mradi wowote. Njia rahisi zaidi ni GitHub App ya MonstarX: hakuna tokeni ya kutengeneza au kubandika, na wewe ndiye unaamua hasa ni hazina zipi MonstarX inaweza kugusa.

1. Bofya Unganisha akaunti binafsi ya GitHub.

   

2. GitHub inafunguka na kuuliza mahali pa kusakinisha programu. Chagua akaunti yako binafsi (si shirika).

3. Chagua hazina ambazo MonstarX inaweza kutumia: All repositories, au Only select repositories kisha uweke alama kwenye zile unazotaka. Unaweza kubadilisha hili baadaye kwenye GitHub.

4. Bofya Install, kisha Authorize GitHub inapokuomba uthibitishe.

5. Umerudi kwenye MonstarX. Kadi inasema Imeunganishwa · GitHub App.

Mambo machache ya kujua kuhusu GitHub App:

• Hakuna idhini ya shirika inayohitajika. Inasakinishwa kwenye akaunti yako binafsi pekee. Ukichagua shirika kimakosa, MonstarX itakuomba uisakinishe kwenye akaunti yako binafsi na ujaribu tena.
• Hazina mpya huundwa kwenye akaunti yako binafsi. MonstarX inaweza kufikia kila wakati hazina iliyoiunda, hata kama ulichagua Only select repositories.
• Hazina ulizochagua ndizo kikomo. Ili kuunganisha hazina iliyopo, lazima iwe mojawapo ya zile ulizoipa programu ruhusa. Ongeza zaidi kwenye mipangilio ya GitHub ya programu zilizosakinishwa.
• Ufikiaji ni wa muda mfupi na hujisasisha kiotomatiki, na huhifadhiwa ukiwa umesimbwa kwa njia fiche. Hautumwi kamwe kwenye kivinjari chako.

Njia nyingine za kuunganisha

Ukipenda, kuna njia nyingine mbili pia:

Njia	Wakati wa kuitumia
Hazina binafsi yenye ufikiaji mdogo (katika Mipangilio: Unganisha hazina ya kibinafsi yenye ufikiaji mdogo)	Unataka MonstarX ifikie hazina moja tu kwa tokeni ya ufikiaji wa kibinafsi (nenosiri unalotengeneza kwenye GitHub kwa kazi moja maalum). Tengeneza tokeni ya fine-grained ambayo mmiliki wa rasilimali ni akaunti yako binafsi, kwa hazina hiyo tu, na ruhusa ya Contents: read and write. Unda hazina kwenye GitHub kwanza; tokeni ya aina hii haiwezi kuunda hazina mpya.
Tumia idhini ya GitHub badala yake	Unataka kutuma kwenye hazina za mashirika ambayo wewe ni mwanachama. Skrini ya kawaida ya kuingia ya GitHub inaweza kujumuisha ufikiaji wa mashirika hayo, kwa hiyo ikague kabla ya kuruhusu.

Ukishaunganisha, kadi inaonyesha njia uliyotumia (GitHub App, Umeingia kwa kutumia GitHub au Tokeni ya ufikiaji wa kibinafsi) na kuorodhesha kila hazina ambayo MonstarX inaisasisha, pamoja na iliposawazishwa mara ya mwisho na kama usawazishaji ni Kiotomatiki au Kwa mkono. Ukiunganisha kwa njia nyingine baadaye, muunganisho wa zamani unabadilishwa; hazina zako zilizounganishwa zinabaki zimeunganishwa.

Ninawezaje kuhifadhi mradi kwenye GitHub?

1. Fungua mradi na ubofye GitHub kwenye upau wa juu. (Pia kipo katika Mipangilio›Pakua msimbo ya mradi, chini ya Iweke GitHub.)

2. Ikiwa akaunti yako bado haijaunganishwa, iunganishe hapo hapo.

   

3. Chagua Hazina mpya au Hazina iliyopo:

   • Hazina mpya — chagua Mmiliki (wewe au mojawapo ya mashirika yako), andika Jina la hazina, acha Hazina ya faragha ikiwa na alama isipokuwa unataka kila mtu auone msimbo, kisha ubofye Unda hazina na utume msimbo.
   • Hazina iliyopo — andika owner/repository au ubandike anwani yake ya github.com, ukipenda pia Tawi (tawi chaguo-msingi ukiliacha wazi), kisha ubofye Unganisha na usawazishe. Akaunti yako inahitaji ruhusa ya kutuma kwenye hazina hiyo.

4. MonstarX inatuma mradi mzima kama hazina iliyo tayari kuchapishwa. Kitufe cha GitHub kinapata kitone cha kijani kikiwa kimesawazishwa.

Hazina mpya huanza na commit moja, “Initial commit from MonstarX”. Katika hazina iliyopo, mradi unafanyiwa commit juu ya tawi, na faili ambazo MonstarX haizisimamii — LICENSE, mitiririko ya CI, nyaraka — haziguswi kamwe.

Nini kinaingia kwenye hazina?

Kila kitu unachopata kwa kupakua msimbo: msimbo wa programu, faili za mfumo wa MonstarX, usanidi wa kuiendesha na kuichapisha, faili za mabadiliko ya muundo wa hifadhidata, orodha ya majina ya siri ambazo programu inahitaji (kamwe si thamani zake), na README.

Baadhi ya vitu haviendi GitHub kamwe:

• Thamani za siri pamoja na safu mlalo za hifadhidata na faili zilizopakiwa za programu yako hubaki kwa MonstarX.
• Safu mlalo zilizoingizwa kutoka kwenye lahajedwali hazitumwi kamwe, kwa sababu hazina inaweza kuwa ya umma na hizo ni taarifa za wateja wako.
• Faili zisizo za maandishi na faili zinazozidi 1 MB huachwa na kuorodheshwa kwenye kumbukumbu ya usawazishaji.

MonstarX husawazisha lini?

Wakati Tuma kila badiliko kiotomatiki imewashwa (huwa imewashwa kwa chaguo-msingi), MonstarX husawazisha:

• baada ya kila ombi lililobadilisha faili za programu — ujumbe wa commit ni ombi lako;
• baada ya marekebisho ya kiotomatiki ya QA;
• baada ya kurejesha toleo;
• baada ya kuhifadhi au kufuta faili kwenye mwonekano wa Msimbo.

Sawazisha sasa kwenye menyu ya GitHub hutuma na kuleta mabadiliko wakati wowote unaotaka. Zima utumaji wa kiotomatiki ikiwa ungependa kusawazisha kwa mkono.

Nini kinatokea mtu akihariri msimbo kwenye GitHub?

Fanya commit kwenye GitHub kama kawaida. Katika usawazishaji unaofuata, MonstarX huleta mabadiliko kwenye mradi:

• Mabadiliko ya faili za programu yenyewe (src/, public/, migrations/ na README.md) huingia kwenye MonstarX. Hakikisho linasasishwa, mabadiliko mapya ya muundo wa hifadhidata yanaendeshwa, na toleo lenye jina Kutoka GitHub: pamoja na kichwa cha commit linaonekana kwenye Matoleo.
• Kadi kwenye mazungumzo, kama “Imepokea faili 3 kutoka GitHub”, huorodhesha faili, ili wewe na MonstarX mjue kilichobadilika.
• Mabadiliko ya faili za mfumo wa MonstarX, kama package.json au usanidi, hubaki kwenye GitHub hadi MonstarX yenyewe itakapobadilisha faili hiyo wakati ujao.
• Faili ileile ikibadilika pande zote mbili, MonstarX inabaki na toleo lake na GitHub inabaki na lako kwenye historia. Kadi inaiwekea alama “imebadilishwa pande zote mbili — toleo la MonstarX limehifadhiwa”.

Kidokezo

Msanidi programu akiwa anabadilisha faili kwenye GitHub, epuka kuiomba MonstarX ibadilishe faili hiyo hiyo wakati huo huo. Kusawazisha mara nyingi zaidi (Sawazisha sasa) huweka pande zote mbili karibu.

Menyu ya GitHub inaonyesha nini ikishaunganishwa?

• Hazina, tawi lake na kama ni Ya faragha au Hadharani.
• Iliposawazishwa mara ya mwisho (Imesawazishwa dakika chache zilizopita), au Usawazishaji wa mwisho haukufaulu pamoja na sababu.
• Sawazisha sasa na Fungua hazina.
• Tuma kila badiliko kiotomatiki.
• Usawazishaji wa hivi majuzi — mara tano za mwisho, kila moja na commit yake.
• Tenganisha hazina — husimamisha usawazishaji. Hazina inabaki kwenye GitHub.
• Tenganisha — hutenganisha akaunti yako ya GitHub. Hakuna kinachotumwa hadi uunganishe tena.

Vipi kuhusu programu niliyoingiza kutoka GitHub?

Unapoingiza programu kutoka hazina unayoweza kutuma kwayo (angalia Ingiza programu), mradi unabaki umeunganishwa nayo — kwenye tawi jipya linaloitwa monstarx, linaloanzia kwenye commit uliyoingiza. Tawi lako mwenyewe halisogei kamwe. Ukiridhika na mabadiliko ya MonstarX, Fungua ombi la kuunganisha mabadiliko (pull request) kwenye menyu ya GitHub inakupeleka GitHub ili uyaunganishe.

Maswali ya kawaida

Je, ninahitaji tokeni ya GitHub?

Hapana. Unganisha akaunti binafsi ya GitHub husakinisha GitHub App ya MonstarX: unaingia kwenye GitHub, unachagua hazina, na umemaliza. Tokeni ya ufikiaji wa kibinafsi ni njia mbadala tu kwa watu wanaotaka kuiwekea MonstarX kikomo cha hazina moja kwa njia hiyo.

Je, GitHub App inaweza kufikia shirika la kampuni yangu?

Hapana — inasakinishwa kwenye akaunti yako binafsi pekee, na huunda hazina mpya huko. Ili kutuma kwenye hazina ya shirika, unganisha kwa Tumia idhini ya GitHub badala yake, au uliombe shirika likuongeze ili uweze kuiunganisha kutoka kwenye akaunti yako.

Ninawezaje kuipa MonstarX ufikiaji wa hazina nyingine baadaye?

Kwenye GitHub, fungua mipangilio yako ya GitHub Apps zilizosakinishwa, chagua MonstarX, na uongeze hazina (au ubadilishe kuwa All repositories). Kisha iunganishe kutoka kwenye menyu ya GitHub ya mradi.

Je, hazina yangu ni ya faragha?

Hazina mpya ni ya faragha kwa chaguo-msingi — ondoa alama kwenye Hazina ya faragha ikiwa tu unataka msimbo uwe wa umma. MonstarX haitumi kamwe thamani za siri wala data ya programu yako.

Je, ninaweza kuunganisha hazina iliyo ya shirika la kampuni yangu?

Ndiyo, ikiwa akaunti yako ya GitHub inaweza kutuma kwayo. Tumia Hazina iliyopo, au uchague shirika kama Mmiliki unapounda hazina mpya.

Nini kinatokea nikitenganisha hazina?

MonstarX inaacha kusawazisha. Hazina na historia yake yote vinabaki kwenye GitHub, na unaweza kuiunganisha tena baadaye.

Msanidi programu amebadilisha package.json kwenye GitHub. Kwa nini haikurudi?

Faili za mfumo kama package.json na usanidi zinasimamiwa na MonstarX. Mabadiliko yake hubaki kwenye GitHub hadi MonstarX itakapobadilisha faili hiyo wakati ujao; usawazishaji unaofuata hauyafuti kimyakimya kamwe.

Je, ninaweza kuchapisha kutoka kwenye hazina?

Ndiyo. Hazina iko tayari kuchapishwa, na Railway huchapisha kutoka humo. Angalia pia Chapisha kwenye huduma nyingine za upangishaji.

Nini kinatokea kwa muunganisho nikikabidhi mradi kwa mtu mwingine?

Unaondolewa, ili hakuna kitakachotumwa kwenye akaunti yako ya GitHub kwa niaba ya mmiliki mpya. Hazina yenyewe haiguswi.

Angalia pia

Pakua msimbo wakoPakua mradi mzima kama faili ya zip.

Ingiza programuLeta programu kutoka GitHub au faili ya zip.

MatoleoKila badiliko, na jinsi ya kurejesha moja.

Mawakala wa kuandika msimboTuma na uvute msimbo ukitumia Claude Code, Cursor au Codex.