v0.11-alpha3

Breaking Changes

This release begins the provider migration from SDKv2 to the new Plugin Framework. As part of this, the minimum Terraform requirement has increased to 1.0+. Please update your tooling accordingly before upgrading to this version.

The deprecated parameters property on the jenkins_job resource has been removed. Please migrate your TF to use Terraform's native templatefile function instead.

Framework

This release introduces the Terraform Plugin Framework. This framework dramatically changes how both data sources and resources are written. The following items have been migrated already:

• credential_username Data Source
• credential_vault_approle Data Source
• folder Data Source
• job Data Source
• view Data Source
• credential_azure_service_principal Resource
• credential_secret_file Resource
• credential_secret_text Resource
• credential_ssh Resource
• credential_username Resource
• credential_vault_approle Resource
• folder Resource
• job Resource
• view Resource

Additional items will be migrated as confidence increases in the new framework.

New Resources

The jenkins_view data source and resource were added in this release.

Docs Generation

Automatic documentation generation is being introduced, rendering templates stored in the resource definitions and templates/ folder into the docs/ folder. Authors will not need to write any documentation for new resources -- a template will automatically be rendered from the schema -- but will now need to run make generate before PRing their changes.

Example Installation Refactored

The example Docker Compose installation provided for developers encountered a name conflict with the documentation generation (which expects an examples/ folder) and was renamed from example/ to integration/.

The terraform test framework was configured into the new integration/ folder, expanding the available ways that integration testing can be performed. This framework requires Terraform 1.6+ for contributors to run.

What's Changed

• Migrate secret file credential to Framework by @taiidani in #169
• Reduce duplication in Import block by @taiidani in #170
• Migrate secret text credential to Framework by @taiidani in #171
• Migrate SSH credential to Framework by @taiidani in #172
• Migrate View Resource & Data Source to Framework by @taiidani in #173
• Address Failing Integration Test by @taiidani in #195
• Upgrade all Go dependencies by @taiidani in #194
• Remove deprecated job "parameters" property by @taiidani in #197
• Bump the gha group with 5 updates by @dependabot in #196
• Bump the tools group in /tools with 1 update by @dependabot in #198
• Bump the integration group in /integration with 1 update by @dependabot in #188
• Allowing custom descriptions for resources by @taiidani in #200
• Decouple the folder resource from the job resource by @taiidani in #201
• Ensure resource names cannot include path characters by @taiidani in #202
• Migrate job data-source to Framework by @taiidani in #203
• Add integration test assertions for folders by @taiidani in #204
• Migrate folder data-source to Framework by @taiidani in #205

Full Changelog: v0.11-alpha2...v0.11-alpha3

v0.11-alpha2

Breaking Changes

This release begins the provider migration from SDKv2 to the new Plugin Framework. As part of this, the minimum Terraform requirement has increased to 1.0+. Please update your tooling accordingly before upgrading to this version.

Framework

This release introduces the Terraform Plugin Framework. This framework dramatically changes how both data sources and resources are written. The following items have been migrated already:

• credential_username Data Source
• credential_vault_approle Data Source
• folder Data Source
• job Data Source
• view Data Source
• credential_azure_service_principal Resource
• credential_secret_file Resource
• credential_secret_text Resource
• credential_ssh Resource
• credential_username Resource
• credential_vault_approle Resource
• folder Resource
• job Resource
• view Resource

Additional items will be migrated as confidence increases in the new framework.

New Resources

The jenkins_view data source and resource were added in this alpha, and will be migrated to the Framework before final release. Thanks @naitmare01!

Docs Generation

Automatic documentation generation is being introduced, rendering templates stored in the templates/ folder into the docs/ folder. Note that authors will not need to write any documentation for new resources -- a template will automatically be rendered from the resource's schema.

As items are migrated from SDKv2 to the Plugin Framework, their documentation will be migrated as well. Until that time, all SDKv2 items have static docs stored in the templates/ folder.

Example Installation Refactored

The example Docker Compose installation provided for developers encountered a name conflict with the documentation generation (which expects an examples/ folder) and was renamed from example/ to integration/.

Additionally the terraform test framework was configured, expanding the available ways that integration testing can be performed. This framework requires Terraform 1.6+ for contributors to run.

What's Changed

• Add data source and resource Jenkins Views by @naitmare01 in #148
• Set up terraform test on integration tests by @taiidani in #161
• Bump the combined group with 5 updates by @dependabot in #158
• Bump Go to 1.20 by @taiidani in #162
• Bump the gha group with 3 updates by @dependabot in #163
• Migrate Vault AppRole to Framework by @taiidani in #165
• Reduce code duplication in Framework by @taiidani in #167
• Bump the gomod group with 1 update by @dependabot in #164
• Bump golang.org/x/net from 0.13.0 to 0.17.0 by @dependabot in #166
• Migrate Azure Service Principal to Framework by @taiidani in #168

Full Changelog: v0.11-alpha1...v0.11-alpha2

v0.11.0-alpha1

Breaking Changes

This release begins the provider migration from SDKv2 to the new Plugin Framework. As part of this, the minimum Terraform requirement has increased to 1.0+. Please update your tooling accordingly before upgrading to this version.

Framework

This release introduces the Terraform Plugin Framework. This framework dramatically changes how both data sources and resources are written. The following items have been migrated already:

• credential_username Data Source
• credential_username Resource

Additional items will be migrated as confidence increases in the new framework.

Docs Generation

Automatic documentation generation is being introduced, rendering templates stored in the templates/ folder into the docs/ folder. Note that authors will not need to write any documentation for new resources -- a template will automatically be rendered from the resource's schema.

As items are migrated from SDKv2 to the Plugin Framework, their documentation will be migrated as well. Until that time, all SDKv2 items will have static docs stored in the templates/ folder.

Example Installation Renamed

The example Docker Compose installation provided for developers encountered a name conflict with the documentation generation (which expects an examples/ folder) and was renamed from example/ to integration/.

What's Changed

• Build forward compatibility for terraform-plugin-framework by @taiidani in #141
• Migrate acceptance tests to new testing framework by @taiidani in #142
• Address env var default mismatch by @taiidani in #143
• Add mux to all acceptance tests, forward compatibility by @taiidani in #144
• Introducing docs generation by @taiidani in #146
• Migrate Username credential to Plugin Framework by @taiidani in #145

Full Changelog: v0.10.2...v0.11-alpha1

v0.10.2

What's Changed

• Group Dependabot updates by @taiidani in #138
• Bump the combined group with 1 update by @dependabot in #140
• Bump the combined group with 1 update by @dependabot in #139

Full Changelog: v0.10.1...v0.10.2

v0.10.1

What's Changed

• Update docs to include how to import secret text resource by @naitmare01 in #127
• Bump goreleaser/goreleaser-action from 3 to 4 by @dependabot in #109
• Bump golangci/golangci-lint-action from 3.3.1 to 3.4.0 by @dependabot in #117
• Set username and password to optional by @naitmare01 in #124
• Update docs to reflect default value by @naitmare01 in #126
• Bump actions/stale from 7 to 8 by @dependabot in #130
• Bump actions/setup-go from 3 to 4 by @dependabot in #128
• Bump golang.org/x/net from 0.0.0-20211112202133-69e39bad7dc2 to 0.7.0 by @dependabot in #121
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.22.0 to 2.26.1 by @dependabot in #131

New Contributors

• @naitmare01 made their first contribution in #127

Full Changelog: v0.10.0...v0.10.1

v0.10.0

Upcoming Changes

This will be the last release using the Terraform Plugin SDKv2. An upcoming release will build against HashiCorp's newer Terraform Plugin Framework.

Notable Changes

• Add new resource for jenkins_credential_azure_service_principal. Thanks @gitflo1!

What's Changed

• Bump actions/stale from 5 to 6 by @dependabot in #102
• Bump golangci/golangci-lint-action from 3.2.0 to 3.3.1 by @dependabot in #105
• Add CI for running example TF by @taiidani in #111
• Add built binary to example test by @taiidani in #113
• Bump actions/stale from 6 to 7 by @dependabot in #110
• Add new resource for Jenkins credential Azure Service Principal by @gitflo1 in #108
• Revisiting example/ CI test by @taiidani in #115

New Contributors

• @gitflo1 made their first contribution in #108

Full Changelog: v0.9.3...v0.10.0

v0.9.3

What's Changed

• Bump Go to 1.19, Address deprecations by @taiidani in #98
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.17.0 to 2.21.0 by @dependabot in #97
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.21.0 to 2.22.0 by @dependabot in #99
• Exempt enhancement label from stale by @taiidani in #100

Full Changelog: v0.9.2...v0.9.3

v0.9.2

What's Changed

• Bump goreleaser/goreleaser-action from 2 to 3 by @dependabot in #88
• Bump golangci/golangci-lint-action from 3.1.0 to 3.2.0 by @dependabot in #86
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.14.0 to 2.17.0 by @dependabot in #89

Full Changelog: v0.9.1...v0.9.2

v0.9.1

Upcoming Changes

The Terraform Plugin SDKv2 is being deprecated soon, which will require a full rewrite of the library. An upcoming release will build against HashiCorp's newer Terraform Plugin Framework.

What's Changed

• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.7.1 to 2.8.0 by @dependabot in #66
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.8.0 to 2.9.0 by @dependabot in #71
• Add Namespace attribute for credential_vault_approle by @JVanAartsen in #69
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.9.0 to 2.10.1 by @dependabot in #72
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.10.1 to 2.11.0 by @dependabot in #76
• Bump actions/checkout from 2 to 3 by @dependabot in #75
• Bump golangci/golangci-lint-action from 2 to 3.1.0 by @dependabot in #74
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.11.0 to 2.12.0 by @dependabot in #77
• Remove Codecov by @taiidani in #82
• Bump actions/stale from 4 to 5 by @dependabot in #79
• Bump actions/setup-go from 2 to 3 by @dependabot in #80
• Remove duplicate push target from CI by @taiidani in #83
• Bump Go to 1.18 by @taiidani in #84
• Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.12.0 to 2.14.0 by @dependabot in #81

New Contributors

• @JVanAartsen made their first contribution in #69

Full Changelog: v0.9.0...v0.9.1

v0.9.0

Notable Changes

• Added ability to import jenkins_job resources (#57)
• Deprecate parameters property in jenkins_job resource in favour of using Terraform's built-in template_file resource or templatefile (Terraform 0.12+) (#61)
• Improve Jenkins XML config diff, by escaping HTML entities before the diff is generated to ensure only meaningful changes are shown (#63)

Changelog

f9d1b62 Bump github.com/hashicorp/terraform-plugin-sdk/v2 from 2.7.0 to 2.7.1 (#64)
4b89d6f Unescape HTML entities during state diff (#63)
8d11b81 Deprecate jenkins_job 'parameters' property (#61)
3730a01 Fix typo in validations_test.go (#59)
bf7747c Add support for importing jenkins_job resource (#57)