Скачування файлів із GitHub
Дізнайтеся, як завантажити файли з GitHub, а також зрозуміти різницю між завантаженням, клонуванням та вилкою.
У цій статті
Вступ
GitHub.com є домом для мільйонів проектів програмного забезпечення з відкритим вихідним кодом, які можна копіювати, налаштовувати та використовувати для власних цілей.
Існують різні способи одержання копії файлів репозиторію на GitHub. Ви можете:
- Завантажте моментальний знімок файлів репозиторію у вигляді ZIP-файлу на власний (локальний) комп'ютер.
- Клонуйте репозиторій на локальному комп'ютері за допомогою Git.
- Вилку репозиторію для створення нового репозиторію на GitHub.
Кожен із цих методів має власний варіант використання, який ми пояснимо у наступному розділі.
У цьому посібнику розглядається завантаження файлів репозиторію на локальний комп'ютер. Наприклад, якщо ви знайшли цікавий вміст у репозиторії на GitHub, завантаження - це простий спосіб отримати копію вмісту без використання Git або застосування керування версіями.
Загальні відомості про відмінності між завантаженням, клонуванням та вилкою
| Термін | Визначення | Варіант використання |
|---|
| Завантаження | Збереження моментального знімка файлів репозиторію на локальному комп'ютері. | Ви хочете використовувати або налаштувати вміст файлів, але ви не зацікавлені у застосуванні керування версіями. |
| Клонувати | Щоб зробити повну копію даних репозиторію, включаючи всі версії кожного файлу та папки. | Ви хочете працювати з повною копією репозиторію на локальному комп'ютері, використовуючи Git для відстеження змін та керування ними. Швидше за все, ви плануєте синхронізувати ці локально внесені зміни за допомогою репозиторію GitHub. Щоб отримати додаткові відомості, див. Клонування репозиторію. |
| Виделка | Щоб створити новий репозиторій на GitHub, пов'язаний з особистим обліковим записом, який надає загальний доступ до коду та параметрів видимості вихідному (вищому) репозиторію. | Ви хочете використовувати дані вихідного репозиторію як основу для власного проекту на GitHub. Крім того, ви хочете використовувати вилку для пропозиції змін у вихідному репозиторії. Після створення вилки репозиторію може знадобитися клонувати репозиторій, щоб ви могли працювати зі змінами на локальному комп'ютері. Для отримання додаткових відомостей див. у розділі Виделка репозиторію. |
Необхідні компоненти
Завантаження файлів репозиторію
У цьому посібнику ми використовуватимемо демонстраційний репозиторій (octocat/Spoon-Knife).
Висновок
Тепер у вас є копія файлів репозиторію, збережених у вигляді ZIP-файлу на локальному комп'ютері. Ви можете змінювати та настроювати файли для власних цілей.
Наступні кроки
- У наступному посібнику "Відправка проекту в GitHub" ви дізнаєтесь, як надіслати власні файли у віддалений репозиторій на GitHub.
Додаткові матеріали
Як почати працювати з GitHub: швидкий старт
Розподілені системи контролю версій (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 з консолі. Курс проходить за кілька годин та дає необхідні базові навички.
- офіційний клієнт від GitHub — на мій погляд поки що досить сируватий.
- GitX - особисто мені не сподобався
- GitBox - найбільше слід mac-way, дуже рекомендую спробувати саме його
Качаємо за посиланням code.google.com/p/tortoisegit/downloads/list.При установці скрізь тиснемо Next.
Тепер повертаємось до github і створимо новий репозиторій. Перебуваючи на Dashboard, тиснемо New Repository (https://github.com/repositories/new), вводимо дані та тиснемо Create Repository.
GitHub дозволяє працювати з репозиторіями трьома способами: SSH, HTTP та Git Read-Only, відповідно надаючи посилання трьох видів для нашого репозиторію:
1. [email protected]:habrauser/Hello-world.git
2. [email protected]/habrauser/Hello-world.git
3. git://github.com/habrauser/Hello-world.git
Щоб просто забрати репозиторій на локальну машину, достатньо внутрішнього протоколу git (третє посилання). Це найбільш швидкий та ефективний спосіб, який забезпечує анонімний доступ лише для читання.
Якщо ж ми захочемо внести зміни до репозиторію на github, потрібно користуватися HTTP або SSH.
Робота по http ніяких труднощів не викликає, у потрібний момент просто використовується пароль облікового запису на github.
Щоб використати SSH, нам потрібно створити спеціальну пару ключів: публічний та приватний. Публічний буде розміщений в налаштуваннях облікового запису на github, а приватний збережений на локальній машині.
Для генерації ключів можна скористатися інструментом ssh-keygen, який йде в комплекті з git (опис цього способу можна почитати тут). Ми будемо використовувати PuTTY (а точніше невелику програму puttygen, що входить до його складу). PuTTY – це такий клієнт для віддаленого доступу, у тому числі з використанням SSH.
Качаємо останню версію з офіційного сайту (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html). До речі, puttygen більш старої версії (2007 рік) йде у складі TortoiseGit.
Після встановлення PuTTY, запускаємо puttygen з папки із встановленою програмою:
Тиснемо Generate, рухаємо деякий час курсором миші, для отримання випадкових даних, необхідних алгоритму
Вводимо пароль, що захищає наш приватний ключ у полі Key passphrase, вводимо підтвердження, тиснемо Save private key, зберігаємо.
Далі копіюємо публічний ключ у форматі OpenSSH із текстової області «Public key for pasting. » і йдемо в налаштування нашого облікового запису на github (Account Settings) в розділ SSH Public Keys:
тиснемо Add another public Key, вставляємо наш публічний ключ:
натискаємо Add key. Все, тепер ми готові працювати з github по ssh. Спробуємо забрати наш порожній рерозитор на локальну машину з використанням TortioшseGit. У контекстному меню провідника вибираємо Git Clone…
У поле Url вставляємо SSH-адресу нашого репозиторію, у полі Load Putty Key вказуємо шлях до нашого приватного ключа, тиснемо OK.
Pageant запросить у наc пароль для приватного ключа (після цього робити не потрібно)
Pageant - це агент SSH-аутентифікації у складі PuTTY, він дозволяє керувати закритими ключами.
У треї висить його знак:
Репозиторій успішно схильний до локальної машини
Тепер спробуємо змінити локальний репозиторій та відправити зміни на github. Додамо в локальний репозиторій файл README (файл з ім'ям README обробляється github спеціальним чином - його вміст буде відображатися як опис репозиторію на відповідній сторінці)
Закомітити зміни до локального репозиторію
і синхронізуємо його з репозиторієм на github:
Тепер зайшовши на сторінку нашого репозиторію, ми побачимо наступне:
Для кожного репозиторію сайт пропонує wiki:
а також просту систему issue tracking-a:
до речі, для тих, хто використовує в роботі Eclipse - є відповідний mylyn-конектор для github:
За посиланням Explore GitHub відкривається каталог репозиторіїв, у якому можна шукати за багатьма іншими критеріями, у тому числі з мов програмування, популярності тощо.
Резюмуючи хочеться сказати, що якщо ви розробник-початківець, який планує почати користуватися системами контролю версій, або ж більш досвідчений і придивляється до розподілених VCS, але не знає як почати, тобто сенс спробувати git, використовуючи такий чудовий інструмент як github.com.
Корисні посилання
Про git російською:
habrahabr.ru/blogs/Git/106912 «Вдала модель розгалуження для git» — переклад гарної англомовної статті
githowto.com інтерактивний курс з роботи з git з консолі
habrahabr.ru/blogs/Git/106912 «Чому git» + обговорення
habrahabr.ru/blogs/development/68341 «Git для перехідних з SVN» + обговорення
habrahabr.ru/blogs/Git/75990 «Командна робота в git» + обговорення
progit.org/book/ua російський переклад книги «Pro Git» (перекладено не до кінця)
habrahabr.ru/blogs/Git/123111 інструкція-шпаргалка для початківців
los-t.livejournal.com/tag/git%20guts цикл постів «начинки git»
lib.custis.ru/%D0%9B%D0%B8%D0%BD%D1%83%D1%81_%D0%A2%D0%BE%D1%80%D0%B2%D0%B0%D0%BB %D1%8C%D0%B4%D1%81_%D0%BE_GIT_%D0%BD%D0%B0_Google_Talks Лінус Торвальдс про git
habrahabr.ru/blogs/Git/80909 книга «Чарівність git»
- progit.org/book книга «Pro Git»
- rutracker.org/forum/viewtopic.php?t=2808582 книга "Version Control with Git", 2009, O'Reilly
- book.git-scm.com книга «Git Community Book»
- rutracker.org/forum/viewtopic.php?t=2808843 книга "Pragmatic Version Control Using Git", 2008, T. Swicegood
- rutracker.org/forum/viewtopic.php?t=3239579 книга "Pragmatic Guide to Git", 2010, T. Swicegood. Описувана версія git: 1.7.2.1. Книга у форматі двосторінкових розворотів — проблема/вирішення
- rutracker.org/forum/viewtopic.php?t=900767 книга "Git Internals"
- http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html книга «Git Magic»
- rutracker.org/forum/viewtopic.php?t=3520513 відеокурс, присвячений git. Досить ненудний і з гумором.
- www.youtube.com/watch?v=8dhZ9BXQgc4 лекція про git від Randal Schwartz
- excess.org/article/2008/07/ogre-git-tutorial відеотуторіал Git The Basics Tutorial
- gitref.org референс для вивчення найбільш використовуваних команд
- ftp.newartisans.com/pub/git.from.bottom.up.pdf інструкція за принципом «знизу нагору», тобто. від низькорівневого пристрою git до верхньорівневих команд. Автор стверджує, що так інформація краще сприймається
- ndpsoftware.com/git-cheatsheet.html хороший cheatsheet
- whygitisbetterthanx.com переваги git у порівнянні з іншими VCS
- devcheatsheet.com/tag/git добірка cheatsheets