Skip to content

Installation📜

This section provides guidance for installing Big Bang in various environments. Whether you’re setting up a new cluster or migrating from an existing deployment, these documents will guide you through the installation process and help you avoid common pitfalls.

What You’ll Find Here📜

The installation documentation covers the essential aspects of deploying Big Bang:

  • Prerequisites: Cluster requirements, infrastructure setup, and dependency verification
  • Installation Methods: Step-by-step installation procedures for different environments
  • Configuration: Essential configuration options and customization guidance
  • Validation: Post-installation verification and health checks

Installation Overview📜

Big Bang uses GitOps principles with Flux to deploy and manage Kubernetes applications. The installation process typically involves:

  1. Cluster Preparation: Ensuring your Kubernetes cluster meets Big Bang requirements
  2. Flux Installation: Setting up the GitOps engine that manages deployments
  3. Big Bang Deployment: Configuring and deploying the Big Bang umbrella chart
  4. Package Configuration: Customizing individual packages for your environment
  5. Validation: Verifying successful deployment and functionality

Quick Start📜

For a basic installation:

  1. Verify cluster meets prerequisites
  2. Install Flux controllers
  3. Deploy Big Bang with your configuration
  4. Validate installation using the health checks

Prerequisites📜

Before installing Big Bang, ensure your environment meets these requirements:

  • Kubernetes Version: Compatible Kubernetes cluster (see compatibility matrix)
  • Node Resources: Sufficient CPU, memory, and storage capacity
  • Network Access: Connectivity to required registries and repositories
  • Storage Classes: Available persistent storage for applications
  • Load Balancer: External load balancer capability (cloud or on-premises)

See the detailed prerequisites guide for more information.

Common Installation Scenarios📜

Big Bang supports various deployment patterns:

  • Cloud Deployments: AWS EKS, Azure AKS, Google GKE
  • On-Premises: Self-managed Kubernetes clusters
  • Edge Deployments: Resource-constrained environments
  • Air-Gapped: Disconnected environments with registry mirrors

When Installation Problems Occur📜

Installation issues can manifest at different stages of the deployment process. Our troubleshooting documentation is organized to help you quickly identify and resolve problems based on the symptoms you’re experiencing:

Diagnostic Approach📜

When facing installation problems, follow this systematic approach:

  1. Start with Installation Troubleshooting for immediate deployment failures
  2. Move to Package Troubleshooting for individual component issues
  3. Check Networking Troubleshooting for connectivity problems
  4. Use Performance Troubleshooting for resource-related issues

Each guide provides both quick diagnostic commands and detailed remediation steps, allowing you to either quickly resolve common issues or dive deep into complex problems.

Post-Installation Operations📜

After successful installation, transition to operational procedures:

  1. Set Up Monitoring: Configure observability using Operations Monitoring
  2. Plan Backups: Implement backup strategies from Operations Backup & Restore
  3. Review Upgrades: Understand upgrade procedures in Operations Upgrades
  4. Ongoing Maintenance: Follow guidance in Operations Maintenance

Getting Help📜

If troubleshooting guides don’t resolve your issue:

  • Gather diagnostic information using commands from the troubleshooting guides
  • Check Big Bang GitLab repository for similar reported issues
  • Engage with the Big Bang community with detailed problem descriptions
  • Consider escalating to platform support with collected diagnostic data

The troubleshooting documentation is designed to provide both immediate solutions and the diagnostic information needed for effective support requests.