provisioning/docs/src/guides

User Guides

Step-by-step guides for common workflows, best practices, and advanced operational scenarios using the Provisioning platform.

Overview

This section provides practical guides for:

• Getting started - From-scratch deployment and initial setup
• Organization - Workspace management and multi-cloud strategies
• Automation - Advanced workflow orchestration and GitOps
• Operations - Disaster recovery, secrets rotation, cost governance
• Integration - Hybrid cloud setup, zero-trust networks, legacy migration
• Scaling - Multi-tenant environments, high availability, performance optimization

Each guide includes step-by-step instructions, configuration examples, troubleshooting, and best practices.

Getting Started

I'm completely new to Provisioning

Start with: From Scratch Guide - Complete walkthrough from installation through first deployment with explanations and examples.

I want to organize infrastructure

Read: Workspace Management - Best practices for organizing workspaces, isolation, and multi-team setup.

Core Workflow Guides

• From Scratch Guide - Installation, workspace creation, first deployment step-by-step

• Workspace Management - Organization best practices, multi-tenancy, collaboration, customization, schemas

• Multi-Cloud Deployment - Deploy across AWS, UpCloud, Hetzner with abstraction and failover

• Advanced Workflow Orchestration - DAG scheduling, parallel execution, logic, error handling, multi-environment

Advanced Operational Guides

• Hybrid Cloud Deployment - Hub-and-spoke architecture connecting on-premise and cloud infrastructure

• GitOps Infrastructure Deployment

  • GitHub Actions, reconciliation, drift detection, audit trails

• Advanced Networking - Load balancing, service mesh, DNS, zero-trust architecture, network policies

• Secrets Rotation Strategy - Password, API key, certificate, encryption key rotation with zero downtime

Enterprise Features

• Custom Extensions - Custom providers, task services, detectors, Nushell plugins

• Disaster Recovery Guide - DR planning, backup, failover procedures, testing, recovery time optimization

• Legacy System Migration - Zero-downtime migration with gradual traffic cutover and validation

Quick Navigation

I need to

Deploy infrastructure quickly → From Scratch Guide

Organize multiple workspaces → Workspace Management

Deploy across clouds → Multi-Cloud Deployment

Build complex workflows → Advanced Workflow Orchestration

Set up GitOps → GitOps Infrastructure Deployment

Handle disasters → Disaster Recovery Guide

Rotate secrets safely → Secrets Rotation Strategy

Connect on-premise to cloud → Hybrid Cloud Deployment

Design secure networks → Advanced Networking

Build custom extensions → Custom Extensions

Migrate legacy systems → Legacy System Migration

Guide Structure

Each guide follows this pattern:

1. Overview - What you'll accomplish
2. Prerequisites - What you need before starting
3. Architecture - Visual diagram of the solution
4. Step-by-Step - Detailed instructions with examples
5. Configuration - Full Nickel configuration examples
6. Verification - How to validate the deployment
7. Troubleshooting - Common issues and solutions
8. Next Steps - How to extend or customize
9. Best Practices - Lessons learned and recommendations

Learning Paths

Path 1: I'm new to Provisioning (Day 1)

1. From Scratch Guide - Basic setup
2. Workspace Management - Organization
3. Multi-Cloud Deployment - Multi-cloud

Path 2: I need production-ready setup (Week 1)

1. Workspace Management - Organization
2. GitOps Infrastructure Deployment - Automation
3. Disaster Recovery Guide - Resilience
4. Secrets Rotation Strategy - Security
5. Advanced Networking - Enterprise networking

Path 3: I'm migrating from legacy (Month-long project)

1. Legacy System Migration - Migration plan
2. Advanced Workflow Orchestration - Complex deployments
3. Hybrid Cloud Deployment - Coexistence
4. GitOps Infrastructure Deployment - Continuous deployment
5. Disaster Recovery Guide - Failover strategies

Path 4: I'm building a platform (Team project)

1. Custom Extensions - Build extensions
2. Workspace Management - Multi-tenant setup
3. Advanced Workflow Orchestration - Complex workflows
4. GitOps Infrastructure Deployment - CD/GitOps
5. Secrets Rotation Strategy - Security at scale

Related Documentation

• Getting Started → See provisioning/docs/src/getting-started/
• Examples → See provisioning/docs/src/examples/
• Features → See provisioning/docs/src/features/
• Operations → See provisioning/docs/src/operations/
• Development → See provisioning/docs/src/development/