terraform-provider-cphalo

README

Terraform provider for CloudPassage Halo

The CloudPassage Halo provider is used to interact with CloudPassage Halo resources.

Acceptance tests run every night, to ensure the provider is working. Check the Pipeline status badge.

• Documentation: https://kiwicom.gitlab.io/terraform-provider-cphalo/
• API Docs: https://library.cloudpassage.com/help/cloudpassage-api-documentation

Requirements

• Terraform 0.12.x
• Go 1.12 (to build the provider plugin)

Note: If you need compatibility with older version of Terraform < v0.12, use provider version < v0.2.0.

Building the Provider

Clone repository

$ git clone git@gitlab.com:kiwicom/terraform-provider-cphalo.git

Enter the provider directory and build the provider

$ cd terraform-provider-cphalo
$ make build

You can then find binary in bin/current_system.

Running tests

The Terraform Provider has acceptance tests, these can run against CloudPassage Halo service. Credentials are required.
For more information on getting the credentials, consult the official docs of CloudPassage Halo.

AWS credentials are also needed, since tests need access to AWS to properly test CSP AWS account integration.

Create .env file

make .env

Fill .env with your credentials

And run tests

make testacc

Contributing

Contributions are always welcome. Pull requests have to pass the following checks:

• lint make lint
• tests make test
• website make website-build
• acceptance tests make testacc
• build make release

For more information on existing tools use make help.