https://github.com/duplocloud/terraform-provider-duplocloud

Terraform provider for the DuploCloud platform
https://github.com/duplocloud/terraform-provider-duplocloud

terraform terraform-provider

Last synced: 25 days ago
JSON representation

Terraform provider for the DuploCloud platform

• Host: GitHub
• URL: https://github.com/duplocloud/terraform-provider-duplocloud
• Owner: duplocloud
• Created: 2021-01-06T17:05:32.000Z (almost 4 years ago)
• Default Branch: develop
• Last Pushed: 2024-04-12T19:34:14.000Z (7 months ago)
• Last Synced: 2024-04-14T01:07:27.491Z (7 months ago)
• Topics: terraform, terraform-provider
• Language: Go
• Homepage: https://duplocloud.com
• Size: 16.9 MB
• Stars: 10
• Watchers: 10
• Forks: 3
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Terraform Provider duplocloud

## Releasing new versions

This repo now the Duplo Github Actions to perform releases.

There is a `Start Release` workflow to kick off the process.

## Development

### Building locally.

 - To build and install, run `make install`.

 - To generate or update documentation, run `make doc`.

### Running examples.

```shell

cd examples/service

terraform init && terraform apply

```

### Debugging

#### Using debug output during execution

``` shell

export TF_LOG_PATH=duplo.log

export TF_LOG=TRACE

terraform init && terraform apply

```

#### Using a debugger on VS code

Reference documentation [here](https://developer.hashicorp.com/terraform/plugin/debugging#debugger-based-debugging)

1. Install the VS code [GO extension](https://marketplace.visualstudio.com/items?itemName=golang.go)

2. Go to VS code debug tab and start a new debug session for the terraform provider. You should see something similar to the output below in the console:

```

Starting: /Users/{USERNAME}/go/bin/dlv dap --listen=127.0.0.1:55046 --log-dest=3 from /Users/{USERNAME}/Desktop/duplocloud/terraform-provider-duplocloud

DAP server listening at: 127.0.0.1:55046

Type 'dlv help' for list of commands.

Provider started. To attach Terraform CLI, set the TF_REATTACH_PROVIDERS environment variable with the following:

	TF_REATTACH_PROVIDERS='{"registry.terraform.io/duplocloud/duplocloud":{"Protocol":"grpc","ProtocolVersion":5,"Pid":79817,"Test":true,"Addr":{"Network":"unix","String":"/var/folders/32/bgvj1ynd6p16109l4t7sx4jm0000gn/T/plugin2604224326"}}}'

```

3. Copy `TF_REATTACH_PROVIDERS` to your clipboard and a terminal session to run the terraform commands

4. Run the terraform apply command like the following:

```

TF_REATTACH_PROVIDERS='{"registry.terraform.io/duplocloud/duplocloud":{"Protocol":"grpc","ProtocolVersion":5,"Pid":79817,"Test":true,"Addr":{"Network":"unix","String":"/var/folders/32/bgvj1ynd6p16109l4t7sx4jm0000gn/T/plugin2604224326"}}}' terraform apply

```

5. Happy debugging!

## Installing and running project on WSL2

*Assumptions*

1. Wsl2 is already installed

2. You are using a Ubuntu Linux

3. You have pulled the project on Wsl2

4. You will need to enable systemd support https://devblogs.microsoft.com/commandline/systemd-support-is-now-available-in-wsl/#set-the-systemd-flag-set-in-your-wsl-distro-settings

Install make on Wsl2:

```shell

sudo apt-get install build-essential

make version # make: *** No rule to make target 'version'.  Stop.

```

Install go on Wsl2:

```shell

sudo apt install golang-go

go version # Test your install: you should see something like "go version go1.18.1 linux/amd64"

```

Build project

- Make sure you are in the directory where the **Makefile** is located

```

make install

```

Install terraform

```shell

sudo snap install terraform --classic

terraform version # you should see something like Terraform v1.6.5 ....

```