Skip to main content

Pre-Installation Setup

Before deploying the MLAngles LLMOps Platform, ensure your local system has the required tools installed and configured. This guide covers installing and configuring Terraform and the AWS CLI (v2), plus verification and common troubleshooting steps.

Required Tools and Versions​

ToolMinimum VersionRecommended VersionPurpose
Terraform1.5.01.6.x or latest stableInfrastructure-as-code provisioning
AWS CLI2.13.02.15.x or latestAWS service interaction and authentication

Installation Instructions​

1. Installing Terraform​

For Linux/macOS (example using version 1.6.6 — replace with desired version):

# Download and install Terraform (replace VERSION as needed)
wget https://releases.hashicorp.com/terraform/1.6.6/terraform_1.6.6_linux_amd64.zip
unzip terraform_1.6.6_linux_amd64.zip
sudo mv terraform /usr/local/bin/
rm terraform_1.6.6_linux_amd64.zip

# Verify installation
terraform --version

For Windows:

  1. Download the appropriate version from Terraform Downloads: https://www.terraform.io/downloads
  2. Extract the ZIP file to a directory (e.g., C:\terraform)
  3. Add the directory to your PATH
  4. Verify: terraform --version

Using package managers:

macOS (Homebrew)

brew tap hashicorp/tap
brew install hashicorp/tap/terraform

Ubuntu/Debian

sudo apt-get update && sudo apt-get install -y gnupg software-properties-common
wget -O- https://apt.releases.hashicorp.com/gpg | gpg --dearmor | sudo tee /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install -y terraform

2. Installing AWS CLI v2​

For Linux (x86_64 example):

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
rm -rf awscliv2.zip aws

# Verify installation
aws --version

For macOS:

Official installer:

curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
sudo installer -pkg AWSCLIV2.pkg -target /
rm AWSCLIV2.pkg

# Verify installation
aws --version

Or via Homebrew:

brew install awscli
aws --version

For Windows:

  1. Download the MSI installer from: https://aws.amazon.com/cli/
  2. Run the MSI and follow the installer wizard
  3. Verify: aws --version

Configuration​

AWS CLI Configuration​

Run the interactive configuration:

aws configure

You will be prompted for:

  • AWS Access Key ID
  • AWS Secret Access Key
  • Default region name (e.g., us-east-1)
  • Default output format (json recommended)

Alternatively, set environment variables:

export AWS_ACCESS_KEY_ID="your-access-key-id"
export AWS_SECRET_ACCESS_KEY="your-secret-access-key"
export AWS_DEFAULT_REGION="us-east-1"

Terraform Initialization​

Initialize and validate Terraform in your project directory:

# Navigate to your Terraform configuration directory
cd /path/to/terraform/configs

# Initialize Terraform (downloads providers)
terraform init

# Validate configuration files
terraform validate

# Review planned infrastructure changes
terraform plan

Verification Checklist​

Before proceeding with deployment, verify:

  • Terraform version is 1.5.0 or higher: 
    terraform --version
  • AWS CLI version is 2.13.0 or higher: 
    aws --version
  • AWS credentials are valid: 
    aws sts get-caller-identity
  • Terraform can authenticate with AWS (terraform init completes successfully)
  • Required AWS permissions are granted to your IAM user/role
  • Network connectivity to AWS services is established from your environment

Troubleshooting Common Issues​

IssueSolution
"terraform: command not found"Ensure Terraform binary is in your PATH (move to /usr/local/bin or add install dir to PATH)
"Unable to locate credentials"Run aws configure or set the AWS environment variables
"Invalid AWS credentials"Verify that the access keys are active in the AWS IAM console
"Permission denied" errorsCheck IAM policies attached to your user/role and required AWS permissions
TLS/GPG / apt repository errors on UbuntuEnsure system time is correct and the HashiCorp GPG key import succeeded

With Terraform and AWS CLI installed and configured, you are ready to proceed with the MLAngles LLMOps