Гитхаб

.

Введение

Сегодня я расскажу о GitHub – сервисе для работы с системой контроля версий Git, которая является важным инструментом командной разработки. В этой статье вы узнаете о его основных возможностях и предназначении, познакомитесь с процессом настройки и установки на компьютер, чтобы приступить к использованию.

Зачем нужен Git

Git позволяет возвращать отдельные файлы и весь проект к прежнему состоянию, просматривать происходящие со временем изменения. Определять, кто последним вносил изменения во внезапно переставший работать модуль, отследить цепь событий, которая привела к ошибкам и многое другое. Одним из наиболее популярных ресурсов для работы с Git является GitHub. Для удобства работы с ним существует графический клиент GitHub Desktop и консольный Git Shell. В статье рассмотрен пример работы с использованием этого сервиса и его графического клиента.

Основные возможности GitHub

Этапы разработки

С помощью вкладки commits вы можете изучить историю разработки проекта: когда и кем были внесены изменения в какие файлы и строки, как развивался проект в целом. Коммиты (“commit” —  фиксировать) — записи изменений в репозиторий.

Контроль версий

Git позволяет создавать несколько различных, параллельных версий проекта – веток, каждая из которых предназначена для разных целей. Допустим, у вас есть работающий проект. Основная ветка проекта – master. В ней хранится последняя стабильная версия. Для добавления в проект новой функциональности необходимо создать отдельную ветку, при этом данные изменения никак не отразятся на основной версии. Можно переключаться между ветками, что приведёт к изменению файлов локальной версии репозитория.

Начало работы

Как развернуть локальный репозиторий

Начнем с того, что для работы с Git необходима локальная копия (клон) удаленного репозитория – папка на компьютере, в которой будут храниться его файлы. С ними вы будете в дальнейшем работать.

Для клонирования репозитория существующего проекта зайдите на страницу вашего проекта, выберите нужный репозиторий, в открывшемся меню нажмите Clone or download, затем – Open in Desktop.

Откроется Git клиент, где вам будет предложено выбрать директорию для скачивания репозитория. После скачивания файлов попробуйте внести изменения в какой-нибудь файл репозитория – они сразу отобразятся в Git клиенте в разделе Changes: 

Если вы хотите отменить изменения – нажмите правой кнопкой мыши на галочку напротив файла. Появится вкладка Discard changes. Чтобы отменить изменения во всех файлах – нажмите на самую верхнюю галочку, затем Discard all changes.

Также вы можете развернуть локальный репозиторий, который затем можно синхронизировать c GitHub, нажав на кнопку Сreate. Чтобы добавить существующий репозиторий на вашем компьютере – нажмите Add:

После клонирования репозитория можно приступить к работе. Сначала выберите ветку, в которой вы будете работать.

Для создания новой ветки нажмите на кнопку слева от названия ветки. Новая ветка образуется от той, которая указана; изменения, которые есть в текущей ветке, но отсутствуют в мастере, будут перенесены в новую ветку.

Для того чтобы начать работу с последней актуальной версией, нажмите кнопку Sync – ваш локальный репозиторий синхронизируется с удалённым. В локальном репозитории появятся все последние версии файлов. Если вы забудете синхронизироваться перед началом работы, может возникнуть ситуация, когда вы внесли изменения в старую версию файла.

В таком случае возникает конфликт ваших изменений с изменениями в актуальной версии. Объединять их вам придется вручную. Процесс этот порой может быть довольно долгим и трудоёмким.

Для того чтобы сделать коммит, нужно ввести общее название изменений (Summary). В description описывается, какие изменения были внесены. Оно не является обязательным. Ваш коммит появится в разделе History.

После этого тоже обязательно синхронизируйтесь.

Для того чтобы другие разработчики узнали о внесённых вами изменениях и рассмотрели их для внесения в одну из веток, существует действие под названием Pull request.

Как пользоваться GitHub

После отправки Pull request’a разработчики знакомятся с изменениями, оставляют комментарии к коду, вносят правки и при необходимости добавляют коммиты.

Ваш реквест появится во вкладке “Рull requests” на странице проекта, поделитесь ссылкой на него с другими участниками. Можете снова добавлять коммиты в созданную ранее ветку, они отобразятся в пулл-реквесте. Когда все изменения будут согласованы, ветки смёрджат (merge — операция слияния веток), пулл-реквест будет закрыт и все изменения окажутся в ветке, в которую он был сделан.

Итоги

Вы узнали об основном предназначении и возможностях GitHub – инструмента, используемого в совместной разработке. Для начала работы с ним нужно:

1. Стать пользователем сервиса github.com и присоединиться к проекту

2. Установить клиент Github Desktop 

3. Клонировать нужный репозиторий и начать работать с ним в клиенте

Если вам понравилась статья, поделитесь ссылкой на нее

Поделиться

    Читайте далее

    Мы рассказываем об интересных технологиях и делимся опытом их использования.

Работа с GitHub (1/3)

Всем доброго времени суток! Вы, наверное, слышали такое слово как GitHub? В любом случае именно сегодня мы поговорим о том, что это такое и научимся азам работы с ним.

Что такое GitHub?

GitHub — это сервис, который был разработан с целью давать разработчикам делиться своими проектами, разрабатывать их вместе, а также следить за версиями, т.к. GitHub основан на системе контроля версий Git.

Основным плюсом GitHub является то, что он бесплатен для OpenSource проектов, но, если проект частный, то уже придется платить.

Каждый человек может создать репозиторий, где хранить какой-то свой проект и, если захочет, показывать его другим людям. Другие же могут просматривать все файлы проекта и их исходный код с подсветкой синтаксиса, а если нужно, то могут их даже скачать или изменить.

Регистрация

Регистрация в данной системе очень простая. Вам нужно лишь перейти по ссылке

https://github.com/

Там ввести незанятый логин, email и пароль и после чего нажать на кнопку Sign Up for GitHub. Теперь перейдите в указанную вами почту и подтвердите регистрацию, перейдя по присланной вам ссылке. Теперь авторизуйтесь и… вы уже зарегистрированы. Не трудно, правда?

Создаем репозиторий

Чтобы создать свой репозиторий, найдите в правом верхнем углу знак плюса и нажмите на него, выбрав там пункт New repository.

В самом начале введите имя вашего проекта, а затем его описание(необязательно).

Ниже вы можете видеть радио-переключатель с режимами Public и Private. Первый означает, что ваш репозиторий будет виден всем и вы можете выбрать тех, кто сможет совершать с ним коммиты(commit).

Shop the shirt that gives back.

Второй же означает, что репозиторий будет закрытым, но вы можете выбрать, кто сможет коммитить и просматривать его.

Ниже вы можете установить галочку, чтобы сразу инициализировать этот репозиторий с файлом readme.

Теперь нажмите на кнопку Create repository.

Поздравляю! Вы создали свой первый репозиторий!

Установка GitHub

Для Windows есть программа windows.github.com

Для Mac есть mac.github.com

Эти программы позволяют работать с графическим интерфейсом, мы же будем работать с командной строкой. Если у вас mac, то там все работает из коробки, ну, а если вы счастливый обладатель windows, то вам придется поставить msysqgit

http://msysgit.github.io/

Откройте терминал(командную строку) и введите следующее:

Если вы увидите версию, то все работает.

Клонируем репозиторий

Перейдите в созданный вами репозиторий и найдите справа текстовое поле, подписанное HTTPS. Там вы найдете ссылку, которую нужно скопировать.

Откройте терминал и введите следующее:

Вместо yourlink вставьте скопированную ссылку и через пробел введите любое имя, которое хотите. Если вы не введете имя, то оно будет таким же, как и название репозитория.

Теперь внутри папки git появился склонированный нами репозиторий. Внутри вы можете обнаружить файл readme.txt. Пока что это все, что у нас есть.

Настройка

Когда вы делаете какие-то изменения, то все это сохраняется и отображается. В этом большой плюс систем контроля версий. Но нам нужно сделать несколько настроек.

В терминале введите следующее:

Если теперь вы введете

То получите указанное имя.

Итак, на этом заканчивается первая часть, посвященная работе с GitHub. Сегодня мы в основном возились с настройками, но дальше будет интересней, и вы сразу поймете всю прелесть данного сервиса. Спасибо за внимание!

  • Создано 07.07.2014 20:29:17

  • Михаил Русаков

Если у Вас остались какие-либо вопросы, либо у Вас есть желание высказаться по поводу этой статьи, то Вы можете оставить свой комментарий внизу страницы.

Если Вам понравился сайт, то разместите ссылку на него (у себя на сайте, на форуме, в контакте):

  1. Кнопка:

    Она выглядит вот так:

  2. Текстовая ссылка:

    Она выглядит вот так: Как создать свой сайт

  3. BB-код ссылки для форумов (например, можете поставить её в подписи):

1. Регистрируем аккаунт GitHub


Переходим на официальный сайт

GitHub

Вот такую картину мы с вами увидим


Далее 2 стандартных шага:

  1. Вводим в поля имя, почту и желаемый логин (никнэйм пользователя), проходим несложные и понятные шаги регистрации

  2. На указанную почту придет письмо с сылкой для подтверждения регистрации

Вот мы и зарегестрировали аккаунт GitHub

2.

GitHub как хостинг для сайтов

Идем дальше, устанавливаем Git

Git является системмой контроля версий, как в принципе и GitHub, и они друг с другом связанны.

Нам же Git нужен для быстрой и удобной публиуации новых постов в блоге, а так же изменений в дизайне и функционале сайта. + ко всему каждое изменение как бы заносится в своеобразный протокол, который поможет в случае чего откатиться до нужной нам версии сайта и узнавать какие изменения и в каком порядке мы вносили. Публикация сайта в репозиторий GitHub без установленного Git невозможна.


Скачиваем Git

Git


  1. Скачиваем

  2. Устанавливаем все по умолчанию (просто устанавливаем)

  3. С зажатым Shift нажимаем правую кнопку мыши и выбираем пункт Открыть окно команд

  4. Вводим в окне командной строки:

Если Git установился и установился правильно, то мы увидим версию программы:


3. GitHub Desktop, публиковаться будем без командной строки

Так как уроки принципиально рассчитаны на простых людей, которые не знакомы с програмированием и версткой сайтов, то и инструмент для отправки изменений на GitHub нам нужен более понятный и с визуальным интерфейсом.

Скачиваем GitHub Desktop и устанавливаем на свой компьютер, просто устанавливаем

GitHub Desktop


Итог

По итогу данного урока мы сделали три важных шага: создали аккаунт GitHub; установили Git, для публикации из команндной строки; установили GitHub Desktop для более удобных публикаций с визуальным интерфейсом.

Все три шага принципиално важны, так как они необходимы, хоть мы и не сразу будем использовать эти инструменты, но они понадобятся в будущем, для создания блога или сайта !бесплатно!


Навигация между постами

« НазадВперёд »

Данная статья является логическим продолжением истории о создании бота для Telegram, там мы разработали простого, но бесполезного пока, Telegram-бота и научили его разговаривать. Пришло время добавить ему более интересных функций.

Мы научимся получать уведомления от сервиса GitHub, взаимодействовать с GitHub API и Telegram API, напишем бота для передачи всех оповещений о новых коммитах GitHub репозитория в Telegram чат. Как показывает опыт работы нашей команды, это позволяет получать максимально оперативные сведения о работе над проектом в Telegram мессенджере и структурировать процесс разработки проектов. Начнем с этапа получения и обработки оповещений от GitHub.

Для того, чтобы получать все обновления от GitHub, нам понадобятся две вещи: настроить GitHub таким образом, чтобы он посылал вашему серверу информацию об обновлениях, а также написать и запустить серверное приложение, который эту информацию будет получать и обрабатывать.

Что такое API

API (Application Program Interface) — это интерфейс программирования приложений, специальный набор инструкций для взаимодействия сторонних разработчиков с вашим ресурсом. Сегодня многие крупные проекты имеют свои API, предоставляющие удобный механизм создания внешних приложений для сторонних разработчиков.

GitHub API

С GitHub API можно взаимодействовать посредством GET, POST запросов, даже через браузер.

Путеводитель по GitHub для новичков

Для примера вы можете запросить информацию о пользователе. Подставьте вместо n0str свой GitHub-логин и пройдите по данному адресу в браузере:

GitHub ответит вам в формате JSON, который представляет из себя достаточно удобный способ представления информации в виде списков. JSON, ввиду своей универсальности, получил широкое распостранение, а его поддержка реализована в виде библиотек практически для каждого языка программирования. В ответе вы увидите свой логин, ссылки на аватарку, информацию профиля, количество репозиториев и прочие данные.

Мы не будем касаться вопросов работы с git; если вы не знаете как это делать, можете почитать заметки об этом:

Настраиваем прокси

Чтобы получать сообщения от GitHub, нужно сконфигурировать свой собственный сервер. Вы можете прочесть о настройке прокси в статье Простой веб-сервер с использованием Python и Flask.

В качестве прокси, будем использовать бесплатную программу ngrok. Ее главная задача — держать постоянное соединение и передавать вам всю полученную от сервера GitHub информацию. Запустите ее командой, передав в качестве параметра любой свободный порт:

Полученный ответ будет содержать несколько строк, среди которых вы найдете нечто подобное:

Адрес http://ddabef45.ngrok.io нам понадобится позже.

Создаем локальный веб-сервер

Осталось поднять веб-сервер, который будет получать всю информацию по порту 4567.

Воспользуемся кодом из предыдущей статьи о создании веб-сервера на Python Flask, слегка его модифицировав:

Данный код проверяет, действительно ли вам передали POST запрос. Содержимое запроса можно сконвертировать в обычный массив с помощью библиотеки JSON и ее метода loads. В результате, в переменной payload окажется массив с информацией, а на экран будет выведено название репозитория.

GitHub Webhooks

Webhooks — это технология, работающая следующим образом: вы выбираете информация о каких событиях вам понадобятся, вводите адрес вашего веб-сервера и получаете от Github’а все сообщения в реальном времени. Для того, чтобы настроить Webhooks, перейдите в ваш репозиторий, выберите вкладку Settings и переключитесь на экран Webhooks & services.

После нажатия на кнопку Add webhook, потребуется ввести адрес своего сервера, который мы получили ранее (http://ddabef45.ngrok.io), в поле Payload URL и выбрать тип данных (JSON или urlencoded). В данной статье будем придерживаться формата JSON.

Проверка работы

Для проверки запустите сервер командой:

Если все правильно сделано, осталось лишь выполнить команду git commit, затем команду git push и посмотреть результаты. В терминале, в котором вы запускали Flask сервер, отобразится имя репозитория (codex) и появится строка, отображающая POST запрос с HTTP кодом успеха (200).

Чтобы при экспериментировании с приложением вам не приходилось постоянно совершать одни и те же действия над репозиторием, можно воспользоваться встроенной в GitHub функцией повторной отправки сообщения по Payload URL. На странице Webhooks & Services кликните по соответствующему Webhook.

Откроется окно с информацией о вашем Webhook и его оповещениям. Кликнув по конкретному оповещению, вы откроете его содержание, среди которого можно видеть кнопку Redeliver. Клик по ней приводит к посылке повторного оповещения вашему веб-серверу.

Извлекаем полезные данные

Внесем немного изменений в код, чтобы вывести информацию о пользователе, который выполнил push запрос, количестве коммитов в запросе и название ветки репозитория, куда они были загружены. Код примет следующий вид:

А в терминале вы сможете увидеть строку приблизительно следующего содержания:

Также, вы могли заметить в коде строчку:

Она позволяет вам получить дополнительную информацию об ошибках, в случае, если код написан неверно, или некоторые элементы массива оказались недоступны.

В следующей статье вы научите программу анализировать полученные от GitHub данные и посылать уведомления в ваш Telegram-чат.

Если вам понравилась статья, поделитесь ссылкой на нее

Поделиться

    Читайте далее

    Мы рассказываем об интересных технологиях и делимся опытом их использования.

Введение

Сегодня я расскажу о GitHub – сервисе для работы с системой контроля версий Git, которая является важным инструментом командной разработки. В этой статье вы узнаете о его основных возможностях и предназначении, познакомитесь с процессом настройки и установки на компьютер, чтобы приступить к использованию.

Зачем нужен Git

Git позволяет возвращать отдельные файлы и весь проект к прежнему состоянию, просматривать происходящие со временем изменения. Определять, кто последним вносил изменения во внезапно переставший работать модуль, отследить цепь событий, которая привела к ошибкам и многое другое. Одним из наиболее популярных ресурсов для работы с Git является GitHub. Для удобства работы с ним существует графический клиент GitHub Desktop и консольный Git Shell. В статье рассмотрен пример работы с использованием этого сервиса и его графического клиента.

Основные возможности GitHub

Этапы разработки

С помощью вкладки commits вы можете изучить историю разработки проекта: когда и кем были внесены изменения в какие файлы и строки, как развивался проект в целом. Коммиты (“commit” —  фиксировать) — записи изменений в репозиторий.

Контроль версий

Git позволяет создавать несколько различных, параллельных версий проекта – веток, каждая из которых предназначена для разных целей. Допустим, у вас есть работающий проект. Основная ветка проекта – master. В ней хранится последняя стабильная версия. Для добавления в проект новой функциональности необходимо создать отдельную ветку, при этом данные изменения никак не отразятся на основной версии. Можно переключаться между ветками, что приведёт к изменению файлов локальной версии репозитория.

Начало работы

Как развернуть локальный репозиторий

Начнем с того, что для работы с Git необходима локальная копия (клон) удаленного репозитория – папка на компьютере, в которой будут храниться его файлы. С ними вы будете в дальнейшем работать.

Для клонирования репозитория существующего проекта зайдите на страницу вашего проекта, выберите нужный репозиторий, в открывшемся меню нажмите Clone or download, затем – Open in Desktop.

Откроется Git клиент, где вам будет предложено выбрать директорию для скачивания репозитория. После скачивания файлов попробуйте внести изменения в какой-нибудь файл репозитория – они сразу отобразятся в Git клиенте в разделе Changes: 

Если вы хотите отменить изменения – нажмите правой кнопкой мыши на галочку напротив файла. Появится вкладка Discard changes. Чтобы отменить изменения во всех файлах – нажмите на самую верхнюю галочку, затем Discard all changes.

Также вы можете развернуть локальный репозиторий, который затем можно синхронизировать c GitHub, нажав на кнопку Сreate. Чтобы добавить существующий репозиторий на вашем компьютере – нажмите Add:

После клонирования репозитория можно приступить к работе. Сначала выберите ветку, в которой вы будете работать.

Для создания новой ветки нажмите на кнопку слева от названия ветки. Новая ветка образуется от той, которая указана; изменения, которые есть в текущей ветке, но отсутствуют в мастере, будут перенесены в новую ветку.

Для того чтобы начать работу с последней актуальной версией, нажмите кнопку Sync – ваш локальный репозиторий синхронизируется с удалённым. В локальном репозитории появятся все последние версии файлов. Если вы забудете синхронизироваться перед началом работы, может возникнуть ситуация, когда вы внесли изменения в старую версию файла. В таком случае возникает конфликт ваших изменений с изменениями в актуальной версии.

Создание сайта на Github — это просто!

Объединять их вам придется вручную. Процесс этот порой может быть довольно долгим и трудоёмким.

Для того чтобы сделать коммит, нужно ввести общее название изменений (Summary). В description описывается, какие изменения были внесены. Оно не является обязательным. Ваш коммит появится в разделе History.

После этого тоже обязательно синхронизируйтесь.

Для того чтобы другие разработчики узнали о внесённых вами изменениях и рассмотрели их для внесения в одну из веток, существует действие под названием Pull request. После отправки Pull request’a разработчики знакомятся с изменениями, оставляют комментарии к коду, вносят правки и при необходимости добавляют коммиты.

Ваш реквест появится во вкладке “Рull requests” на странице проекта, поделитесь ссылкой на него с другими участниками. Можете снова добавлять коммиты в созданную ранее ветку, они отобразятся в пулл-реквесте. Когда все изменения будут согла
сованы, ветки смёрджат (merge — операция слияния веток), пулл-реквест будет закрыт и все изменения окажутся в ветке, в которую он был сделан.

Итоги

Вы узнали об основном предназначении и возможностях GitHub – инструмента, используемого в совместной разработке. Для начала работы с ним нужно:

1. Стать пользователем сервиса github.com и присоединиться к проекту

2. Установить клиент Github Desktop 

3. Клонировать нужный репозиторий и начать работать с ним в клиенте

Если вам понравилась статья, поделитесь ссылкой на нее

Поделиться

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *