This repo provides a terraform provider to provision resources on the Cisco CDO platform.
We make use of Go workspaces - this is to split the responsibility of the provider and the Go CDO client. Eventually the client will be moved to its own repo, but in the interest of hitting the ground running they both live in here.
.
├── client # Golang CDO client - currently using the module name github.com/CiscoDevnet/terraform-provider-cdo/go-client
├── provider # Terraform provider
└── README.md
- Go (1.20)
- macos install:
brew install go
- macos install:
- tfenv
- macos install:
brew install tfenv
- macos install:
Acceptance tests will create real resources!
Ensure you have met the requirements.
Ensure you have an active terraform:
tfenv use 1.3.1
Then in the provider dir you can run the acceptance tests:
cd ./provider
ACC_TEST_CISCO_CDO_API_TOKEN=<CDO_API_TOKEN> make testacc
Run following command in the client
or provider
directory.
golangci-lint run
Examples are provided so that you can do the usual plan
, apply
, destroy
etc in the folders under provider/examples
directory.
- Build provider locally.
- Figure out where your executable will be built.
Note: If empty output, it is default to
go env GOBIN
~/go/bin
- Build executable.
cd provider go install .
- Verify installation The installation path that you figured out above should contain an executable called terraform-provider-cdo.
- Figure out where your executable will be built.
- Tell terraform to use your local build
- Modify local terraform configuration
vim ~/.terraformrc
- Copy the following into it:
provider_installation { dev_overrides { "hashicorp.com/CiscoDevnet/cdo" = "<DIRECTORY_OF_YOUR_EXECUTABLE>" } # 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 {} }
- Modify local terraform configuration
- Navigate to a folder under
provider/examples
, e.g.provider/examples/resources/asa
. - Run
terraform plan
- Output (sample)
| │ Warning: Provider development overrides are in effect │ │ The following provider development overrides are set in the CLI configuration: │ - hashicorp.com/CiscoDevnet/cdo in /Users/weilluo/go/bin │ │ The behavior may therefore not match any released version of the provider and applying changes may cause the state to become incompatible with published releases. | ... rest
If you make any changes to the resources and data sources provided by this provider, you will need to regenerate the docs, otherwise the Github actions triggered by this pull request will fail. To do this, run:
go run github.com/hashicorp/terraform-plugin-docs/cmd/tfplugindocs generate --provider-name cdo --rendered-provider-name "CDO Provider" --rendered-website-dir ../docs
To release a new version of the Terraform CDO Provider, perform the following steps.
- Checkout main branch.
- List current available tags:
git tag
. - Add a tag:
git tag vMAJOR.MINOR.PATCH
, e.g.git tag v0.1.3
(following semver conventions as described in https://www.semver.org).- To add a tag for past commit:
git tag -a vMAJOR.MINOR.PATCH COMMIT_HASH
, e.g.git tag -a v1.2.3 9fceb02
.
- To add a tag for past commit:
- Push the tag:
git push --tags origin main
.
- Error: Inconsistent dependency lock file
provider hashicorp/CiscoDevnet/cdo: required by this configuration but no version is selected
- This means you have not setup the dev override properly, make sure your
~/.terraformrc
has the right override for the provider in question.
- This means you have not setup the dev override properly, make sure your