Merge pull request #2 from komminarlabs/tk/initial-version

Initial Version `0.1.0`

.github/workflows/pull-request.yml

@@ -33,4 +33,4 @@ jobs:
           install-only: true
 
       - name: Run GoReleaser
-        run: goreleaser build --clean --skip=validate
+        run: goreleaser build --clean --skip=validate --snapshot

.golangci.yml

@@ -0,0 +1,27 @@
+# Visit https://golangci-lint.run/ for usage documentation
+# and information on other useful linters
+issues:
+  max-per-linter: 0
+  max-same-issues: 0
+
+linters:
+  disable-all: true
+  enable:
+    - durationcheck
+    - errcheck
+    - exportloopref
+    - forcetypeassert
+    - godot
+    - gofmt
+    - gosimple
+    - ineffassign
+    - makezero
+    - misspell
+    - nilerr
+    - predeclared
+    - staticcheck
+    - tenv
+    - unconvert
+    - unparam
+    - unused
+    - vet

.goreleaser.yml

@@ -0,0 +1,60 @@
+# Visit https://goreleaser.com for documentation on how to customize this
+# behavior.
+before:
+  hooks:
+    # this is just an example and not a requirement for provider building/publishing
+    - go mod tidy
+builds:
+- env:
+    # goreleaser does not work with CGO, it could also complicate
+    # usage by users in CI/CD systems like Terraform Cloud where
+    # they are unable to install libraries.
+    - CGO_ENABLED=0
+  mod_timestamp: '{{ .CommitTimestamp }}'
+  flags:
+    - -trimpath
+  ldflags:
+    - '-s -w -X main.version={{.Version}} -X main.commit={{.Commit}}'
+  goos:
+    - freebsd
+    - windows
+    - linux
+    - darwin
+  goarch:
+    - amd64
+    - '386'
+    - arm
+    - arm64
+  ignore:
+    - goos: darwin
+      goarch: '386'
+  binary: '{{ .ProjectName }}_v{{ .Version }}'
+archives:
+- format: zip
+  name_template: '{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}'
+checksum:
+  extra_files:
+    - glob: 'terraform-registry-manifest.json'
+      name_template: '{{ .ProjectName }}_{{ .Version }}_manifest.json'
+  name_template: '{{ .ProjectName }}_{{ .Version }}_SHA256SUMS'
+  algorithm: sha256
+signs:
+  - artifacts: checksum
+    args:
+      # if you are using this in a GitHub action or some other automated pipeline, you 
+      # need to pass the batch flag to indicate its not interactive.
+      - "--batch"
+      - "--local-user"
+      - "{{ .Env.GPG_FINGERPRINT }}" # set this environment variable for your signing key
+      - "--output"
+      - "${signature}"
+      - "--detach-sign"
+      - "${artifact}"
+release:
+  extra_files:
+    - glob: 'terraform-registry-manifest.json'
+      name_template: '{{ .ProjectName }}_{{ .Version }}_manifest.json'
+  # If you want to manually examine the release before its live, uncomment this line:
+  # draft: true
+changelog:
+  skip: true

CHANGELOG.md

@@ -0,0 +1,11 @@
+## [0.1.0] - 2024-05-01
+
+### Added:
+
+* **New Data Source:** `influxdb3_database`
+* **New Data Source:** `influxdb3_databases`
+* **New Data Source:** `influxdb3_token`
+* **New Data Source:** `influxdb3_tokens`
+
+* **New Resource:** `influxdb3_database`
+* **New Resource:** `influxdb3_token`

Makefile

@@ -0,0 +1,15 @@
+default: testacc
+
+# Run acceptance tests
+.PHONY: testacc
+testacc:
+	TF_ACC=1 go test ./... -v $(TESTARGS) -timeout 120m
+
+.PHONY: lint
+lint:
+	golangci-lint run
+
+.PHONY: docs
+docs:
+	go install github.com/hashicorp/terraform-plugin-docs/cmd/tfplugindocs
+	tfplugindocs generate

README.md

@@ -1,2 +1,86 @@
 # terraform-provider-influxdb3
 Terraform provider to manage InfluxDB V3
+
+## Requirements
+
+- [Terraform](https://developer.hashicorp.com/terraform/downloads) >= 1.0
+- [Go](https://golang.org/doc/install) >= 1.20
+
+## Building The Provider
+
+1. Clone the repository
+1. Enter the repository directory
+1. Build the provider using the Go `install` command:
+
+```shell
+go install
+```
+
+## Adding Dependencies
+
+This provider uses [Go modules](https://github.com/golang/go/wiki/Modules).
+Please see the Go documentation for the most up to date information about using Go modules.
+
+To add a new dependency `github.com/author/dependency` to your Terraform provider:
+
+```shell
+go get github.com/author/dependency
+go mod tidy
+```
+
+Then commit the changes to `go.mod` and `go.sum`.
+
+## Using the provider
+
+Add the below code to your configuration.
+
+```terraform
+terraform {
+  required_providers {
+    influxdb3 = {
+      source = "komminarlabs/influxdb3"
+    }
+  }
+}
+```
+
+Initialize the provider
+
+```terraform
+provider "influxdb3" {
+  account_id = "*******"
+  cluster_id = "*******"
+  token      = "*******"
+  url        = "https://console.influxdata.com"
+}
+```
+
+## Available functionalities
+
+### Data Sources
+
+* `influxdb3_database`
+* `influxdb3_databases`
+* `influxdb3_token`
+* `influxdb3_tokens`
+
+### Resources
+
+* `influxdb3_database`
+* `influxdb3_token`
+
+## Developing the Provider
+
+If you wish to work on the provider, you'll first need [Go](http://www.golang.org) installed on your machine (see [Requirements](#requirements) above).
+
+To compile the provider, run `go install`. This will build the provider and put the provider binary in the `$GOPATH/bin` directory.
+
+To generate or update documentation, run `make docs`.
+
+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.
+
+```shell
+make testacc
+```

docs/data-sources/database.md

@@ -0,0 +1,37 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "influxdb3_database Data Source - terraform-provider-influxdb3"
+subcategory: ""
+description: |-
+  Retrieves a database. Use this data source to retrieve information for a specific database.
+---
+
+# influxdb3_database (Data Source)
+
+Retrieves a database. Use this data source to retrieve information for a specific database.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) The name of the cluster database. The Length should be between `[ 1 .. 64 ]` characters.
+
+### Read-Only
+
+- `account_id` (String) The ID of the account that the cluster belongs to.
+- `cluster_id` (String) The ID of the cluster that you want to manage.
+- `max_columns_per_table` (Number) The maximum number of columns per table for the cluster database. The default is `200`
+- `max_tables` (Number) The maximum number of tables for the cluster database. The default is `500`
+- `partition_template` (Attributes List) A [template](https://docs.influxdata.com/influxdb/cloud-dedicated/admin/custom-partitions/partition-templates/) for partitioning a cluster database. (see [below for nested schema](#nestedatt--partition_template))
+- `retention_period` (Number) The retention period of the cluster database in nanoseconds. The default is `0`. If the retention period is not set or is set to `0`, the database will have infinite retention.
+
+<a id="nestedatt--partition_template"></a>
+### Nested Schema for `partition_template`
+
+Read-Only:
+
+- `type` (String) The type of the template part.
+- `value` (String) The value of the template part.

docs/data-sources/databases.md

@@ -0,0 +1,41 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "influxdb3_databases Data Source - terraform-provider-influxdb3"
+subcategory: ""
+description: |-
+  Gets all databases for a cluster.
+---
+
+# influxdb3_databases (Data Source)
+
+Gets all databases for a cluster.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Read-Only
+
+- `databases` (Attributes List) (see [below for nested schema](#nestedatt--databases))
+
+<a id="nestedatt--databases"></a>
+### Nested Schema for `databases`
+
+Read-Only:
+
+- `account_id` (String) The ID of the account that the cluster belongs to.
+- `cluster_id` (String) The ID of the cluster that you want to manage.
+- `max_columns_per_table` (Number) The maximum number of columns per table for the cluster database. The default is `200`
+- `max_tables` (Number) The maximum number of tables for the cluster database. The default is `500`
+- `name` (String) The name of the cluster database. The Length should be between `[ 1 .. 64 ]` characters.
+- `partition_template` (Attributes List) A [template](https://docs.influxdata.com/influxdb/cloud-dedicated/admin/custom-partitions/partition-templates/) for partitioning a cluster database. (see [below for nested schema](#nestedatt--databases--partition_template))
+- `retention_period` (Number) The retention period of the cluster database in nanoseconds. The default is `0`. If the retention period is not set or is set to `0`, the database will have infinite retention.
+
+<a id="nestedatt--databases--partition_template"></a>
+### Nested Schema for `databases.partition_template`
+
+Read-Only:
+
+- `type` (String) The type of the template part.
+- `value` (String) The value of the template part.

docs/data-sources/token.md

@@ -0,0 +1,37 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "influxdb3_token Data Source - terraform-provider-influxdb3"
+subcategory: ""
+description: |-
+  Gets a database token. Use this data source to retrieve information about a database token, including the token's permissions.
+---
+
+# influxdb3_token (Data Source)
+
+Gets a database token. Use this data source to retrieve information about a database token, including the token's permissions.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `id` (String) The ID of the database token.
+
+### Read-Only
+
+- `access_token` (String, Sensitive) The access token that can be used to authenticate query and write requests to the cluster. The access token is never stored by InfluxDB and is only returned once when the token is created. If the access token is lost, a new token must be created.
+- `account_id` (String) The ID of the account that the database token belongs to.
+- `cluster_id` (String) The ID of the cluster that the database token belongs to.
+- `created_at` (String) The date and time that the database token was created. Uses RFC3339 format.
+- `description` (String) The description of the database token.
+- `permissions` (Attributes List) The list of permissions the database token allows. (see [below for nested schema](#nestedatt--permissions))
+
+<a id="nestedatt--permissions"></a>
+### Nested Schema for `permissions`
+
+Read-Only:
+
+- `action` (String) The action the database token permission allows. Valid values are `read` or `write`.
+- `resource` (String) The resource the database token permission applies to. `*` refers to all databases.

docs/data-sources/tokens.md

@@ -0,0 +1,44 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "influxdb3_tokens Data Source - terraform-provider-influxdb3"
+subcategory: ""
+description: |-
+  Gets all database tokens for a cluster.
+---
+
+# influxdb3_tokens (Data Source)
+
+Gets all database tokens for a cluster.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Read-Only
+
+- `tokens` (Attributes List) (see [below for nested schema](#nestedatt--tokens))
+
+<a id="nestedatt--tokens"></a>
+### Nested Schema for `tokens`
+
+Required:
+
+- `id` (String) The ID of the database token.
+
+Read-Only:
+
+- `access_token` (String, Sensitive) The access token that can be used to authenticate query and write requests to the cluster. The access token is never stored by InfluxDB and is only returned once when the token is created. If the access token is lost, a new token must be created.
+- `account_id` (String) The ID of the account that the database token belongs to.
+- `cluster_id` (String) The ID of the cluster that the database token belongs to.
+- `created_at` (String) The date and time that the database token was created. Uses RFC3339 format.
+- `description` (String) The description of the database token.
+- `permissions` (Attributes List) The list of permissions the database token allows. (see [below for nested schema](#nestedatt--tokens--permissions))
+
+<a id="nestedatt--tokens--permissions"></a>
+### Nested Schema for `tokens.permissions`
+
+Read-Only:
+
+- `action` (String) The action the database token permission allows. Valid values are `read` or `write`.
+- `resource` (String) The resource the database token permission applies to. `*` refers to all databases.