Bundling multiple WAR files for Tomcat environments - Amazon Elastic Beanstalk
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Bundling multiple WAR files for Tomcat environments

If your web app comprises multiple web application components, you can simplify deployments and reduce operating costs by running components in a single environment, instead of running a separate environment for each component. This strategy is effective for lightweight applications that don't require a lot of resources, and for development and test environments.

To deploy multiple web applications to your environment, combine each component's web application archive (WAR) files into a single source bundle.

To create an application source bundle that contains multiple WAR files, organize the WAR files using the following structure.

MyApplication.zip
├── .ebextensions
├── .platform
├── foo.war
├── bar.war
└── ROOT.war

When you deploy a source bundle containing multiple WAR files to an Amazon Elastic Beanstalk environment, each application is accessible from a different path off of the root domain name. The preceding example includes three applications: foo, bar, and ROOT. ROOT.war is a special file name that tells Elastic Beanstalk to run that application at the root domain, so that the three applications are available at http://MyApplication.elasticbeanstalk.com/foo, http://MyApplication.elasticbeanstalk.com/bar, and http://MyApplication.elasticbeanstalk.com.

The source bundle can include WAR files, an optional .ebextensions folder, and an optional .platform folder. For details about these optional configuration folders, see Extending Elastic Beanstalk Linux platforms.

To launch an environment (console)

  1. Open the Elastic Beanstalk console with this preconfigured link: console.amazonaws.cn/elasticbeanstalk/home#/newApplication?applicationName=tutorials&environmentType=LoadBalanced

  2. For Platform, select the platform and platform branch that match the language used by your application, or the Docker platform for container-based applications.

  3. For Application code, choose Upload your code.

  4. Choose Local file, choose Choose file, and then open the source bundle.

  5. Choose Review and launch.

  6. Review the available settings, and then choose Create app.

For information about creating source bundles, see Create an application source bundle.