Skip to main content

1. Configure

Prepare Terraform, cloud provider, and authentication.

Pre-requisites​

  • Terraform CLI (0.14.9+) installed
  • Dynatrace tenant

Clone Repository​

  1. Clone the ACE-Box repository:

    git clone https://github.com/Dynatrace/ace-box.git

Configure Cloud Provider​

  1. Choose your preferred cloud provider. The ACE-Box will be deployed on a standard compute resource (VM).

AWS Requirements​

  • AWS Account
  • AWS CLI (AWS SDK) installed
  • AWS Account credentials (usually set up and sourced by AWS SDK)

AWS Deployment​

  1. Navigate to the AWS folder:

    cd terraform/aws/

  2. Configure the AWS CLI from your terminal. Follow the prompts to input your AWS Access Key ID and Secret Access Key:

    aws configure

    Note: The configuration process stores your credentials in a file at ~/.aws/credentials on macOS and Linux, or %UserProfile%\.aws\credentials on Windows.

Initialize Terraform​

  1. Initialize Terraform using the following command:

    terraform init

Configure terraform.tfvars​

  1. In the terraform/<your_cloud_provider> folder, create a terraform.tfvars file with the following structure (the next step will guide you on how to fill the placeholders):

    dt_tenant = "https://<tenant_id>.live.dynatrace.com" 
    dt_api_token = "<dt_api_token>"
    extra_vars = {
      dt_environment_url_gen3 = "https://<tenant_id>.apps.dynatrace.com" 
      dt_oauth_sso_endpoint   = "https://sso.dynatrace.com/sso/oauth2/token"
      dt_oauth_client_id = "<client_id>"
      dt_oauth_client_secret = "<client_secret>"
      dt_oauth_account_urn = "urn:dtaccount:<id>"
    }

  2. Create the respective Dynatrace tokens with the following scopes for each: dt_api_token & dt_oauth_client_secret. Then add them into the placeholders within your terraform.tfvars.

    Note: It is recommended to set sensitive variables as environment variables. More information can be found in the Terraform documentation here.

  3. Configure cloud provider-specific variables if needed, adding them to the terraform.tfvars.

No extra variables needed for AWS. 🙂

Configuration Ready!​

Well done! The next step is to apply the configuration and deploy the ACE-Box.