terraform provider pinecone

Terraform-Provider-Pinecone

Ein Terraform -Anbieter für die Verwaltung von Ressourcen auf Tinecone. Informationen zur vollständigen Anbieterdokumentation finden Sie auf der Anbieterseite der Registrierung

QuickStart

 terraform {
  required_providers {
    pinecone = {
      source  = " thiskevinwang/pinecone "
      version = " 0.1.2 "
    }
  }
}

provider "pinecone" {
  apikey      = var . pinecone_api_key # optional; PINECONE_API_KEY
  environment = var . pinecone_environment # optional; PINECONE_ENVIRONMENT
}

data "pinecone_collection" "existing-collection" {
  name = " my-existing-collection "
}

resource "pinecone_index" "my-first-index" {
  name   = " index-to-be-managed "
  metric = " cosine "
  pods   = 1

  source_collection = data . pinecone_collection . existing-collection . name
  dimension         = data . pinecone_collection . existing-collection . dimension
}

Entwicklung

Schauen Sie sich das Beispielverzeichnis für verschiedene Beispiele an, die lokal ausgeführt werden können.

Stellen Sie während der lokalen Entwicklung sicher, dass Sie einen provider_override in Ihrer Terraform -Konfigurationsdatei ( ~/.terraformrc ) auf die lokale Binärdatei hinweisen.

 provider_installation {
  dev_overrides {
    # Adjust this path to point to the directory where the local provider
    # binary is present. It is likely your $GOPATH/bin directory.
    " thekevinwang.com/terraform-providers/pinecone " = " /Users/kevin/go/bin "
  }

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

 terraform {
  required_providers {
    pinecone = {
      source = " thekevinwang.com/terraform-providers/pinecone "
    }
  }
}

Testen

 cp .env.example .env
go test -v ./... 

Dokumentation

Dieses Projekt basiert auf ./tools/tools.go , um tfplugindocs zu installieren.

 export GOBIN=$PWD/bin
export PATH=$GOBIN:$PATH
go install github.com/hashicorp/terraform-plugin-docs/cmd/tfplugindocs
which tfplugindocs

Führen Sie tfplugindocs aus, um Dokumente zu generieren, und Vorschau auf einzelne Dateien unter https://registry.terraform.io/tools/doc-preview

Freigeben

Es gibt einige einmalige Schritte, die bereits durchgeführt wurden und in diesem Readme nicht behandelt werden. Weitere Informationen finden Sie in der folgenden Fußnote. ¹

Um eine neue Version des Anbieters in die Registrierung zu veröffentlichen, muss eine neue Github -Veröffentlichung erstellt werden. Verwenden Sie die folgenden Schritte, um fortzufahren.

1. Idealerweise sind Sie am main und haben einen sauberen Arbeitsbaum.
2. Stellen Sie sicher, dass das Commit (auch bekannt als Head), das Sie veröffentlichen möchten, markiert ist.
   • git tag v0.1.2
   • git push origin v0.1.2
3. goreleaser run: GITHUB_TOKEN=$(gh auth token) goreleaser release --clean
   • Dadurch wird eine neue Github -Veröffentlichung erstellt, die kurz darauf vom Terraform -Register festgestellt werden sollte.

Notiz

Die Goreleaser -Konfiguration erfordert, dass GPG_FINGERPRINT eingestellt wird. Vielleicht versuchen Sie Folgendes (muss getestet werden)

 export GPG_FINGERPRINT= $( gpg --list-keys --with-colons | awk -F: ' $1 == "fpr" || $1 == "fp2" {print $10} ' | head -n 1 )
export GITHUB_TOKEN= $( gh auth token )
goreleaser release --clean

• REF: https://unix.stackexchange.com/a/743986

Anhang

• https://thekevinwang.com/2023/10/05/build-publish-terraform-provider
• https://docs.pinecone.io/
• https://github.com/hashicorp/terraform-plugin-framework
• https://developer.hashicorp.com/terraform/tutorials/providers-plugin-framework/providers-plugin-framework-Provider
• https://github.com/hashicorp/terraform-provider-hashicups-pf

Fußnoten

1. Dokumente zu Veröffentlichungen: https://developer.hashicorp.com/terraform/registry/providers/publishing#publishing-the-registry ↩