Agent deployment to AWS Fargate

Use this guide to deploy an application instrumented with a Contrast agent to AWS Fargate. AWS Fargate is a serverless compute engine that runs containers without requiring you to manage the underlying servers or clusters. You can deploy to Fargate using Docker containers through Amazon ECS, or using Kubernetes pods through Amazon EKS.

This guide assumes you have already instrumented your application with a Contrast agent. If you have not, start with the agent installation guide for your language.

Before you begin

Before you start, you must have:

Your application is already instrumented with a Contrast agent and packaged in a container image. See the container installation guide for your language:
The agent can reach your Contrast instance. It can be on-premises or hosted. You can configure a proxy if the environment has limited network access.
Set the contrast.server.name to the server name you want displayed in the web interface
You have an AWS account with permissions to deploy to Fargate, and some familiarity with either Docker/ECS or Kubernetes/EKS

Note

The Contrast Agent Operator and Flex Agent Kubernetes installation do not currently require DaemonSets or other privileged, cluster-wide workloads, so they work within Fargate's restrictions. If you are using either of these, follow the Agent Operator installation, then deploy to Fargate as described below.

Deploy a Docker container to AWS Fargate

Build a container image for your application using the appropriate language-specific container installation guide to instrument it with a Contrast agent.
Follow the AWS documentation to deploy your Docker container to Fargate through Amazon ECS.

Deploy Kubernetes pods to AWS Fargate

Build a Kubernetes pod for your application using the appropriate language-specific container installation guide, or install the agent operator using the agent wizard, Helm charts (recommended), or a manifest file. See Install the Agent Operator for all available methods.
Follow the AWS documentation to deploy your Kubernetes pod to Fargate through Amazon EKS.

Verify agent deployment

Interact with your application as you normally would, for example, by clicking a few links or sending a few requests. This gives the agent something to detect.
In Contrast, select Applications. Your application should appear in the list soon after you start using it.