Skip to content

Terraform Providers

The Terraform Providers layer enables infrastructure-as-code using Python-based Terraform providers built on the Pyvider framework. These providers allow you to manage infrastructure resources using Terraform/OpenTofu while implementing provider logic in Python.

Provider Architecture

graph LR
    terraform[Terraform/OpenTofu] --> grpc[gRPC Protocol]
    grpc --> pyvider[Pyvider Framework]
    pyvider --> provider[Provider Implementation]
    provider --> resources[Resources & Data Sources]

    style terraform fill:#5c4ee5,stroke:#fff,color:#fff
    style pyvider fill:#4051b5,stroke:#fff,color:#fff
    style provider fill:#5c6bc0,stroke:#fff,color:#fff

Available Providers

The provide.io ecosystem includes two production Terraform providers:

Pyvider Provider: Reference implementation showcasing the Pyvider framework capabilities. Demonstrates resource lifecycle management, data sources, and provider configuration patterns.

TofuSoup Provider: Infrastructure testing and conformance provider. Enables testing Terraform configurations and validating infrastructure compliance using the TofuSoup conformance framework.

Provider Features

Each provider is built on the Pyvider framework and provides:

  • Type Safety: Full CTY type system integration for Terraform data types
  • HCL Support: Native HCL parsing and manipulation
  • gRPC Protocol: Terraform plugin protocol v6 support
  • Resource Management: Complete CRUD lifecycle support
  • Data Sources: Read-only data source implementations
  • Provider Configuration: Flexible provider-level configuration
  • Schema Validation: Automatic schema validation and type checking

Development Workflow

Building Terraform providers with Pyvider:

  1. Define Resources: Use Pyvider resource decorators to define resource schemas
  2. Implement CRUD: Implement Create, Read, Update, Delete operations
  3. Add Data Sources: Define read-only data sources for external data
  4. Configure Provider: Set up provider-level configuration and authentication
  5. Test: Use TofuSoup for conformance testing
  6. Package: Build and distribute using FlavorPack

Provider Integration

Terraform providers integrate seamlessly with the ecosystem:

  • Foundation: Uses provide-foundation for logging and telemetry
  • Pyvider Framework: Built on pyvider core, cty, hcl, and rpcplugin
  • Testing: Validated using provide-testkit and tofusoup
  • Packaging: Distributed using FlavorPack secure packaging

Providers

  • Pyvider Provider

    Reference Terraform provider implementation showcasing Pyvider framework capabilities and best practices.

    Explore Pyvider Provider

  • TofuSoup Provider

    Infrastructure testing and conformance provider for validating Terraform configurations.

    Explore TofuSoup Provider