feat: [#24] add provision command with cloud-init monitoring

- Add new 'provision' command to create VMs using OpenTofu and libvirt
- Implement cloud-init progress monitoring via SSH password authentication
- Add SSH key verification after cloud-init completion
- Create comprehensive cloud-init configuration for Ubuntu 24.04 LTS
- Install Docker, security tools, and system optimizations via cloud-init
- Add template system for OpenTofu and cloud-init configurations
- Use testing SSH key (testing_rsa) instead of personal SSH keys
- Remove custom help command to use App::Cmd's superior built-in help
- Add comprehensive test suite for provision command functionality
- All values currently hardcoded for single local environment

The provision command:
1. Copies templates to build/tofu directory
2. Initializes and applies OpenTofu configuration
3. Waits for VM IP assignment
4. Monitors cloud-init progress using password auth (torrust/torrust123)
5. Verifies SSH key authentication works correctly
6. Provides clear feedback throughout the process

Author: josecelano

.gitignore

@@ -3,6 +3,9 @@ local/
 .carmel/
 cpanfile.snapshot
 
+# Build artifacts and working directories
+build/
+
 # Editor temporary files
 *.swp
 *.swo

README.md

@@ -49,6 +49,66 @@ Run the application:
 carmel exec -- ./bin/torrust-deploy help
 ```
 
+## Commands
+
+### provision
+
+Provision a Torrust Tracker virtual machine using OpenTofu with libvirt provider:
+
+```bash
+carmel exec -- ./bin/torrust-deploy provision
+```
+
+This command will:
+
+1. Copy OpenTofu configuration templates from `templates/provision/` directory
+2. Initialize OpenTofu if needed
+3. Create a minimal Ubuntu 22.04 LTS VM with hardcoded configuration
+4. Start the VM and make it ready for use
+
+#### Requirements
+
+Before using the provision command, ensure you have:
+
+- **OpenTofu** installed ([Download from opentofu.org](https://opentofu.org/docs/intro/install/))
+- **libvirt/KVM** installed and running:
+
+  ```bash
+  sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils
+  sudo systemctl enable libvirtd
+  sudo systemctl start libvirtd
+  sudo usermod -aG libvirt $USER
+  ```
+
+- **Default libvirt storage pool** configured:
+
+  ```bash
+  virsh pool-list --all
+  # If 'default' pool doesn't exist, create it:
+  sudo virsh pool-define-as default dir - - - - "/var/lib/libvirt/images"
+  sudo virsh pool-build default
+  sudo virsh pool-start default
+  sudo virsh pool-autostart default
+  ```
+
+#### VM Configuration
+
+The VM is created with:
+
+- **OS:** Ubuntu 22.04 LTS (Cloud Image)
+- **CPU:** 2 vCPUs
+- **Memory:** 2GB RAM
+- **Disk:** 10GB
+- **Network:** NAT with DHCP (192.168.122.0/24)
+- **User:** `torrust` (with sudo access)
+- **SSH:** Enabled (requires SSH key configuration in cloud-init.yml)
+
+After provisioning, you can find the VM IP with:
+
+```bash
+cd build/tofu && tofu output
+```
+
 ## Testing
 
 Run the test suite:

bin/torrust-deploy

@@ -1,4 +1,4 @@
-#!/usr/bin/env perl          # Shebang line - tells the system to use perl to execute this script
+#!/usr/bin/env perl
 
 # Set up Perl environment with safety features
 use strict;                  # Enable strict mode - catches common programming errors like undeclared variables

lib/TorrustDeploy/App.pm

@@ -9,6 +9,15 @@ use v5.20;
 # becomes a command (e.g., help.pm -> "help" command, packer.pm -> "packer" command)
 use App::Cmd::Setup -app;
 
+sub usage_desc { "%c %o" }
+
+sub global_opt_spec {
+  return (
+    [ "help|h",    "show help" ],
+    [ "version|v", "show version" ],
+  );
+}
+
 1;
 
 __END__