terraform-provider-konnect

This repository contains a Terraform provider for Kong Konnect.

Capabilities

This provider can manage the following resources:

Gateway Manager

Gateway Hybrid Control Plane
Gateway KIC Control Plane
Gateway Control Plane Group
- Control Plane Group Memberships
Gateway Data Plane Client Certificates

Cloud Gateways

Cloud Gateway Configuration
Custom Domain
Network
Transit Gateway
Serverless Cloud Gateway

Kong Gateway Entities

Service
Route
Plugins
Custom Plugins
Consumers
Consumer Groups
- Consumer Group Members
Credentials
- Basic Auth
- Key Auth
- JWT
- HMAC Auth
- ACL
Upstream
Target
Vault
Certificate
CA Certificate
SNI
Key
Key Set
Custom Plugin Schema

Mesh

Mesh Control Plane

API Products

API Product
API Product Version
API Product Specification
API Product Documentation

Dev Portal

Portal
Portal Authentication
Application Auth Strategy
Portal Product Version
Portal Appearance

Organization

System Account
System Account Access Tokens
System Account Roles
System Account Teams
Team
Team Roles
Team Users

Usage

The provider can be installed from the Terraform registry. Before using the provider, you must configure a personal_access_token. If you are running in a non-US region, you must also set the server_url configuration option.

terraform {
  required_providers {
    konnect = {
      source  = "kong/konnect"
    }
  }
}

provider "konnect" {
  personal_access_token = "kpat_YOUR_PAT"
  server_url            = "https://us.api.konghq.com"
}

You may also configure the provider block using environment variables:

personal_access_token = KONNECT_TOKEN
system_account_access_token = KONNECT_SPAT
server_url = KONNECT_SERVER_URL

e.g. KONNECT_TOKEN=kpat_YOUR_PAT terraform apply

Examples

The examples directory contains sample usage for all supported resources. For a full list of supported parameters for each resource, see the provider documentation.

The examples in this repo reference resources that are expected to exist in your manifests e.g. konnect_gateway_control_plane.tfdemo.id. Update the references to match the names that you have given your resources.

ful4n1t0/terraform-provider-konnect