XLD AWS Elastic Beanstalk Plugin

Overview

This plugin enables AWS Elastic Beanstalk deployments from XL Deploy.

Requirements

• XL Deploy Server 7+
• XL Deploy AWS plugin

Installation

The plugin JAR file can be downloaded from releases. Copy the downloaded JAR into the SERVER_HOME/plugins directory of XL Deploy.

Usage

ElasticBeanstalk Application Environment

Define the information about the ElasticBeanstalk application environment, eb.ApplicationEnvironment, as a child of an aws.Cloud configuration item under the Infrastructure node.

ElasticBeanstalk Application Bundle

Define the ElasticBeanstalk application bundle, eb.AppicationBundle in a udm.DeploymentPackage.

Development

Setting up AWS credentials

Create an itest-conf.json file in this projects root folder defining the following content with that for your AWS account.

[ {
    "name": "aws_cloud",
    "accesskey": "xxxxxxxxx",
    "accessSecret": "xxxxxxxxx"
  }
]

The plugin's Jython Tests will use this file to connect to the AWS account and run the integration tests.

Setting up a local Jython interpreter and dependent librariers to run tests

Install Jython on your local system by using the Jython 2.7.1 Installer

Use pip located in the Jython installation's bin directory to install the boto3 library.

pip install boto3

Setting up Gradle for Jython tests

Create an gradle.properties in this project's root folder defining the following content making adjustments for your Jython installation.

jythonInterpreter=/Users/ravan/labs/software/jython-2.7.1/bin/jython

Your Jython tests should be written with the Python 2 Unit testing framework and the file name should match the pattern *_test.py

Running Tests from Gradle

From the project root,

• Run all tests with ./gradlew clean build itest

• Run a single test with ./gradlew runTest -DtestName=itests.connection_test.CheckConnectionTest

  The testName parameter is the absolute reference to the test class.

Running Tests from IDE

You can also run and debug tests from Intellij using a python test configuration similar to the one below.

References

1. https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_Operations.html

---