GitHub — это веб-сервис для хостинга кода, который позволяет разработчикам хранить, отслеживать и управлять проектами с помощью системы контроля версий Git. Платформа дает возможность создания и управления открытыми репозиториями, способствует обмену опытом. В статье рассказываем, как залить файлы на Гитхаб и правильно работать с сервисом.
Почему GitHub стал стандартом для разработчиков
GitHub — это облачный сервис, где программисты хранят файлы, опубликовывают проекты и совместно управляют ими. Для работы с ресурсом нужно создать репозиторий (repository), добавить в него данные, синхронизировать с устройством, а затем отслеживать изменения и рецензировать код.
Принцип работы: Git — это локальный репозиторий кода, а GitHub — удалённый. Это разные сервисы, которые существуют и функционируют отдельно, но могут взаимодействовать друг с другом.
Возможности платформы:
- Предоставляет дистанционный доступ к коду и документации.
- Помогает управлять изменениями в коде.
- Создает условия для совместной работы разработчиков над задачей.
- Позволяет присоединиться к проекту и поучаствовать в улучшении открытого кода.
- Интегрируется с другими инструментами, помогает автоматизировать тестирование и развертывание.
- Хранит открытые программные обеспечения, позволяет получать отзывы от сообщества программистов.
К инструментам работы с веб-сервисом относятся: графические интерфейсы, такие как GitKraken, GitHub Desktop, консоль, интерфейс командной строки git, TortoiseGit.
Начало работы: настройка аккаунта и подготовка проекта к загрузке
- Установите Git на компьютер:
- На iOS откройте терминал и наберите git —version.
- На Windows поставьте консоль.
- Запустите установщик.
- Чтобы сэкономить время, можете не менять настройки по умолчанию и прокликать Next.
Чтобы пройти регистрацию, выполните действия:
- Создайте учетную запись. Для этого зайдите на страницу github.com, зарегистрируйтесь и выполните верификацию адреса электронной почты.
- Решите, какой тип профиля выбрать:
- Публичный. Repositories доступны всем.
- Приватный. Данные могут просматривать только отдельные участники.
- Определитесь с тарифом:
- По умолчанию система присваивает бесплатную версию. В разделе Pricing можно изменить параметр.
- Платный тариф характеризуется улучшенной системой безопасности, объемом памяти и расширенным функционалом для разработки.
- Заполните аккаунт. На сервисе присутствует много IT-рекрутеров, которые по данным в профиле могут предложить работу. Выгрузите фотографию, разместите ссылки на социальные сети, опишите опыт, навыки, специализацию, образование, кейсы.
Как подготовить проект к публикации
- После верификации почты создайте удаленный пустой репозиторий. На бесплатной версии хранилище вмещает до 500 Мб данных.
- Перейдите на главную страницу GitHub и нажмите кнопку New repository.
- Введите название проекта, кратко опишите, выберите опцию для публичного или приватного доступа, при необходимости закиньте техническую документацию. Например, README file — предоставляет описание проекта для других разработчиков, Gitignore — экономит место путем исключения скрытых файлов, License — содержит ссылку на первоисточник и защищает права программиста.
Создание репозитория
- Нажмите кнопку Create repository.
Страница репозитория
- Проведите инициализацию Git в папке проекта:
- Перейдите в папку, которую планируете добавить в repository.
- Выполните в терминале команду git init, чтобы создать в папке скрытый каталог .git. В нем хранятся все метаданные и истории обновлений.
- Добавьте файлы в индекс Git с помощью команды git add -A.
- Создайте коммит со всеми загруженными файлами — git commit -m 'Added my project'.
- Добавьте новый удаленный repository командой: git remote add origin git@github.com:имя пользователя/репозиторий.git
- Для передачи на сервис примените команду: git push -u -f origin main
Как загрузить проект на GitHub
- Загрузите GitHub Desktop со страницы desktop.github.com для синхронизации remote repository и файлов на ПК без командной строки.
- Пройдите авторизацию. Для этого введите электронную почту и данные профиля.
- Система предоставит выбор действий: создать новый репозиторий, отправить папку с устройства или клонировать имеющийся репозиторий на компьютер.
Desktop
- Нажмите на кнопку Clone. После этого программа выдаст три раздела для работы:
- Current Repository для переключения между разными репозиториями, просмотра невнесенных правок и истории коммитов.
- Current Branch для переключения между ветками.
- Fetch origin для обновления внесенных изменений и синхронизации файлов локального и удалённого репозитория.
Desktop
Авторизация
Выбор репозитория
Открывшееся меню
- Откройте проект в редакторе кода с помощью любой программы, например, Visual Studio Code. GitHub Desktop рекомендует Atom.
- Создайте HTML-файл, добавьте базовую структуру. В боковом меню эти данные будут подсвечены зеленым. Это означает, что изменения появились, но не добавлены на GitHub.
- Перейдите в приложение. В разделе Changes появится созданный HTML-файл. Напишите коммит для сохранения, в разделе History проверьте, зафиксированы ли правки, затем запушьте.
- Добавьте к проекту CSS-файл (подсветится зеленым) и подключите его к HTML (станет оранжевым). Зеленый цвет означает, что файл нужно добавить в репозиторий, оранжевый — что он загружен.
- Если вы хотите поэкспериментировать, но не вносить изменения в код, добавьте новую ветку. Для этого перейдите в блок Current Branch, кликните New Branch, напишите название и нажмите Create New Branch.
- Перейдите обратно в редактор кода и протестируйте изменения.
- Если эксперимент оказался успешным, и вы хотите перенести правки на основной код, перейдите на сайт, кликните Compare & pull request.
- Подтвердите действия с помощью Merge pull request.
- Вернитесь в Desktop, нажмите Fetch origin, чтобы выполнить синхронизацию с удалённым репозиторием.
Типичные ошибки и как их исправить
- Git не установлен на компьютере. Перед загрузкой GitHub Desktop необходимо скачать Git с официального сайта. Иначе работа с приложением невозможна.
- Ошибка при клонировании репозитория. При сбое убедитесь, что правильно указали URL репозитория и имеете доступ к нему.
- Потерялся файл, или правки не отображаются. Проверьте, верно ли сохраняли и коммитили обновления в репозитории.
- Необходимость очистки кэша. Если Desktop работает медленно или некорректно, попробуйте очистить кэш и перезапустить программу.
- Неверное управление конфликтами слияния. Могут возникнуть, когда две ветки содержат изменения в одной и той же строке кода.
- Невнительное управление доступом. Может привести к утечке конфиденциальной информации или нежелательным изменениям в коде. Используйте функционал GitHub для корректного распределения прав доступа.
Как потом управлять проектом
Советы для работы с загруженным проектом на сервисе:
- В разделе Current Repository в левом нижнем углу во вкладке Changes найдите окно для внесения коммитов и комментариев. Используйте этот функционал, чтобы отображать действия в проекте без посещения сайта GitHub.
- Учитывайте подсветку данных в меню в качестве подсказки. Оттенок меняется после редактирования и помогает не забывать обновлять репозиторий. Это важно, чтобы не только не потерять данные, но и чтобы остальные участники могли своевременно видеть изменения.
- Используйте ветки для разработки новых функций и тестирования идей.
- По возможности оставляйте комментарии к каждому коммиту, чтобы остальные разработчики в команде понимали, что изменено в коде и почему.
- Поддерживайте актуальную документацию в репозитории, чтобы не упустить значимые детали.
Главное, что нужно знать
- GitHub — это облачный сервис для хранения и управления проектами с помощью системы контроля версий Git. Платформа предоставляет доступ к коду и документации, помогает отслеживать изменения, создает условия совместной работы разработчиков, хранит открытые программные обеспечения, позволяет автоматизировать тестирование и развертывание.
- Чтобы загрузить проект на Гитхаб, нужно зарегистрировать аккаунт, создать удаленный репозиторий, установить Desktop, клонировать имеющийся репозиторий на компьютер, открыть проект в редакторе кода, сформировать HTML-файл, сохранить его в приложении. Для тестирования разных вариаций кода, используйте новые ветки.
- К распространенным ошибкам относятся — отсутствие Git на компьютере, ошибка при клонировании репозитория, нерегулярное обновление данных.
