terraform provider pinecone

Terraform-Provider-Pinecone

Un fournisseur de terraform pour gérer les ressources sur pignon. Pour la documentation complète du fournisseur, reportez-vous à la page du fournisseur du registre

Start

 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
}

Développement

Consultez le répertoire des exemples pour divers exemples qui peuvent être exécutés localement.

Pendant le développement local, assurez-vous de définir un provider_override dans votre fichier de configuration Terraform ( ~/.terraformrc ) pour pointer vers le binaire local.

 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 "
    }
  }
}

Essai

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

Documentation

Ce projet repose sur ./tools/tools.go pour installer tfplugindocs .

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

Exécutez tfplugindocs pour générer des documents et prévisualisez les fichiers individuels à https://registry.terraform.io/tools/doc-preview

Libération

Il y a quelques pas de temps qui ont déjà été effectués et ne seront pas couverts dans cette lecture. Voir la note de bas de page suivante pour plus d'informations. ¹

Pour publier une nouvelle version du fournisseur dans le registre, une nouvelle version GitHub doit être créée. Utilisez les étapes suivantes pour continuer.

1. Idéalement, vous êtes sur main et avez un arbre en activité propre.
2. Assurez-vous que le commit (aka tête) que vous êtes sur le point de libérer est étiqueté.
   • git tag v0.1.2
   • git push origin v0.1.2
3. Exécutez goreleaser : GITHUB_TOKEN=$(gh auth token) goreleaser release --clean
   • Cela créera une nouvelle version GitHub qui devrait être détectée par le registre Terraform peu de temps après.

Note

La configuration de GoreleSer nécessite que GPG_FINGERPRINT soit définie. Peut-être essayer ce qui suit (doit être testé)

 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

• Réf: https://unix.stackexchange.com/a/743986

Appendice

• 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

Notes de bas de page

1. Docs on Publishing: https://developer.hashicorp.com/terraform/registry/providers/publishing#publishing-to-the-registry ↩