- Website: https://www.terraform.io
- Mailing list: Google Groups
This is a community provider and is not supported by Hashicorp.
This provider has been published to the Terraform Registry at https://registry.terraform.io/providers/taiidani/jenkins. Please visit the registry for documentation and installation instructions.
This repository is actively maintained as free time allows for me to work on it. I am accepting Issues and Pull Requests and if you are interested in helping as a maintainer I am open to the possibility. Please allow for 2-3 weeks of turnaround time on your contributions.
The scope of the provider covers the entire (extendable) Jenkins API provided that the https://github.com/bndr/gojenkins client library supports it. I accept submissions for functionality outside of Jenkins Core but expect that the plugin(s) required are clearly stated in the documentation. See jenkins_credential_vault_approle for an example of this. I can only support these extensions as much as my own ability to test them allows -- Your Mileage May Vary.
Working on this provider requires the following:
- Terraform 1.0+
- Go (version requirements documented in the
go.modfile) - Docker Engine 20.10+ (for running acceptance tests)
You will also need to correctly setup a GOPATH, as well as adding ${GOPATH}/bin to your $PATH.
To compile the provider, run make. This will install the provider into your GOPATH and print instructions on registering it into your system.
In order to test the provider, you can simply run make test.
$ make testIn order to run the full suite of Acceptance tests, run make testacc. These tests require Docker to be installed on the machine that runs them, and do not create any remote resources.
$ make testaccWhen changing a data source or resource, you may need to update the documentation. This documentation is automatically rendered by https://github.com/hashicorp/terraform-plugin-docs. To trigger a render, execute:
$ make generateThis provider design was originally inspired from the work at dihedron/terraform-provider-jenkins.