Files
fleet/tools/terraform
Lucas Manuel Rodriguez 703dcf0b4f Update go to 1.26.5 (#48993)
Resolves #48988.

I ran `make update-go version=1.26.5`.

- [X] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.

## Testing

- [X] QA'd all new/changed functionality manually

Fleet:
<img width="301" height="102" alt="Screenshot 2026-07-09 at 8 41 49 AM"
src="https://github.com/user-attachments/assets/baf76ce7-6192-4506-a9db-52f5318939ee"
/>
fleetctl:
```
fleetctl --version
fleetctl - version orbit-v1.57.0-402-ge3d0c005dc
  branch:       48988-update-go-1.26.5
  revision:     e3d0c005dc6698c024ad47a124c99e4f264855a0
  build date:   2026-07-09
  build user:   lucas
  go version:   go1.26.5
```
Also verified orbit in Linux:
<img width="582" height="121" alt="Screenshot 2026-07-09 at 8 51 55 AM"
src="https://github.com/user-attachments/assets/65672676-8010-45a1-8c28-9f9959e72134"
/>


## fleetd/orbit/Fleet Desktop

- [X] Verified compatibility with the latest released version of Fleet
(see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/workflows/fleetd-development-and-release-strategy.md))
- [X] Verified auto-update works from the released version of component
to the new version (see [tools/tuf/test](../tools/tuf/test/README.md))

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Chores**
  * Updated the project and all included tooling modules to Go 1.26.5.
* Refreshed build images used by desktop Linux, load testing, and
related utilities to the newer Go toolchain.
  * Updated change log entries to reflect the Go version bump.

* **Bug Fixes**
* Improved the automation that refreshes Go-pinned Docker image
references to resolve and apply correct digests, helping prevent broken
build images.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-07-09 11:20:45 -03:00
..
2026-07-09 11:20:45 -03:00

Terraform Provider for fleets

This is a Terraform provider for managing fleets (formally "teams"). When you have 100+ fleets, and manually managing them is not feasible. The primary setting of concern is the fleet's "agent options" which consists of some settings and command line flags. These (potentially dangerously) configure FleetDM all machines.

Usage

All the interesting commands are in the Makefile. If you just want to use the thing, see make install and make apply.

Note that if you run terraform apply in the tf directory, it won't work out of the box. That's because you need to set the TF_CLI_CONFIG_FILE environment variable to point to a file that enables local development of this provider. The Makefile does this for you.

Future work: actually publish this provider.

Development

Code Generation

See make gen. It will create team_resource_gen.go, which defines the types that Terraform knows about. This is automatically run when you run make install.

Running locally

See make plan and make apply.

Running Tests

You probably guessed this. See make test. Note that these tests require a FleetDM server to be running. The tests will create fleets and delete them when they're done. The tests also require a valid Fleet API token to be in the FLEETDM_APIKEY environment variable.

Debugging locally

The basic idea is that you want to run the provider in a debugger. When terraform normally runs, it will execute the provider a few times in the course of operations. What you want to do instead is to run the provider in debug mode and tell terraform to contact it.

To do this, you need to start the provider with the -debug flag inside a debugger. You'll also need to give it the FLEETDM_APIKEY environment variable. The provider will print out a big environment variable that you can copy and paste to your command line.

When you run terraform apply or the like, you'll invoke it with that big environment variable. It'll look something like

TF_REATTACH_PROVIDERS='{"fleetdm.com/tf/fleetdm":{"Protocol":"grpc","ProtocolVersion":6,"Pid":33644,"Test":true,"Addr":{"Network":"unix","String":"/var/folders/32/xw2p1jtd4w10hpnsyrb_4nmm0000gq/T/plugin771405263"}}}' terraform apply

With this magic, terraform will look to your provider that's running in a debugger. You get breakpoints and the goodness of a debugger.