example-deploy-agent-terraform-aws

Example deployment of the Hercules CI Agent with Terraform to Amazon Web Services

It is designed to be deployed from a bastion host in the same region. You are encouraged to copy and adapt this module to your conventions and requirements.

Deployment

1. Get a cluster join token from the dashboard
2. Create a binary caches file and save it as binary-caches.json.key by following roughly this subsection
3. Configure AWS credentials for Terraform
4. On a bastion host, run

$ ssh-add ~/.ssh/id_rsa
$ ./deploy

and note the terraform_bucket output. 5. Uncomment the terraform backend section in main.tf and update the bucket name. 6. Run

nix-shell --run 'terraform init'

7. Securely backup the secrets.

Update

Consult the hercules-ci-agent changelog.

• Pull changes from the public example into a private fork.
• ./update if necessary.
• ./deploy