terraform

T-Pot Terraform

This Terraform configuration can be used to launch a virtual machine, bootstrap any dependencies and install T-Pot in a single step.
Configuration for Amazon Web Services (AWS) and Open Telekom Cloud (OTC) is currently included. This can easily be extended to support other Terraform providers.

Cloud-init is used to bootstrap the instance and install T-Pot on startup.

Table of Contents

• What get's created
  • Amazon Web Services (AWS)
  • Open Telekom Cloud (OTC)
• Prerequisites
  • Amazon Web Services (AWS)
  • Open Telekom Cloud (OTC)
• Terraform Variables
  • Common configuration items
  • Amazon Web Services (AWS)
  • Open Telekom Cloud (OTC)
• Initialising
• Applying the Configuration
• Connecting to the Instance

What get's created

Amazon Web Services (AWS)

• EC2 instance:
  • t3.large (2 vCPUs, 8 GB RAM)
  • 128 GB disk
  • Debian 10
  • Public IP
• Security Group:
  • TCP/UDP ports <= 64000 open to the Internet
  • TCP ports 64294, 64295 and 64297 open to a chosen administrative IP

Open Telekom Cloud (OTC)

• ECS instance:
  • s3.medium.8 (1 vCPU, 8 GB RAM)
  • 128 GB disk
  • Debian 10
  • Public EIP
• Security Group
  • All TCP/UDP ports are open to the Internet
• Virtual Private Cloud (VPC) and Subnet

Prerequisites

• Terraform 0.13

Amazon Web Services (AWS)

• AWS Account
  • Existing VPC: VPC ID needs to be specified in aws/variables.tf
  • Existing subnet: Subnet ID needs to be specified in aws/variables.tf
  • Existing SSH key pair: Key name needs to be specified in aws/variables.tf
• AWS Authentication credentials should be set using environment variables

Open Telekom Cloud (OTC)

• OTC Account
  • Existing SSH key pair: Key name needs to be specified in otc/variables.tf
• OTC Authentication credentials (Username, Password, Project Name, User Domain Name) can be set in the otc/clouds.yaml file

Terraform Variables

Common configuration items

These variables exist in aws/variables.tf and otc/variables.tf respectively.
Settings for cloud-init:

• timezone - Set the Server's timezone
• linux_password- Set a password for the Linux Operating System user (which is also used on the Admin UI)

Settings for T-Pot:

• tpot_flavor - Set the flavor of the T-Pot (Available flavors are listed in the variable's description)
• web_user - Set a username for the T-Pot Kibana Dasboard
• web_password - Set a password for the T-Pot Kibana Dashboard

Amazon Web Services (AWS)

In aws/variables.tf, you can change the additional variables:

• admin_ip - source IP address(es) that you will use to administer the system. Connections to TCP ports 64294, 64295 and 64297 will be allowed from this IP only. Multiple IPs or CIDR blocks can be specified in the format: ["127.0.0.1/32", "192.168.0.0/24"]
• ec2_vpc_id - Specify an existing VPC ID
• ec2_subnet_id - Specify an existing Subnet ID
• ec2_region
• ec2_ssh_key_name - Specify an existing SSH key pair
• ec2_instance_type

Open Telekom Cloud (OTC)

In otc/variables.tf, you can change the additional variables:

• ecs_flavor
• ecs_disk_size
• availability_zone
• key_pair - Specify an existing SSH key pair
• eip_size

... and some more, but these are the most relevant.

Initialising

The terraform init command is used to initialize a working directory containing Terraform configuration files.

$ cd aws
$ terraform init

OR

$ cd otc
$ terraform init

Applying the Configuration

The terraform apply command is used to apply the changes required to reach the desired state of the configuration, or the pre-determined set of actions generated by a terraform plan execution plan.

$ terraform apply

This will create your infrastructure and start a Cloud Server. On startup, the Server gets bootstrapped with cloud-init and will install T-Pot. Once this is done, the server will reboot.

If you want the remove the built infrastructure, you can run terraform destroy to delete it.

Connecting to the Instance

When the installation is completed, you can proceed with connecting/logging in to the T-Pot according to the documentation.