Requirements
Prerequisites
Before installing the OpsWorker Kubernetes Agent, ensure your environment meets these requirements.
Kubernetes
| Requirement | Details |
|---|---|
| Version | Kubernetes 1.24 or later |
| Distribution | EKS, GKE, AKS, self-hosted, OpenShift |
| Access | Cluster admin permissions for initial installation |
Tools
| Tool | Version | Purpose |
|---|---|---|
| Helm | 3.x | Agent installation and management |
| kubectl | Compatible with cluster version | Verification and troubleshooting |
Network
| Requirement | Details |
|---|---|
| Outbound HTTPS | Port 443 to *.amazonaws.com (AWS SQS endpoints) |
| Inbound | None required — agent communicates outbound only |
| DNS | Cluster DNS must resolve external hostnames |
Resources
| Resource | Request | Limit |
|---|---|---|
| CPU | 100m | 200m |
| Memory | 128Mi | 256Mi |
The agent runs as a single pod. No DaemonSets or sidecars are needed.
OpsWorker Account
- An OpsWorker account at app.opsworker.ai
- A cluster added in the portal (provides the cluster token needed for installation)
Network Considerations
Firewalls and Security Groups
If your cluster uses egress restrictions, allow outbound HTTPS to:
*.amazonaws.com(SQS endpoints)sqs.*.amazonaws.com(specific SQS service endpoints)
Proxy Environments
If outbound traffic goes through a proxy, configure proxy settings during Helm installation. See Agent Configuration.
Network Policies
If your cluster enforces NetworkPolicy resources, ensure the opsworker namespace is allowed outbound HTTPS access.
Next Steps
- Installation — Install the agent