Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[v16] Add a two-part Terraform starter guide #46260

Merged
merged 5 commits into from
Sep 5, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/config.json
Original file line number Diff line number Diff line change
Expand Up @@ -326,7 +326,7 @@
},
{
"source": "/agents/deploy-agents-terraform/",
"destination": "/enroll-resources/agents/deploy-agents-terraform/",
"destination": "/admin-guides/infrastructure-as-code/terraform-starter/enroll-resources/",
"permanent": true
},
{
Expand Down
3 changes: 2 additions & 1 deletion docs/cspell.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"version": "0.2",
"language": "en",
"version": "0.2",
"words": [
"AADUSER",
"ABCDEFGHIJKL",
Expand Down Expand Up @@ -875,6 +875,7 @@
"subchart",
"subgroups",
"subkind",
"subnetworks",
"sudoer",
"supervillain",
"svid",
Expand Down
Binary file removed docs/img/tf-agent-diagram.png
Binary file not shown.
2 changes: 1 addition & 1 deletion docs/pages/admin-guides/deploy-a-cluster/linux-demo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -205,4 +205,4 @@ Step 4 showed you how to install agents manually, and you can also launch agents
and enroll resources with them using infrastructure-as-code tools. For example,
you can use Terraform to declare a pool of Teleport agents and configure them to
proxy your infrastructure. Read [Deploy Teleport Agents with
Terraform](../../enroll-resources/agents/deploy-agents-terraform.mdx) to get started.
Terraform](../../enroll-resources/agents/introduction.mdx) to get started.
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: "Terraform Starter Setup"
description: Provides an example to help you get started managing dynamic resources in a Teleport cluster using Terraform.
---

The Terraform starter guide provides an example of a Terraform module that
manages Teleport resources in production. The guide helps you to understand the
Teleport resources to manage with Terraform in order to accomplish common
Teleport setup tasks. You can use the example module as a starting point for
managing a complete set of Teleport cluster resources.

The guides in the Terraform starter module assume that you have followed [Machine
ID with the Teleport Terraform Provider](
../../enroll-resources/machine-id/access-guides/terraform.mdx) on your
workstation.

## Part One: Enroll resources

In Part One of the Terraform starter module, we show you how to enroll resources
such as Linux servers, databases, and Kubernetes clusters by deploying a pool of
Teleport Agents on virtual machine instances. You can then declare dynamic
infrastructure resources with Terraform or change the configuration file
provided to each Agent.

[Read Part One](./terraform-starter/enroll-resources.mdx).

## Part Two: Configure RBAC

Part Two of the Terraform starter module shows you how to configure Teleport
role-based access controls to provide different levels of access to the
resources you enrolled in Part One. It also configures Access Requests,
available in Teleport Identity, so that users authenticate with less privileged
roles by default but can request access to more privileged roles. An
authentication connector lets users authenticate to Teleport using a Single
Sign-On provider.

[Read Part Two](./terraform-starter/rbac.mdx).

Loading
Loading