Terraform - WunderGraph
Terraform Provider for Cosmo
Terraform is an open-source infrastructure as code (IaC) tool that enables you to safely and predictably create, change, and improve infrastructure. With the Cosmo Terraform provider, you can manage your Cosmo Cloud resources programmatically, ensuring consistent and repeatable deployments.
Installation
To get started with Terraform, you’ll need to install it first. Please follow the official installation guide for detailed instructions.
Provider Configuration
To use the Cosmo provider, you’ll need to configure it in your Terraform configuration. Here’s a basic example:
terraform {
required_providers {
cosmo = {
source = "wundergraph/cosmo"
version = "~> 0.4.1"
}
}
}
provider "cosmo" {
api_key = var.api_key
}
You can find complete examples in the examples directory.
Why Use Terraform with Cosmo?
- Infrastructure as Code: Define your Cosmo Cloud infrastructure using declarative configuration files
- Version Control: Track changes to your infrastructure in version control
- Automation: Automate the provisioning and management of Cosmo resources
- Consistency: Ensure consistent deployments across different environments
- Collaboration: Enable team collaboration through shared infrastructure code
Available Resources
Namespaces \ \ Organize and isolate resources using namespaces
Monographs \ \ Define and manage GraphQL schema documentation
Federated Graphs \ \ Manage federated GraphQL schema configurations
Subgraphs \ \ Configure and manage GraphQL subgraphs
Feature Flags \ \ Control feature availability across your GraphQL API
Feature Subgraphs \ \ Configure subgraphs for specific features
Contracts \ \ Define and manage GraphQL contracts between your services
Router Tokens \ \ Manage authentication tokens for your GraphQL router
Considerations
Why should I use Terraform to manage my Cosmo Cloud resources?
Using Terraform provides several benefits:
- Reproducibility: Your infrastructure can be recreated exactly as defined
- State Management: Terraform tracks the state of your resources
- Change Management: Preview changes before applying them
- Multi-environment Support: Easily manage different environments (dev, staging, prod)
How does Terraform work with Cosmo Cloud?
The Cosmo Terraform provider allows you to:
- Define your GraphQL infrastructure as code
- Automate the creation and management of resources
- Version control your infrastructure configurations
- Collaborate with team members on infrastructure changes
What are the prerequisites for using the Cosmo Terraform provider?
To get started, you’ll need:
- Terraform installed (version 1.0.0 or later)
- A Cosmo Cloud account
- Appropriate authentication credentials
- Basic understanding of Terraform concepts
Can I use Terraform with existing Cosmo Cloud resources?
Yes, you can import existing Cosmo Cloud resources into your Terraform state. This allows you to manage both new and existing resources using Terraform.
How do I get started with the Cosmo Terraform provider?
- Install Terraform
- Configure the Cosmo provider in your Terraform configuration
- Define your resources using the available resource types
- Initialize Terraform and apply your configuration
For detailed setup instructions, refer to our provider documentation.