aboutsummaryrefslogtreecommitdiffstats
path: root/opentofu/README.md
diff options
context:
space:
mode:
authorclyhtsuriva <aimeric@adjutor.xyz>2025-02-02 19:51:54 +0100
committerclyhtsuriva <aimeric@adjutor.xyz>2025-02-02 19:51:54 +0100
commite1688aa9f2c3cc09f05c007c921bc24ed566e8e8 (patch)
treee02fcfe7ed41855cf71c90f74aeec5e1630886ba /opentofu/README.md
parent93f98bb6051fa702458f6853873a4443a401ba87 (diff)
downloadhomelab-iac-e1688aa9f2c3cc09f05c007c921bc24ed566e8e8.tar.gz
homelab-iac-e1688aa9f2c3cc09f05c007c921bc24ed566e8e8.tar.bz2
homelab-iac-e1688aa9f2c3cc09f05c007c921bc24ed566e8e8.zip
opentofu : Moving version definition from provider.tf to versions.tf
Diffstat (limited to '')
-rw-r--r--opentofu/README.md44
1 files changed, 32 insertions, 12 deletions
diff --git a/opentofu/README.md b/opentofu/README.md
index 8521989..1bf6e55 100644
--- a/opentofu/README.md
+++ b/opentofu/README.md
@@ -1,14 +1,34 @@
# OpenTofu Infrastructure Provisioning
-This folder contains OpenTofu configurations and modules for provisioning infrastructure in my homelab environment.
-
-## Structure
-
-- **`README.md`**: Project overview.
-- **`examples/`**: Sample configurations demonstrating module usage.
-- **`main.tf`**: Primary entry point for the OpenTofu configuration.
-- **`modules/`**: Reusable OpenTofu modules for provisioning infrastructure.
-- **`outputs.tf`**: Definitions of outputs from the configuration.
-- **`variables.tf`**: Definitions of input variables for the configuration.
-- **`versions.tf`**: Specifies required provider versions.
-- to complete ..
+This repository contains OpenTofu configurations and modules for automating infrastructure provisioning in my homelab environment.
+
+## **Overview**
+OpenTofu is used to define, manage, and provision infrastructure as code (IaC). This setup provides a modular approach for creating and managing infrastructure efficiently.
+
+## **Project Structure**
+- **`README.md`** – Project overview and documentation.
+- **`examples/`** – Sample configurations demonstrating how to use modules in different scenarios.
+- **`main.tf`** – Primary OpenTofu configuration file, orchestrating resource provisioning.
+- **`modules/`** – Reusable OpenTofu modules for provisioning infrastructure components.
+- **`outputs.tf`** – Definitions of outputs to expose key resource attributes.
+- **`provider.tf`** – Configuration for OpenTofu providers, such as Proxmox.
+- **`terraform.tfvars`** – Variable values for customizing deployments.
+- **`variables.tf`** – Definitions of input variables used across the configuration.
+- **`versions.tf`** – Specifies required OpenTofu and provider versions to maintain compatibility.
+
+## **Credentials**
+
+There needs to be a file with credentials in them.
+With this kind of content :
+
+```tf
+proxmox_api_url = "https://<pve ip/fqdn>:<port>/api2/json"
+proxmox_api_token_id = "<id>"
+proxmox_api_token_secret = "<token>"
+```
+
+Refer to this :
+
+- https://opentofu.org/docs/language/values/variables/#variable-definition-precedence
+- https://registry.terraform.io/providers/Telmate/proxmox/latest/docs
+