Skip to main content

Работа с Git и GitLab

Это руководство объясняет основы работы с системой контроля версий Git и наш локальный GitLab, доступный по адресу http://192.168.0.103:3000.

🚀 Что такое Git и GitLab?​

Git — система контроля версий, которая помогает отслеживать изменения в коде.
GitLab — платформа для хранения Git-репозиториев с веб-интерфейсом. Наш GitLab доступен локально на сервере.

📍 Доступ к GitLab​

Наш GitLab развернут локально и доступен по адресу:

http://192.168.0.103:3000

текущие данные для входа:

  • ip 192.168.0.103:3000
  • логин root (супер-пользователь)
  • пароль 12332155

Первые шаги:

  1. Открой этот адрес в браузере
  2. Зарегистрируйся или войди под существующим аккаунтом
  3. Попроси администратора дать тебе доступ к нужным проектам

🛠️ Установка Git (Git Bash для Windows)​

Для Windows: Git Bash​

  1. Скачай установщик с официального сайта Git
  2. Запусти установщик
  3. Важные настройки при установке:
    • Выбери "Git from the command line and also from 3rd-party software"
    • Выбери "Checkout Windows-style, commit Unix-style line endings"
    • Выбери "Use Windows' default console window"
  4. После установки найди в меню Пуск "Git Bash" — это твой терминал для работы с Git

Проверка установки​

Открой Git Bash и выполни:

git --version

Должна отобразиться версия Git (например, git version 2.40.1).

Настройка имени и почты​

git config --global user.name "Твое Имя"
git config --global user.email "твоя@почта.com"

🌐 Работа с GitLab через веб-интерфейс​

Создание проекта​

  1. Войди в GitLab
  2. Нажми "New project"
  3. Выбери:
    • Create blank project — пустой проект
    • Import project — импорт существующего
    • Create from template — из шаблона
  4. Заполни название проекта (например, my-first-project)
  5. Выбери видимость (Private/Internal/Public)

Основные разделы GitLab​

РазделДля чего нужен
Project OverviewГлавная страница проекта
RepositoryФайлы проекта, история изменений
IssuesЗадачи, баги, feature requests
Merge RequestsВетвление и слияние кода
CI/CDАвтоматическая сборка и деплой
SettingsНастройки проекта

Работа с файлами через веб-интерфейс​

Просмотр кода​

  • Перейди в Repository > Files
  • Навигация по папкам как в проводнике
  • Просмотр истории файла (blame)

Создание/редактирование файлов​

  1. В разделе Repository > Files
  2. Нажми "+" (New file) для создания
  3. Или найди файл и нажми кнопку редактирования (карандаш)
  4. GitLab позволяет создавать файлы прямо в браузере с подсветкой синтаксиса

Коммит изменений​

При редактировании файла внизу страницы есть форма коммита:

  • Commit message — описание изменений (что сделал и почему)
  • Target branch — в какую ветку сохранить
  • Start a new merge request — сразу создать запрос на слияние

Пример хорошего коммита:

Добавлена страница авторизации

- Создан компонент LoginForm.vue
- Добавлена валидация полей
- Настроена отправка данных на API

🔄 Основной рабочий процесс в GitLab​

1. Создание Issue (задачи)​

  1. Перейди в Issues > New issue
  2. Заполни:
    • Title — краткое описание
    • Description — подробное описание, можно использовать Markdown
    • Assignee — на кого назначить
    • Labels — метки (bug, feature, enhancement)
    • Milestone — веху

2. Создание ветки для задачи​

От Issue можно создать ветку:

  1. На странице Issue нажми "Create merge request"
  2. Или вручную создай ветку с именем: feature/краткое-описание или fix/что-исправляешь

3. Работа над кодом​

  • Делай изменения в своей ветке
  • Делай коммиты с понятными сообщениями
  • Пуши изменения в GitLab

4. Создание Merge Request (MR)​

  1. Когда задача готова, перейди в Merge Requests > New merge request
  2. Выбери:
    • Source branch — твоя ветка с изменениями
    • Target branch — обычно main или master
  3. Заполни описание MR
  4. Назначь ревьюверов
  5. Добавь связанные Issue (через Closes #номер-issue)

5. Code Review и слияние​

  • Рецензенты проверяют код, оставляют комментарии
  • Ты вносишь правки по замечаниям
  • После аппрува нажимаешь "Merge"

💻 Минимальная работа с консолью​

Клонирование проекта с GitLab​

# Клонируй проект (ссылка есть на главной странице проекта в GitLab)
git clone http://192.168.0.103:3000/username/project-name.git

# Перейди в папку проекта
cd project-name

Основные команды​

# Проверить статус изменений
git status

# Добавить изменения для коммита
git add .                      # все изменения
git add имя_файла              # конкретный файл

# Создать коммит
git commit -m "Описание изменений"

# Отправить изменения в GitLab
git push

# Получить обновления с GitLab
git pull

Настройка remote (если проект уже создан локально)​

# Инициализировать Git в папке
git init

# Добавить удаленный репозиторий GitLab
git remote add origin http://192.168.0.103:3000/username/project-name.git

# Привязать локальную ветку к удаленной
git branch -M main
git push -u origin main

🔌 Работа с Git в VS Code​

VS Code имеет отличную встроенную поддержку Git.

Настройка​

  1. Открой проект в VS Code
  2. Перейди во вкладку Source Control (Ctrl+Shift+G)
  3. Если проект не подключен к Git, нажми "Initialize Repository"

Основные операции в VS Code​

Визуальное отслеживание изменений​

  • Во вкладке Source Control видны все измененные файлы
  • Нажми на файл, чтобы увидеть разницу (diff)
  • Зеленым выделены добавленные строки, красным — удаленные

Коммит через VS Code​

  1. Напиши сообщение коммита в поле вверху
  2. Нажми галочку (✓) для коммита
  3. Или нажми "..." → "Commit" → "Commit Staged"

Ветвление в VS Code​

  1. Нажми на название текущей ветки в левом нижнем углу
  2. Выбери "Create new branch"
  3. Введи имя ветки (например, feature/new-auth)
  4. VS Code автоматически переключит на новую ветку

Push/Pull через VS Code​

  • Нажми "..." во вкладке Source Control
  • Выбери "Push" для отправки изменений
  • Или "Pull" для получения обновлений

Расширения для Git в VS Code​

  1. GitLens — расширенная информация о коммитах, blame, история файлов
  2. Git Graph — визуальное представление истории веток
  3. Git History — подробная история изменений

📚 Полезные туториалы по Git​

Официальная документация​

  • Pro Git Book — полная книга по Git (есть на русском)
  • Git Documentation — официальная документация

Интерактивные обучалки​

Видеокурсы​

🚨 Частые ошибки и решения​

"Please tell me who you are"​

git config --global user.email "твоя@почта.com"
git config --global user.name "Твое Имя"

"Updates were rejected because the remote contains work..."​

# Сначала получи изменения с GitLab
git pull origin main

# Если есть конфликты, разреши их
# Затем залей свои изменения
git push origin main

"Your branch is ahead of 'origin/main' by X commits"​

# Просто отправь свои коммиты на GitLab
git push

Забыл сделать ветку и работал в main​

# Создай новую ветку с текущими изменениями
git checkout -b feature/my-feature

# Верни main в исходное состояние
git checkout main
git reset --hard origin/main

🎯 Best Practices​

Правила именования​

  • Ветки: feature/краткое-описание, fix/баг, hotfix/срочное-исправление
  • Коммиты: Глагол в настоящем времени: "Add", "Fix", "Update", "Remove"
  • Теги версий: v1.0.0, v2.1.3

Частота коммитов​

  • Делай коммиты часто, но по одному логическому изменению
  • Каждый коммит должен собираться и проходить тесты
  • Сообщение коммита должно объяснять "почему", а не "что" (код и так показывает "что")

Работа в команде​

  1. Всегда перед началом работы делай git pull
  2. Не работай напрямую в main ветке
  3. Создавай Merge Request даже для себя — это история и документирование

📞 Контакты и помощь​

Если возникли проблемы с GitLab:

  • Проверь доступ к http://192.168.0.103:3000
  • Убедись, что у тебя есть права на проект
  • Для доступа к новым проектам обращайся к администратору

Для вопросов по Git:

  • Используй официальную документацию
  • Пробуй команды в тестовом репозитории
  • Google — твой лучший друг: "git как отменить последний коммит"