aws / aws/agentcore-cli

Command to provision a minimal harness-compatible VPC and output the IDs

Open
#1,563 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
TypeScript
Stars
283
Forks
95
Avg merge
1d 2h
Merged PRs (30d)
183

Description

### Description

Harness supports VPC mode by passing subnetIds and securityGroupIds on the network configuration. For users who already have a Harness-compatible VPC, this is straightforward. For users who don’t, or aren’t sure whether their existing VPC meets the requirements (NAT gateway for ECR Public egress, correct security group rules, multi-AZ subnets), there’s no one-command path today.

Integrations like the n8n community node surface subnet IDs and security group IDs as raw fields in their credential UI. A standalone command that provisions a minimal harness-compatible VPC and outputs the IDs would let these integrations offer a one-command setup step, parallel to the standalone IAM role command.

Suggested shape:
```
agentcore vpc create-harness-network \
--name MyHarnessNetwork \
[--region us-west-2] \
[--cidr 10.0.0.0/16] \
[--az-count 2] \
[--output text|json]
```

Optional companion subcommand `agentcore vpc validate --subnets ... --security-groups ..`. that checks whether a caller-supplied VPC/subnet/SG combination meets harness requirements and reports what’s missing. Useful for the “I already have a VPC” path.

### Acceptance Criteria

• Command provisions a minimal Harness-compatible VPC: subnets across at least two AZs, security group with egress permitting public.ecr.aws, and a NAT gateway with route to an internet gateway
• Output includes VPC ID, subnet IDs, and security group ID (plain text by default, JSON with --output json)
• Idempotent on --name: re-running returns the existing resources rather than creating duplicates
• --region, --cidr, and --az-count flags honored with sensible defaults
• Optional agentcore vpc validate subcommand reports whether an existing VPC/subnet/SG combination meets Harness requirements, with clear messages on anything missing
• Help text describes the integration use case
• README updated alongside the IAM command section

### Additional Context

• Reference for Harness network configuration requirements: https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/harness-security.html (Network configuration section)
• Driving use case: the n8n community node — npm: [[npm link](https://www.npmjs.com/package/@aws/n8n-nodes-agentcore)], repo: [[repo link](https://github.com/aws/n8n-nodes-agentcore)]
• Same pattern as the standalone IAM role command (separate issue): the goal is a small set of one-command building blocks that integrations can compose into a “from zero to working Harness” path for their users
• A CloudFormation quick-create template wrapping the same underlying construct would be a useful companion for fully no-code audiences

Contributor guide

Open the contributing guide

Research direction

Start by tracing the existing standalone IAM role command and its README section, then review the linked Harness network requirements. Define the VPC, subnet, route, NAT gateway, internet gateway, and security-group behavior before implementing the requested flags and output modes. Done means idempotent resources, clear help and validation behavior, README coverage, and outputs containing the requested IDs.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws, typescript
Domain
cli, cloud, infrastructure, networking
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.