Skip to content

Releases

v0.10.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 06:19
2ddddde

Added

  • Badges under the title of the README: CI status, latest release, licence (Apache-2.0) and Terraform 1.12+.
  • README badge for the Go version (read from go.mod), and the Go and Terraform logos on their badges.
  • A weekly versions workflow (and scripts/check-versions.sh) that reports when a newer Floci, AWS provider or Terraform exists than the pinned ones. It only reports.
  • SECURITY.md says that release binaries are unsigned and that the Homebrew cask removes the macOS quarantine flag.
  • 16 new mock exam questions (questions/batch5.toml) for the thinnest objectives: 3f (destroy), 3g (formatting), 4a (resource and data blocks) and 4b (references). The bank has 183 questions.
  • Two hands-on exercises for objectives that were quiz only: workflow7 (terraform init and a module it cannot install, plan mode) and workflow8 (terraform validate, fix mode). 97 exercises.
  • tflings sandbox: a scratch folder (<home>/sandbox/src) with a fake AWS account of its own, for trying Terraform outside the exercises. tflings sandbox prints the folder and the sealed environment, tflings sandbox <terraform arguments> runs Terraform there (its .tf files get the same safety check as an exercise's), tflings sandbox --reset starts over in a new account. aws up and watch do not empty Floci while the sandbox's state has resources. Not yet run against Floci: tested with provider-free configurations only.

Changed

  • The release workflow runs go test ./... (on Terraform 1.12, without Docker) before GoReleaser publishes, and the aws CI job runs its tests with -timeout 60m.
  • Two exercises folders on one machine no longer share state. tflings init now gives the folder a random salt (in .tflings.json), which names its scratch folders under tflings's home and goes into its fake AWS accounts, so a reset in one folder cannot delete the other's saved state. Folders made by an older version have no salt and keep working exactly as before.
  • run now records a pass in the progress file of the exercises folder it works on, the same file the reset counter lives in, instead of always in the current directory.
  • The safety check that refuses a configuration which could leave the fake AWS now also reads backend configuration files (*.tfbackend, *.hcl) and refuses assume_role written as an argument of the s3 backend. tflings tf refuses -backend-config values that set credentials, a role or an endpoint other than Floci (or name a file that is not one of the exercise's own), -var values that give an endpoint another URL, and a -var-file outside the exercise's folder.
  • tflings aws up and watch now say that they are about to empty Floci before they do it, not after.

Fixed

  • workflow6 could not be done as its README says: every tflings tf call cleared the exercise's scratch folder, so the saved plan of tflings tf workflow6 plan -out=tfplan was gone before show and apply tfplan. tflings now removes only the files it wrote itself; a saved plan or a file Terraform generated stays. The proof of a fix exercise's solution now runs each command the way tflings tf does, so a mistake like this is caught.

  • Two tflings processes (a watch in one terminal, tflings tf or run in another) could use the same exercise's scratch folder at once, and one could delete the folder under the other (the likely cause of a "chdir .../runs/.../src" error). The folder now has a lock that is held for the whole command, reset waits for it (or says it could not and changes nothing), and a fix exercise is built in a side folder and moved into place when it is whole.

Changed

  • Documentation brought up to date: ROADMAP.md (phases that are done, the modes that need Terraform and Docker, the per-exercise plugin cache), CLAUDE.md (status, architecture, the automatic Floci reset exists) and the README (Go is needed only to build from source; update also refreshes info.toml entries).

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.10.0, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).

v0.9.2

Choose a tag to compare

@github-actions github-actions released this 15 Nov 19:32
be0a8f6

Fixed

  • tflings update now also replaces the info.toml entry (objective, hint, link) of exercises you already have when the binary's is newer. Before, only new exercises were added, so a folder made by an older version kept old objective ids and tflings progress counted exercises under the wrong objective. info.toml holds no progress (that is in .tflings.json), and the earlier file is kept as info.toml.bak.
  • When the setup of a fix exercise fails (for example because an earlier setup of the same exercise, in another folder that shares the Floci container, left a lock or an object behind), the message now says to run tflings reset <exercise>, which starts it again in a fresh account. A failed setup also removes its "built" marker.

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.9.2, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).

v0.9.1

Choose a tag to compare

@github-actions github-actions released this 15 Nov 10:37
82c24af

Added

  • Two demo recordings in the README (misc/demo-tui.gif and misc/demo-exam.gif), made with vhs from demo-tui.tape and demo-exam.tape, and a "first five minutes" section.

Fixed

  • In the full-screen view, a long explanation or failure message is wrapped to the width of the terminal instead of being cut off.
  • tflings progress printed its "run this inside your exercises folder" note to stderr, so it could appear above the table; it is now printed after it.

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.9.1, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 08:46
d156df5

Added

  • The cli exercise mode and ten exercises (cli1 to cli10): you write one Terraform command in answer.sh for a short task (apply a saved plan, plan -refresh-only, init -migrate-state, force-unlock, apply -replace, import, fmt -check -recursive, ...). tflings reads it and compares it with the accepted form; it is never run, so these need neither Terraform nor Docker. A wrong but tempting command (taint, refresh, destroy) gets a hint that says why. 95 exercises.

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.9.0, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 08:16
7563f44

Added

  • tflings doctor --install-terraform: downloads Terraform from releases.hashicorp.com into tflings's own folder (nothing system-wide), with HashiCorp's hc-install, which checks the release's SHA256 sums and the signature on them. The default is the newest 1.12.x, the version the exam tests (--terraform-version 1.12.3 or a constraint chooses another), and tflings uses it before any terraform on PATH. doctor now says to run it when no Terraform is found. Tried on macOS arm64 and on Ubuntu 26.04 arm64 with no Terraform on PATH.
  • Three exercises for topics the exam asks about: workspaces1 (CLI workspaces: a second state for the same configuration), iteration7 (count against for_each: removing an item must not shift the others) and conditions5 (can(regex(...)) in a validation): 85 exercises.

Fixed

  • The states of CLI workspaces (terraform.tfstate.d) are kept between runs of an apply or fix exercise, like the default state.

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.8.0, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 07:39
92de6b4

Added

  • tflings version (it only worked as tflings --version).
  • tflings exam --review: asks again, with the answer after each, the questions you missed in your last sitting.
  • Exam questions can show a code snippet. 12 new questions use one (what a for_each plans, what a failing validation does, what -/+ in a plan will do, variable precedence, an import block, provider aliases, a version constraint, and more).
  • 12 more questions for the objectives that had one (2b, 3a, 5a, 6a): 167 questions in all.

Fixed

  • A command or flag that does not exist, or any error a command did not report itself, made tflings exit with status 1 and print nothing. It now prints Error: ..., and for an unknown command or flag points to tflings --help (cobra's "Did you mean" suggestion is kept).

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.7.0, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 06:41
9732350

Added

  • 77 more exam questions, 143 in all, for every objective of the 004 content list. Batch 2 (38) covers IaC and providers (1, 2), the core workflow (3), resources, data, variables, types, expressions and dependencies (4a to 4f) and modules (5). Batch 3 (39) covers HCP Terraform (8a to 8d: execution modes, agents, run tasks, policy levels, dynamic credentials, speculative plans), drift (6d), the state commands (7b) and more of 2d, 3d, 3e, 4b, 4d, 4e and 5d.

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.6.0, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 06:16
fb0b524

Added

  • tflings progress: for each of the 37 objectives of the 004 content list, the exercises done and the score on the mock exam questions, with a ! for what needs work. tflings exam now keeps its results (exam-history.jsonl in tflings's home folder), and exam --weak asks about the three objectives you score lowest on, those never asked first.
  • 31 more exam questions (66 in all): conditions, secrets, local and remote backends, locking, drift, import, state commands and logging.
  • tflings exam: a mock exam from an embedded bank of multiple choice questions (35 so far), including pick-two questions. It asks in random order, can be timed, limited to an objective (--objective 4g) or run as practice with the answer after each question, and reports the score per objective with the exercises to redo. HashiCorp does not publish the real exam's question count or pass mark, so the defaults (30 questions, 60 minutes) are ours.

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.5.0, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 05:35
3d97509

Added

  • Release builds: archives for Linux, macOS and Windows (amd64 and arm64) from GoReleaser, and a Homebrew cask (brew install cleonte/tap/tflings).

Changed

  • When init finds no AWS provider in the cache, the message says to run tflings doctor --prefetch.

Install

go install github.com/cleonte/tflings/cmd/tflings@v0.4.0, brew install cleonte/tap/tflings (macOS), or download the archive for your system below and put tflings on your PATH. Then run tflings doctor, tflings init and tflings watch.

Exercises that use the AWS provider need Docker and a one-time tflings doctor --prefetch (about 250 MB); tflings aws up starts the local AWS emulator (Floci).