The Numspot provider allows Terraform to manage Numspot Cloud resources: compute, networking, storage, security and more — declared as code, versioned with your infrastructure, and applied through the standard Terraform workflow.

Full provider documentation, including every resource and data source reference, lives in the Terraform Registry.

1. Get your Numspot service-account credentials and your Space ID.
2. Declare the provider and a first resource:

terraform {
  required_providers {
    numspot = {
      source = "numspot/numspot"
    }
  }
}

provider "numspot" {}

resource "numspot_vpc" "vpc" {
  ip_range = "10.0.0.0/16"

  tags = [{
    key   = "name"
    value = "terraform-demo"
  }]
}

3. Authenticate through environment variables:

$ export NUMSPOT_HOST="https://api.eu-west-2.numspot.com"
$ export NUMSPOT_HOST_OS="https://objectstorage.eu-west-2.numspot.com"
$ export NUMSPOT_CLIENT_ID="my-svc-account-id"
$ export NUMSPOT_CLIENT_SECRET="my-svc-account-secret"
$ export NUMSPOT_SPACE_ID="my-space-id"
$ terraform init
$ terraform plan

Credentials can also be set in the provider block (static credentials) — see the authentication documentation for all supported methods.

• Terraform >= 1.0
• Go >= 1.27

Go-based tooling is managed automatically by this repository:

• terrafmt and tfplugindocs are pinned via go tool in go.mod.
• golangci-lint is installed locally into bin/ by make setup (or on demand by make fmt/make lint) using the official install script.

1. Clone the repository
2. Enter the repository directory
3. Build the provider using the Go install command:

go install

To generate or update documentation, run go generate.

Acceptance tests run in VCR replay mode: HTTP interactions are recorded in committed cassettes, so the suite runs fully offline.

make testacc            # replay the recorded cassettes (offline)
make record-cassettes   # record new cassettes (VCR_MODE=record, requires credentials)

• Terraform Registry docs — provider, resource and data-source reference.
• docs/ — the in-repo copy of the registry documentation.
• docs/internal/ — contributor documentation: the descriptor-driven code generation pipeline, commands, and the resource registry.
• VERSION.md — currently pinned OpenAPI Specification versions.
• AGENTS.md — contributor- and agent-friendly overview of commands and conventions.

Contributions are welcome! Please open a pull request — Conventional Commits are enforced on every commit and PR title. See CONTRIBUTING.md for the full workflow, and our Code of Conduct. Security issues follow the process in SECURITY.md.

This project is licensed under the Mozilla Public License 2.0.