README.md

Terraform Provider: Graylog

This is a Terraform provider for managing resources within Graylog.

Getting Started

As this provider is published to the public Terraform Registry, you can install it like so (for Terraform 0.14+):

provider "graylog" {
  web_endpoint_uri = "http://example.com/api"
  api_version      = "v3"
}

terraform {
  required_providers {
    graylog = {
      source  = "zahiar/graylog"
    }
  }
}

For more detailed instructions and documentation on the resources and data sources supported, please go to Terraform Registry.

Maintenance

This provider is maintained during free time, so if you are interested in helping to develop this further, you are more than welcome to submit a pull request or raise a ticket if you'd prefer.

Development

Requirements

If you do wish to help develop this, you will need the following installed:

• Go (see go.mod file for the correct version to install)
• Go Linter
• GOPATH (is correctly setup)
• Terraform (0.14+)

Building

Simply run make build, and it will compile and create a binary, as well as print-out instructions on how to configure Terraform to use this locally built provider.

$ make build

Testing

Unit Tests

$ make test

Acceptance Tests

$ make testacc

Documentation

Every data source or resource added must have an accompanying docs page (see docs directory for examples).

Docs are written using Markdown, and you can use this page to preview what your docs will look like when rendered.