Dan HeathandRobin Beck
5ce6515156
* docs: IA reorganization * docs: Updates * docs: Updates * docs: Fix links * docs: Updates * docs: Fix a typo * docs: Fix client agent topic * docs: Update Client Agent nav * docs: Fix conflict * docs: Fix a typo in Client Agent docs (#5853) * docs: Fix client agent topic * docs: Updates * docs: Updates * docs: Updates * docs: Updates * docs: Fixes get started and operations links * docs: Update nav * docs: Partials * docs: Unix partials * docs: Worker partials * docs: Updates * docs: Update workers and targets * docs: Updates * docs: Updates * docs: Fixes link * docs: Updates after sync review * docs: Updates from review feedback * docs: Move worker filter examples * docs: Fix links * docs: Updates for filters based on working session * docs: Fixes broken links * docs: Add links to other filter topics * docs: Update list intro * docs: Adds link * docs: Fixes redirects * docs: Fixes redirects * docs: Deleted mysql page from TOC * docs: Add versioned redirect * docs: Adds versioned redirects * docs: Adds versioned redirects * docs: Update redirects * docs: Update redirects * docs: Redirect fixes * docs: Update redirect format * docs: Fix a typo * docs: Fixes redirects * docs: Fixes redirect * docs: Adds links out to client agent troubleshooting * uses /etc/boundary.d/ as recommended installation directory (#6003) * docs: Updates legacy io links * docs: Fixes redirects * docs: Fix redirect * docs: Restoring deleted file --------- Co-authored-by: Robin Beck <stellarsquall@users.noreply.github.com>
64 lines
2.7 KiB
Plaintext
64 lines
2.7 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: Terraform patterns for Boundary
|
|
description: >-
|
|
Configure the Terraform Boundary provider so that you can use Terraform patterns to install and manage Boundary resources.
|
|
---
|
|
|
|
# Terraform patterns for Boundary
|
|
|
|
HashiCorp recommends using Terraform to deploy and maintain your Boundary environment.
|
|
|
|
This following topics outline MVP (Minimum Viable Product) patterns to deploy and maintain Boundary using Terraform.
|
|
|
|
## Requirements
|
|
|
|
This document assumes the reader has:
|
|
|
|
- An understanding of [Terraform](/terraform/docs) fundamentals.
|
|
- An existing Boundary installation. Refer to [Deploy Boundary in a self-managed environment](/boundary/docs/deploy/self-managed) to learn about deploying Boundary.
|
|
|
|
## Terraform provider configuration
|
|
|
|
To use Terraform to manage your Boundary environment, you must first configure the Terraform Boundary provider.
|
|
|
|
The following code block provides an example of provider configuration using the userpass authentication method.
|
|
You can use any of the available Boundary authentication methods by specifying the appropriate `auth_method_id`.
|
|
|
|
```hcl
|
|
terraform {
|
|
required_providers {
|
|
# Declare the provider
|
|
boundary = {
|
|
source = "hashicorp/boundary"
|
|
}
|
|
}
|
|
}
|
|
|
|
# Configure the provider
|
|
# This example assumes that you have stored your Boundary cluster address and credentials in Terraform variables
|
|
|
|
provider "boundary" {
|
|
addr = var.boundary_addr
|
|
auth_method_login_name = var.boundary_login_name
|
|
auth_method_password = var.boundary_password
|
|
}
|
|
```
|
|
## More information
|
|
|
|
Refer to the [Boundary provider documentation](https://registry.terraform.io/providers/hashicorp/boundary/latest/docs/) for more information on the available authentication methods.
|
|
|
|
## Next steps
|
|
|
|
The following pages provide examples and patterns for configuring Boundary resources with Terraform.
|
|
|
|
If you are configuring Boundary resources for the first time, you may want to start by creating a scope.
|
|
You create scopes to partition resources and then assign ownership of those resources to users and groups.
|
|
|
|
- [Scopes](/boundary/docs/deploy/terraform-patterns/terraform-scopes)
|
|
- [Users and auth methods](/boundary/docs/deploy/terraform-patterns/terraform-users-and-auth-methods)
|
|
- [Groups and role-based-access-control (RBAC)](/boundary/docs/deploy/terraform-patterns/terraform-groups-and-rbac)
|
|
- [Hosts and host management](/boundary/docs/deploy/terraform-patterns/terraform-hosts-and-host-management)
|
|
- [Credentials and credential stores](/boundary/docs/deploy/terraform-patterns/terraform-credentials-and-credential-stores)
|
|
- [Session recording](/boundary/docs/deploy/terraform-patterns/terraform-session-recording)
|
|
- [Targets](/boundary/docs/deploy/terraform-patterns/terraform-targets) |