Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
685 changes: 422 additions & 263 deletions .speakeasy/gen.lock

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ generate: generate-plan-modifiers speakeasy

speakeasy: check-speakeasy
@rm -rf examples/resources
speakeasy run --skip-versioning --output console --minimal
speakeasy run --skip-versioning --output console --minimal --skip-compile
@go mod tidy
@go generate .
@git checkout -- README.md
Expand Down
108 changes: 108 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,4 +35,112 @@ e.g. `KONNECT_TOKEN=kpat_YOUR_PAT terraform apply`
<!-- No SDK Installation -->
<!-- No SDK Example Usage -->
<!-- No SDK Available Operations -->
<!-- Start Summary [summary] -->
## Summary

Konnect API (BETA): This is a BETA specification. Endpoints in this specification may change with zero notice
<!-- End Summary [summary] -->

<!-- Start Table of Contents [toc] -->
## Table of Contents
<!-- $toc-max-depth=2 -->
* [terraform-provider-konnect-beta](#terraform-provider-konnect-beta)
* [Usage](#usage)
* [Installation](#installation)
* [Authentication](#authentication)
* [Testing the provider locally](#testing-the-provider-locally)

<!-- End Table of Contents [toc] -->

<!-- Start Installation [installation] -->
## Installation

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

```hcl
terraform {
required_providers {
konnect-beta = {
source = "kong/konnect-beta"
version = "0.15.0"
}
}
}

provider "konnect-beta" {
# Configuration options
}
```
<!-- End Installation [installation] -->

<!-- Start Authentication [security] -->
## Authentication

This provider supports authentication configuration via environment variables and provider configuration.

The configuration precedence is:

- Provider configuration
- Environment variables

Available configuration:

| Provider Attribute | Description |
|---|---|
| `konnect_access_token` | The Konnect access token is meant to be used by the Konnect dashboard and the decK CLI authenticate with.
. |
| `personal_access_token` | The personal access token is meant to be used as an alternative to basic-auth when accessing Konnect via APIs.
You can generate a Personal Access Token (PAT) from the [personal access token page](https://cloud.konghq.com/global/account/tokens/) in the Konnect dashboard.
The PAT token must be passed in the header of a request, for example:
`curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer kpat_xgfT...'`
. Configurable via environment variable `KONNECT_TOKEN`. |
| `system_account_access_token` | The system account access token is meant for automations and integrations that are not directly associated with a human identity.
You can generate a system account Access Token by creating a system account and then obtaining a system account access token for that account.
The access token must be passed in the header of a request, for example:
`curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer spat_i2Ej...'`
. Configurable via environment variable `KONNECT_SPAT`. |
<!-- End Authentication [security] -->

<!-- Start Testing the provider locally [usage] -->
## Testing the provider locally

#### Local Provider

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.

```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
```

#### Compiled Provider

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.

1. Execute `go build` to construct a binary called `terraform-provider-konnect-beta`
2. Ensure that the `.terraformrc` file is configured with a `dev_overrides` section such that your local copy of terraform can see the provider binary

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

```
provider_installation {

dev_overrides {
"registry.terraform.io/kong/konnect-beta" = "<PATH>"
}

# 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 {}
}
```
<!-- End Testing the provider locally [usage] -->

<!-- Placeholder for Future Speakeasy SDK Sections -->
62 changes: 62 additions & 0 deletions docs/data-sources/mesh_control_planes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "konnect-beta_mesh_control_planes Data Source - terraform-provider-konnect-beta"
subcategory: ""
description: |-
MeshControlPlanes DataSource
---

# konnect-beta_mesh_control_planes (Data Source)

MeshControlPlanes DataSource

## Example Usage

```terraform
data "konnect-beta_mesh_control_planes" "my_meshcontrolplanes" {
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Read-Only

- `data` (Attributes List) (see [below for nested schema](#nestedatt--data))

<a id="nestedatt--data"></a>
### Nested Schema for `data`

Read-Only:

- `created_at` (String)
- `description` (String)
- `features` (Attributes List) (see [below for nested schema](#nestedatt--data--features))
- `id` (String) ID of the control plane.
- `labels` (Map of String) Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters.
- `name` (String) The name of the control plane.
- `updated_at` (String)

<a id="nestedatt--data--features"></a>
### Nested Schema for `data.features`

Read-Only:

- `hostname_generator_creation` (Attributes) (see [below for nested schema](#nestedatt--data--features--hostname_generator_creation))
- `mesh_creation` (Attributes) (see [below for nested schema](#nestedatt--data--features--mesh_creation))
- `type` (String)

<a id="nestedatt--data--features--hostname_generator_creation"></a>
### Nested Schema for `data.features.hostname_generator_creation`

Read-Only:

- `enabled` (Boolean)


<a id="nestedatt--data--features--mesh_creation"></a>
### Nested Schema for `data.features.mesh_creation`

Read-Only:

- `enabled` (Boolean)
Loading
Loading