terraform-provider-keycloak

README

terraform-provider-keycloak

Terraform provider for Keycloak.

Docs

https://Trois-Six.github.io/terraform-provider-keycloak/

Building

This project uses Go Modules which requires Go 1.11. You can initialize your local development environment and build the provider like so:

GO111MODULE=on go mod download && make build

Supported Versions

Currently, this provider is tested against Terraform v0.12.1 and Keycloak v7.0.0. I personally use this provider with Terraform v0.11.x and Keycloak 4.8.3.Final.

In the future, it would be nice to run acceptance tests using different versions of Terraform / Keycloak. Please feel free to submit a PR if you believe you can help with this.

Tests

Every resource supported by this provider will have a reasonable amount of acceptance test coverage

For local development, you can spin up a local instance of Keycloak, backed by Postgres and OpenLDAP using make local. Once the environment is ready, you can run the acceptance tests after setting the required environment variables:

KEYCLOAK_CLIENT_ID=terraform \
KEYCLOAK_CLIENT_SECRET=884e0f95-0f42-4a63-9b1f-94274655669e \
KEYCLOAK_REALM=master \
KEYCLOAK_URL="http://localhost:8080" \
make testacc

These tests will also run in CI when opening a PR and on master.

License

MIT