From f8ef3aef8cec7471ee045ce1d56741280b59db92 Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Tue, 16 Jan 2024 18:01:16 +0100
Subject: [PATCH] feat: kb article for opentofu

---
 knowledge base/opentofu.md  | 109 ++++++++++++++++++++++++++++++++++++
 knowledge base/terraform.md |  10 +++-
 2 files changed, 116 insertions(+), 3 deletions(-)
 create mode 100644 knowledge base/opentofu.md

diff --git a/knowledge base/opentofu.md b/knowledge base/opentofu.md
new file mode 100644
index 0000000..e6fa063
--- /dev/null
+++ b/knowledge base/opentofu.md	
@@ -0,0 +1,109 @@
+# OpenTofu
+
+Open-source and community-driven fork of [Terraform] managed by the Linux Foundation.
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
+## TL;DR
+
+```sh
+# Installation.
+brew install 'opentofu'
+
+# Manage autocompletion.
+# Only supports BASH and ZSH.
+tofu -install-autocomplete
+tofu -uninstall-autocomplete
+
+# Initialization.
+tofu init
+tofu init -reconfigure
+tofu init -backend=false
+
+# Validate files.
+tofu validate
+tofu validate -json -no-color
+
+# Show what would be done.
+tofu plan
+tofu plan -state 'path/to/file.tfstate' -var-file 'path/to/var.tfvars'
+tofu plan -out 'path/to/file.tfstate' -parallelism '50'
+
+# Make the changes.
+tofu apply
+tofu apply -auto-approve -backup -parallelism '25' 'path/to/plan.tfstate'
+tofu -chdir='envs/prod' apply …
+
+# Destroy everything.
+# `destroy` is an alias of `apply -destroy` and is being deprecated.
+tofu destroy
+tofu apply -destroy
+
+# Unlock a state file.
+tofu force-unlock 'lock_id'
+
+# Format files.
+tofu fmt
+tofu fmt -check -diff -recursive
+
+# Show outputs.
+tofu output 'team_tokens'
+
+# List registered resource.
+tofu state list
+
+# Show registered resources' details.
+tofu state show 'packet_device.worker'
+tofu state show 'packet_device.worker["example"]'
+tofu state show 'module.foo.packet_device.worker'
+
+# Remove registered resources from states.
+tofu state rm 'oci_core_instance.ampere'
+tofu state -state 'path/to/file.tfstate' \
+  'module.foo.packet_device.worker' 'tfe_team.robots[1]'
+
+# Remove all resources from the current state.
+tofu state list | xargs tofu state rm
+
+# Import existing resources into the state.
+tofu import 'oci_core_instance.this' 'ocid1.instance.oc1…'
+tofu import 'tfe_team.robots[4]' 'team-KV54…'
+tofu import 'module.app42.google_sql_user.teams["secops"]' 'fizzybull/…'
+
+# Show all the existing resources.
+tofu show
+tofu show -json
+
+# Create a dependency graph.
+# Requires `dot` from 'graphviz' for image generation.
+tofu graph
+tofu graph | dot -Tsvg > 'graph.svg'
+
+# Recursively update all modules.
+# `get` is being deprecated in favour of `init`
+tofu get -update -no-color
+
+# Do stuff in the console in a non-interactive way.
+echo 'split(",", "foo,bar,baz")' | tofu console
+```
+
+## Further readings
+
+- [Website]
+- [Documentation]
+- [Terraform]
+
+<!--
+  References
+  -->
+
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Knowledge base -->
+[terraform]: terraform.md
+
+<!-- Upstream -->
+[documentation]: https://opentofu.org/docs/
+[website]: https://opentofu.org/
diff --git a/knowledge base/terraform.md b/knowledge base/terraform.md
index 0ab44bc..2d50399 100644
--- a/knowledge base/terraform.md	
+++ b/knowledge base/terraform.md	
@@ -288,6 +288,7 @@ eval "export $(sed -E 's/([[:graph:]]+)[[:blank:]]*=[[:blank:]]*([[:graph:]]+)/T
 - [References to Named Values]
 - [Environment Variables]
 - [Forcing Re-creation of Resources]
+- [OpenTofu]
 
 ## Sources
 
@@ -301,6 +302,12 @@ All the references in the [further readings] section, plus the following:
   References
   -->
 
+<!-- In-article sections -->
+[further readings]: #further-readings
+
+<!-- Knowledge base -->
+[opentofu]: opentofu.md
+
 <!-- Upstream -->
 [cli documentation]: https://www.terraform.io/docs/cli/
 [environment variables]: https://www.terraform.io/cli/config/environment-variables
@@ -310,9 +317,6 @@ All the references in the [further readings] section, plus the following:
 [version constraints]: https://www.terraform.io/language/expressions/version-constraints
 [website]: https://www.terraform.io
 
-<!-- In-article sections -->
-[further readings]: #further-readings
-
 <!-- Others -->
 [azure provider]: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs
 [conditional creation of a resource based on a variable in .tfvars]: https://stackoverflow.com/questions/60231309/terraform-conditional-creation-of-a-resource-based-on-a-variable-in-tfvars