terraform-provider-jamfpro

README

Terraform Provider for Jamf Pro

This repository contains the Terraform provider for managing resources in Jamf Pro. It is built on the Terraform Plugin SDK and intended for creating and managing Jamf Pro entities like departments, sites, policies, etc.

The provider contains:

• Resources and data sources for Jamf Pro entities (internal/provider/),
• Examples (examples/) and generated documentation (docs/),
• Miscellaneous meta files.

These files contain the actual code and configurations for the Terraform provider. Tutorials for creating Terraform providers can be found on the HashiCorp Developer platform.

Please see the GitHub template repository documentation for guidance on creating a new repository.

Once the provider is finalized, you may want to publish it on the Terraform Registry so that others can use it.

Requirements

• Terraform >= 1.0
• Go >= 1.21

Building The Provider

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

go install

Adding Dependencies

This provider uses Go modules.

To add a new dependency github.com/author/dependency to your Terraform provider:

go Get github.com/author/dependency
go mod tidy

Then commit the changes to go.mod and go.sum.

Using the provider

To use this provider, you need to configure it with your Jamf Pro instance's URL and authentication credentials. The provider allows you to manage various resources such as departments, sites, and policies within Jamf Pro.

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (see 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 go generate.

To run the full suite of Acceptance tests, execute make testacc.

Note: Acceptance tests create real resources, and often cost money to run.

make testacc

Benchmarking

Indicative time taken to implement changes using this terraform provider against a jamf cloud instance of jamf pro.

Setup: Jamf Cloud instance of Jamf Pro Empty instance of jamf pro with 0 devices enrolled Deployment of jamf pro departments (Simplement resource type in jamf pro)

API Calls	Resource Type	CRUD Operation	Time Taken
1000	Departments	Create	8m10s
1000	Departments	Read	8ms
1000	Departments	Update	8ms
1000	Departments	delete	8ms
10000	Departments	Create (TF Plan+Apply)	8m10s
10000	Departments	Read (TF Plan)	2m49s
10000	Departments	Update (TF Plan+Apply)	8ms
10000	Departments	delete	8ms