Jumpcloud Terraform Provider

A Terraform provider for managing Jumpcloud resources.

"Jumpcloud" is a trademark of Jumpcloud, Inc. "Terraform" is a trademark of HashiCorp, Inc. "Go" is a trademark of Google LLC or its affiliate ("Google") for its programming language (see https://go.dev/brand). These marks are used nominatively to indicate the nature and function of Spotnana's Terraform provider, which is neither sponsored or endorsed by Jumpcloud, Inc., Hashicorp, Inc. or Google.

Requirements

Spotnana Jumpcloud Go Client >= 1.0.2
Terraform >= 1.0
Go >= 1.20

Getting Started

terraform {
  required_providers {
    jumpcloud = {
      source = "Spotnana-Tech/jumpcloud"
    }
  }
}

provider "jumpcloud" {
  api_key = var.api_key
}

resource "jumpcloud_usergroup" "example_group" {
  name = "example"
}

Usage

See the core example to see all features executed in a single plan.

Importing Existing Resources

Add an import block to the Terraform configuration file for the resource you want to import.

import {
  to = jumpcloud_app.example_app
  id = "6abcd1230987654321" # The `app_id` of the application in Jumpcloud
}

Generate a .tf file for the resource you want to import.

terraform plan -generate-config-out="generated.tf"

Installation for Local Development

Clone the repository locally

git clone https://github.com/Spotnana-Tech/terraform-provider-jumpcloud.git
cd terraform-provider-jumpcloud

Build the provider using the Go install command:

go install .

Use this command to force terraform to reference the local build within ~/.terraformrc:

export SN_GOPATH=~/go/bin 

cat > ~/.terraformrc <<EOF
provider_installation {

  dev_overrides {
     "Spotnana-Tech/jumpcloud" = "$SN_GOPATH"  
  }
  direct {}
}
EOF

Testing

Run make testacc to run the full suite of Acceptance tests.

Set the required environment variables, navigate to the example directory, and run terraform plan.

export TF_VAR_api_key=<<YOUR_JUMPCLOUD_API_KEY>>

cd ./examples/jumpcloud/confirm_install && terraform plan

Get Support

Open a new issue on this repository.