Инструкция по работе с платформой Scalaxi в Yandex.cloud

Как установить Scalaxi Platform в Yandex.cloud

Scalaxi Platform — это микросервисная low-code платформа разработки приложений (Low-Сode Aplication Development Platform). Scalaxi Platform позволяет создавать, управлять и публиковать любые кроссплатформенные приложения.
Для установки Scalaxi Platform следует использовать образ виртуальной машины (VM) Scalaxi Platform, доступный в Yandex Cloud Marketplace.

При установке укажите имя домена, на котором будет опубликовано приложение, созданное в Scalaxi Platform. По умолчанию для первоначальной авторизации в Scalaxi Platform используется учетная запись пользователя servadmin. Во время установки для этой учетной записи будет сгенерирован пароль. Сгенерированный пароль отобразится в консоли виртуальной машины, а также будет доступен в файле /root/sp_pwd.

Для разработки (конфигурирования) приложений в Scalaxi Platform предусмотрено рабочее пространство (Development Environment) Scalaxi Studio.
После установки рабочее пространство Scalaxi Studio доступно по адресу: http://"IP-адрес"/studio/, где IP-адрес – имя домена, на котором будет опубликовано приложение. Например: http://192.168.0.1/studio/ или http://mybestapp.net/studio/

Созданное в студии приложение после публикации становится доступно по адресу http://"IP-адрес". Например: http://192.168.0.1 или http://mybestapp.net.

Для начала работы следует использовать учетную запись авторизации пользователя servadmin со сгенерированным паролем.

Как настроить Scalaxi Platform

В платформе Scalaxi реализован дополнительный функционал, который позволит выполнить следующие действия:
a. назначить доменное имя (взамен использования публичного IP-адреса);
b. сбросить пароль администратора платформы
b. установить актуальное обновление платформы;

A. Настройка доменного имени.
Изначальная инициализация платформы происходит с использованием публичного IP-адреса. Для организации доступа к платформе по доменному имени необходимо выполнить следующие шаги:
1. приобрести доменное имя;
2. создать DNS-запись (A-тип), например:
mybestapp.net 172.20.77.53, где mybestapp.net - доменное имя, полученное на первом шаге, а 172.20.77.53 - IP-адрес, на котором произошла инициализация платформы.
3. выполнить настройку платформы на работу с доменным именем

B. Сброс пароля администратора платформы Scalaxi
Данный шаг состоит из следующих действий:
1. подключитесь к виртуальной машине по ssh (https://cloud.yandex.ru/docs/compute/operations/vm-connect/ssh)
2. выполните команду sudo scalaxi-platform set_domain mybestapp.net (вместо low-code.platform укажите Ваше доменное имя)

Готово! Платформа доступна по адресу:
http://mybestapp.net/studio/

C. Обновление платформы
Для установки актуального обновления необходимо выполнить следующие шаги:
1. подключитесь к виртуальной машине по ssh (https://cloud.yandex.ru/docs/compute/operations/vm-connect/ssh)
2. выполните команду sudo scalaxi-platform update 0.2.XX (вместо 0.2.XX укажите актуальную версию обновления)

Если обновление платформы не удалось, следует произвести возврат к предыдущей версии, для этого выполните следующие шаги:
1. подключитесь к виртуальной машине по ssh (https://cloud.yandex.ru/docs/compute/operations/vm-connect/ssh)
2. выполните команду sudo scalaxi-platform rollback

Сброс пароля системного пользователя
Пароль системного пользователя (servadmin) создается случайным образом при инициализации платформы. Посмотреть пароль, созданный во время инициализации, возможно выполнив следующие шаги:
1. подключитесь к виртуальной машине по ssh (https://cloud.yandex.ru/docs/compute/operations/vm-connect/ssh)
2. выполните команду sudo cat /root/sp_pwd
В консоль будет выведен пароль.

Если по какой-то причине данный пароль не подходит, вы можете произвести его сброс, выполнив следующие шаги:
1. подключитесь к виртуальной машине по ssh (https://cloud.yandex.ru/docs/compute/operations/vm-connect/ssh)
2. выполните команду sudo scalaxi-platform reset_password
Новый пароль будет выведен в консоль. Также пароль будет зафиксирован в файле /root/sp_pwd, и отображен в консоли виртуальной машины Yandex Cloud.


Подробная документация Scalaxi Platform доступна по адресу https://scalaxi.notion.site
По вопросам поддержки пишите на почту yc-support@scalaxi.com