Java installation and configuration in a container
Use this workflow with the Add New Java agent wizard to ensure you have all the steps covered for installing and configuring the Java agent with in a container. Using the wizard is the simplest way to deploy a new agent.
Before you begin
Make sure you have everything you need before you start.
The agent will need to be able to reach your Contrast instance. It can be a local/on-premise instance or a hosted instance. A proxy can be configured if the environment has limited network access.
Your web application is packaged in a JAR file
It must use supported versions, frameworks, and tools or supported technologies for the agent operator
Understand the order of precedence
You will also need access to a command line interface (with a chosen directory for downloading the agent) and your organization's instance of Contrast
Start the Java agent wizard
Select Add New at the top of the Contrast web interface.
Select the Application card.
Under Select a language, select Java.
Select the operating system you are using.
Select method to deploy with containers
Under Select application deployment method, select Install with a container.
Under Select method to deploy with containers, select Dockerfile or Kubernetes (Linux or OS X only).
If you want to use Openshift, use these instructions.
Dockerfile: Build image with the agent
Under Build image with agent, copy the displayed command and add it to your Dockerfile.
Copy the displayed command to build the image.
Dockerfile: Configure the agent
Under Configure the agent, select the best options to get the configuration details that the agent needs to communicate with Contrast:
Optionally, select Register the application.
When you register an application, you can assign it to groups for access control. You can also assign tags and metadata to the application.
For agent versions 6.10.1 and later, select Use Connection Token.
This configuration method uses a single variable to specify authentication values. The Connection Token is the recommended configuration option.
Copy the displayed code and set the variable in a location where the agent has access to it.
For agent versions earlier than 6.10.1, select Use API configuration.
This configuration method uses individual variables to specify authentication values.
Copy the displayed code and set these variables in a location where the agent has access to them.
If you prefer to configure the agent using a YAML file, select Download configuration.
Copy the displayed code to generate a YAML file that contains your authentication settings.
Kubernetes: (Linux and OS X only)
Under Select method to configure agent operator, select Helm (recommended) or Manifest.
For Helm:
Under Download and set up files, copy the displayed commands to create a values files.
Under Label the deployments, use the displayed commands to label your deployments.
Under Install and deploy Helm chart, copy the displayed commands to complete the configuration.
For Manifest:
Under Install operator, copy the displayed commands to install the Contrast agent operator.
Under Configure operator, copy the displayed commands to configure the Contrast agent operator.
Under Inject workloads, copy the displayed commands to configure an AgentInjector entity.
Optionally, under Configure cluster agent and cluster, copy the displayed commands to configure these entities.
Verify the agent deployment
Interact with your application as you normally would. For example, interact with your application's web interface or send API commands
Go to the Contrast web interface and select Applications in the header.
Verify that you see the name of your application in the list.
Select servers in the header.
Verify that you see the name of your local server in the list.