Способы доступа
Операции Git из командной строки аутентифицируются SSH-ключом или личным токеном доступа по HTTPS.
- SSH-ключи — сгенерируйте пару ключей на компьютере и добавьте открытый ключ в «Профиль» → «SSH-ключи». Используйте SSH-ключ, чтобы клонировать репозиторий и отправлять изменения по URL вида
git@...без ввода пароля при каждом запросе. - HTTPS с личным токеном доступа — создайте токен в «Профиль» → «Токены доступа» и используйте его как пароль, когда Git запрашивает учётные данные для URL вида
https://....
Администратор может ограничить, какой из двух протоколов доступен на инстансе. Подробнее — в разделе Пользователи и доступ.
Клонирование репозитория
Клонирование позволяет скопировать удалённый Git-репозиторий на локальный компьютер.
Для клонирования выполните команду в терминале:
git clone <REPOSITORY_URL>Замените <REPOSITORY_URL> на HTTPS или SSH-URL вашего репозитория.
Получение изменений
Чтобы получить последние изменения из удалённого репозитория, перейдите в директорию репозитория на локальном компьютере и выполните команду:
git pull origin <BRANCH_NAME>Замените <BRANCH_NAME> на имя ветки, например, main или feature/my-new-feature.
Отправка изменений (Push)
Внесите необходимые исправления в кодовую базу.
Зафиксируйте изменения командой:
git commit -am "Описание ваших изменений"Отправьте изменения в удалённый репозиторий:
git push origin <BRANCH_NAME>
Замените <BRANCH_NAME> на имя ветки, в которую отправляются изменения.
Создание feature-ветки
Feature-ветки используются для разработки новых функций или внесения исправлений. Ниже приведены шаги по созданию feature-ветки и отправке её в Deckhouse Code:
Склонируйте репозиторий:
git clone <REPOSITORY_URL>Замените
<REPOSITORY_URL>на актуальный URL репозитория.Перейдите в директорию репозитория:
cd <REPOSITORY_PATH>Создайте новую feature-ветку:
git checkout -b <BRANCH_NAME>Замените
<BRANCH_NAME>на имя новой ветки. Флаг-bуказывает Git создать новую ветку и сразу на неё переключиться.Отправьте новую ветку в удалённый репозиторий:
git push origin <BRANCH_NAME>Убедитесь, что ветка появилась в удалённом репозитории. Для проверки откройте проект в Deckhouse Code и найдите новую ветку в меню выбора веток.
Запрос на слияние (Merge Request)
Запрос на слияние используется для объединения изменений из одной ветки в другую.
Преимущества использования Merge Request:
Контроль качества кода:
- Позволяет проводить ревью перед слиянием в основную ветку.
- Помогает обнаруживать ошибки и поддерживать единый стиль кодирования.
Организация совместной работы:
- Разработчики могут комментировать код, предлагать исправления и обсуждать изменения.
Автоматизация тестирования и CI/CD:
- MR может интегрироваться с CI/CD-пайплайнами для автоматического тестирования изменений.
История изменений и документация:
- MR содержит описание изменений, комментарии ревьюеров и обсуждения.
Гибкость разработки и контроль версий:
- Позволяет легко откатить или внести исправления в код до слияния.
Повышение безопасности:
- Предотвращает внедрение уязвимостей благодаря проверкам и ревью.
Создание запроса на слияние
Переход в раздел Merge Requests:
- Откройте проект в Deckhouse Code.
- В боковой панели выберите раздел: «Код» → «Запросы на слияние».
Создание нового запроса:
- Нажмите кнопку «Новый запрос на слияние».
- Выберите исходную ветку (с изменениями) и целевую ветку (обычно main).
- Нажмите «Сравнить ветки и продолжить».
Заполнение деталей запроса:
- Название: опишите кратко суть изменений.
- Описание: укажите подробности, при необходимости добавьте скриншоты.
- Ответственный: назначьте пользователя, который будет проводить ревью.
Отправка запроса:
- Нажмите «Создать запрос на слияние».
Ревью и слияние запроса
Слияние происходит после выполнения следующих условий:
- Запрос на слияние прошёл ревью и получил необходимое количество одобрений.
- Отсутствуют конфликты между ветками.
- Все CI/CD пайплайны успешно завершены.
Чтобы завершить процесс, нажмите кнопку «Слияние» на странице запроса.