From 207556f7f8173ff72a503ba260e760fa0fce5c3b Mon Sep 17 00:00:00 2001 From: Adrian Lai Date: Tue, 7 Jan 2025 13:15:14 +0000 Subject: [PATCH] Add initial README --- README.md | 44 +++++--------------------------------------- 1 file changed, 5 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index 83a9643..6686b08 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,12 @@ -# Terraform Provider Scaffolding (Terraform Plugin Framework) +# Terraform Provider for Venafi TLS Protect Cloud Platform -_This template repository is built on the [Terraform Plugin Framework](https://github.com/hashicorp/terraform-plugin-framework). The template repository built on the [Terraform Plugin SDK](https://github.com/hashicorp/terraform-plugin-sdk) can be found at [terraform-provider-scaffolding](https://github.com/hashicorp/terraform-provider-scaffolding). See [Which SDK Should I Use?](https://developer.hashicorp.com/terraform/plugin/framework-benefits) in the Terraform documentation for additional information._ +This is an experimental Terraform Provider for the Venafi TLS Protect Cloud Platform. -This repository is a *template* for a [Terraform](https://www.terraform.io) provider. It is intended as a starting point for creating Terraform providers, containing: - -- A resource and a data source (`internal/provider/`), -- Examples (`examples/`) and generated documentation (`docs/`), -- Miscellaneous meta files. - -These files contain boilerplate code that you will need to edit to create your own Terraform provider. Tutorials for creating Terraform providers can be found on the [HashiCorp Developer](https://developer.hashicorp.com/terraform/tutorials/providers-plugin-framework) platform. _Terraform Plugin Framework specific guides are titled accordingly._ - -Please see the [GitHub template repository documentation](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template) for how to create a new repository from this template on GitHub. - -Once you've written your provider, you'll want to [publish it on the Terraform Registry](https://developer.hashicorp.com/terraform/registry/providers/publishing) so that others can use it. +It has limited support at this stage. All contributions and feedback are both welcome and appreciated. ## Requirements -- [Terraform](https://developer.hashicorp.com/terraform/downloads) >= 1.0 +- [Terraform](https://developer.hashicorp.com/terraform/downloads) >= 1.9.8 - [Go](https://golang.org/doc/install) >= 1.22 ## Building The Provider @@ -29,24 +19,6 @@ Once you've written your provider, you'll want to [publish it on the Terraform R go install ``` -## Adding Dependencies - -This provider uses [Go modules](https://github.com/golang/go/wiki/Modules). -Please see the Go documentation for the most up to date information about using Go modules. - -To add a new dependency `github.com/author/dependency` to your Terraform provider: - -```shell -go get github.com/author/dependency -go mod tidy -``` - -Then commit the changes to `go.mod` and `go.sum`. - -## Using the provider - -Fill this in for each provider - ## Developing the Provider If you wish to work on the provider, you'll first need [Go](http://www.golang.org) installed on your machine (see [Requirements](#requirements) above). @@ -55,10 +27,4 @@ To compile the provider, run `go install`. This will build the provider and put To generate or update documentation, run `make generate`. -In order 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 -``` +In order to test your local build, you will need to setup a [`dev_override`](https://developer.hashicorp.com/terraform/tutorials/providers-plugin-framework/providers-plugin-framework-provider#prepare-terraform-for-local-provider-install). The provider address is `venafi.com/dev/tlspc`.