Configure ActiveMQ Container
Some aspects of the ActiveMQ application container configuration are specified in files that are checked into source control, in the CloudOps for Kubernetes Git project cloud-ops-kubernetes
under path terraform/activemq/env-file
. Elastic Path refers to these files as Resource Profiles.
The Resource Profiles specify configuration values that can be tuned per environment type, such as maximum allowed incoming connections and additional JVM arguments.
Two Resource Profile files are included out of the box:
terraform/activemq/env-file/dev.tfvars
: An example that is a suitable starting point for a development or QA environment.terraform/activemq/env-file/prod-small.tfvars
: An example that is a suitable starting point for a production environment with low load requirements.
Creating a Custom Resource Profile
If is common for environments to be tuned to meet unique requirements. Complete the below steps to create custom resourcing profiles, to tune your ActiveMQ container configuration.
Copy one of the existing files to a new file in the
terraform/activemq/env-file
directory. Ensure that new file has no spaces in the name and has the.tfvars
extension.Make the desired changes to the values in the new
*.tfvars
file.Commit and push the changes to the CloudOps for Kubernetes repository and branch used by the Jenkins job
create-or-delete-activemq-container
.
You can create multiple resource profiles. It is possible to have a different resource profile for each type of environment, or even a unique profile for each environment.
Using the Resource Profiles
You specify which resource profile to use when you configure an ActiveMQ environment using the create-or-delete-activemq-container
Jenkins job. That job contains a parameter named epStackResourcingProfile
, and that parameter is where you specify which resource profile to use for the given environment.
The value to specify for parameter epStackResourcingProfile
is the file name, minus the extension. For example:
If you want to use
terraform/activemq/env-file/prod-small.tfvars
then specifyprod-small
in parameterepStackResourcingProfile
.If you created and want to use a custom file named
terraform/activemq/env-file/my-custom-profile1.tfvars
then specifymy-custom-profile1
in parameterepStackResourcingProfile
.
Contents of the Resource Profile Files
The Resource Profile files contain various values that impact different aspect of the ActiveMQ configuration. The details below are a guide to the purpose to the various values in the files.
Used to modify the maximum simultaneous incoming connections:
MAXIMUM_CONNECTIONS
Used to define additional Java Virtual Machine (JVM) arguments used by ActiveMQ:
EP_ACTIVEMQ_X_JVM_ARGS
important
To use the above arguments for ActiveMQ, ensure that you are using and building your ActiveMQ image with the Elastic Path Docker project release 4.5.7
and higher.