Управление версиями приложения через Git. Инициализация репозитория, экспорт и импорт

Введение

В Comindware Platform предусмотрены экспорт и импорт версий приложений посредством системы контроля версий Git.

Для работы этой функции требуется настроить подключение к репозиторию. См. статью «Управление версиями с помомщью Git. Настройка подключения».

Переход к странице управления версиями через Git

1. На странице «Администрирование» приложения выберите пункт «Управление версиями» ‌.

2. Если отображается страница ручного управления версиями, нажмите заголовок «Ручное управление версиями» и в раскрывающемся меню выберите пункт «Управление версиями через Git».

   

3. Отобразится страница «Управление версиями через Git».

4. Выполните необходимые операции:

   • Инициализация — выбор репозитория, настройка аккаунта для создания коммитов и выбор или создание ветки в репозитории для управления версиями приложения.
   • Импортировать из Git — импорт последней версии приложения из ветки, выбранной при инициализации репозитория Git.
   • Экспортировать в Git — экспорт текущей версии приложения ветка, выбранную при инициализации репозитория Git.

   

Инициализация репозитория

Чтобы использовать функцию управления версиями через Git, сначала инициализируйте репозиторий.

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

Перед этим необходимо настроить подключение к репозиторию.

1. Нажмите кнопку «Инициализация» на странице «Управление версиями через Git».
2. Отобразится окно «Инициализация репозитория Git».
3. Выберите репозиторий — одно из настроенных подключений к Git.

4. Перейдите к шагу «Подключение к Git», нажав кнопку «Далее».

   

5. В окне «Настройка аккаунта Git» заполните перечисленные ниже поля:

   • Имя пользователя — укажите логин для подключения к репозиторию.
   • Пароль — укажите пароль для подключения к репозиторию.
   • Ф. И. О — укажите имя, которое будет отображаться в репозитории в качестве имени автора коммитов.
   • Адрес эл. почты — укажите адрес электронной почты, который храниться в репозитории в качестве адреса автора коммитов.

   Автор коммитов

   От имени настроенного пользователя будут создаваться коммиты (версии приложения) в репозитории.

6. Проверьте подключение к репозиторию, нажав кнопку «Подключиться».

   

7. Должно отобразиться сообщение «Соединение установлено».

   

8. Перейдите к шагу «Выбор ветви», нажав кнопку «Далее».

9. Выберите ветку репозитория в раскрывающемся списке «Ветка». Выбранная ветка будет использоваться для импорта и экспорта версий приложения

10. Отобразится список коммитов (версий приложения) в выбранной ветке со следующими сведениями:

    • Описание — наглядное описание версии приложения, хранящейся в репозитории.
    • Дата — дата сохранения версии приложения в репозитории.
    • Автор — пользователь, под именем которого была сохранена версия приложения.
    • Коммит — уникальный идентификатор версии приложения в репозитории.

    

11. При необходимости нажмите кнопку «Создать новую ветвь».

    В окне «Новая ветвь в репозитории Git»

    • введите название новой ветви — оно может содержать латинские буквы (A–Z, a–z), цифры (0–9) дефисы и символы подчёркивания (-, _);
    • нажмите кнопку «Сохранить».

    

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

12. Нажмите кнопку «Назад», если требуется вернуться к предыдущему шагу инициализации репозитория.

Экспорт приложения в репозиторий Git

При экспорте в репозиторий Git в репозитории будет создан коммит с текущей версией приложения из Comindware Platform в ветке, заданной при инициализации репозитория.

1. Перейдите на страницу «Управление версиями через Git».
2. Отобразится окно «Экспортировать в Git».

3. Нажмите кнопку «Экспортировать».

   

4. Будет экспортирована текущая версия приложения в ветку, заданную при инициализации репозитория.

5. После успешного экспорта версии приложения в репозиторий должно отобразиться сообщение «Экспорт в Git выполнен».

   

6. Если экспорт не удаётся выполнить:

   • отобразится список найденных ошибок;
   • скачайте и изучите журнал экспорта (transfer_export_YYYY-MM-DD.log), нажав кнопку «Скачать»;
   • при необходимости скачайте журнал ошибок;
   • устраните обнаруженные проблемы в приложении;
   • экспортируйте приложение заново.

   

Импорт приложения из репозитория Git

При импорте из репозитория Git будет импортирован последний коммит с версией приложения из ветки, заданной при инициализации репозитория.

1. Перейдите на страницу «Управление версиями через Git».
2. Отобразится окно «Импортировать из Git».
3. При необходимости устанофите флажок «Импортировать архивные записи из справочников».

4. Нажмите кнопку «Выполнить».

   

5. После импорта версии приложения в репозиторий должно отобразиться сообщение «Импорт выполнен».

   

6. Если импорт версии приложения не удаётся выполнить:

   • отобразится список найденных ошибок;
   • скачайте и изучите журнал импорта (transfer_import_YYYY-MM-DD.log), нажав кнопку «Скачать»;
   • устраните обнаруженные проблемы и конфликты в исходном и целевом приложениях;
   • экспортируйте исходное приложение заново;
   • повторите импорт.