Способы размещения проекта

---

При создании проекта вы можете выбрать один из двух способов его размещения:

• Локальное размещение.
• Размещение во внешнем репозитории.

Локальное размещение проекта

При локальном размещении проект хранится непосредственно в JAICP.

Локальные проекты создаются быстро и позволяют избежать проблем администрирования внешних репозиториев, однако накладывают ряд ограничений:

• Нет полноценного версионирования и возможности вернуться к предыдущим версиям.
• Затруднена работа над проектом нескольких разработчиков одновременно.
• Сложно поддерживать проекты с объемной кодовой базой.

Проекты сохраняются локально, если при создании проекта с нуля, создании проекта из шаблона или загрузке проекта из архива опция Разместить во внешнем Git-репозитории остается неактивна.

После создания локального проекта вы можете переходить к разработке бота.

Размещение во внешнем репозитории

Проект может храниться в репозитории, созданном при помощи системы контроля версий Git.

Другие системы контроля версий, такие как Mercurial или SVN, не поддерживаются.

Использование Git имеет ряд преимуществ:

• Возможность вернуть состояние проекта до любой предыдущей версии.
• Простота одновременной работы над проектом благодаря отведению веток.
• Гибкий контроль над большими командами разработки контента.

Репозиторий может быть размещен на любом внешнем хостинге, например, Bitbucket, GitLab или GitHub.

Подключение Git-проекта осуществляется при выборе одноименного способа создания проекта или при включенной опции Разместить во внешнем Git-репозитории, если вы создаете проект любым другим способом.

Заполните поля:

• Название проекта — имя проекта, обязательное поле.
• Ссылка на репозиторий — URL-адрес репозитория.
• Путь — относительный путь к директории, в которой будет храниться контент проекта.

Директорией контента в репозитории считается та, в которой хранится конфигурационный файл chatbot.yaml.

• Ветка — ветка с контентом, по умолчанию master.

Эта настройка определяет, содержимое какой ветки будет отображаться в редакторе. Однако в любом канале по-прежнему можно указать любую ветку.

• Доступ — гостевой доступ или собственная учетная запись.

Собственная учетная запись

При выборе данного типа доступа дополнительно заполните следующие поля:

• Логин — логин на хостинге, где расположен репозиторий.
• Пароль — пароль от учетной записи на хостинге.

Нажмите Создать проект.

Если репозиторий размещен на GitHub, обратите внимание на необходимость использовать для авторизации персональный токен вместо пароля от учетной записи.

Гостевой доступ On-premise

Гостевой доступ может быть предоставлен только для версии платформы JAICP On-premise.

При выборе гостевого доступа дополнительно заполните поле Ключ. Ключ обеспечивает защиту репозиториев с гостевым доступом. Сгенерируйте или придумайте ключ.

Подробнее об использовании ключа

Нажмите Создать проект. После создания проекта вы можете переходить к разработке бота.

Изменение способа размещения

Когда проект уже создан, напрямую изменить его способ размещения с локального хранилища на внешний репозиторий либо наоборот невозможно.

Перенос во внешний репозиторий

Чтобы перенести проект из локального хранилища в репозиторий, потребуется:

1. Экспортировать проект в виде архива и распаковать.
2. В директории с файлом chatbot.yaml инициализировать новый репозиторий Git.
3. Сохранить все изменения и загрузить во внешний репозиторий.
4. Создать новый проект с размещением во внешнем репозитории.

Перенос в локальное хранилище

Для переноса из репозитория в локальное хранилище достаточно:

1. Экспортировать проект в виде архива.
2. Создать новый проект с размещением в локальном хранилище.
3. Импортировать содержимое старого проекта в новый.