Repository navigation
Releases
v0.10.0
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
versionsworkflow (andscripts/check-versions.sh) that reports when a newer Floci, AWS provider or Terraform exists than the pinned ones. It only reports. SECURITY.mdsays 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 initand a module it cannot install, plan mode) andworkflow8(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 sandboxprints the folder and the sealed environment,tflings sandbox <terraform arguments>runs Terraform there (its.tffiles get the same safety check as an exercise's),tflings sandbox --resetstarts over in a new account.aws upandwatchdo 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 theawsCI job runs its tests with-timeout 60m. - Two exercises folders on one machine no longer share state.
tflings initnow 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 aresetin one folder cannot delete the other's saved state. Folders made by an older version have no salt and keep working exactly as before. runnow 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 refusesassume_rolewritten as an argument of the s3 backend.tflings tfrefuses-backend-configvalues that set credentials, a role or an endpoint other than Floci (or name a file that is not one of the exercise's own),-varvalues that give an endpoint another URL, and a-var-fileoutside the exercise's folder. tflings aws upandwatchnow say that they are about to empty Floci before they do it, not after.
Fixed
-
workflow6could not be done as its README says: everytflings tfcall cleared the exercise's scratch folder, so the saved plan oftflings tf workflow6 plan -out=tfplanwas gone beforeshowandapply 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 waytflings tfdoes, so a mistake like this is caught. -
Two tflings processes (a
watchin one terminal,tflings tforrunin 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,resetwaits 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;updatealso refreshesinfo.tomlentries).
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
Fixed
tflings updatenow also replaces theinfo.tomlentry (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 andtflings progresscounted exercises under the wrong objective.info.tomlholds no progress (that is in.tflings.json), and the earlier file is kept asinfo.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
Added
- Two demo recordings in the README (
misc/demo-tui.gifandmisc/demo-exam.gif), made with vhs fromdemo-tui.tapeanddemo-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 progressprinted 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
Added
- The
cliexercise mode and ten exercises (cli1tocli10): you write one Terraform command inanswer.shfor 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
Added
tflings doctor --install-terraform: downloads Terraform from releases.hashicorp.com into tflings's own folder (nothing system-wide), with HashiCorp'shc-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.3or a constraint chooses another), and tflings uses it before anyterraformon PATH.doctornow 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(countagainstfor_each: removing an item must not shift the others) andconditions5(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
Added
tflings version(it only worked astflings --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_eachplans, what a failingvalidationdoes, what-/+in a plan will do, variable precedence, animportblock, 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 totflings --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
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
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 examnow keeps its results (exam-history.jsonlin tflings's home folder), andexam --weakasks 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
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
initfinds no AWS provider in the cache, the message says to runtflings 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).