README.md

terraform-provider-ecloud

Getting Started

This provider is available via the Terraform Registry with Terraform v0.13+

⚠️ We strongly recommend pinning the provider version to a target major version, as to ensure future breaking changes do not affect workflows and automated CI pipelines

terraform {
  required_providers {
    ecloud = {
      source  = "ans-group/ecloud"
      version = "~> 2.0"
    }
  }
}

provider "ecloud" {
  api_key = "abc"
}

Getting Started (manual)

To get started, the terraform-provider-ecloud binary (.exe extension if Windows) should be downloaded from Releases and placed in the plugins directory (see here for more information). For this example, we'll place it in ~/.terraform.d/plugins/

We'll then need to initialise terraform with our provider:

terraform init

Finally, we can invoke terraform apply to apply our terraform configuration:

terraform apply

Documentation

Documentation is located within this repository at /docs, and is published in the Terraform Registry

Upgrading

⚠️ This provider was originally created under the ukfast organisation, and was later moved to the ans-group organisation. Upgrading the ukfast provider will result in the error checksum list has unexpected. Updating provider config to use the ans-group organisation will resolve this

Development

Testing

Acceptance tests can be executed using make as below:

make testacc TEST=VPC_basic

Releasing

goreleaser is used to release the provider on Github. First, obtain your GPG fingerprint:

gpg -k

Cache GPG passphrase:

gpg --armor --detach-sign -n main.go

Finally tag and invoke goreleaser:

git tag v2.0.0
git push --tags
export GITHUB_TOKEN=<token>
export GPG_FINGERPRINT=<fingerprint>
export GPG_TTY=$(tty)
goreleaser --rm-dist