README
¶
Workbench Terraform Provider
Local development
Run go build -o terraform-provider-workbench . to build an executable in /bin. You will see terrafrom-provider-workbench in your bin folder. Note that it won't be able to find the provider without the -workbench suffix so you must specify the output name to append the suffix.
Prepare Terraform for local provider install
Terraform installs providers and verifies their versions and checksums when you run terraform init. Terraform will download your providers from either the provider registry or a local registry. However, while building your provider you will want to test Terraform configuration against a local development build of the provider. The development build will not have an associated version number or an official set of checksums listed in a provider registry.
Terraform allows you to use local provider builds by setting a dev_overrides block in a configuration file called .terraformrc. This block overrides all other configured installation methods.
Terraform searches for the ~/.terraformrc file and applies any configuration settings you set.
First, find the GOBIN path where Go installs your binaries. Your path may vary depending on how your Go environment variables are configured.
go env GOBIN
If the GOBIN go environment variable is not set, use the default path, /Users/<Username>/go/bin.
Create a new file called .terraformrc in your home directory (~), then add the dev_overrides block below. Change the to the value returned from the go env GOBIN command above.
provider_installation {
dev_overrides {
"registry.terraform.io/verily-src/workbench" = "<repo-path>/bin"
}
# For all other providers, install them directly from their origin provider
# registries as normal. If you omit this, Terraform will _only_ use
# the dev_overrides block, and so no other providers will be available.
direct {}
}
Testing
To run acceptance test, set TF_ACC=1
TF_ACC=1 go test ./... -v
Generate documentation
cd tools && go generate ./...
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
api
api contains calls to the workspace manager API.
|
api contains calls to the workspace manager API. |
|
client
package client provides utilites for working with Workbench clients.
|
package client provides utilites for working with Workbench clients. |
|
fakes
Package fakes provides testing fakes for other services.
|
Package fakes provides testing fakes for other services. |
|
fakes/user
Package user provides a user-manager fake at the service API layer.
|
Package user provides a user-manager fake at the service API layer. |
|
fakes/wsm
Package wsm provides a workspace-manager fake at the service API layer.
|
Package wsm provides a workspace-manager fake at the service API layer. |
|
models
package models defines the models used in the provider.
|
package models defines the models used in the provider. |
|
openapi/user
Package user provides primitives to interact with the openapi HTTP API.
|
Package user provides primitives to interact with the openapi HTTP API. |
|
openapi/wsm
Package wsm provides primitives to interact with the openapi HTTP API.
|
Package wsm provides primitives to interact with the openapi HTTP API. |
|
provider
package provider provides the implementation of the Workbench provider for Terraform.
|
package provider provides the implementation of the Workbench provider for Terraform. |