Жаңадан бастаушы ретінде жобаны Github-қа қалай жүктеуге болады

Технологиялық әлеммен байланысты кез келген әзірлеуші ​​немесе кәсіпқой оның не екенін біледі GitHubДегенмен, бәрі бірдей процесті меңгере бермейді жобаны Github-қа жүктеңіз және осы платформа ұсынатын нұсқаларды басқару, топтық ынтымақтастық және кәсіби көріну мүмкіндіктерін толық пайдаланыңыз.

Осылайша, бұл мағынада жаңадан бастағандар да, сарапшылар да жиі жоғалады. Бұл мақалада сіз үйренесіз Біз мұны қалай жасау керектігін айтамыз, өйткені Бірнеше нұсқалар немесе әдістер барЖобаңызды бірлесіп жұмыс істеу үшін немесе басқалар оңай көру және жүктеп алу үшін қолжетімді еткіңіз келсе, барлық мәліметтерді білу үшін оқыңыз.

Репозиторий дегеніміз не және оны неліктен GitHub сайтында орналастыру керек?

Un қойма Бұл сіздің жобаңыздың файлдары мен қалталары, сондай-ақ оларды әзірлеу барысында оларда болатын өзгерістер тарихы сақталатын виртуалды кеңістік. Бұл тарих мүмкіндік береді Нұсқаларды басқарыңыз, алдыңғы күйлерге оралыңыз, басқалармен бірлесіп жұмыс жасаңыз және жұмыс барысының нақты есебін сақтаңыз..

Репозиторийді орналастыру қосулы GitHub Оның көптеген артықшылықтары бар:

• Нұсқаны басқару: Өзгерістер жазылады және әзірлеудің кез келген бөлігін болдырмауға, қарауға немесе бөлісуге болады.
• Бұлттық сақтық көшірме: кез келген жергілікті оқиға кезінде маңызды ақпаратты жоғалтудан аулақ боласыз.
• Кәсіби көріну: Жалпыға ортақ болғандықтан, кез келген адам сіздің жұмысыңызды көре алады, бұл портфолиоңызды жақсартады.
• Қарапайым ынтымақтастық: GitHub басқаларға тарту сұраулары, мәселелер немесе шанышқылар арқылы жобаңызға үлес қосуды жеңілдетеді.

Жұмысты бастау: Алғы шарттар және қоршаған ортаны дайындау

Жобаны Github-қа жүктеп салмас бұрын, компьютеріңізде мыналар орнатылғанына көз жеткізіңіз:

• GitHub жүйесіндегі тіркелгі. Платформада репозиторийлерді жасау өте маңызды.
• Git орнатылды. Бұл өзгертулерді басқаруға мүмкіндік беретін негізгі нұсқаны басқару құралы. Сіз оны жүктеп алып, одан орнатуға болады ресми веб-сайт. Linux негізіндегі жүйелерде орнатуды пәрменді іске қосу арқылы орындауға болады sudo apt-get install git терминалда.
• Код редакторы немесе IDE. Visual Studio коды сияқты опциялар (VSCode) процесті жеңілдетіңіз. Редактордан GitHub-пен тікелей интеграцияның артықшылығын пайдаланғыңыз келсе, осы құралдардың бірін жүктеп алу ұсынылады.

Орнатылғаннан кейін Git Жүйеде бірінші қадам - ​​оны өзіңіздің жүйеңізбен конфигурациялау аты және электрондық поштасы (Бұл деректер міндеттемелеріңізге қол қою үшін пайдаланылады.) Терминалдан келесіні іске қосыңыз:

git config --global user.name "TuNombre"
git config --global user.email [email protected]

Бұл конфигурация әлемдік және сіз оны командаңызда бір рет орындауыңыз керек.

GitHub жүйесінде репозиторий жасау

Енді жобаңызды орналастыратын кеңістікті жасау уақыты келді. Мұны GitHub веб-интерфейсінен мына қадамдарды орындау арқылы орындаңыз:

1. Профиліңізге кіру GitHub.com және түймені басыңыз «Жаңа» жаңа репозиторий жасау үшін.
2. Кіріңіз аты репозиторий үшін қажет және a қосады сипаттама жобаның мақсаты туралы қысқаша, бірақ нақты.
3. Репозиторий болатын-болмайтынын таңдаңыз мемлекеттік немесе жекеменшікБасқалардың көру және қатысу мүмкіндігін қаласаңыз, жалпыға ортақ опциясын таңдаңыз.
4. Сізде файл жасау мүмкіндігі бар README.md автоматты түрде. Бұл файл ұсынылады, өйткені бұл басқа әзірлеушілер репозиторийге кірген кезде көретін бірінші нәрсе.
5. Басыңыз «Репозиторий жасау» процесті аяқтау үшін және сіздің репозиторий файлдарды қабылдауға дайын болады.

GitHub-қа жүктеп салу үшін жергілікті жобаны дайындау

Репозиторий жасалған кезде GitHub жүйесіне жобаны жүктеп салудың келесі қадамы компьютерде жоба қалтасын дайындау болып табылады. Ол үшін терминалдағы осы нұсқауларды орындаңыз, алдымен дұрыс жолды табыңыз cd:

cd tu-carpeta-del-proyecto

Енді жергілікті Git репозиторийін инициализациялаңыз:

git init

Бұл жасырын қалтаны жасайды .git сақтайды нұсқа тарихы және басқа ішкі файлдар.

 

Кодты GitHub-қа жүктеп салу: терминалдағы толық процесс

Жергілікті репозиторий инициализацияланғаннан кейін, біз осы пәрмендерді орындау арқылы барлық мазмұнды GitHub жүйесіне жүктейміз:

1. Барлық файлдарды кезең аймағына қосыңыз бірге:

git add .

2. Міндеттеме жасаңыз Бірінші бақылау нүктесін жазу үшін:

git commit -m "Primer commit"

3. Жергілікті репозиторийді қашықтағымен байланыстырыңыз. ауыстырады NOMBRE_USUARIO y NOMBRE_REPOSITORIO нақты деректер бойынша:

git remote add origin https://github.com/NOMBRE_USUARIO/NOMBRE_REPOSITORIO.git

4. GitHub жүйесіне өзгертулерді жүктеп салыңыз (тармақ main o master сәйкесінше):

git push -u origin main

Кейбір ескі репозитарийлерде немесе конфигурацияларда негізгі тармақ болып табылады master орнына mainҚателерді алсаңыз, негізгі филиалдың атын тексеріңіз және оны жоғарыдағы пәрменде ауыстырыңыз.

VSCode арқылы Github-қа жобаларды қалай жүктеуге болады

сияқты заманауи редакторлар VSCode Олар Git және GitHub-пен жергілікті интеграцияны ұсынады. Міне, мұны оңай істеу жолы:

• Редакторда жоба қалтаңызды ашыңыз («Файл → Қалтаны ашу»).
• Панельге кіру Дереккөзді басқару (бастапқы кодты басқару) бүйірлік тақтада орналасқан.
• Егер әлі жасамаған болсаңыз, «Репозиторийді инициализациялау» түймесін басыңыз. Бұл пәрменге тең git init.
• Баптандырудан кейін сіз түймені көресіз GitHub сайтында жариялауЕгер бұл бірінші рет болса, VSCode және GitHub тіркелгіңіз арасындағы қосылымға рұқсат беруіңіз керек.
• Репозиторийді жалпыға ортақ немесе жеке ретінде жариялауды таңдаңыз.
• Өзгерістерді белгілеу және сипаттама хабарламасын қосу арқылы файлдарды бірінші тапсырмаға дайындаңыз.
• Жобаңызды жариялаңыз және өңдеушіден өзгертулерді оңай синхрондауға болады.

Бұл опция әзірлеу ортасында қалуды қалайтындар үшін өте қолайлы және күнделікті жобаны басқаруды айтарлықтай жеңілдетеді.

Файлдарды GitHub веб-сайтынан қолмен жүктеп салыңыз

Тағы бір балама, әсіресе шағын жобалар үшін, файлдарды веб-интерфейстен қолмен жүктеп салу:

1. GitHub жүйесінде жаңадан жасалған репозиторийді енгізіңіз.
2. Ашылмалы мәзірді басыңыз «Файл қосу» және таңдаңыз Файлдарды жүктеп салу.
3. Файлдарды немесе қалталарды компьютерден браузер терезесіне сүйреп апарыңыз.
4. Төменгі жағында растау хабарын қосып, түймесін басыңыз Өзгерістерді қабылдау файлдарды жүктеп салу үшін.

Бұл әдіс белсенді әзірлеудегі жобалар үшін тиімділігі азырақ, бірақ нақты файлдарды, құжаттаманы және басқа элементтерді қосу үшін пайдалы.

GitHub-пен жұмыс істеу кезіндегі жетілдірілген басқару және үздік тәжірибелер

Жобаны жүктеп салу - бұл бастамасы ғана. GitHub мүмкіндігін барынша пайдалану және кәсіби ұйымды қолдау үшін осы қосымша ең жақсы тәжірибелерді орындауды ұсынамыз:

• README.md жаңартып отырыңыз. Бұл сіздің жобаңыздың ілеспе хаты. Ол оның мақсатын, оны орнату жолын, оны қалай пайдалану керектігін және кез келген тиісті мәліметтерді түсіндіреді. Оны тікелей желіде немесе Markdown синтаксисін пайдаланып редактордан өңдеуге болады.
• Жұмыс тармақтарын жасаңыз. Барлық өзгертулеріңізді «негізгі» немесе «басты» өзгертпеңіз. Жаңа мүмкіндіктер немесе түзетулер үшін бөлек тармақтарды пайдаланыңыз. Оларды тарту сұраулары арқылы кейінірек біріктіруге болады.
• .gitignore файлдарын жүктеп салыңыз node_modules қалталары, уақытша файлдар немесе жергілікті конфигурация файлдары сияқты құпия немесе автоматты түрде жасалған деректерді ортақ пайдалануды болдырмау үшін.
• Жергілікті және қашықтағы репозиторийлерді мезгіл-мезгіл синхрондаңыз. Қолдану git pull жергілікті көшірмені салымшылар енгізуі мүмкін кез келген өзгерістермен жаңартып отыру үшін.
• Қашықтан басқару құралдарын мұқият басқарыңыз. Қашықтағы көзді өзгертсеңіз, пайдаланыңыз git remote -v байланысты репозитарийлерді қарап шығу және git remote remove origin қажет болса, оларды жою үшін.

Жобаларды клондау және бірлесіп жұмыс істеу: келесі қадам

Репозиторий бұлтта болғаннан кейін оны кез келген басқа компьютерге клондауға болады:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git

Бұл сіздің жобаңыздың жергілікті көшірмесін, соның ішінде оның барлығын жасайды тарихты өзгертуҚалтаның басқа атауы болғанын қаласаңыз, оны пәрменнің соңына қосуға болады. Пәрменнің жаңа қалта жасауына және файлдарды ағымдағы каталогқа тікелей орналастыруына жол бермеу үшін нүктені қосыңыз:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git .

GitHub-та басқа пайдаланушылармен бірлесіп жұмыс істеу - бұл филиалдар ағынын, сұрауларды тартуды және кодты шолуды үйрену. Осылайша, сіз сыртқы жарналарды қабылдай аласыз және ұйымдасқан және тиімді түрде команда ретінде жұмыс істей аласыз.

Жиі кездесетін қателіктер және оларды қалай түзетуге болады

Жобаны жүктеп салу кезінде сіз кейбір жалпы мәселелерге тап болуыңыз мүмкін. Міне, ең көп таралғандары және оларды шешу жолдары:

• Басты тармақсыз бос репозиторийге өтуге әрекеттену- Қашықтағы репозиторий README.md файлынсыз жасалған болса және тармақ ешқашан итерілмеген болса, дұрыс атауы бар бірінші тармақты итеріңіз, әдетте «негізгі» немесе «басты».
• Синхрондау қақтығыстары: Жергілікті және қашықтан бір уақытта өзгерістер болған кезде, алдымен a әрекетін орындау арқылы оларды шешіңіз git pull және жасамас бұрын қақтығыстарды шешу git push қайтадан.
• Рұқсаттар жеткіліксіз: Дұрыс тіркелгі деректері бар екеніне көз жеткізіңіз және қашықтағы URL мекенжайының дұрыс жазылғанын тексеріңіз (сәйкесінше https немесе ssh).
• Маңызды файлдарды қосуды ұмыту: файлды қарап шығыңыз және жаңартыңыз .gitignore негізгі файлдарды қалдырмау немесе жеке ақпаратты кездейсоқ жүктеп алмау үшін.

Жобаңызды GitHub-қа жүктеп салу жұмыс үрдісіңіз үшін ойын өзгертеді: сіз әрқашан бұрынғы нұсқаларды қалпына келтіре аласыз, бірлесіп жұмыс істей аласыз және жұмысыңызды әлемге көрсете аласыз.