Skip to content

Latest commit

 

History

History
69 lines (46 loc) · 2.38 KB

README.md

File metadata and controls

69 lines (46 loc) · 2.38 KB
Raw

Terraform Provider for Splunk Cloud Platform

At this point in time, this provider supports the following resources for Splunk Cloud Platform deployments.

  • Indexes
  • Hec Tokens
  • IP Allowlist
  • Users
  • Roles
Copyright 2023 Splunk Inc. 

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. 
If a copy of the MPL was not distributed with this file, You can obtain one at 
https://www.mozilla.org/en-US/MPL/2.0/

Requirements

Building The Provider

  1. Clone the repository
  2. Create go src directory and setup $GOPATH
  3. Enter the provider directory
  4. Compile the provider by running make build

Using the Provider (Local build)

  • Install Terraform
  • Tell Terraform where to locate the provider
    • With dev_overrides, we tell Terraform where to locate the provider locally as we will not be pulling from the registry. Make sure the path is where the provider has been compiled
    • First vim ~/.terraformrc and paste the following in it: 
      • provider_installation {
     dev_overrides {
         "registry.terraform.io/splunk/scp" = "<path to local terraform binary>"
     }
}
  • To update run terraform plan first to check config diff
  • Run terraform apply to apply configurations
  • NOTE: running terraform init with dev_overrides is not necessary and may result in unexpected errors.

Examples/Documentation

Refer to the /examples directory for example .tf files for each resource and provider configuration.

Refer to the /docs directory for documentation on provider and resource usage, notes, troubleshooting, etc.

Contributions

Currently, we are not accepting contributions, however, please use the

  • Github issue tracker to submit bugs
  • Splunk Ideas for your suggestions/feature requests. Please file under Enterprise Cloud.
  • Splunk Answers for questions.

Notes and Troubleshooting

  • If using stack deployment credentials to authenticate, you may run into a rate limit error which prevents the token creation request needed to authenticate. You will need to wait around 5 mins until the request is allowed or use the auth (stack) token to avoid this issue.