Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/squat/terraform-provider-saladcloud

Terraform Provider for SaladCloud
https://github.com/squat/terraform-provider-saladcloud

salad saladcloud terraform terraform-provider

Last synced: 6 days ago
JSON representation

Terraform Provider for SaladCloud

Awesome Lists containing this project

README

        

# SaladCloud Terraform Provider

The Terraform provider for SaladCloud enables the declarative management of resources in [SaladCloud](https://salad.com/).

[![Build Status](https://github.com/squat/terraform-provider-saladcloud/workflows/CI/badge.svg)](https://github.com/squat/terraform-provider-saladcloud/actions?query=workflow%3ACI)

## SDK Installation

To install this provider, copy and paste this code into your Terraform configuration. Then, run `terraform init`.

```hcl
terraform {
required_providers {
saladcloud = {
source = "squat/saladcloud"
version = "0.3.0"
}
}
}

provider "saladcloud" {
# Configuration options
api_key = "some_saladcloud_api_key"
}
```

## SDK Example Usage

### Testing the provider locally

Should you want to validate a change locally, the `--debug` flag allows you to execute the provider against a terraform instance locally.

This also allows for debuggers (e.g. delve) to be attached to the provider.

### Example

```sh
go run main.go --debug
# Copy the TF_REATTACH_PROVIDERS env var
# In a new terminal
cd examples/your-example
TF_REATTACH_PROVIDERS=... terraform init
TF_REATTACH_PROVIDERS=... terraform apply
```

## Available Resources and Operations

Terraform allows you to use local provider builds by setting a `dev_overrides` block in a configuration file called `.terraformrc`. This block overrides all other configured installation methods.

Terraform searches for the `.terraformrc` file in your home directory and applies any configuration settings you set.

```
provider_installation {

dev_overrides {
"squat/saladcloud" = ""
}

# 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 {}
}
```

Your `` may vary depending on how your Go environment variables are configured. Execute `go env GOBIN` to set it, then set the `` to the value returned. If nothing is returned, set it to the default location, `$HOME/go/bin`.

### Generation

This project is generated using [Speakeasy](https://github.com/speakeasy-api/speakeasy).