Platform AWS Deployment
Deploy the BigHammer umbrella chart (bighammer) on EKS. This page covers values preparation and Helm install — the final step after infrastructure, database bootstrap, secrets, and cluster add-ons are ready.
Before you start
Complete these steps before running helm upgrade:
| Step | Action | Doc |
|---|---|---|
| 0 | EKS, RDS, AWS Secrets Manager, Route 53 | Infrastructure |
| 1 | Application DB schemas and grants | Prerequisites |
| 2 | Verify AWS Secrets Manager | Secrets Manager Secrets |
| 3 | ESO, ALB Controller, RabbitMQ, TLS | Prerequisites |
End-to-end journey
Mirror chart and prepare values
Pull the chart from your mirrored registry (ECR) using OCI:
# Login to AWS ECR
aws ecr get-login-password --region us-east-1 | helm registry login --username AWS --password-stdin <aws_account_id>.dkr.ecr.us-east-1.amazonaws.com
# Pull the helm chart
helm pull oci://<aws_account_id>.dkr.ecr.us-east-1.amazonaws.com/bh-helm-release/bighammer \
--version <CHART_VERSION>
# Extract the chart
tar -xzf bighammer-<CHART_VERSION>.tgz
cp bighammer/values.yaml values.yaml
cp bighammer/values-release.yaml values-<env>.yaml # edit all placeholders
Values files
| File | Use |
|---|---|
values.yaml | Chart defaults, global.remoteSecrets, service toggles |
values-release.yaml | Sample customer overlay in the chart (placeholder account IDs, hostnames, IPs) |
values-<env>.yaml | Your per-environment overlay (copy from values-release.yaml) |
Do not deploy values-release.yaml as-is
values-release.yaml uses fictional placeholders. Copy it to values-<env>.yaml in your deployment repository and replace every sample value with your target configuration.
Required global settings
| Path | Example (replace with yours) |
|---|---|
secretStore.name | aws-secret-store |
secretStore.region | us-east-1 |
awsRegion | us-east-1 |
image.repository | <aws_account_id>.dkr.ecr.us-east-1.amazonaws.com/ |
ingress.uiHostName | ui.dev.bighammer.ai |
ingress.aiAgentHostName | aiagent.dev.bighammer.ai |
ingress.certificateArn | arn:aws:acm:us-east-1:123456789012:certificate/uuid |
Run deployment command
Once your values-<env>.yaml file is ready and secrets are validated, run the following command to deploy the platform:
helm upgrade --install bighammer ./bighammer \
--namespace bh-control-plane \
--create-namespace \
-f values.yaml \
-f values-<env>.yaml
Check the status of the rollout:
kubectl get pods -n bh-control-plane -w