5.3.8. Развертывание в облаке Jelastic

Рассмотрим пример сборки и развёртывания приложения в облаке Jelastic.

В данный момент развёртывание в облаке возможно для проектов, использующих в качестве сервера базы данных PostgreSQL или HSQL.

  1. Создайте бесплатную тестовую учётную запись в облаке Jelastic с помощью веб-браузера.

  2. Создайте новое окружение, в которое будет развёрнут WAR:

    • Кликните New Environment.

      jelasticEnvironment
    • В открывшемся окне задайте настройки: окружение должно иметь Java 8, Tomcat 8 и PostgreSQL 9.1+ (если в проекте используется база данных PostgreSQL). В поле Environment Name задайте уникальное имя окружения и нажмите на кнопку Create.

    • Если в созданном окружении был использован PostgreSQL, вы получите email с информацией о подключении к БД. Перейдите в административный веб-интерфейс по ссылке в письме, полученном после создания окружения, и создайте пустую базу данных. Выбранное имя базы данных должно быть указано позже в context.xml.

  3. Соберите единый Single WAR файл, используя CUBA Studio:

    • Выберите пункт главного меню CUBA > Deployment > WAR Settings.

    • Включите флажок Build WAR.

    • Введите значение .. в поле Application home directory:

    • Включите флажки Include JDBC driver и Include Tomcat’s context.xml.

    • Если ваш проект использует базу данных PostgreSQL, нажмите на кнопку Generate рядом с полем Custom context.xml path. Укажите пользователя, пароль, хост и имя базы данных, созданной ранее в веб-интерфейсе Jelastic.

      customContextXml
    • Установите флажок Single WAR for Middleware and Web Client.

    • Нажмите на кнопку Generate рядом с полем Custom web.xml path. Studio сгенерирует специальный web.xml для единого WAR, содержащего блоки Middleware и Web Client.

      jelasticWarSettings
    • Добавьте свойство cuba.logDir в окне App properties:

      appProperties = ['cuba.automaticDatabaseUpdate': true,
      'cuba.logDir': '${catalina.base}/logs']
    • Нажмите на кнопку OK. В конец файла build.gradle добавилась задача сборки buildWar:

      task buildWar(type: CubaWarBuilding) {
          includeJdbcDriver = true
          includeContextXml = true
          appProperties = ['cuba.automaticDatabaseUpdate': true,
                           'cuba.logDir'                 : '${catalina.base}/logs']
          webXmlPath = 'modules/web/web/WEB-INF/single-war-web.xml'
          appHome = '..'
          coreContextXmlPath = 'modules/core/web/META-INF/war-context.xml'
      }
    • Если ваш проект использует HSQL, откройте задачу buildWar в файле build.gradle и добавьте свойство hsqlInProcess = true, чтобы запустить встроенный сервер HSQL при развертывании WAR файла. Убедитесь, что свойство coreContextXmlPath не задано.

      task buildWar(type: CubaWarBuilding) {
          appProperties = ['cuba.automaticDatabaseUpdate': true, 'cuba.logDir': '${catalina.base}/logs']
          appHome = '..'
          includeContextXml = true
          webXmlPath = 'modules/web/web/WEB-INF/single-war-web.xml'
          includeJdbcDriver = true
          hsqlInProcess = true
      }
    • Запустите сборку, выбрав buildWar через командную строку:

      gradlew buildWar

      В результате в подкаталоге build\distributions\war проекта будет создан файл app.war.

  4. Для развертывания WAR-файла в Jelastic используйте задачу Gradle deployWar:

    task deployWar(type: CubaJelasticDeploy, dependsOn: buildWar){
        email = ****
        password = ****
        hostUrl = 'app.j.layershift.co.uk'
        environment = 'my-env-1'
    }
  5. По завершению процесса развёртывания CUBA-приложение будет доступно в облаке Jelastic. Чтобы его открыть, воспользуйтесь URL вида <environment>.<hostUrl> в браузере.

    Например:

    http://my-env-1.j.layershift.co.uk

    Вы также можете открыть приложение с помощью кнопки Open in Browser, расположенной на панели окружений в Jelastic.

    jelasticDeploy