Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hummusonrails/couchbase-capella-terraform-example
Get started with using the Couchbase Capella Terraform provider
https://github.com/hummusonrails/couchbase-capella-terraform-example
capella couchbase iac iac-terraform nosql nosql-database
Last synced: about 1 month ago
JSON representation
Get started with using the Couchbase Capella Terraform provider
- Host: GitHub
- URL: https://github.com/hummusonrails/couchbase-capella-terraform-example
- Owner: hummusonrails
- License: mit
- Created: 2024-09-30T13:17:16.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-01T12:39:43.000Z (3 months ago)
- Last Synced: 2024-11-27T06:48:55.227Z (about 1 month ago)
- Topics: capella, couchbase, iac, iac-terraform, nosql, nosql-database
- Language: HCL
- Homepage: https://docs.couchbase.com/cloud/terraform/index.html
- Size: 275 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Couchbase Capella with Terraform Example
[](/LICENSE)
This repository contains a Terraform example to create a new bucket on a Couchbase Capella cluster. It uses the [Couchbase Capella provider for Terraform](https://registry.terraform.io/providers/couchbasecloud/couchbase-capella/latest).
Couchbase Capella is a fully managed Database-as-a-Service (DBaaS) that provides a seamless experience for deploying, managing, and scaling data in the cloud. Capella offers a permanent [free tier](https://www.couchbase.com/blog/free-tier-capella-dev-available/).
Terraform is an open-source Infrastructure as Code (IaC) tool that allows you to define, provision, and manage cloud infrastructure in a declarative and consistent manner using human-readable configuration files.
https://github.com/user-attachments/assets/90a22399-759e-4f7b-b1ca-525f4d721732
## Prerequisites
- [Terraform](https://learn.hashicorp.com/tutorials/terraform/install-cli)
- [Couchbase Capella Account](https://cloud.couchbase.com/)
## Usage
1. Clone the repository
Using the GitHub CLI:
```bash
gh repo clone hummusonrails/couchbase-capella-terraform-example
```
Using Git:
```bash
git clone [email protected]:hummusonrails/couchbase-capella-terraform-example.git
```
2. Change into the directory
```bash
cd couchbase-capella-terraform-example
```
3. Initialize the Terraform configuration
```bash
terraform init
```
4. Set the required environment variables
Create a new file named `terraform.tfvars` and add the following content:
```hcl
auth_token = "YOUR_CAPELLA_API_TOKEN"
organization_id = "YOUR_CAPELLA_ORGANIZATION_ID"
project_id = "YOUR_CAPELLA_PROJECT_ID"
cluster_id = "YOUR_CAPELLA_CLUSTER_ID"
```
This [blog post](https://www.couchbase.com/blog/terraform-provider-couchbase-capella/) explains where to find the required values in the Couchbase Capella UI.
In a production environment, it is recommended to use a secrets management tool to store sensitive information. Either way, make sure to add `terraform.tfvars` to your `.gitignore` file.
5. Apply the Terraform configuration
```bash
terraform apply -var-file=terraform.tfvars
```
6. Confirm the changes
Type `yes` when prompted to confirm the changes.
7. Verify the bucket creation
Check the Couchbase Capella UI to verify that the bucket has been created successfully.
## Further Reading
To learn more about Couchbase Capella and Terraform, check out the following resources:
- [Terraform Provider for Couchbase Capella](https://www.couchbase.com/blog/terraform-provider-couchbase-capella/)
- [Terraform Provider Documentation](https://registry.terraform.io/providers/couchbasecloud/couchbase-capella/latest/docs)
- [Couchbase Capella Terraform Getting Started Documentation](https://docs.couchbase.com/cloud/terraform/index.html)
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.