Installation

This section guides you through installing Bindy in your Kubernetes cluster.

Overview

Installing Bindy involves these steps:

1. Prerequisites - Ensure your environment meets the requirements
2. Install CRDs - Deploy Custom Resource Definitions
3. Create RBAC - Set up service accounts and permissions
4. Deploy Controller - Install the Bindy controller
5. Create BIND9 Instances - Deploy your DNS servers

Installation Methods

Standard Installation

The standard installation uses kubectl to apply YAML manifests:

# Create namespace
kubectl create namespace dns-system

# Install CRDs (use kubectl create to avoid annotation size limits)
kubectl create -f https://raw.githubusercontent.com/firestoned/bindy/main/deploy/crds/

# Install RBAC
kubectl apply -f https://raw.githubusercontent.com/firestoned/bindy/main/deploy/rbac/

# Deploy controller
kubectl apply -f https://raw.githubusercontent.com/firestoned/bindy/main/deploy/controller/deployment.yaml

Development Installation

For development or testing, you can build and deploy from source:

# Clone the repository
git clone https://github.com/firestoned/bindy.git
cd bindy

# Build the controller
cargo build --release

# Build Docker image
docker build -t bindy:dev .

# Deploy with your custom image
kubectl apply -f deploy/

Verification

After installation, verify that all components are running:

# Check CRDs are installed
kubectl get crd | grep bindy.firestoned.io

# Check controller is running
kubectl get pods -n dns-system

# Check controller logs
kubectl logs -n dns-system -l app=bind9-controller

You should see output similar to:

NAME                                READY   STATUS    RESTARTS   AGE
bind9-controller-7d4b8c4f9b-x7k2m   1/1     Running   0          1m

Next Steps

• Quick Start - Deploy your first DNS zone
• Prerequisites - Detailed system requirements
• Installing CRDs - Understanding the Custom Resources
• Deploying the Controller - Controller configuration options