Prerequisites

Review the prerequisites to provision with Terraform

To install and configure Domino in your AWS account, you must have:

Validate the prerequisites

Run the following:

aws --version
terraform version
kubectl version --client=true --short=true
docker version
helm version

Validate AWS credentials

Validate AWS credentials by making sure that the following command returns the UserId, Account, and Arn:

aws sts get-caller-identity

Verify that the required binaries are installed

Ensure you have a Unix or Linux terminal with the following installed:

Note
If you already have cluster access in your local kubeconfig, the aws CLI steps are not necessary.
# ddlctl
ddlctl version

# aws-cli
aws --version

# kubectl
kubectl version --client=true --short=true

# docker daemon is installed and running
docker --version
docker ps

Otherwise, follow these steps to install those that are missing:

  1. Install the aws-cli by following these instructions.

  2. Install kubectl by following these instructions.

  3. Install Docker and exit the terminal. When you log in again, the modifications that you just made will become active.

  4. Install ddlctl.

Configure cluster access

  1. Run the following:

    unset HISTFILE
    export DEPLOY_NAME=<Name of deployment>
    export AWS_REGION=<The region to deploy the resources>
    export AWS_ACCESS_KEY_ID=<Your AWS access key ID>
    export AWS_SECRET_ACCESS_KEY=<Your AWS secret key>
  2. To retrieve the credentials for your Kubernetes cluster, check your local kubeconfig with:

    export KUBECONFIG=$(pwd)/kubeconfig
  3. Update the kubeconfig:

    aws eks update-kubeconfig --kubeconfig $KUBECONFIG --region $AWS_REGION --name $DEPLOY_NAME --alias $DEPLOY_NAME