உங்கள் திட்டத்தை GitHub-இல் சேமியுங்கள்

GitHub என்பது டெவலப்பர்கள் குறியீட்டை, ஒவ்வொரு மாற்றத்தின் வரலாற்றுடன் வைத்திருக்கும் இடம். ஒரு MonstarX திட்டத்தை GitHub களஞ்சியத்துடன் (GitHub-இல் ஒரு திட்டத்தின் கோப்புறை) இணைத்தால், இரண்டும் இரு திசைகளிலும் ஒத்திசைவில் இருக்கும்: MonstarX உருவாக்குவது அங்கே கமிட்களாக அனுப்பப்படும்; நீங்களோ ஒரு டெவலப்பரோ அங்கே கமிட் செய்வது MonstarX-க்குத் திரும்பி வரும்.

ஒரு டெவலப்பர் தன் சொந்த எடிட்டரில் குறியீட்டில் வேலை செய்ய விரும்பும்போது, உங்கள் நிறுவனம் எல்லாக் குறியீட்டையும் GitHub-இல் வைத்திருக்கும்போது, அல்லது நீங்கள் GitHub-இலிருந்து டிப்ளாய் செய்யும்போது (உதாரணமாக Railway அப்படிச் செய்கிறது) இது பயனுள்ளதாக இருக்கும்.

என் GitHub கணக்கை இணைப்பது எப்படி?

உங்கள் முழு MonstarX கணக்குக்கும் GitHub-ஐ ஒருமுறை இணைத்தால் போதும்: அமைப்புகள்›ஒருங்கிணைப்புகள் பகுதியிலிருந்து, அல்லது எந்தத் திட்டத்திலும் உள்ள GitHub பொத்தானிலிருந்து. எளிதான வழி MonstarX-இன் GitHub App: உருவாக்கவோ ஒட்டவோ டோக்கன் எதுவும் இல்லை; MonstarX எந்தக் களஞ்சியங்களைத் தொடலாம் என்பதை நீங்களே துல்லியமாகத் தீர்மானிக்கலாம்.

1. தனிப்பட்ட GitHub கணக்கை இணை என்பதைக் கிளிக் செய்யுங்கள்.

   

2. GitHub திறந்து, செயலியை எங்கே நிறுவ வேண்டும் என்று கேட்கும். உங்கள் தனிப்பட்ட கணக்கைத் தேர்ந்தெடுங்கள் (ஒரு நிறுவனத்தை அல்ல).

3. MonstarX எந்தக் களஞ்சியங்களைப் பயன்படுத்தலாம் என்று தேர்ந்தெடுங்கள்: All repositories, அல்லது Only select repositories என்பதைத் தேர்ந்தெடுத்து வேண்டியவற்றைக் குறியிடுங்கள். இதைப் பின்னர் GitHub-இல் மாற்றலாம்.

4. Install என்பதைக் கிளிக் செய்யுங்கள். GitHub உறுதிப்படுத்தக் கேட்கும்போது Authorize என்பதைக் கிளிக் செய்யுங்கள்.

5. நீங்கள் MonstarX-க்குத் திரும்புவீர்கள். அட்டையில் இணைக்கப்பட்டது · GitHub App என்று இருக்கும்.

GitHub App பற்றித் தெரிந்துகொள்ள வேண்டிய சில விஷயங்கள்:

• நிறுவன ஒப்புதல் தேவையில்லை. இது உங்கள் தனிப்பட்ட கணக்கில் மட்டுமே நிறுவப்படும். தவறுதலாக ஒரு நிறுவனத்தைத் தேர்ந்தெடுத்தால், உங்கள் தனிப்பட்ட கணக்கில் நிறுவி மீண்டும் முயலுமாறு MonstarX கேட்கும்.
• புதிய களஞ்சியங்கள் உங்கள் தனிப்பட்ட கணக்கில் உருவாக்கப்படும். நீங்கள் Only select repositories தேர்ந்தெடுத்திருந்தாலும், தான் உருவாக்கிய களஞ்சியத்தை MonstarX எப்போதும் அணுக முடியும்.
• நீங்கள் தேர்ந்தெடுக்கும் களஞ்சியங்களே எல்லை. ஏற்கெனவே உள்ள களஞ்சியத்தை இணைக்க, அது நீங்கள் செயலிக்கு அனுமதி கொடுத்த ஒன்றாக இருக்க வேண்டும். நிறுவிய செயலிகளுக்கான GitHub அமைப்புகளில் மேலும் சேர்க்கலாம்.
• அணுகல் குறுகிய காலத்துக்கானது, தானாகப் புதுப்பிக்கப்படும், மறையாக்கம் செய்து சேமிக்கப்படும். அது உங்கள் உலாவிக்கு ஒருபோதும் அனுப்பப்படாது.

இணைக்க வேறு வழிகள்

விரும்பினால், வேறு இரண்டு வழிகளும் உள்ளன:

வழி	எப்போது பயன்படுத்துவது
வரையறுக்கப்பட்ட அணுகலுடன் தனிப்பட்ட களஞ்சியம் (அமைப்புகளில்: வரையறுக்கப்பட்ட அணுகலுடன் தனிப்பட்ட களஞ்சியத்தை இணை)	ஒரு தனிப்பட்ட அணுகல் டோக்கன் (ஒரே நோக்கத்துக்காக GitHub-இல் நீங்கள் உருவாக்கும் கடவுச்சொல்) மூலம், MonstarX ஒரே ஒரு களஞ்சியத்தை மட்டும் அணுக வேண்டும் என்றால். உங்கள் தனிப்பட்ட கணக்கை resource owner-ஆகவும், அந்தக் களஞ்சியத்தை மட்டும், Contents: read and write அனுமதியுடனும் ஒரு fine-grained டோக்கனை உருவாக்குங்கள். முதலில் GitHub-இல் களஞ்சியத்தை உருவாக்குங்கள்; இந்த வகை டோக்கனால் புதியவற்றை உருவாக்க முடியாது.
அதற்குப் பதிலாக GitHub அங்கீகாரத்தைப் பயன்படுத்து	நீங்கள் உறுப்பினராக உள்ள நிறுவனங்களின் களஞ்சியங்களுக்கு அனுப்ப விரும்பினால். GitHub-இன் வழக்கமான உள்நுழைவுத் திரையில் அந்த நிறுவனங்களுக்கான அணுகலும் இருக்கலாம்; அதனால் அனுமதிக்கும் முன் அதைச் சரிபாருங்கள்.

இணைத்ததும், எப்படி இணைக்கப்பட்டது என்று அட்டை காட்டும் (GitHub App, GitHub-உடன் உள்நுழைந்துள்ளீர்கள் அல்லது தனிப்பட்ட அணுகல் டோக்கன்). MonstarX புதுப்பித்த நிலையில் வைத்திருக்கும் ஒவ்வொரு களஞ்சியத்தையும், ஒவ்வொன்றும் கடைசியாக எப்போது ஒத்திசைந்தது, அது தானியங்கு முறையிலா கைமுறையாக ஒத்திசைகிறதா என்பதுடன் பட்டியலிடும். பின்னர் வேறு வழியில் இணைத்தால், பழைய இணைப்புக்குப் பதிலாக அது வரும்; இணைத்த களஞ்சியங்கள் அப்படியே இணைந்திருக்கும்.

ஒரு திட்டத்தை GitHub-இல் சேமிப்பது எப்படி?

1. திட்டத்தைத் திறந்து, மேல் பட்டியில் உள்ள GitHub என்பதைக் கிளிக் செய்யுங்கள். (திட்டத்தின் அமைப்புகள்›ஏற்றுமதி பகுதியிலும், GitHub-இல் வைக்கவும் என்பதன் கீழ் இது உள்ளது.)

2. உங்கள் கணக்கு இன்னும் இணைக்கப்படவில்லை என்றால், அங்கேயே இணையுங்கள்.

   

3. புதிய களஞ்சியம் அல்லது தற்போதுள்ள களஞ்சியம் என்பதைத் தேர்ந்தெடுங்கள்:

   • புதிய களஞ்சியம்: உரிமையாளர் (நீங்கள் அல்லது உங்கள் நிறுவனங்களில் ஒன்று) தேர்ந்தெடுத்து, களஞ்சியத்தின் பெயர் தட்டச்சு செய்யுங்கள். எல்லோரும் குறியீட்டைப் பார்க்க வேண்டும் என்று விரும்பினால் தவிர, தனிப்பட்ட களஞ்சியம் குறியிட்டபடியே விடுங்கள். பிறகு களஞ்சியத்தை உருவாக்கிப் புஷ் செய் என்பதைக் கிளிக் செய்யுங்கள்.
   • தற்போதுள்ள களஞ்சியம்: owner/repository என்று தட்டச்சு செய்யுங்கள் அல்லது அதன் github.com முகவரியை ஒட்டுங்கள். விரும்பினால் ஒரு கிளை குறிப்பிடுங்கள் (காலியாக இருந்தால் இயல்புநிலைக் கிளை). பிறகு இணைத்து ஒத்திசை என்பதைக் கிளிக் செய்யுங்கள். அதற்கு அனுப்ப உங்கள் கணக்குக்கு அனுமதி இருக்க வேண்டும்.

4. டிப்ளாய் செய்யத் தயாரான களஞ்சியமாக MonstarX முழுத் திட்டத்தையும் அனுப்பும். ஒத்திசைவில் இருக்கும்போது GitHub பொத்தானில் ஒரு பச்சைப் புள்ளி தெரியும்.

புதிய களஞ்சியம் “Initial commit from MonstarX” என்ற ஒரே கமிட்டுடன் தொடங்கும். ஏற்கெனவே உள்ள களஞ்சியத்தில், கிளையின் மேல் திட்டம் கமிட் செய்யப்படும். MonstarX நிர்வகிக்காத கோப்புகள் (LICENSE, CI workflows, ஆவணங்கள்) ஒருபோதும் தொடப்படாது.

களஞ்சியத்தில் என்ன சேரும்?

ஏற்றுமதி தரும் அனைத்தும்: செயலியின் குறியீடு, MonstarX-இன் framework கோப்புகள், அதை இயக்கவும் டிப்ளாய் செய்யவும் தேவையான கட்டமைப்பு, தரவுத்தள migrations, செயலிக்குத் தேவையான ரகசியங்களின் பெயர்ப் பட்டியல் (அவற்றின் மதிப்புகள் ஒருபோதும் இல்லை), ஒரு README.

சில விஷயங்கள் ஒருபோதும் GitHub-க்குச் செல்லாது:

• ரகசிய மதிப்புகள், உங்கள் செயலியின் தரவுத்தள வரிசைகள், பதிவேற்றிய கோப்புகள் ஆகியவை MonstarX-இலேயே இருக்கும்.
• விரிதாளிலிருந்து இறக்குமதி செய்த வரிசைகள் ஒருபோதும் அனுப்பப்படாது, ஏனெனில் களஞ்சியம் பொதுவானதாக இருக்கலாம்; அவை உங்கள் வாடிக்கையாளர்களின் விவரங்கள்.
• பைனரி கோப்புகளும் 1 MB-க்கு மேற்பட்ட கோப்புகளும் தவிர்க்கப்பட்டு, ஒத்திசைவுப் பதிவில் பட்டியலிடப்படும்.

MonstarX எப்போது ஒத்திசைக்கும்?

ஒவ்வொரு மாற்றத்தையும் தானாகப் புஷ் செய் இயக்கத்தில் இருக்கும் வரை (இயல்பாக அது இயக்கத்தில்தான் இருக்கும்), MonstarX இவற்றுக்குப் பிறகு ஒத்திசைக்கும்:

• செயலியின் கோப்புகளை மாற்றிய ஒவ்வொரு கோரிக்கைக்கும் பிறகு; கமிட் செய்தி உங்கள் கோரிக்கையாகவே இருக்கும்;
• QA தானாகச் சரிசெய்த பிறகு;
• நீங்கள் ஒரு பதிப்பை மீட்டமைத்த பிறகு;
• குறியீடு காட்சியில் ஒரு கோப்பைச் சேமித்த அல்லது நீக்கிய பிறகு.

GitHub மெனுவில் உள்ள இப்போது ஒத்திசை நீங்கள் விரும்பும்போதெல்லாம் அனுப்பவும் பெறவும் செய்யும். கைமுறையாக ஒத்திசைக்க விரும்பினால், தானியங்கு அனுப்புதலை முடக்குங்கள்.

யாராவது GitHub-இல் குறியீட்டைத் திருத்தினால் என்ன நடக்கும்?

வழக்கம்போல் GitHub-இல் கமிட் செய்யுங்கள். அடுத்த ஒத்திசைவில், MonstarX அந்த மாற்றங்களைத் திட்டத்துக்குள் கொண்டுவரும்:

• செயலியின் சொந்தக் கோப்புகளில் (src/, public/, migrations/, README.md) செய்த மாற்றங்கள் MonstarX-க்கு வரும். முன்னோட்டம் புதுப்பிக்கப்படும், புதிய தரவுத்தள migrations இயங்கும், பதிப்புகளில் GitHub-இலிருந்து: என்பதுடன் கமிட்டின் தலைப்பைக் கொண்ட ஒரு பதிப்பு தோன்றும்.
• அரட்டையில் “GitHub-இலிருந்து 3 கோப்புகள் பெறப்பட்டன” போன்ற ஓர் அட்டை கோப்புகளைப் பட்டியலிடும்; அதனால் என்ன மாறியது என்று நீங்களும் MonstarX முகவரும் அறிவீர்கள்.
• package.json அல்லது கட்டமைப்பு போன்ற MonstarX-இன் framework கோப்புகளில் செய்த மாற்றங்கள், MonstarX தானே அடுத்த முறை அந்தக் கோப்பை மாற்றும் வரை GitHub-இலேயே இருக்கும்.
• ஒரே கோப்பு இரு பக்கங்களிலும் மாறியிருந்தால், MonstarX தன் பதிப்பை வைத்துக்கொள்ளும்; உங்கள் பதிப்பு GitHub-இன் வரலாற்றில் இருக்கும். அட்டை அதை “இருபுறமும் மாற்றப்பட்டது — MonstarX-இன் பதிப்பு வைக்கப்பட்டுள்ளது” என்று குறிக்கும்.

உதவிக்குறிப்பு

ஒரு டெவலப்பர் GitHub-இல் ஒரு கோப்பை மாற்றிக்கொண்டிருந்தால், அதே நேரத்தில் அதே கோப்பை மாற்றும்படி MonstarX-இடம் கேட்காதீர்கள். அடிக்கடி ஒத்திசைப்பது (இப்போது ஒத்திசை) இரு பக்கங்களையும் நெருக்கமாக வைத்திருக்கும்.

இணைத்த பிறகு GitHub மெனு என்ன காட்டும்?

• களஞ்சியம், அதன் கிளை, அது தனிப்பட்டது அல்லது பொது என்பது.
• கடைசியாக எப்போது ஒத்திசைந்தது (ஒத்திசைக்கப்பட்டது சில நிமிடங்களுக்கு முன்பு), அல்லது காரணத்துடன் கடைசி ஒத்திசைவு தோல்வியடைந்தது.
• இப்போது ஒத்திசை, களஞ்சியத்தைத் திற.
• ஒவ்வொரு மாற்றத்தையும் தானாகப் புஷ் செய்.
• சமீபத்திய ஒத்திசைவுகள்: கடைசி ஐந்து, ஒவ்வொன்றும் அதன் கமிட்டுடன்.
• களஞ்சிய இணைப்பை நீக்கு: ஒத்திசைவை நிறுத்தும். களஞ்சியம் GitHub-இலேயே இருக்கும்.
• இணைப்பைத் துண்டி: உங்கள் GitHub கணக்கின் இணைப்பைத் துண்டிக்கும். மீண்டும் இணைக்கும் வரை எதுவும் அனுப்பப்படாது.

GitHub-இலிருந்து இறக்குமதி செய்த செயலி என்றால்?

நீங்கள் அனுப்ப அனுமதியுள்ள ஒரு களஞ்சியத்திலிருந்து செயலியை இறக்குமதி செய்தால், திட்டம் அதனுடன் இணைந்தே இருக்கும்: நீங்கள் இறக்குமதி செய்த கமிட்டிலிருந்து தொடங்கும் monstarx என்ற புதிய கிளையில். உங்கள் சொந்தக் கிளை ஒருபோதும் நகராது. MonstarX-இன் மாற்றங்கள் திருப்தியாக இருந்தால், GitHub மெனுவில் உள்ள புல் ரிக்வெஸ்ட்டைத் திற அவற்றை இணைக்க (merge) உங்களை GitHub-க்கு அழைத்துச் செல்லும்.

அடிக்கடி கேட்கப்படும் கேள்விகள்

எனக்கு GitHub டோக்கன் தேவையா?

தேவையில்லை. தனிப்பட்ட GitHub கணக்கை இணை MonstarX-இன் GitHub App-ஐ நிறுவும்: GitHub-இல் உள்நுழைந்து, களஞ்சியங்களைத் தேர்ந்தெடுத்தால் முடிந்தது. MonstarX-ஐ அந்த வழியில் ஒரே களஞ்சியத்துக்குக் கட்டுப்படுத்த விரும்புபவர்களுக்கு மட்டுமே தனிப்பட்ட அணுகல் டோக்கன் ஒரு மாற்று வழி.

GitHub App என் நிறுவனத்தின் organization-ஐ அணுகுமா?

அணுகாது. இது உங்கள் தனிப்பட்ட கணக்கில் மட்டுமே நிறுவப்படும், புதிய களஞ்சியங்களையும் அங்கேயே உருவாக்கும். ஒரு நிறுவனத்தின் களஞ்சியத்துக்கு அனுப்ப, அதற்குப் பதிலாக GitHub அங்கீகாரத்தைப் பயன்படுத்து மூலம் இணையுங்கள். அல்லது உங்கள் கணக்கிலிருந்து இணைக்கக்கூடிய வகையில் உங்களைச் சேர்க்குமாறு அந்த நிறுவனத்திடம் கேளுங்கள்.

பின்னர் MonstarX-க்கு வேறொரு களஞ்சியத்தின் அணுகலைக் கொடுப்பது எப்படி?

GitHub-இல், நிறுவிய GitHub Apps-க்கான உங்கள் அமைப்புகளைத் திறந்து, MonstarX-ஐத் தேர்ந்தெடுத்து, களஞ்சியத்தைச் சேருங்கள் (அல்லது All repositories-க்கு மாறுங்கள்). பிறகு திட்டத்தின் GitHub மெனுவிலிருந்து அதை இணையுங்கள்.

என் களஞ்சியம் தனிப்பட்டதா?

புதிய களஞ்சியம் இயல்பாகத் தனிப்பட்டது. குறியீடு பொதுவாக இருக்க வேண்டும் என்றால் மட்டுமே தனிப்பட்ட களஞ்சியம் குறியை நீக்குங்கள். ரகசிய மதிப்புகளையோ உங்கள் செயலியின் தரவையோ MonstarX ஒருபோதும் அனுப்பாது.

என் நிறுவனத்தின் organization-க்குச் சொந்தமான களஞ்சியத்தை இணைக்கலாமா?

உங்கள் GitHub கணக்கால் அதற்கு அனுப்ப முடிந்தால், இணைக்கலாம். தற்போதுள்ள களஞ்சியம் என்பதைப் பயன்படுத்துங்கள், அல்லது புதியதை உருவாக்கும்போது அந்த நிறுவனத்தை உரிமையாளர் ஆகத் தேர்ந்தெடுங்கள்.

களஞ்சிய இணைப்பை நீக்கினால் என்ன நடக்கும்?

MonstarX ஒத்திசைப்பதை நிறுத்தும். களஞ்சியமும் அதன் முழு வரலாறும் GitHub-இலேயே இருக்கும்; பின்னர் மீண்டும் இணைக்கலாம்.

ஒரு டெவலப்பர் GitHub-இல் package.json-ஐ மாற்றினார். அது ஏன் திரும்ப வரவில்லை?

package.json, கட்டமைப்பு போன்ற framework கோப்புகளை MonstarX நிர்வகிக்கிறது. அவற்றில் செய்த திருத்தங்கள், MonstarX அடுத்த முறை அந்தக் கோப்பை மாற்றும் வரை GitHub-இலேயே இருக்கும்; பிந்தைய ஒத்திசைவுகள் அவற்றை ஒருபோதும் மௌனமாக அழிக்காது.

களஞ்சியத்திலிருந்து டிப்ளாய் செய்யலாமா?

செய்யலாம். களஞ்சியம் டிப்ளாய் செய்யத் தயாராக இருக்கும்; Railway அதிலிருந்து டிப்ளாய் செய்யும். பிற ஹோஸ்டிங் சேவைகளில் வெளியிடுங்கள் பக்கத்தையும் பாருங்கள்.

திட்டத்தை இடமாற்றம் செய்தால் இணைப்புக்கு என்ன ஆகும்?

இணைப்பு நீக்கப்படும்; அதனால் புதிய உரிமையாளரின் சார்பில் உங்கள் GitHub கணக்குக்கு எதுவும் ஒருபோதும் அனுப்பப்படாது. களஞ்சியம் அப்படியே இருக்கும்.

தொடர்புடையவை

உங்கள் குறியீட்டை ஏற்றுமதி செய்யுங்கள்முழுத் திட்டத்தையும் zip-ஆகப் பதிவிறக்குங்கள்.

செயலியை இறக்குமதி செய்யுங்கள்GitHub அல்லது zip-இலிருந்து ஒரு செயலியைக் கொண்டுவாருங்கள்.

பதிப்புகள்ஒவ்வொரு மாற்றமும், ஒன்றை மீட்டமைப்பது எப்படி என்பதும்.

குறியீடு எழுதும் முகவர்கள்Claude Code, Cursor அல்லது Codex மூலம் குறியீட்டை அனுப்புங்கள், பெறுங்கள்.