Skip to main content

Environment

Last updated on

The environment defines where an agent deploys. It groups your deployment targets, and its infrastructure definition describes the AWS Agent Core target, such as the connector, region, gateway, and networking. This page shows you how to add an AWS Agent Core infrastructure definition.

note

Agent deployments are behind the feature flag CDS_AGENT_RUNTIME_DEPLOYMENT. Contact Harness Support to enable the feature.

You need a registered agent service with AWS Agent Core as its deploy target and an AWS connector with permission to deploy to AgentCore. For all prerequisites, go to Before you begin on the overview. For how environments and infrastructure definitions work in CD, go to Environment overview.

Create the environment​

Create an environment for your agent deployments, or reuse an existing one. Set the environment type to Production or Pre-Production based on the target. Go to Create environments to add one.

Add an infrastructure definition​

The infrastructure definition describes the cloud target for one environment. In the environment, open the Infrastructure Definitions tab and select Infrastructure Definition to add one.

  1. Enter a name for the infrastructure definition.
  2. Set Deployment Type to AI Agent Services.
  3. Under Select Infrastructure Type, select AWS Agent Core.
  4. Under Cluster Details, configure the connector and target. Go to Configure the infrastructure for the fields.
  5. Select Save.

Configure the infrastructure​

The cluster details define the connector Harness uses and the AgentCore target the agent deploys to. Configure the following fields:

  • Connector: The AWS connector with permission to deploy to AgentCore.
  • Region: A region where AgentCore is available, for example us-east-1.
  • Networking Type: Select None for the default, or VPC when the agent must reach private resources. When you select VPC, provide the subnets, which must all belong to the same VPC, and optionally the security groups.

Gateway (optional): An AgentCore Gateway enables weighted canary traffic shifting between agent versions. If you do not need traffic switching, leave the Gateway ARN and Gateway Rule ID fields empty. Without a gateway, each deploy performs a direct endpoint cutover and the traffic shift step in the pipeline is skipped.

To set up gateway-based traffic shifting, complete the following steps in order:

  1. Deploy the agent once without a gateway configured. This initial deploy creates the first live AgentCore endpoint.
  2. Note the live endpoint ARN from the deployed agent. Provision an AgentCore Gateway outside Harness, through Terraform, CDK, or the AWS console, and create a static target rule in the gateway that points to the live endpoint ARN.
  3. Return to this infrastructure definition, enter the Gateway ARN and Gateway Rule ID from the gateway you provisioned, and save.

After the gateway is in place, Harness manages the live and candidate endpoints and shifts traffic between them according to the canary steps in your pipeline.

Edit Infrastructure panel for AWS Agent Core showing connector, region, gateway ARN, gateway rule ID, and networking type
AWS Agent Core infrastructure definition YAML
infrastructureDefinition:
  name: Agent Core CD Play
  identifier: Agent_Core_CD_Play
  orgIdentifier: default
  projectIdentifier: Demo
  environmentRef: Aws_Agent_Core
  deploymentType: AiAgent
  type: AwsAgentCore
  spec:
    connectorRef: account.aws_connector
    region: us-east-1
    networking:
      type: none
    gateway:
      arn: arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/my-agent-gateway
      ruleId: <gateway-rule-id>
  allowSimultaneousDeployments: false

Next steps​

With the infrastructure defined, build the pipeline stage that wires the service, environment, and infrastructure together.