Статьи

Автоматизированное развертывание с Cargo и Maven — краткий учебник

Апрель 20, 2019

Cargo — это универсальная библиотека, которая позволяет вам управлять и развертывать приложения на различных серверах приложений. В этой статье мы рассмотрим, как использовать Cargo с Maven.

Если вы начинаете с нуля, вы можете использовать Archetype для создания веб-приложения с поддержкой Cargo: 

mvn archetype:create -DarchetypeGroupId=org.codehaus.cargo 
-DarchetypeArtifactId=cargo-archetype-webapp-single-module 
-DgroupId=com.wakaleo -DartifactId=ezbank

Или же это легко добавить к существующей конфигурации — просто добавьте плагин cargo-maven2 в ваш файл pom.

Конфигурация по умолчанию развернет приложение на встроенном сервере Jetty: 

<plugin>
  <groupId>org.codehaus.cargo</groupId>
  <artifactId>cargo-maven2-plugin</artifactId>
  <version>1.0</version>
</plugin>

Тогда просто запустите mvn cargo: старт .

Однако Cargo предназначен для развертывания и не поддерживает быструю разработку жизненного цикла — используйте для этого обычный плагин Jetty.

Развертывание в экземпляре Tomcat

Вы можете запустить свои интеграционные тесты на сервере Tomcat, который Cargo будет инициализировать и настраивать по этому случаю — это называется «автономным» режимом: 

<plugin>
  <groupId>org.codehaus.cargo</groupId>
  <artifactId>cargo-maven2-plugin</artifactId>
  <version>1.0</version>
  <configuration>
    <!-- Container configuration -->
    <container>
      <containerId>tomcat6x</containerId>
      <home>/usr/local/apache-tomcat-6.0.18</home>
    </container>
    <configuration>
      <type>standalone</type>
      <home>target/tomcat6x</home>
    </configuration>
  </configuration>
</plugin>

Cargo создаст базовый каталог (например, CATALINA_BASE) в указанном вами каталоге. Он будет использовать предоставленный вами домашний каталог Tomcat. При каждой установке Cargo будет уничтожать и воссоздавать базовый каталог.

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

<zipUrlInstaller>
  <url>http://www.orionserver.com/distributions/orion2.0.5.zip</url>
  <installDir>${java.io.tmpdir}/cargoinstalls</installDir>
</zipUrlInstaller>

Это более портативное решение, которое полезно для интеграционных тестов.

Выполнение интеграционных тестов с Cargo

Вы можете использовать Cargo для автоматического запуска веб-сервера для запуска интеграционных тестов. Это означает, что вы можете запустить свои интеграционные тесты на любом из поддерживаемых серверов (Tomcat, Jetty, JBoss, Weblogic, …):

<plugin>
  <groupId>org.codehaus.cargo</groupId>
  <artifactId>cargo-maven2-plugin</artifactId>
  <version>1.0</version>
  <executions>
    <execution>
      <id>start-container</id>
      <phase>pre-integration-test</phase>
      <goals>
        <goal>start</goal>
      </goals>
    </execution>
    <execution>
      <id>stop-container</id>
      <phase>post-integration-test</phase>
      <goals>
        <goal>stop</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <wait>false</wait>      
    <!-- Container configuration -->
    <container>
      <containerId>tomcat6x</containerId>
      <home>/usr/local/apache-tomcat-6.0.18</home>
    </container>
    <configuration>
      <type>standalone</type>
      <home>target/tomcat6x</home>
    </configuration>
  </configuration>
</plugin>

 

Развертывание на существующем сервере

Вы также можете выполнить развертывание на работающем сервере приложений. Вам необходимо использовать «существующий» тип конфигурации (существующий). Вы можете использовать отдельный профиль для запуска интеграционных тестов в автономном экземпляре, а затем развернуть его в работающем экземпляре.

<profiles>
  <profile>
    <id>integration</id>
    <build>
      <plugins>
        <plugin>
          <groupId>org.codehaus.cargo</groupId>
          <artifactId>cargo-maven2-plugin</artifactId>
          <version>1.0</version>
          <configuration>
            <!-- Container configuration -->
            <container>
              <containerId>tomcat6x</containerId>
            </container>
            <configuration>
              <type>existing</type>
              <home>/usr/local/apache-tomcat-6.0.18</home>
            </configuration>
          </configuration>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>
...

 

Затем вы можете развернуть свое приложение, как показано здесь: 

$ mvn install

$ mvn cargo:deploy -Pintegration

Развертывание на удаленном сервере

Вы также можете выполнить развертывание на удаленном сервере, используя серверный удаленный API (например, приложение HTML-менеджер для Tomcat). Вам необходимо настроить контейнер типа «remote» и конфигурацию типа «runtime»:

<configuration>
  <!-- Container configuration -->
  <container>
    <containerId>tomcat6x</containerId>
    <type>remote</type>
  </container>
  <configuration>          
    <type>runtime</type>
    <properties>
      <cargo.remote.username>admin</cargo.remote.username>
      <cargo.remote.password></cargo.remote.password>
      <cargo.tomcat.manager.url>http://localhost:8888/manager</cargo.tomcat.manager.url>
    </properties>
  </configuration>
  ...
</configuration>

В разделе <properties> вы определяете специфичные для сервера свойства (см. Документацию Cargo). Затем вы используете Cargo как обычно:

$ mvn cargo:redeploy -o 
...
[INFO] [cargo:redeploy]
[INFO] [mcat6xRemoteDeployer] Redeploying [/Users/johnsmart/.m2/repository/org/ebank/
ebank-web/1.0.0-SNAPSHOT/ebank-web-1.0.0-SNAPSHOT.war]
[INFO] [mcat6xRemoteDeployer] Undeploying [/Users/johnsmart/.m2/repository/org/ebank/
ebank-web/1.0.0-SNAPSHOT/ebank-web-1.0.0-SNAPSHOT.war]
[INFO] [mcat6xRemoteDeployer] Deploying [/Users/johnsmart/.m2/repository/org/ebank/
ebank-web/1.0.0-SNAPSHOT/ebank-web-1.0.0-SNAPSHOT.war]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 4 seconds
[INFO] Finished at: Fri Jul 17 17:45:34 CEST 2009
[INFO] Final Memory: 6M/12M
[INFO] ------------------------------------------------------------------------

Использование выделенного модуля развертывания

Вы можете отделить процесс сборки от процесса развертывания приложения, создав отдельный модуль Maven, предназначенный для развертываний. Это также упрощает создание и развертывание файла WAR в Nexus на одном сервере, а затем развертывание на сервере приложений непосредственно на целевом компьютере.

Для этого вы создаете выделенный модуль Maven. Он должен содержать только плагин Cargo и зависимость от развертываемого приложения. Плагин Cargo использует этот раздел для получения файла WAR, который будет развернут из вашего хранилища Nexus.

<project>
...
<build>
  <plugins>
    <plugin>
      <groupId>org.codehaus.cargo</groupId>
      <artifactId>cargo-maven2-plugin</artifactId>
      <version>1.0</version>
      <configuration>
        <!-- Container configuration -->
        <container>
          <containerId>tomcat6x</containerId>
        </container>
        <configuration>
          <type>existing</type>
          <home>/usr/local/apache-tomcat-6.0.18</home>
        </configuration>
        <deployer>
          <deployables>
            <deployable>
              <artifactId>ebank-web</artifactId>
              <groupId>org.ebank</groupId>
              <type>war</type>
            </deployable>
          </deployables>
        </deployer>
      </configuration>
    </plugin>
  </plugins>
</build>

Раздел зависимостей содержит ссылку на файл WAR для развертывания. Здесь вы можете использовать свойство, чтобы передавать номер версии из командной строки:

 ...
  <dependencies>
    <dependency>
      <groupId>org.ebank</groupId>
      <artifactId>ebank-web</artifactId>
      <type>war</type>
      <version>${target.version}</version>
    </dependency>
  </dependencies>  
  
  <properties>
    <target.version>${project.version}</target.version>
  </properties>

 

С  http://weblogs.java.net/blog/johnsmart

44
Share: