Github com російською покрокова інструкція. Git

Протистояння змін - основна риса людини. Якщо в той час, коли ви починали роботу з системами контролю версій, не було Git - ймовірно, що ви починали з Subversion. Часто люди кажуть, що Git надто складний для початківців. Проте я дозволю собі з вами не погодитись.

У цій статті я розповім, як можна використовувати Git у роботі з вашими проектами. Вважатимемо, що ви створюєте проект з нуля, і хочете використовувати Git як систему контролю версій. Після ознайомлення з основними командами ми ознайомимося з тим, як можна викласти ваш код на GitHub.

У цій статті йтиметься про основні речі - як ініціалізувати проект, як керувати новими і вже існуючими файлами, і як зберігати свій код у хмарі. Ми опустимо деякі складні речі, як розгалуження, тому що стаття орієнтована на початківців.

Установка Git

На офіційному сайті Git є різні системи - Linux, Mac, Windows. У нашому випадку ми будемо використовувати Ubuntu 13.04, і Git ми будемо встановлювати за допомогою apt-get.

Sudo apt-get install git

Початкова конфігуація

Створимо директорію, в якій ми працюватимемо. Також ви можете використовувати Git для роботи з вже існуючим проектом, і в такому разі ви не створюватимете демонстраційну директорію, як це описано нижче.

Mkdir my_git_project cd my_git_project

Насамперед треба ініціалізувати Git-репозитарій у директорії проекту. Зробити це можна командою init, яка створює директорію.git з усією інформацією про ваш проект.

Git config --global user.name "Shaumik" git config --global user.email " [email protected]" git config --global color.ui "auto"

Варто зазначити, що якщо ви не вкажете вашу адресу та ім'я, то замість них будуть використовуватися значення за промовчанням. У нашому випадку значеннями за промовчанням будуть donny і [email protected]

Також ми встановлюємо колір інтерфейсу значення auto , так що виведення команд Git буде кольоровим. Ми додаємо префікс --global до цих команд для того, щоб ці значення використовувалися у всій системі, і не було потреби задавати їх для кожного окремого проекту.

Готуємо файли для комміту

Наступним кроком ми створимо декілька файлів. Можна використовувати будь-який текстовий редактор. Зверніть увагу, що якщо ви ініціалізуєте Git у вже існуючому проекті, вам не потрібно робити цей крок.

Перевіряємо стан репозитарію

Тепер, коли у вашому проекті є файли, погляньмо, як Git з ними звертається. Щоб перевірити поточний статус репозитарію, використовуйте команду git status

Додаємо файли до Git

На цьому етапі Git не стежить за одним із наших файлів. Необхідно спеціально додати файли до Git, щоб це відбувалося. Для цього скористаємося командою add.

Git add my_file

Перевіривши статус репозитарію, бачимо, що один із файлів уже доданий до нього.

Щоб додати кілька файлів, використовуємо наступне (зауважте, що перший файл ми додали раніше, так що додаємо тільки два).

Git add myfile2 myfile3

Ви можете використовувати git add рекурсивно, але будьте обережні з цією командою. Є деякі файли (наприклад, скомпіловані програми), які не повинні бути додані до системи контролю версій. Якщо ви використовуєте git add рекурсивно, такі файли також потраплять до репозитарію.

Видаляємо файли

Припустимо, що ви випадково додали до репозитарію файл, який не повинен був туди потрапити. Або ж ви хочете прибрати із системи контролю версій будь-який файл. Загалом команда git rm не просто видаляє файл з репозитарію, але й фізично видалить його з диска. Щоб Git перестав відстежувати файл, але він залишився на диску, використовуйте таку команду:

Git rm --cached [ім'я_файлу]

Комітуємо зміни

Як тільки ви додали всі необхідні файли, ви можете закоммітити (зафіксувати) їх у Git. Уявіть, що комміт - це знімок стану проекту на певному етапі, до якого ви можете повернутися будь-якої миті часу, і побачити стан проекту на той момент. З кожним коммітом асоціюється повідомлення, яке задається аргументом після префіксу -m

Git commit -m "Мій перший коміт"

Вказуйте повідомлення, яке міститиме корисну інформацію, оскільки вони допомагають зрозуміти, що саме було змінено в рамках даного комміту. Уникайте якихось спільних повідомлень, на кшталт “Правил баги”. Якщо у вас є баг-трекер, ви можете вказати повідомлення типу "Поправлений баг #123". Хороша практика - вказувати ім'я гілки або поліпшення. Наприклад, “Управління активами – додана можливість генерувати PDF на основі активу” – зрозуміле та зрозуміле повідомлення.

Git визначає комміт довгим шістнадцятковим номером. Зазвичай немає необхідності копіювати весь рядок, перших 5-6 символів достатньо для ідентифікації конкретного комміту. По скріншоті видно, що наш коміт ідентифікується числом 8dd76fc.

Подальші коміти

Давайте змінимо кілька файлів після того, як ми їх закоммітували. Після того, як ми їх змінили, git status повідомить, що у нас є змінені файли.

Можна подивитися, що змінилося в цих файлах з моменту попереднього комміту, за допомогою команди git diff . Якщо ви хочете переглянути зміни для файлу, можна використовувати git diff<файл> .

Необхідно проіндексувати зміни, і закомітіти їх. Усі змінені файли проекту можна додати на коміт наступною командою:

Можна уникнути цієї команди, якщо додати параметр -a до git commit . Ця команда проіндексує всі змінені файли та закоммітує їх. Але такий підхід може бути досить небезпечним, тому помилково можна закомітити те, що не хотілося. Наприклад, скажімо, що ви відкрили файл і випадково його змінили. При індексуванні змінених файлів ви будете сповіщені про зміни у кожному файлі. Але якщо ви відправите на комміт всі змінені файли не дивлячись на допомогу. git commit -a , будуть закоммічені всі файли, включаючи ті, які ви комітити не хотіли.

Як тільки ви проіндексували файли, можна приступати до коміту. Як згадувалося раніше, до комміта можна вказати повідомлення за допомогою ключа -m. Але також можна вказувати і багаторядкові коментарі за допомогою команди git commit, яка відкриває консольний редактор для введення коментаря.

Управління проектом

Щоб переглянути історію проекту, можна скористатися наступною командою:

Вона відобразить повну історію проекту у вигляді списку комітів та інформацію про них. Інформація про коміті містить хеш комміта, автора, час та повідомлення комміта. Є безліч видів команди git log, з якими доведеться познайомитися у разі використання розгалуження у Git. Щоб переглянути деталі конкретного комміту, та змінені файли, виконайте таку команду:

Git show<хеш_коммита>

де<хеш_коммита>- шістнадцятковий номер, асоційований з коммітом. Оскільки цей посібник призначений новачкам, ми не будемо розглядати, як повернути стан на момент конкретного комміту, або як керувати гілками.

Напевно, багато хто чув про систему контролю версій git. Сьогодні ми розглянемо весь шлях від установки git до внесення змін до віддаленого репозиторію на прикладі бібліотеки OsEngine. Для початку завантажуємо клієнт git за посиланням і встановимо його. Запитань виникнути не
мабуть, просто скрізь тиснемо Next. Далі взаємодія з git буде розглянута на прикладі роботи з консольним клієнтом. Наступним кроком необхідно зареєструватися на сайті https://github.com/. Тепер ми можемо приєднатися до роботи над OsEngine. Для цього перейдемо до репозиторію проекту та у правому верхньому кутку натиснемо кнопку Fork.

Цією дією ми створили fork (тобто відгалуження), який зберігається в репозиторії нашого облікового запису і тепер можна вносити до нього зміни, не побоюючись чогось зламати в головній галузі проекту. Далі цей наш репозиторій на github ми будемо називати віддаленим репозиторієм.
Тепер приступимо до роботи з самим git і насамперед нам треба створити на своєму комп'ютері локальну копію віддаленого репозиторію. Для цього переходимо до бажаної папки, в контекстному меню вибираємо пункт Git Bash Here і у нас відкриється консоль.

$ git clone "тут вставляємо посилання без лапок"

Почнеться процес копіювання віддаленого репозиторію в локальний і в поточній папці з'явиться робоча копія з ім'ям OsEngine.

Робота з локальним репозиторієм

Налаштування git

Перед початком роботи з git його необхідно налаштувати. Відкрийте git bash, задайте логін та пароль командами:

$ git config --global user.name “ваше ім'я”
$ git config --global user.email “ваша пошта”

Подивитися файл конфігурації дозволяє команда:

$ git config --global --list

Робота з гілками

Гілки в git це те ж саме, що і гілки на github. Щоб створити нову гілку, виконайте в консолі команду:

$ git branch бажане ім'я

Щоб переключатися на цю галузь, виконайте команду:

$ git checkout ім'я гілки

для повернення в основну гілку наберіть:

$ git checkout master

перейменувати гілку:

$ git branch –m нове ім'я

команда $ git branch дозволяє визначити в якій гілці зараз перебуваємо. Видаляє гілку команда

$git branch –D ім'я гілки

злиття гілки з основною виконується командою:

$ git merge ім'я гілки

При злитті гілок, у яких по-різному змінені однакові файли, може виникнути конфлікт і злиття не станеться. Щоб вийти із цієї ситуації, треба виправити ці файли належним чином.

Комміти

Вся суть використання git у commits (комміти). Коміт – це так званий знімок стану проекту на певному етапі
розробки. Наприклад: у нас є бібліотека OsEngine, ми додали в
її новий індикатор і закоммітили, потім вирішили підправити будь-який файл у
движку і після цього додаток фарбується або не хоче правильно працювати. Щоб
не робити зайву роботу і не правити все назад, ми можемо просто просто
відкотитися до минулого коміту, коли програма працювала як треба. Відповідно
вся робота з git крутиться навколо створення, видалення, редагування, злиття
коммітів та гілок.

Додавання файлів до індексу

Допустимо ми додали в проект файл README, але перш ніж комітити, треба додати змінені файли до
індекс, так зване тимчасове сховище змін. Робиться це так: якщо проіндексувати потрібно один файл, то виконуємо

$ git add README

і файл README буде доданий до індексу, якщо треба проіндексувати всі оновлені та нові файли, то виконуємо

$ git add.

Зверніть увагу, саме з точкою в кінці і пробілом перед нею.

Видалення файлів з індексу

Якщо ви випадково проіндексували не потрібний файл, видалити його з індексу допоможе команда git reset, наприклад видалити файл README з індексу:

$ git reset README

Якщо ви передумали залишати зміни, внесені до файлу, виконайте команду

$ git checkout - ім'я файлу

і він повернеться в стан, в якому знаходився під час останнього комміту, тільки врахуйте, що всі зміни в цьому файлі зникнуть.

Створення комміту

Тепер можна комітити зміни, робиться це за допомогою команди:

$ git commit –m “Тут має бути коментар у лапках”

Слід зазначити, що наявність коментаря є обов'язковою умовою. Історію змін можна переглянути командою

$ git log

$ git show покаже лише останні зміни. Щоб вийти з режиму відтворення, натисніть q.

У git є можливість проіндексувати всі зміни та зробити коміт однією командою:

$ git commit –a –m “коментар у лапках”

A означає: додати всі зміни до індексу до передачі.
-m: коментар.

Редагування, видалення, коміта

Якщо вам потрібно скасувати останній коміт, використовуйте команду:

$ git revert HEAD

Відлік комітів ведеться з 0 починаючи з останнього, наприклад, якщо потрібно скасувати третій коміт, слід виконати:

$ git revert HEAD~2

Команда $ git reset --soft HEAD~3 видалить 3 останніх коміти та відкотить проект у стан четвертого коміту, при цьому зберігши в індексі всі зміни останніх трьох комітів.

$ git reset -- hard HEAD~3

повністю видалить три останні коміти.

Стан файлів

$ git status - Основна команда, яка відстежує стан файлів. Вона показує чи є зміни в файлах, що відстежуються, або наявність не відстежуваних файлів. Файли, що відстежуються – це ті файли, які є в попередньому коміті. Якщо ж ми додали до проекту новий файл, то він вважатиметься таким, що не відслідковується.

Внесення локальних змін у віддалений репозиторій

Тепер, коли в локальному репозиторії було проведено необхідні зміни, їх можна завантажити у віддалений репозиторій.
Робиться це виконанням команди:

$ git push origin master

При цьому потрібно ввести логін та пароль від github. Однак завантаження може не відбутися. Причина може бути в тому, що у віддаленому репозиторії з'явилися зміни, які відсутні в локальному. Щоб вийти зі становища, необхідно забрати ці нові
зміни до локального репозиторію командою:

$ git pull

Використання SSH ключів

Щоб позбавитися необхідності кожного разу вводити логін і пароль при відправці змін у віддалений репозиторій, можна використовувати SSH ключі. Для початку ключі треба згенерувати, виконавши команду:

$ssh-keygen

Далі 3 рази натиснути enter і в директорії за замовчуванням C:\Users\ім'я користувача\.sshз'явиться папка з ключами. Потрібно відкрити файл
id_rsa типу PUB у будь-якому текстовому редакторі та скопіювати його вміст. Потім йдемо на github в налаштування свого облікового запису

Після чого в колонці зліва вибираємо пункт: SSH and GPG keys і тиснемо зелену кнопку праворуч New SSH key

задаємо Title, в поле Key вставляємо дані, скопійовані з ключа і тиснемо

Злиття гілок на github

Після того як ви внесли всі необхідні зміни до свого віддаленого репозиторію, можна надіслати запит на злиття з головним репозиторієм проекту OsEngine. Просто натисніть кнопку New pull request

а потім

У цій статті ми розглянули основні команди git, їх вистачить для початку роботи над проектом OsEngine, використовуючи git та сервіс github.

Вдалих коммітів!

Для людей природно чинити опір змінам. Якщо Git не зустрівся вам, коли ви починали працювати з системами контролю версій, напевно, ви почуваєтеся комфортніше в системі Subversion (SVN).

Часто люди кажуть, що Git надто складний для новачків. Проте я дозволю собі не погодитись із цим.

У цьому уроці я розповім, як використовувати Git у ваших проектах. Припустимо, що ви створюєте проект із нуля і хочете керувати ним за допомогою Git . Пройшовшись по списку основних команд, ви отримаєте уявлення про те, як розмістити ваш код у хмарі за допомогою GitHub.

У цій статті ми поговоримо про основи Git – як ініціалізувати ваші проекти, як керувати новими та існуючими файлами та як зберегти ваш код у хмарі.

Ми не стосуватимемося щодо складних частин Git , таких як розгалуження, оскільки даний урок призначений для початківців.

Установка Git

На офіційному сайті Git є Детальна інформаціяпро його встановлення на Linux, Mac та Windows. У нашому випадку, ми будемо використовувати для демонстрації Ubuntu 13.04 , де встановимо Git за допомогою apt-get:

sudo apt-get install git

Початкове налаштування

Давайте створимо каталог, у якому ми будемо працювати. В якості альтернативи ви можете використовувати Git для керування одним із існуючих проектів; у такому разі вам не потрібно буде створювати демо-каталог, як показано нижче:

mkdir my_git_project cd my_git_project

Першим етапом є ініціалізація Git у каталозі. Це можна зробити за допомогою команди init, яка створює каталог .git, що містить всю інформацію, пов'язану з Git для вашого проекту.

git config --global user.name "Shaumik" git config --global user.email " [email protected]" git config --global color.ui "auto"

Важливо, що якщо ви не вкажіть своє ім'я та адресу електронної пошти, то буде використано значення за замовчуванням. У нашому випадку, значеннями за промовчанням були б ім'я користувача donny та адреса електронної пошти [email protected].

Крім того, ми задаємо для кольору інтерфейсу значення auto , завдяки чому виведення команд Git буде мати колірне підсвічування.

Префікс-global перед командами потрібен для того, щоб не вводити ці команди налаштувань наступного разу, коли ми запустимо проект Git у нашій системі.

Підготовка файлів для комміту

Наступний крок – це створення файлів у каталозі. Ви можете використовувати, наприклад, текстовий редактор Vim. Зауважте, що якщо ви збираєтеся додати Git до існуючого каталогу, вам не потрібно виконувати цей крок:

Перевірити статус репозиторію

Тепер, коли ми маємо кілька файлів у нашому репозиторії, давайте подивимося, як Git звертається з ними. Щоб перевірити поточний статус репозиторію, потрібно скористатися командою git status :

Додавання файлів до Git для відстеження

На даний момент у нас немає файлів для відстеження за допомогою Git. Нам необхідно додати файли конкретно до Git для того, щоб вказати Git, що потрібно відстежувати.

Додаємо файли за допомогою команди add:

Знову перевіривши стан репозиторію, ми побачимо, що додано один файл:

Для додавання декількох файлів, можна використовувати наступний запис команди (зверніть увагу, що ми додали ще один файл для демонстрації):

git add myfile2 myfile3

Ви можете використовувати git add рекурсивно, але будьте обережні з цією командою. Існують певні файли (наприклад, скомпільовані файли), які зазвичай зберігають поза репозиторієм Git .

Якщо ви будете використовувати команду add рекурсивно, вона додасть усі такі файли, якщо вони існують у вашому репозиторії.

Видалення файлів

Але виконання простої команди git rm видалить файл не тільки з Git, але і з вашої локальної файлової системи! Щоб

Git припинив відстежувати файл, але при цьому у вашій локальній системі зберігся сам файл, виконайте таку команду:

git rm --cached

Коміт змін

Після того, як ви розмістили свої файли, можете закомітити їх у Git. Уявіть, що комміт - це відображення певного моменту, до якого ви можете повернутися, щоб отримати доступ до репозиторію на цьому етапі.

Ви можете прив'язувати до кожного комміту повідомлення, яке додається за допомогою префікса -m:

git commit -m "My first commit"

Забезпечуйте коміти корисними повідомленнями, тому що це допоможе вам визначити, що ви змінили у цьому коміті.

Уникайте надто загальних повідомлень типу « Виправлені помилки». Якщо у вас є трекер завдань, ви можете додавати повідомлення як « Виправлена помилка #234».

Хорошою практикою є використання імені гілки або імені функції як префікс до повідомлення комміту. Наприклад, « Керування активами: додано функцію для генерації PDF-файлів активів- це змістовне повідомлення.

Git ідентифікує коміти шляхом додавання довгого шістнадцяткового числа до кожного коміту. Як правило, не потрібно копіювати весь рядок, для визначення вашого комміту достатньо перших 5-6 символів.

Зверніть увагу, що на скріншоті наш перший коміт визначається кодом 8dd76fc.

Подальші коміти

Тепер давайте змінимо кілька файлів після першого комміту. Після їх зміни ми побачимо, що в результаті виконання команди git status Git виявив зміни у файлах, які він відстежує:

Ви можете перевірити зміни в файлах, що відстежуються, зроблені в останньому коміті, за допомогою команди git diff . Якщо ви хочете переглянути зміни у певному файлі, використовуйте команду git diff :

Вам потрібно додати ці файли знову, щоб змінити відстежувані файли для наступного комміту. Можна додати всі відстежувані файли, виконавши команду:

Ви можете уникнути використання цієї команди, скориставшись префіксом -a для команди git commit , який додасть всі зміни в файли, що відстежуються.

Цей процес, проте, дуже небезпечний, оскільки може зашкодити проекту. Наприклад, припустимо, що ви відкрили файл і змінили його помилково.

Якщо ви вибірково розміщуєте файли, то помітите зміни у кожному файлі. Але якщо ви додасте префікс -a до вашого комміту, всі файли будуть закоммічені і ви не зможете виявити можливі помилки.

Після того, як ви розмістили файли, можна приступити до комміту. Я згадував, що з кожним коммітом може бути асоційоване повідомлення, яке ми запроваджуємо за допомогою префікса -m.

Однак існує можливість ввести повідомлення в кілька рядків, скориставшись командою git commit, яка відкриває інтерактивну форму для запису:

Управління проектом

Щоб переглянути історію вашого проекту, ви можете виконати наступну команду:

Так буде показана вся історія проекту, яка представляє собою список усіх коммітів та інформації щодо них. Інформація про коміті включає хеш-код комміту, автора, час і повідомлення комміту. Є різні варіанти git log, які ви можете вивчити, як тільки освоїте поняття гілки (branch) в Git.

Щоб переглянути докладну інформацію про певний коміте та файли, які були змінені, виконайте таку команду:

git show

де це шістнадцяткове число, асоційоване з коммітом. Оскільки цей урок розрахований на новачків, ми не розглядатимемо, як повернутися назад до стану певного комміту або як керувати гілками.

Розміщення коду у хмарі

Тепер, коли ви дізналися, як керувати кодом у вашій системі, настав час розмістити код у хмарі.

Розподілені системи контролю версій (DVCS) поступово замінюють централізовані. Якщо ви ще не використовуєте одну з них - саме час спробувати.

У статті я намагатимусь показати, як можна швидко почати експериментувати з git, використовуючи сайт github.com.

У статті не буде розглянуто різницю між різними DVCS. Також не буде детально розглядатися робота з git, на цю тему є безліч хороших джерел, які я наведу в кінці статті.

Отже, сайт github.com позиціонується як веб-сервіс хостингу проектів із використанням системи контролю версій git, а також як соціальна мережа для розробників. Користувачі можуть створювати необмежену кількість репозиторіїв, для кожного з яких надається wiki, система issue tracking-а, є можливість проводити code review та багато іншого. GitHub на даний момент є найпопулярнішим сервісом такого роду, обігнавши Sourceforge та Google Code.

Для open-souce проектів використання сайту є безкоштовно. За потреби мати приватні репозиторії, є можливість перейти на платний тарифний план:

Почнемо із реєстрації. Йдемо за посиланням github.com/signup/free та вводимо свої дані.
Після реєстрації ми потрапляємо на Dashboard нашого облікового запису:

Зараз у нас немає жодного репозиторію, і ми можемо або створити новий репозиторій, або відгалужитися (fork) від вже існуючого чужого репозиторію і вести власну гілку розробки. Потім, за бажання, зміни можна запропонувати автору вихідного репозиторію (Pull request).

Але для початку встановимо git та налаштуємо його для роботи з сайтом.

Якщо ви працюєте в Windows, качаємо та встановлюємо msysgit. Це консольна версія git для Windows (далі розповідь буде вестись на прикладі цієї ОС).
Інструкція для MacOS X (eng)
Інструкція для Linux (eng)
Проблем виникнути не повинно, просто скрізь тиснемо Next. Після встановлення вибираємо у контекстному меню Провідника Git Bash:

Або через Git Bash.lnk у папці із встановленою програмою:

Прописуємо в консолі свої дані та налаштування переносів рядків:
git config --global user.name "ваше ім'я"
git config --global user.email "ваша пошта"
git config --global core.autocrlf true
git config --global core.safecrlf true

До речі, рекомендую пройти непоганий інтерактивний курс використання git з консолі. Курс проходить за кілька годин та дає необхідні базові навички.

Для тих, хто надає перевагу gui - для Windows існує кілька таких інструментів для роботи з git. Два основних - це SmartGit (кроссплатформенний) та TortoiseGit. Обидва непогані, і який використовувати – справа смаку. Я опишу роботу з TortoiseGit.
Для маків вибір giu також є.

офіційний клієнт від GitHub - на мій погляд поки що досить сируватий.
GitX - особисто мені не сподобався
GitBox - найбільше слід mac-way, дуже рекомендую спробувати саме його

Про git російською:
habrahabr.ru/blogs/Git/106912 «Вдала модель розгалуження для git» - переклад гарної англомовної статті
githowto.com інтерактивний курс по роботі з git з консолі
habrahabr.ru/blogs/Git/106912 «Чому git» + обговорення
habrahabr.ru/blogs/development/68341 «Git для перехідних з SVN» + обговорення

У статті я намагатимусь показати, як можна швидко почати експериментувати з git, використовуючи сайт github.com.

У статті не буде розглянуто різницю між різними DVCS. Також не буде детально розглядатися робота з git, на цю тему є безліч хороших джерел, які я наведу в кінці статті.

Отже, сайт github.com позиціонується як веб-сервіс хостингу проектів із використанням системи контролю версій git, а також як соціальна мережа для розробників. Користувачі можуть створювати необмежену кількість репозиторіїв, для кожного з яких надається wiki, система issue tracking-а, є можливість проводити code review та багато іншого. GitHub на даний момент найпопулярнішим сервісом такого роду, обігнавши Sourceforge та Google Code.

Але для початку встановимо git та налаштуємо його для роботи з сайтом.

Або через Git Bash.lnk у папці із встановленою програмою:

офіційний клієнт від GitHub - на мій погляд поки що досить сируватий.
GitX - особисто мені не сподобався
GitBox - найбільше слід mac-way, дуже рекомендую спробувати саме його

Про git російською:
"Вдала модель розгалуження для git" - переклад гарної англомовної статті
githowto.com інтерактивний курс по роботі з git з консолі
«Чому git» + обговорення
«Git для перехідних із SVN» + обговорення