Как начать работать с GitHub: быстрый старт. Подробное введение в работу с Git Размещение кода в облаке
Git - это очень популярная система контроля версий и совместной разработки проектов с открытым исходным кодом. С помощью Git вы можете отслеживать изменения в исходном коде своих проектов, возвращать предыдущие версии в случае критических ошибок, а также делиться своим кодом со всеми желающими и принимать от них исправления.
Это мощная система, которая позволяет оптимизировать работу над вашими проектами. Здесь нет каких-либо требований к языку или структуре файлов, поэтому у разработчиков полная свобода действий. В этой статье мы рассмотрим как пользоваться git для начинающих пользователей. Рассмотрим все очень подробно, начиная от настройки, и до ветвей проектов.
Уже по традиции, перед тем, как перейти к примерам и работе с командой давайте рассмотрим ее основные опции и параметры. Синтаксис git очень прост:
$ git опции команда аргументы
Сначала рассмотрим опции, они влияют на работу всей утилиты:
- -C - использовать указанную папку репозитория вместо текущей папки;
- -c параметр=значение - использовать указанное значение параметра конфигурации;
- -p - прокручивать весь вывод с помощью less;
Теперь рассмотрим команды git, их немного больше и именно с помощью них вы будете выполнять все основные действия:
- add - добавить файл или папку в репозиторий git;
- am - применить все патчи из email;
- archive - создать архив файлов;
- bisect - использовать бинарный поиск для поиска нужного коммита;
- branch - управление ветками проекта;
- bundle - перемещение объектов и ссылок в архиве;
- checkout - переключение между ветками;
- cherry-pick - внести изменения в уже существующие коммиты;
- clean - удалить все неотслеживаемые файлы и папки проекта;
- clone - создать копию удаленного репозитория в папку;
- commit - сохранить изменения в репозиторий;
- diff - посмотреть изменения между коммитами;
- fetch - скачать удаленный репозиторий;
- init - создать репозиторий;
- merge - объединить две ветви;
- pull - интегрировать удаленный репозиторий с локальным;
- push - отправить изменения в удаленный репозиторий;
- tag - управление тегами;
- worktree - управление деревями разработки.
Аргументы зависят от используемой команды, поэтому более подробно мы будем разбирать их в примерах.
Как работает git?
Итак, из всего выше перечисленного, вы, наверное, уже поняли, что контроль версий позволяет вам посмотреть изменения на любом этапе разработки, а также вернуться к любому моменту. Но это не совсем так. Изменения сохраняются в виде коммитов. По-русски - фиксация. Вы делаете начальный коммит, чтобы сохранить начальное состояние проекта, а затем для каждого изменения. Это работает как снимки состояния.
Кроме того, git позволяет отправлять данные на удаленный сервер. Отправляются не только готовая версия, но и все снимки, таким образом, любой человек из команды может посмотреть историю изменений. К каждому снимку нужно делать комментарий, так работа с git будет проще и понятнее.
Как пользоваться Git?
Обычно, структура проекта в Git будет зависеть от масштаба и сложности вашей программы. Но для начала мы будем использовать проект, состоящий только из одной ветви. Каждый проект содержит одну ветку по умолчанию, она называется master. Наш первый проект будет называться test.
Создание проекта
Когда настройка git завершена перейдем к вашему проекту. В самом начале вам достаточно создать папку для файлов проекта. Если вы собираетесь работать над несколькими проектами, создайте папку git в вашем домашнем каталоге, а уже туда поместите папки ваших проектов:
mkdir -p ~/git/testing ; cd ~/git/testing
Эта команда создаст нужную структуру папок и переводит текущий каталог в только что созданный. Теперь создадим первый файл нашего проекта:
Проект готов, но система контроля версий git еще не знает об этом.
Настройка проекта в git
Перед тем как git начнет отслеживать изменения, нужно подготовить все необходимые конфигурационные файлы. Сначала инициализируем пустой репозиторий в нашей папке:
После того как репозиторий будет создан, вам нужно добавить свои файлы в него. Каждый файл нужно добавлять отдельно или сказать утилите, что необходимо добавить все файлы явно. Пока вы не добавите файл сам он не будет отслеживаться. Новые файлы в будущем тоже нужно добавлять, они не добавляются автоматически. Сначала добавим текущую папку:
Если все прошло хорошо, то команда ничего не выведет.
Фиксация изменений
Изменения тоже автоматически не отслеживаются. Фиксация изменений выполняется с помощью команды commit. Вам нужно указать что было изменено с помощью небольшого комментария, буквально в несколько предложений. Хорошая практика выполнять фиксацию перед каждым серьезным изменением.
Таким образом, вы будете хранить все версии проекта, от самой первой и до текущей, а также сможете знать что, когда и где было изменено. Чтобы создать свой первый коммит выполните:
git commit -m "Initial Commit" -a
Команде необходимо передать два параметра, первый - это -m, ваш комментарий, второй -a, означает, что нужно применить действие ко всем измененным файлам. Для первого раза используется этот параметр, но обычно вам нужно указать измененные файлы или каталоги. Например, можно делать так:
git commit -m "Changed file" file
Отправка изменений
До этого момента мы делали все в локальном репозитории. Вы можете использовать git локально, если нужен только контроль версий, но иногда нужно обменяться информацией с другими разработчиками и отправить данные в удаленный репозиторий.
Сначала нужно добавить удаленный репозиторий с помощью команды remote. Для этого нужно передать ей URL:
git remote add origin https://github.com/Seriyyy95/testing.git
Затем можно посмотреть список удаленных репозиториев:
Вы можете использовать не только github сервера, но и любые другие. Теперь для отправки ваших изменений используйте такую команду:
git push origin master
Команда push указывает, что нужно отправить данные в удаленный репозиторий, origin - наш настроенный репозиторий, а master - ветвь.
Управление ветвями
Для простых проектов достаточно одной ветви. Но если проект большой и он имеет несколько версий, в том числе тестовую, то может понадобиться создать для каждой из них отдельную ветвь. Сначала смотрим доступные ветви:
Опция -a указывает что нужно вывести все ветви, даже не синхронизированные. Звездочка указывает на активную ветвь. Теперь создадим ветвь для разработки с помощью команды checkout:
git checkout -b develop
Переключаться между ветвями можно тоже с помощью той же команды:
git checkout master
$ git checkout develop
Теперь создадим еще один файл:
И добавим его в нашу новую ветвь develop:
Сделаем коммит для внесенных изменений:
git commit -m "develop file" develop
git branch
$ ls
Затем переключаемся на ветку master и снова смотрим:
git checkout master
$ git branch
$ ls
Здесь файла нет, так и должно быть. В git есть такая полезная вещь, как слияние. С помощью нее вы можете объединить две ветви. Например, переместить код из рабочей ветки в стабильную. Для этого достаточно выполнить команду merge:
git merge develop --no-ff
Перед тем как будет выполнено слияние вам нужно ввести комментарий, зачем это нужно. Затем если вы еще раз выполните ls, то увидите, что здесь уже есть нужный файл. Наши примеры git подошли к концу.
Выводы
В этой статье мы рассмотрели как пользоваться git для управления версиями своих проектов. Это только самая основная информация, и система контроля версий git может еще очень многое, но рассмотрение его дополнительных возможностей выходит за рамки данной статьи. Надеюсь, эта статья была вам полезной.
Для людей естественно сопротивляться изменениям. Если 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 "sd@gmail.com" git config --global color.ui "auto"
Важно отметить, что если вы не укажите свое имя и адрес электронной почты, то будут использованы значения по умолчанию. В нашем случае, значениями по умолчанию были бы имя пользователя donny и адрес электронной почты donny@ubuntu .
Кроме того, мы задаем для цвета пользовательского интерфейса значение 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
где
Размещение кода в облаке
Теперь, когда вы узнали, как управлять кодом в вашей системе, пришло время разместить код в облаке.
Если Вы решили сделать первые шаги на пути использования VCS (Version Control System), то Вы уже должны понимать насколько это полезная вещь. Преимуществ использования подобных систем масса, но статья не об этом. В этой статье я расскажу как начать работать (под windows 7) с одной из самых популярных систем контроля версий — Github.
Очень часто в свободной речи мы говорим не гитхаб, а просто гит имея ввиду ресурс https://github.com, однако, это не совсем одинаковые вещи. Сам по себе ресурс гитхаб, это веб оболочка системы по контролю и управлению нашими проектами. Это своего рода социальная сеть для разработчиков и не только по php, но и по другим языкам программирования. Что же касается непосредственно гита, то это программа, которую мы будем ставить на наш компьютер/ноутбук.
Для того, чтобы приступить к работе, нам надо будет скачать две программы:
- msysgit. Скачать последнюю версию можно отсюда -> Git
- TortoiseGit (32bit и 64bit)
После того, как Вы скачали эти две программы, начнем их установку.
Обратите внимание! Сначала нам надо поставить msysgit , а после — TortoiseGit
Процесс установки msysgit интуитивно понятный, поэтому останавливаться на нем мы не будем. Единственное — все настройки, что нам предлагаются в процессе установки можно не менять и оставить их по-умолчанию.
Укажите тот пункт, который Вы видите на скрине выше.
После установки этих пакетов, считайте, что первый этап пройден. Второй этап — получение доступа к нашему репозиторию на Github.
Для начала нам надо пройти регистрацию на сайте https://github.com . Регистрация на этом сайте простая и мало чем отличается от подобных операций на других сайтах.
Обратите внимание! Во время регистрации указывайте реальный email, которым Вы пользуетесь
После этого, нам нужен будет тот имеил, который мы указали при регистрации. Если Вы вдруг забыли какой именно указали при регистрации, то его можно посмотреть в разделе Edit Profile -> Emails (https://github.com/settings/emails) и в главном окне Вы его увидите:
Тут закончили, теперь нам надо сгенерировать SSH key. Это такая цифровая подпись для Вашего компьютера. Чтобы получить этот ключ, нам понадобится тот самый git. После его установки у Вас на рабочем столе должен был появиться ярлык Git Bush. Двойное нажатие на него запустит консоль.
Обратите внимание! Если у Вас нет на рабочем столе этого ярлыка, то эту командную строку можно вызвать так: на рабочем столе, на свободном месте вызовите контекстное меню мышью и в списке пунктов Вы найдете тот самый Git Bush
Теперь в командной строке необходимо выполнить команду:
ssh-keygen -t rsa -C "E-Mail из Вашего профиля"
После этого, здесь же, появится надпись «Enter file in which to save the key». Пока мы оставим все как есть и просто нажмем Enter. Теперь нас просят ввести пароль, пока мы пропустим и этот шаг нажав Enter, но в последствии этот пароль можно будет ввести самостоятельно. После этого у нас сгенерируются два файла — один из них будет нашим SSH ключом.
Обратите внимание! У Вас может быть не установлен модуль ssh-keygen и вышеописанная команда попросту не сработает, а как следствие — ключ генериться не будет. В таком случае либо качайте программы вроде putty. Более подробно в статье на хабре -> http://habrahabr.ru/ . Либо используйте соединение по протоколу HTTPS.
Если Вы все делали как описано в этой инструкции и ничего в процессе не меняли, то файлы будут находиться здесь: C:/users/{UserName}/.ssh/
В этой папке нам нужен будет файл ida_rsa.pub , который надо открыть при помощи обычного блокнота и скопировать содержимое в буфер обмена (попросту говоря, в открытом файле нажать Ctrl+A, затем Ctrl+C).
Следующим шагом настройки, будет занесение этого ключа в Ваш профиль на гитхабе. Для этого идите в настройки Вашего профиля: Settings -> SSH Keys и нажмите кнопку Add SSH key, как показано на скрине ниже.
Перед Вами открылась форма с двумя полями:
- Title
Тайтл оставляйте пустым, а вот в поле Key вставьте скопированный ранее текст из файла ida_rsa.pub .
Поздравляю, еще один этап окончен. Еще совсем чуть-чуть и Вы сможете наслаждаться работой в своем собственном репозитории.
Теперь создайте отдельную папку на локальном хосте в которой будет храниться Ваш проект и вызовите на ней контекстное меню. Затем выберите пункт TortoiseGit -> Settings как показано на скрине:
В открывшемся окне слева, Вы увидите древовидное меню. Вам нужно выбрать Git -> Config и записать свое имя и адрес имейла в точности такой же, как Вы указывали при регистрации на гитхабе.
Теперь нам надо клонировать (скопировать) репозиторий на наш компьютер. Для этого перейдите на гитхабе в свой созданный репозиторий и справа вы увидите его адрес:
Скопируйте этот адрес в буфер обмена. Теперь вызовите контекстное меню на папке, которую Вы создали под свой проект и выберите команду «Git Clone…» :
У нас открылось окно куда нам надо вставить скопированный адрес нашего репозитория:
Обратите внимание на поле Directory — иногда может быть дописана еще одна папка. Проследите чтобы там путь был к вашей папке с проектом, а не какой-нибудь другой. Теперь нажимайте ОК. Начинается клонирование:
Продолжение статьи о работе с Git. Учимся добавлять файлы, коммитить и пушить >
Распределенные системы контроля версий (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 на русском:
«Удачная модель ветвления для git» - перевод хорошей англоязычной статьи
githowto.com интерактивный курс по работе с git из консоли
«Почему git» + обсуждение
«Git для переходящих с SVN» + обсуждение
