Terraform: Implement suggestions by CodeRabbit

Author: amotl

docs/integrate/terraform/tutorial.md

@@ -12,6 +12,15 @@ Terraform eliminates manual console steps to create resources.
 Instead, Terraform uses a configuration language that describes resources
 with parameters.
 
+## Prerequisites
+
+- Terraform CLI >= 1.5
+- An AWS account with credentials configured (AWS SSO/profile or env vars)
+  and a default region or the provider block shown below
+- Existing VPC and subnet IDs in the chosen region (and their AZ mapping)
+- An EC2 key pair name to use for SSH
+- jq installed (used to pretty‑print JSON output)
+
 ## Example
 
 This example deploys a 3‑node cluster across multiple Availability Zones on AWS.
@@ -28,6 +37,9 @@ Then, specify variables for the target environment.
 terraform {
   required_version = ">= 1.5.0"
 }
+provider "aws" {
+  region = "eu-central-1"
+}
 module "cratedb_cluster" {
   source = "https://github.com/crate/cratedb-terraform.git//aws"
 
@@ -70,6 +82,7 @@ module "cratedb_cluster" {
   ssh_keypair = "cratedb_cluster"
 
   # Enable SSH access to EC2 instances
+  # Tip: restrict SSH to your IP/CIDRs if supported by the module.
   ssh_access = true
 }
 
@@ -86,7 +99,7 @@ Once you adjust all variables, initialize Terraform by installing the needed plu
 ```bash
 $ terraform init   
 Initializing modules...
-Downloading https://github.com/crate/cratedb-terraform.git for cratedb_cluster...
+Downloading git::https://github.com/crate/cratedb-terraform.git for cratedb_cluster...
 - cratedb_cluster in .terraform/modules/cratedb_cluster/aws
 
 Initializing the backend...
@@ -263,7 +276,8 @@ cratedb = <sensitive>
 The `cratedb` output element contains the connection details (URL and
 credentials). Because it’s marked sensitive, human‑readable output is
 redacted. Use the `terraform output` command to display it, adding
-`-json` to print the full value and pipe it to `jq`:
+`-json` to print the full value and pipe it to `jq` (ensure `jq` is
+installed).
 ```bash
 terraform output -json cratedb | jq
 ```