Администрирование (Windows) > Локальная установка системы > Установка системы (Directum Launcher)

В среде разработки Directum RX для хранения исходных кодов используется распределенная система контроля версий Git. Для совместной работы в Git нескольких прикладных разработчиков нужно установить систему управления репозиториями и создать учетные записи для всех разработчиков.

По умолчанию используется система управления репозиториями Gitea. Первая учетная запись создается при установке, а остальные – в параметрах среды разработки.

Примечание. Для работы с Git можно использовать любую другую систему управления репозиториями. В этом случае нужно самостоятельно установить систему и настроить учетные записи.

Если систему будет модифицировать только один разработчик:

1.На компьютере со средой разработки:

•установите сервер Git;

•установите и настройте Gitea.

2.Настройте хранение исходных кодов разработки.

Если планируется совместная работа нескольких разработчиков:

1.На отдельном компьютере:

•установите сервер Git;

•установите и настройте Gitea.

2.На каждом компьютере разработчика в настройках Git укажите учетные данные для работы с репозиторием: имя пользователя и адрес электронной почты. Для этого запустите файл C:\Program Files\Git\git-cmd.exe и в открывшемся окне утилиты выполните команды:

git config --global user.name "<Фамилия и имя пользователя>"
git config --global user.email <Адрес электронной почты>

Пример команд:

git config --global user.name "Ivanov Ivan"
git config --global user.email Ivanov_II@company.org

Подробнее см. в документации Git статью «1.6 Введение - Первоначальная настройка Git».

3.Настройте хранение исходных кодов разработки.

Установка Git

Для установки сервера Git запустите из дистрибутива файл Redist.zip\<Номер версии>\win7-x64\Git-install.exe.

Установка Gitea

1.На официальном сайте Gitea www.dl.gitea.io/gitea перейдите в папку с версией 1.15.6 и скачайте приложение gitea-1.15.6-gogit-windows-4.0-386.exe.

2.Создайте папку C:\Gitea, в которой будет располагаться репозиторий.

3.В созданную папку скопируйте скачанное приложение и запустите его.

Примечание. Для запуска может потребоваться настройка разрешений в фильтре Microsoft SmartScreen.

В результате запустится командная строка, создастся конфигурационный файл C:\Gitea\custom\conf\app.ini. Затем окно командной строки можно закрыть.

4.Очистите конфигурационный файл app.ini и заполните, как указано ниже:

APP_NAME = dds
RUN_MODE = prod
 
[security]
INSTALL_LOCK   = true
 
[server]
SSH_DOMAIN       = localhost
DOMAIN           = localhost
DISABLE_SSH      = false
SSH_PORT         = 22
LFS_START_SERVER = true
OFFLINE_MODE     = false
 
[repository]
ROOT = 
 
[database]
DB_TYPE  = sqlite3
HOST     = 127.0.0.1:3306
NAME     = gitea
USER     = gitea
PASSWD   = 
SSL_MODE = disable
PATH     = 
 
[mailer]
ENABLED = false
 
[service]
REGISTER_EMAIL_CONFIRM            = false
ENABLE_NOTIFY_MAIL                = false
DISABLE_REGISTRATION              = false
ENABLE_CAPTCHA                    = false
REQUIRE_SIGNIN_VIEW               = false
DEFAULT_KEEP_EMAIL_PRIVATE        = false
DEFAULT_ALLOW_CREATE_ORGANIZATION = true
DEFAULT_ENABLE_TIMETRACKING       = true
NO_REPLY_ADDRESS                  = noreply.example.org
 
[picture]
DISABLE_GRAVATAR        = false
ENABLE_FEDERATED_AVATAR = false
 
[openid]
ENABLE_OPENID_SIGNIN = true
ENABLE_OPENID_SIGNUP = true
 
[session]
PROVIDER = file

Подробнее см. в официальной документации Gitea статью Configuration Cheat Sheet.

5.В папке C:\Gitea создайте подпапку для хранилища репозиториев, затем в секции repository в параметре ROOT укажите путь к нему.

ВАЖНО. В пути используйте «/» вместо «\», не используйте кавычки.

Пример:

ROOT = C:/Gitea/repositories

6.Создайте папку data для базы данных Gitea, затем в секции database в параметре PATH укажите путь к ней.

ВАЖНО. В пути используйте «/» вместо «\», не используйте кавычки. В конце пути укажите имя базы данных с расширением *.db.

Пример:

PATH = C:/Gitea/data/gitea.db

7.Установите Gitea в качестве службы Windows. Для этого запустите командную строку и выполните команду:

sc create GitService binPath="<Путь к приложению Gitea> web --port <Номер порта>" start=auto

Где:

GitService – название устанавливаемой службы;

bitPath – полный путь до скачанного EXE-приложения Gitea;

--port – порт для работы службы, по умолчанию 3000.

Пример:

sc create GitService binPath="C:\Gitea\gitea-1.15.6-gogit-windows-4.0-386.exe web --port 3000" start=auto

В результате установится служба GitService.

8.С помощью оснастки Службы запустите установленную службу.

Настройка Gitea

1.В браузере откройте сайт сервера Gitea:

<Адрес Git-сервера>:<Порт, заданный при установке>

По умолчанию http://localhost:3000/.

2.Создайте администратора Gitea. Для этого на главной странице нажмите на кнопку Регистрация и заполните поля *Имя пользователя, *Адрес эл. почты, *Пароль. В поле ниже повторите пароль и затем нажмите на кнопку Регистрация аккаунта.

В результате под созданным пользователем откроется главная страница от имени созданного пользователя.

3.Выберите раздел Организация и создайте новую организацию. Для этого на открывшейся странице заполните Название организации*, остальные параметры оставьте по умолчанию. Затем нажмите на кнопку Создать организацию:

4.Создайте базовый репозиторий, который будет использоваться для хранения исходных файлов базовых решений. Для этого в разделе Репозиторий создайте новый репозиторий и на открывшейся странице заполните поля:

Владелец* репозитория. Укажите ранее созданную организацию.

Название репозитория*. Укажите Base. В названии репозитория нельзя использовать символы кириллицы.

В нижней части страницы нажмите на кнопку Создать репозиторий. В результате откроется страница со ссылкой на созданный репозиторий:

Скопируйте и сохраните ссылку, например, в закладке браузера.

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

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

Настройка хранения исходных кодов разработки

1.Убедитесь, что среда разработки закрыта.

2.Перейдите в папку с Directum Launcher и от имени администратора запустите файл DirectumLauncher.exe. Откроется командная строка, в ней запустится сервис развертывания, в браузере откроется страница с параметрами. До окончания конфигурирования не закрывайте окно командной строки.

Если случайно закрыли браузер или он не настроен по умолчанию, страницу с параметрами можно открыть вручную по адресу, указанному в командной строке. Пример адреса: http://127.0.0.1:5000/.

3.На открывшейся странице переключитесь в режим Настройка.

4.Во встроенном текстовом редакторе перейдите в секцию DevelopmentStudio.

5.В секции REPOSITORIES в параметре url укажите адреса репозиториев, которые будут использоваться для хранения исходных файлов базовых и разрабатываемых решений. Ссылки с адресами получали при настройке Gitea.

Пример настройки в config.yml:

REPOSITORIES:
    repository:
    -   '@folderName': 'Work'
        '@solutionType': 'work'
        '@url': 'http://localhost:3000/DirectumRX/work.git'
    -   '@folderName': 'base'
        '@solutionType': 'Base'
        '@url': 'http://localhost:3000/DirectumRX/base.git'

6.Нажмите на кнопку Применить настройки.

Если нужно подключить другие удаленные репозитории, для каждого из них в секции REPOSITORIES добавьте параметры:

•folderName – название папки репозитория;

•solutionType – тип репозитория;

•url – адрес репозитория.

Пример подключения дополнительного репозитория MyNewWork:

REPOSITORIES:
    repository:
    -   '@folderName': 'Work'
        '@solutionType': 'work'
        '@url': 'http://localhost:3000/DirectumRX/work.git'
    -   '@folderName': 'base'
        '@solutionType': 'Base'
        '@url': 'http://localhost:3000/DirectumRX/base.git'
    -   '@folderName': 'MyNewWork'
        '@solutionType': 'work'
        '@url': 'http://localhost:3000/MyNewWork/MyNewWork.git'

Настройки хранения исходных кодов также можно задавать в конфигурационном файле config.yml. Подробнее о конфигурировании см. в руководстве администратора в разделах «Настройка через Directum Launcher» и «Настройка через конфигурационный файл».

Хранилище исходного кода

Хранилище исходного кода