Автоматизация развертывания Play! Framework приложений на платформе OpenShift

Привет, хабражители! Сегодня я хотел бы рассказать о том, как можно воспользоваться бесплатным решением от RedHat для размещения своих сайтов в облаке на примере Play! Framework. Не буду описывать отдельно каждый из продуктов, т.к. про них уже не раз писали, расскажу лишь об их взаимодействии и моей схеме для автоматизации сборки и развертывания.

Итак, приступим. Создав JBoss приложение на OpenShift, мы получаем в распоряжение Git-репозиторий, в котором лежат семпловые исходники (для последующей замены на наши сорцы) и собранная версиях этих исходников в виде WAR-архива.

Разворачивать приложение можно двумя способами: или пропушивая на сервер исходники, которые будут собираться с помощью pom.xml, используя Maven, или пропушивая готовый WAR-архив. Других путей, к сожалению, нет: «заливать» файлы на сервер можно только через Git. Конечно, существует возможность присоединиться к серверу по SSH, но это используется больше для административных задач. На этом с OpenShift-частью пока закончим.

Play! Framework версии 2.1.1 (последней на данный момент), к сожалению, не поддерживает создание WAR-архива, он работает немного по-другому, создавая на выходе подобную структуру:

my-first-application-1.0
└ lib
   └ *.jar
└ start

Я не сумел подружить такую дистрибьюцию с OpenShift (мейби это возможно — буду рад увидеть решение в комментариях), поэтому остановился на использовании версии 1.2.4.

Итак, создаем наше приложение:

play new SuperApplication cd SuperApplication play idealize / play eclipsify 

На даном этапе мы получили тестовое приложение, убедиться в работоспособности которого можно выполнив команду play start

Далее добавляем соль/перец по вкусу вносим необходимые изменения — и мы готовы к развертыванию приложения.

Самое время вернуться к нашему OpenShift-репозиторию, который можно склонировать по следующему адресу: ssh://hashcode@superapplication-suffix.rhcloud.com/~/git/superapplication.git/ и в итоге мы получим нечто подобное:

superapplication
└ .git
   └ bullshit
└ .openshift
   └ bullshit
└ deployments
   └ ROOT.war <— 
└ src
   └ sources

То, что нас интересует, выделено стрелкой. Соответственно, задача теперь сделать так, чтобы наш проект собирался в архив под названием ROOT.war, копировался в нужную папку, происходил коммит и пуш.

Теперь пару слов о конкретно моей ситуации. Все гораздо проще, ежели мы собираемся хранить исходники в том же самом репозитории. Но так вышло, что Web-часть была лишь одним модулем из нескольких, присутствующих у меня в проекте, а сам проект хостился на BitBucket. Поэтому папку src из OpenShift я удалил за ненадобностью, базовую дерикторию переименовал в dist и использовал чисто для деплоя (не забудьте запушить изменения), а исходники продолжил хостить в отдельном месте. И теперь начинается шаманство…

Для автоматизации сборки и развертывания мною был выбран Ant. Не хочу долго описывать содержимое скрипта — он неплохо прокомментирован, поэтому сразу приведу его:

<project name="SuperApplication" default="dist" basedir="."> <!-- Устанавливаем глобальные переменные для скрипта. -->     <property name="dist"  location="..\dist"/>     <property name="deployments"  location="..\dist\deployments"/>  <!--  Выполняем сборку проекта с помощью команды "play war -o outputname"  Обратите внимание, что в Windows не смотря на корректно прописанные переменные окружения, приходится вызывать play.bat, указывая расширение.  После успешного билда зипуем то, что получилось, в архив, не забывая удалить ненужные файлы после этого.  -->     <target name="dist" depends="clean" description="generate the distribution" >         <exec executable="play.bat">             <arg line="war -o ${deployments}\ROOT" />         </exec>         <zip destfile="${deployments}\ROOT.war"              basedir="${deployments}\ROOT" />         <delete dir="${deployments}\ROOT"/>     </target>  <!--  Самое интересное - развертывание.  Обратите внимание: работаем не в директории текущего проекта, а в папке ${dist}, потому что именно там находится наш OpenShift-Git-репозиторий.  -->     <target name="deploy" description="upload war" >         <exec executable="git" dir="${dist}">             <arg line="add ."/>         </exec>         <exec executable="git" dir="${dist}">             <arg line="commit -m 'Deploy'"/>         </exec>         <exec executable="git" dir="${dist}">             <arg line="push"/>         </exec>     </target>  <!-- Выполняем очистку, удаляя старый ROOT.war -->     <target name="clean" description="clean up" >         <delete file="${deployments}\ROOT.war" />     </target> </project> 

Вот, в принципе, и все. Используя цели dist и deploy, мы можем соответственно собирать и разворачивать наш прокет.

Не могу сказать, что решение элегантное — скорее оно смахивает на костыль. Но этот костыль помогает в кратчайшее время наладить быструю и удобную разработку сайта в бесплатном облаке, а значит он имеет право на существование.

Удачи!