teleport/examples/aws/terraform

Teleport AWS Terraform

This section of the Teleport GitHub repo contains AWS Terraform definitions for two Teleport cluster configurations.

• A simple starter Teleport cluster to, quickly and cost-effectively, demo or POC Teleport on a single node (auth, proxy, and node processes running on one t3.nano ec2 instance).
• A production worthy high-availability auto-scaling Teleport Cluster. This cluster makes use of several AWS technologies, provisioned and configured using Terraform.

If you are planning on using our Terraform example in production, please reference the high-availability auto-scaling Teleport Cluster for best practices. Our Production Guide outlines in-depth details on how to run Teleport in production.

Prerequisites

We recommend familiarizing yourself with the following resources prior to reviewing our Terraform examples:

• Teleport Architecture
• Admin Guide

In order to spin up AWS resources using these Terraform examples, you need the following software:

• terraform v1.0+ install docs
• awscli v1.14+ install docs

Projects

• Starter Teleport Cluster

  • Get Started

• HA Auto-Scaling Teleport Cluster

  • Get Started

How to get help

If you're having trouble, check out our GitHub Discussions.

For bugs related to this code, please open an issue.

Public Teleport AMI IDs

Please see the AMIS.md file for a list of public Teleport AMI IDs that you can use.

This is not the Teleport Terraform Provider

If you are looking for Teleport's Terraform Provider which can be used to provision users, roles, auth connectors and other resources inside an existing Teleport cluster, its source code can be found in the teleport-plugins repo here: https://github.com/gravitational/teleport-plugins/tree/master/terraform