f2c2a774c6
* Added using-terraform.mdx to the Install Boundary section * Initial revision * formatting on the list and adding in some links to the provider * Renamed file * Added assumptions. * Updated index. * Fixed some typos * Folded in Carlos's session recording code * small changes * fixes headers * fixes internal developer links * style guide and formatting enhancements * updates Initialize Boundary link * docs: Updates for style/standards * docs: Break topic into smaller pieces * docs: Clean up commented text, rename index file * docs: Trigger a new Vercel build --------- Co-authored-by: Daniel Greeninger <daniel.greeninger@hashicorp.com> Co-authored-by: Adam Bouhmad <adbouhmad@gmail.com> Co-authored-by: Robin Beck <stellarsquall@protonmail.ch> Co-authored-by: Dan Heath <76443935+Dan-Heath@users.noreply.github.com>
64 lines
2.8 KiB
Plaintext
64 lines
2.8 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: Terraform patterns for Boundary
|
|
description: |-
|
|
Learn how to configure the Terraform Boundary provider so that you can use Terraform patterns to install and manage Boundary.
|
|
---
|
|
|
|
# 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 [Initialize Boundary](/boundary/docs/install-boundary/initialize) 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/install-boundary/terraform-patterns/terraform-scopes)
|
|
- [Users and auth methods](/boundary/docs/install-boundary/terraform-patterns/terraform-users-and-auth-methods)
|
|
- [Groups and role-based-access-control (RBAC)](/boundary/docs/install-boundary/terraform-patterns/terraform-groups-and-rbac)
|
|
- [Hosts and host management](/boundary/docs/install-boundary/terraform-patterns/terraform-hosts-and-host-management)
|
|
- [Credentials and credential stores](/boundary/docs/install-boundary/terraform-patterns/terraform-credentials-and-credential-stores)
|
|
- [Session recording](/boundary/docs/install-boundary/terraform-patterns/terraform-session-recording)
|
|
- [Targets](/boundary/docs/install-boundary/terraform-patterns/terraform-targets) |