First Deployment

This guide walks you through deploying your first infrastructure using the Provisioning Platform.

Overview

In this chapter, you’ll:

Configure a simple infrastructure
Create your first server
Install a task service (Kubernetes)
Verify the deployment

Estimated time: 10-15 minutes

Step 1: Configure Infrastructure

Create a basic infrastructure configuration:

# Generate infrastructure template
provisioning generate infra --new my-infra

# This creates: workspace/infra/my-infra/
# - config.toml (infrastructure settings)
# - settings.k (KCL configuration)

Step 2: Edit Configuration

Edit the generated configuration:

# Edit with your preferred editor
$EDITOR workspace/infra/my-infra/settings.k

Example configuration:

import provisioning.settings as cfg

# Infrastructure settings
infra_settings = cfg.InfraSettings {
    name = "my-infra"
    provider = "local"  # Start with local provider
    environment = "development"
}

# Server configuration
servers = [
    {
        hostname = "dev-server-01"
        cores = 2
        memory = 4096  # MB
        disk = 50  # GB
    }
]

Step 3: Create Server (Check Mode)

First, run in check mode to see what would happen:

# Check mode - no actual changes
provisioning server create --infra my-infra --check

# Expected output:
# ✓ Validation passed
# ⚠ Check mode: No changes will be made
# 
# Would create:
# - Server: dev-server-01 (2 cores, 4GB RAM, 50GB disk)

Step 4: Create Server (Real)

If check mode looks good, create the server:

# Create server
provisioning server create --infra my-infra

# Expected output:
# ✓ Creating server: dev-server-01
# ✓ Server created successfully
# ✓ IP Address: 192.168.1.100
# ✓ SSH access: ssh user@192.168.1.100

Step 5: Verify Server

Check server status:

# List all servers
provisioning server list

# Get detailed server info
provisioning server info dev-server-01

# SSH to server (optional)
provisioning server ssh dev-server-01

Step 6: Install Kubernetes (Check Mode)

Install a task service on the server:

# Check mode first
provisioning taskserv create kubernetes --infra my-infra --check

# Expected output:
# ✓ Validation passed
# ⚠ Check mode: No changes will be made
#
# Would install:
# - Kubernetes v1.28.0
# - Required dependencies: containerd, etcd
# - On servers: dev-server-01

Step 7: Install Kubernetes (Real)

Proceed with installation:

# Install Kubernetes
provisioning taskserv create kubernetes --infra my-infra --wait

# This will:
# 1. Check dependencies
# 2. Install containerd
# 3. Install etcd
# 4. Install Kubernetes
# 5. Configure and start services

# Monitor progress
provisioning workflow monitor <task-id>

Step 8: Verify Installation

Check that Kubernetes is running:

# List installed task services
provisioning taskserv list --infra my-infra

# Check Kubernetes status
provisioning server ssh dev-server-01
kubectl get nodes  # On the server
exit

# Or remotely
provisioning server exec dev-server-01 -- kubectl get nodes

Common Deployment Patterns

Pattern 1: Multiple Servers

Create multiple servers at once:

servers = [
    {hostname = "web-01", cores = 2, memory = 4096},
    {hostname = "web-02", cores = 2, memory = 4096},
    {hostname = "db-01", cores = 4, memory = 8192}
]

provisioning server create --infra my-infra --servers web-01,web-02,db-01

Pattern 2: Server with Multiple Task Services

Install multiple services on one server:

provisioning taskserv create kubernetes,cilium,postgres --infra my-infra --servers web-01

Pattern 3: Complete Cluster

Deploy a complete cluster configuration:

provisioning cluster create buildkit --infra my-infra

Deployment Workflow

The typical deployment workflow:

# 1. Initialize workspace
provisioning workspace init production

# 2. Generate infrastructure
provisioning generate infra --new prod-infra

# 3. Configure (edit settings.k)
$EDITOR workspace/infra/prod-infra/settings.k

# 4. Validate configuration
provisioning validate config --infra prod-infra

# 5. Create servers (check mode)
provisioning server create --infra prod-infra --check

# 6. Create servers (real)
provisioning server create --infra prod-infra

# 7. Install task services
provisioning taskserv create kubernetes --infra prod-infra --wait

# 8. Deploy cluster (if needed)
provisioning cluster create my-cluster --infra prod-infra

# 9. Verify
provisioning server list
provisioning taskserv list

Troubleshooting

Server Creation Fails

# Check logs
provisioning server logs dev-server-01

# Try with debug mode
provisioning --debug server create --infra my-infra

Task Service Installation Fails

# Check task service logs
provisioning taskserv logs kubernetes

# Retry installation
provisioning taskserv create kubernetes --infra my-infra --force

SSH Connection Issues

# Verify SSH key
ls -la ~/.ssh/

# Test SSH manually
ssh -v user@<server-ip>

# Use provisioning SSH helper
provisioning server ssh dev-server-01 --debug

Next Steps

Now that you’ve completed your first deployment: → Verification - Verify your deployment is working correctly

Provisioning Platform Documentation