https://github.com/camunda-community-hub/terraform-provider-camunda

A Terraform provider to configure Camunda SaaS
https://github.com/camunda-community-hub/terraform-provider-camunda

terraform terraform-provider

Last synced: 3 months ago
JSON representation

A Terraform provider to configure Camunda SaaS

• Host: GitHub
• URL: https://github.com/camunda-community-hub/terraform-provider-camunda
• Owner: camunda-community-hub
• License: mpl-2.0
• Created: 2022-05-30T14:06:00.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-11-20T03:24:06.000Z (3 months ago)
• Last Synced: 2024-11-20T04:21:42.402Z (3 months ago)
• Topics: terraform, terraform-provider
• Language: Go
• Homepage: https://registry.terraform.io/providers/camunda-community-hub/camunda/
• Size: 340 KB
• Stars: 10
• Watchers: 4
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
[![](https://img.shields.io/badge/Community%20Extension-An%20open%20source%20community%20maintained%20project-FF4700)](https://github.com/camunda-community-hub/community) ![Compatible with: Camunda Platform 8](https://img.shields.io/badge/Compatible%20with-Camunda%20Platform%208-0072Ce) [![](https://img.shields.io/badge/Lifecycle-Incubating-blue)](https://github.com/Camunda-Community-Hub/community/blob/main/extension-lifecycle.md#incubating-)

# Camunda Platform 8 Terraform Provider

This is an community supported [Terraform](https://www.terraform.io/) provider

for [Camunda Platform 8](https://camunda.com/platform/).

Camunda Platform 8 allows you to *Design, automate, and improve any process across your organization*.

Further information can be found under https://docs.camunda.io/.

This Terraform provider allows to manage the resources provided by the Camunda

Platform 8, such as clusters, clients, etc.

* Documentation: https://registry.terraform.io/providers/camunda-community-hub/camunda/

## Development

This Terraform provider is built with the [Terraform Plugin Framework](https://github.com/hashicorp/terraform-plugin-framework).

### Building The Provider

1. Clone the repository

1. Enter the repository directory

1. Build the provider using the Go `install` command:

```shell

go install

```

### Developing the Provider

- To compile the provider, run `go install`. This will build the provider and put the provider binary in the `$GOPATH/bin` directory.

- To generate or update documentation, run `go generate`.

- To run the full suite of acceptance tests, run `make testacc`.

*Note:* Acceptance tests create real resources, and often cost money to run.

```shell

make testacc

```

### Release the Provider

- Create a new git tag named `vX.Y.Z` with: `git tag -s -m "vX.Y.Z" vX.Y.Z`

- Push the tag to GitHub with: `git push origin vX.Y.Z`

Then:

- GitHub Actions should build all the artifacts and create the release.

- Terraform Cloud Registry should automatically detect the new release and publish it.