​

Kubiya Control Plane Terraform Provider

​

Why Use Terraform with Kubiya?

• Infrastructure as Code: Version control your Kubiya resources alongside your application infrastructure
• Repeatability: Deploy consistent configurations across multiple environments
• Automation: Integrate Kubiya resource provisioning into your CI/CD pipelines
• Collaboration: Enable team collaboration through code reviews and GitOps workflows
• Compliance: Track changes and maintain audit trails for your AI agent infrastructure

​

Supported Resources

​

Core Resources

​

Capabilities

​

Data Sources

• controlplane_environment - Look up a single environment by ID
• controlplane_project - Look up a single project by ID
• controlplane_team - Look up a single team by ID
• controlplane_agent - Look up a single agent by ID
• controlplane_skill - Look up a single skill by ID
• controlplane_policy - Look up a single policy by ID
• controlplane_job - Look up a single job by ID
• controlplane_jobs - List all jobs
• controlplane_worker_queue - Look up a single worker queue by ID
• controlplane_worker_queues - List all worker queues in an environment

​

Deployment Options

​

1. Hosted Control Plane (SaaS)

export KUBIYA_CONTROL_PLANE_API_KEY="your-api-key"
# KUBIYA_CONTROL_PLANE_BASE_URL not needed - defaults to hosted

​

2. Self-Hosted Control Plane

export KUBIYA_CONTROL_PLANE_API_KEY="your-api-key"
export KUBIYA_CONTROL_PLANE_BASE_URL="https://your-control-plane.example.com"

​

Quick Example

terraform {
  required_providers {
    controlplane = {
      source  = "kubiya/control-plane"
      version = "~> 1.0"
    }
  }
}

provider "controlplane" {
  # Configuration via environment variables:
  # KUBIYA_CONTROL_PLANE_API_KEY (required)
  # KUBIYA_CONTROL_PLANE_BASE_URL (optional - defaults to https://control-plane.kubiya.ai)
}

# Create an environment
resource "controlplane_environment" "production" {
  name        = "production"
  description = "Production environment for agents"
}

# Create a team
resource "controlplane_team" "platform" {
  name    = "platform-team"
  runtime = "default"
}

# Create an agent
resource "controlplane_agent" "ops_assistant" {
  name        = "ops-assistant"
  description = "Operations assistant agent"
  model_id    = "kubiya/claude-sonnet-4"
  runtime     = "claude_code"
  team_id     = controlplane_team.platform.id

  llm_config = jsonencode({
    temperature = 0.7
    max_tokens  = 4096
  })
}

​

Provider Registry

• Source: kubiya/control-plane
• Registry: https://registry.terraform.io/providers/kubiya/control-plane

​

Key Features for Operators

​

Version Control

git log terraform/
git diff terraform/production.tf

​

Multi-Environment Management

terraform workspace new production
terraform workspace new staging

​

Modular Configuration

modules/
  agent-team/
    main.tf
    variables.tf
    outputs.tf

​

CI/CD Integration

# GitHub Actions example
- name: Terraform Apply
  run: |
    terraform init
    terraform plan
    terraform apply -auto-approve

​

Authentication & Security

1. Generate API Key: Create an API key from your Kubiya Control Plane dashboard
2. Set Environment Variable: Export KUBIYA_CONTROL_PLANE_API_KEY
3. Secure Storage: Use secrets management (Vault, AWS Secrets Manager, etc.)

• Environment variables
• Terraform Cloud/Enterprise variables
• CI/CD secret stores
• Secret management systems

​

Reusable Modules

• engineering-org: Complete organization setup with environments, teams, agents, skills, policies, and jobs

​

Next Steps

• Getting Started Guide - Set up your first Terraform configuration
• Provider Configuration - Detailed configuration options
• Resources Documentation - Complete resource reference
• Modules - Reusable Terraform modules
• Data Sources - Query existing resources
• Operator Examples - End-to-end examples for common use cases

​

Support

• Issues: GitHub Issues
• Documentation: Kubiya Docs
• Provider Source: GitHub Repository