terraform-provider-kafka-connect

README

terraform-plugin-kafka-connect

A Terraform plugin for managing Apache Kafka Connect.

Installation

Download and extract the latest release to your terraform plugin directory (typically ~/.terraform.d/plugins/)

Example

Configure the provider directly, or set the ENV variable KAFKA_CONNECT_URL

provider "kafka-connect" {
  url = "http://localhost:8083"
  basic_auth_username = "user" # Optional
  basic_auth_password = "password" # Optional
}

resource "kafka-connect_connector" "sqlite-sink" {
  name = "sqlite-sink"

  config = {
    "name"            = "sqlite-sink"
    "connector.class" = "io.confluent.connect.jdbc.JdbcSinkConnector"
    "tasks.max"       = 1
    "topics"          = "orders"
    "connection.url"  = "jdbc:sqlite:test.db"
    "auto.create"     = "true"
    "connection.user" = "admin"
  }

  config_sensitive = {
    "connection.password" = "this-should-never-appear-unmasked"
  }
}

Provider Properties

Property	Type	Example	Alternative environment variable name
url	URL	"http://localhost:8083"	KAFKA_CONNECT_URL
basic_auth_username	String	"user"	KAFKA_CONNECT_BASIC_AUTH_USERNAME
basic_auth_password	String	"password"	KAFKA_CONNECT_BASIC_AUTH_PASSWORD

Resource Properties

Property	Type	Description
name	String	Connector name
config	HCL Block	Connector configuration
config_sensitive	HCL Block	Sensitive connector configuration. Will be masked in output.

Developing

1. Install go
2. Clone repository to: $GOPATH/src/github.com/Mongey/terraform-provider-kafka-connect

   mkdir -p $GOPATH/src/github.com/Mongey/terraform-provider-kafka-connect; cd $GOPATH/src/github.com/Mongey/
   git clone https://github.com/Mongey/terraform-provider-kafka-connect.git
   

3. Build the provider make build
4. Run the tests make test
5. Run acceptance tests make testacc