Skip to content

dome9/terraform-provider-dome9

Repository files navigation

terraform-provider-dome9

Terraform check point cloud guard dome9 provider

Requirements

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

Building The Provider

Clone repository to: $GOPATH/src/github.com/terraform-providers/terraform-provider-dome9

$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers
$ git clone [email protected]:terraform-providers/terraform-provider-dome9.git

Enter the provider directory and build the provider

$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-dome9
$ make build
# or if you're on a mac:
$ gnumake build

Using the provider

Detailed documentation for the Dome9 provider can be found here.

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.13+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

To compile the provider, run make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.

$ make build
...
$ $GOPATH/bin/terraform-provider-dome9
...

In order to test the provider, you can simply run make test.

$ make test

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.

$ make testacc

Acceptance test prerequisites

In order to successfully run the full suite of acceptance tests, you will need to have the following:

Dome9 personal access id and secret key

You will need to create a Dome9 access id & secret key for testing. It will need to have a full admin access.

acceptance test full environment variables list:

Dome9 is a security product, in order to manged the supported clouds a sensitive data must be provided in the on-board staging this data is passed using exported environment variables, your environment must set the following:

Dome9 environment variables:

  • DOME9_ACCESS_ID=;
  • DOME9_SECRET_KEY=;
  • ORGANIZATIONAL_UNIT_NAME=;

AWS environment variables:

  • ARN=;
  • ARN_UPDATE=;
  • SECRET=;

Azure environment variables:

  • SUBSCRIPTION_ID=;
  • TENANT_ID=;
  • CLIENT_PASSWORD=;

GCP environment variables:

  • PROJECT_ID
  • PRIVATE_KEY=;
  • PRIVATE_KEY_ID=;
  • CLIENT_EMAIL=;
  • CLIENT_ID=;
  • CLIENT_X509_CERT_URL=;