Installation Guide

Complete deployment instructions for your ItGix platform

Estimated Time: 30-45 minutesDifficulty: Intermediate

Deployment Overview

What you’ll accomplish in this guide

Infrastructure Setup

AWS VPC and networking configuration
EKS cluster deployment with auto-scaling
Database and Redis setup
Security groups and IAM roles

Application Deployment

ArgoCD GitOps configuration
Container registry setup
DNS and SSL certificate management
Monitoring and logging integration

Prerequisites Check

Verify your system has the required tools installed

0/3 Required

AWS CLI

Required

Version 2.0 or later with configured credentials

aws --version

Terraform

Required

Version 1.5.0 or later for infrastructure management

terraform --version

kubectl

Required

Kubernetes command-line tool

kubectl version --client

Docker

For building and managing container images

docker --version

ArgoCD CLI

For GitOps deployment management

argocd version --client

Helm

Package manager for Kubernetes

helm version

Missing Required Tools

Please install all required tools before proceeding with the installation. Click the ”Install” links above for download instructions.

Step-by-Step Installation

Follow these steps to deploy your ItGix platform

Environment Setup

Configure your local environment and AWS credentials

5 minutes

Configure AWS credentials

aws configure

Enter your AWS Access Key ID, Secret Access Key, and default region

Verify AWS configuration

aws sts get-caller-identity

Should return your AWS account information

Set environment variables

export AWS_REGION=us-east-1
export PROJECT_NAME=my-awesome-project
export ENVIRONMENT=production

Replace with your actual values from the configuration

Download and Extract Files

Get your configuration files and extract the Terraform package

2 minutes

Initialize Terraform

Set up Terraform workspace and validate configuration

3 minutes

Deploy Infrastructure

Create AWS resources including VPC, EKS cluster, and databases

15-20 minutes

Configure Kubernetes

Set up kubectl and verify cluster access

3 minutes

Deploy ArgoCD

Set up GitOps deployment with ArgoCD

5 minutes

Troubleshooting Guide

Common issues and their solutions

AWS Permission Denied Errors

Issues with AWS credentials or insufficient permissions

Terraform State Lock Issues

State file is locked or corrupted

Cannot Connect to EKS Cluster

kubectl commands fail with connection errors

EKS Nodes Not Ready

Worker nodes are in NotReady state

Cannot Access ArgoCD UI

ArgoCD interface is not accessible

DNS Resolution Problems

Applications cannot resolve DNS names

Need Help?

Get support from our team and community

Documentation

Comprehensive guides and API references

Community

Join our Discord for community support

Enterprise Support

24/7 support for enterprise customers