Ajiye aikinku a GitHub

GitHub shi ne inda masu haɓaka manhaja suke ajiye lambar tushe, tare da tarihin kowane canji. Ku haɗa aikin MonstarX da ma’ajiyar GitHub (babban fayil na aiki a GitHub), sai su biyun su riƙa tafiya tare, ta ɓangarorin biyu: abin da MonstarX ya gina ana tura shi can a matsayin commit, kuma abin da ku ko wani mai haɓaka manhaja kuka yi commit a can yana dawowa cikin MonstarX.

Yana da amfani idan mai haɓaka manhaja yana son yin aiki a kan lambar tushe a editansa, idan kamfaninku yana ajiye duk lambar tushe a GitHub, ko idan kuna wallafawa daga GitHub — misali, Railway yana yin haka.

Ta yaya zan haɗa asusuna na GitHub?

Kuna haɗa GitHub sau ɗaya don asusunku na MonstarX gaba ɗaya, daga Saituna›Haɗin asusu ko daga maɓallin GitHub a kowane aiki. Hanya mafi sauƙi ita ce GitHub App na MonstarX: babu token da za ku ƙirƙira ko manna, kuma ku ne kuke yanke shawarar ainihin ma’ajiyoyin da MonstarX zai iya taɓawa.

1. Ku danna Haɗa asusun GitHub na kanku.

   

2. GitHub yana buɗewa ya tambayi inda za a saka manhajar. Ku zaɓi asusunku na kanku (ba wata ƙungiya ba).

3. Ku zaɓi ma’ajiyoyin da MonstarX zai iya amfani da su: All repositories, ko Only select repositories ku kuma yi alama a kan waɗanda kuke so. Kuna iya canja wannan daga baya a GitHub.

4. Ku danna Install, sannan Authorize idan GitHub ya nemi ku tabbatar.

5. Kun dawo MonstarX. Katin yana cewa An haɗa · GitHub App.

Wasu abubuwan da ya kamata ku sani game da GitHub App:

• Ba a buƙatar amincewar ƙungiya. Ana saka shi a asusunku na kanku kawai. Idan kun zaɓi wata ƙungiya bisa kuskure, MonstarX zai nemi ku saka shi a asusunku na kanku ku sake gwadawa.
• Ana ƙirƙirar sababbin ma’ajiyoyi a asusunku na kanku. MonstarX koyaushe yana iya isa ga ma’ajiyar da ya ƙirƙira, ko da kun zaɓi Only select repositories.
• Zaɓinku na ma’ajiyoyi shi ne iyaka. Don haɗa ma’ajiyar da ke akwai, dole ta kasance wadda kuka ba manhajar. Ku ƙara wasu a saitunan GitHub na manhajojin da aka saka.
• Damar shiga gajeriya ce kuma ana sabunta ta da kanta, ana kuma ajiye ta a ɓoye. Ba a taɓa aika ta zuwa burauzarku.

Sauran hanyoyin haɗawa

Idan kun fi so, akwai wasu hanyoyi biyu kuma:

Hanya	Lokacin amfani da ita
Ma’ajiya ta kanku da iyakantacciyar damar shiga (a Saituna: Haɗa ma’ajiyarku da izinin shiga mai iyaka)	Kuna son MonstarX ya isa ga ma’ajiya ɗaya tak da token na izinin shiga na kanku (wata kalmar sirri da kuke ƙirƙira a GitHub don aiki ɗaya). Ku ƙirƙiri fine-grained token da asusunku na kanku a matsayin mai albarkatun, wannan ma’ajiyar kawai, da Contents: read and write. Ku ƙirƙiri ma’ajiyar a GitHub da farko; irin wannan token ba zai iya ƙirƙirar sababbi ba.
Yi amfani da izinin GitHub maimakon haka	Kuna son turawa zuwa ma’ajiyoyin ƙungiyoyin da kuke ciki. Shafin shiga na GitHub da aka saba na iya haɗawa da damar shiga waɗannan ƙungiyoyi, don haka ku duba shi kafin ku ba da izini.

Da zarar an haɗa, katin yana nuna ta wace hanya (GitHub App, An shiga ta GitHub ko Token na izinin shiga na kanku) kuma yana jera kowace ma’ajiya da MonstarX yake ci gaba da sabuntawa, tare da lokacin da kowacce ta daidaita na ƙarshe da ko tana daidaitawa Na atomatik ko Da hannu. Haɗawa ta wata hanya dabam daga baya tana maye gurbin tsohon haɗin; ma’ajiyoyinku da aka haɗa suna nan a haɗe.

Ta yaya zan ajiye aiki a GitHub?

1. Ku buɗe aikin ku danna GitHub a sandar sama. (Yana kuma cikin Saituna›Fitarwa na aikin, a ƙarƙashin Adana a GitHub.)

2. Idan ba a haɗa asusunku ba tukuna, ku haɗa shi a nan take.

   

3. Ku zaɓi Sabuwar ma’ajiya ko Ma’ajiyar da ke akwai:

   • Sabuwar ma’ajiya — ku zaɓi Mai shi (ku ko ɗaya daga cikin ƙungiyoyinku), ku rubuta Sunan ma’ajiya, ku bar Ma’ajiyar sirri a zaɓe sai dai idan kuna son kowa ya ga lambar tushe, sannan ku danna Ƙirƙiri ma’ajiya kuma ku tura lambar tushe.
   • Ma’ajiyar da ke akwai — ku rubuta owner/repository ko ku manna adireshinta na github.com, idan kuna so ku ƙara Reshe (reshe na asali idan an bar shi babu komai), sannan ku danna Haɗa kuma daidaita. Asusunku yana buƙatar izinin turawa zuwa gare ta.

4. MonstarX yana tura aikin gaba ɗaya a matsayin ma’ajiya da ke shirye don wallafawa. Maɓallin GitHub yana samun ɗigo kore idan an daidaita.

Sabuwar ma’ajiya tana farawa da commit ɗaya, “Initial commit from MonstarX”. A ma’ajiyar da ke akwai, ana yin commit na aikin a kan reshen, kuma fayilolin da MonstarX ba ya sarrafawa — LICENSE, hanyoyin aikin CI, takardu — ba a taɓa taɓa su.

Me ke shiga cikin ma’ajiyar?

Duk abin da Fitarwa yake ba ku: lambar tushen manhajar, fayilolin tsarin MonstarX, saitunan gudanarwa da wallafa ta, ƙaurar rumbun bayanai (migrations), jerin sunayen bayanan sirri da manhajar take buƙata (ba ƙimominsu ba), da README.

Wasu abubuwa ba sa taɓa zuwa GitHub:

• Ƙimomin bayanan sirri, layukan rumbun bayanai na manhajarku da fayilolin da aka loda suna nan a MonstarX.
• Layukan da aka shigo da su daga takardar lissafi ba a taɓa tura su, domin ma’ajiya na iya kasancewa ta jama’a, kuma waɗannan bayanan kwastomominku ne.
• Fayilolin binary da fayilolin da suka wuce 1 MB ana tsallake su, a jera su a rubutun daidaitawa.

Yaushe MonstarX yake daidaitawa?

Muddin Tura kowane canji ta atomatik a kunne yake (haka yake bisa asali), MonstarX yana daidaitawa:

• bayan kowace buƙata da ta canja fayilolin manhajar — saƙon commit ɗin buƙatarku ce;
• bayan gyaran QA na atomatik;
• bayan kun dawo da siga;
• bayan kun ajiye ko goge fayil a kallon Lambar tushe.

Daidaita yanzu a menu na GitHub yana turawa da karɓowa duk lokacin da kuke so. Ku kashe turawa ta atomatik idan kun fi son daidaitawa da hannu.

Me ke faruwa idan wani ya gyara lambar tushe a GitHub?

Ku yi commit a GitHub kamar yadda kuka saba. A daidaitawa ta gaba, MonstarX yana karɓo canje-canjen cikin aikin:

• Canje-canje a fayilolin manhajar na kanta (src/, public/, migrations/ da README.md) suna shigowa MonstarX. Samfoti yana sabuntawa, sababbin ƙaurar rumbun bayanai suna gudana, kuma siga mai suna Daga GitHub: tare da taken commit ɗin tana bayyana a Sigogi.
• Kati a tattaunawa, kamar “An kawo fayiloli 3 daga GitHub”, yana jera fayilolin, don ku da maginin manhaja na MonstarX duka ku san abin da ya canja.
• Canje-canje a fayilolin tsarin MonstarX, kamar package.json ko saituna, suna nan a GitHub har sai MonstarX da kansa ya canja wannan fayil a gaba.
• Idan fayil ɗaya ya canja a ɓangarorin biyu, MonstarX yana riƙe da sigarsa, GitHub kuma yana riƙe da taku a tarihi. Katin yana yi masa alama “an canza ta ɓangarorin biyu — an kiyaye sigar MonstarX”.

Shawara

Idan mai haɓaka manhaja yana canja wani fayil a GitHub, ku guji neman MonstarX ya canja fayil ɗin a lokaci guda. Daidaitawa akai-akai (Daidaita yanzu) tana sa ɓangarorin biyu su kasance kusa da juna.

Me menu na GitHub yake nunawa bayan an haɗa?

• Ma’ajiyar, reshenta da ko ta Na sirri ce ko Na jama’a.
• Lokacin da ta daidaita na ƙarshe (An daidaita ’yan mintuna da suka wuce), ko Daidaitawar ƙarshe ta gaza tare da dalili.
• Daidaita yanzu da Buɗe ma’ajiya.
• Tura kowane canji ta atomatik.
• Daidaitawar kwanan nan — guda 5 na ƙarshe, kowacce da commit ɗinta.
• Cire haɗin ma’ajiyar — yana dakatar da daidaitawa. Ma’ajiyar tana nan a GitHub.
• Cire haɗin — yana cire haɗin asusunku na GitHub. Ba a tura komai har sai kun sake haɗawa.

Fa manhajar da na shigo da ita daga GitHub?

Idan kun shigo da manhaja daga ma’ajiyar da kuke iya turawa zuwa gare ta, aikin yana nan a haɗe da ita — a wani sabon reshe mai suna monstarx, wanda aka fara daga commit ɗin da kuka shigo da shi. Reshenku ba ya taɓa motsawa. Idan kun gamsu da canje-canjen MonstarX, Buɗe buƙatar haɗa canje-canje (pull request) a menu na GitHub yana kai ku GitHub don haɗa su.

Tambayoyin da ake yawan yi

Ina buƙatar token na GitHub?

A’a. Haɗa asusun GitHub na kanku yana saka GitHub App na MonstarX: kuna shiga a GitHub, ku zaɓi ma’ajiyoyi, shi ke nan. Token na izinin shiga na kanku madadi ne kawai ga masu son iyakance MonstarX ga ma’ajiya ɗaya ta wannan hanyar.

GitHub App zai iya isa ga ƙungiyar kamfanina?

A’a — ana saka shi a asusunku na kanku kawai, kuma a can yake ƙirƙirar sababbin ma’ajiyoyi. Don turawa zuwa ma’ajiyar wata ƙungiya, ku haɗa ta Yi amfani da izinin GitHub maimakon haka, ko ku nemi ƙungiyar ta ƙara ku don ku haɗa ta daga asusunku.

Ta yaya zan ba MonstarX damar shiga wata ma’ajiya daga baya?

A GitHub, ku buɗe saitunanku na GitHub Apps da aka saka, ku zaɓi MonstarX, sannan ku ƙara ma’ajiyar (ko ku sauya zuwa All repositories). Sannan ku haɗa ta daga menu na GitHub na aikin.

Ma’ajiyata ta sirri ce?

Sabuwar ma’ajiya ta sirri ce bisa asali — ku cire alamar Ma’ajiyar sirri ne kawai idan kuna son lambar tushe ta zama ta jama’a. MonstarX ba ya taɓa tura ƙimomin bayanan sirri ko bayanan manhajarku.

Zan iya haɗa ma’ajiyar da ta ƙungiyar kamfanina ce?

Eh, idan asusunku na GitHub yana iya turawa zuwa gare ta. Ku yi amfani da Ma’ajiyar da ke akwai, ko ku zaɓi ƙungiyar a matsayin Mai shi lokacin ƙirƙirar sabuwa.

Me ke faruwa idan na cire haɗin ma’ajiyar?

MonstarX yana daina daidaitawa. Ma’ajiyar da dukkan tarihinta suna nan a GitHub, kuma kuna iya sake haɗa ta daga baya.

Wani mai haɓaka manhaja ya canja package.json a GitHub. Me ya sa bai dawo ba?

Fayilolin tsari kamar package.json da saituna MonstarX ne yake sarrafa su. Gyaran da aka yi musu yana nan a GitHub har sai MonstarX ya canja wannan fayil a gaba; daidaitawa ta gaba ba ta taɓa soke su a ɓoye.

Zan iya wallafawa daga ma’ajiyar?

Eh. Ma’ajiyar a shirye take don wallafawa, kuma Railway yana wallafawa daga gare ta. Duba kuma Wallafa a wasu masaukai.

Me ke faruwa da haɗin idan na canja wa wani mallakar aikin?

Ana cire shi, don kada a taɓa tura wani abu zuwa asusunku na GitHub a madadin sabon mai aikin. Ma’ajiyar kanta ba a taɓa ta.

Shafuka masu alaƙa

Fitar da lambar tushenkuKu zazzage aikin gaba ɗaya a matsayin fayil ɗin zip.

Shigo da manhajaKu kawo manhaja daga GitHub ko fayil ɗin zip.

SigogiKowane canji, da yadda ake dawo da ɗaya.

Wakilan rubuta lambar tusheKu tura ku karɓo lambar tushe da Claude Code, Cursor ko Codex.