# Deployment Documentation

**Last Updated**: 2025-01-27  
**Purpose**: Complete deployment guide index

## Overview

This directory contains comprehensive deployment guides for The Order platform, covering infrastructure setup, service deployment, and operational procedures.

## Quick Links

### Azure Deployment
- [Environment Setup](azure/ENVIRONMENT_SETUP.md) - Azure configuration and setup
- [Dotenv Configuration](azure/DOTENV_SETUP.md) - Using .env file for deployments
- [Sovereignty Landing Zone](azure/SOVEREIGNTY_LANDING_ZONE_DEPLOYMENT.md) - Multi-region deployment
- [CDN Setup](azure/cdn-setup.md) - Azure CDN configuration
- [Entra VerifiedID](azure/entra-verifiedid.md) - Entra VerifiedID setup

### Kubernetes Deployment
- [Kubernetes Guide](../../infra/k8s/README.md) - K8s deployment guide
- [Service Manifests](../../infra/k8s/base/) - Base Kubernetes manifests

### Infrastructure
- [Infrastructure Overview](../../infra/README.md) - Infrastructure documentation
- [Terraform Guide](../../infra/terraform/README.md) - Terraform documentation

## Deployment Guides by Scenario

### Initial Setup
1. [Azure Environment Setup](azure/ENVIRONMENT_SETUP.md)
2. [Dotenv Configuration](azure/DOTENV_SETUP.md)
3. [Infrastructure Deployment](../../infra/README.md)

### Multi-Region Deployment
1. [Sovereignty Landing Zone Deployment](azure/SOVEREIGNTY_LANDING_ZONE_DEPLOYMENT.md)
2. [Cloud for Sovereignty Architecture](../../docs/architecture/CLOUD_FOR_SOVEREIGNTY_LANDING_ZONE.md)

### Service Deployment
1. [Kubernetes Deployment](../../infra/k8s/README.md)
2. Service-specific READMEs in `services/*/README.md`

### Integration Setup
1. [Entra VerifiedID](azure/entra-verifiedid.md)
2. [CDN Configuration](azure/cdn-setup.md)
3. [Integration Guides](../integrations/)

## Deployment Workflows

### Complete Azure Deployment

```bash
# 1. Load environment
source infra/scripts/azure-load-env.sh

# 2. Validate configuration
./infra/scripts/azure-validate-current-env.sh

# 3. Deploy infrastructure
./infra/scripts/azure-deploy.sh

# 4. Deploy sovereignty landing zone
./infra/scripts/deploy-sovereignty-landing-zone.sh
```

### Kubernetes Deployment

```bash
# 1. Apply base configuration
kubectl apply -k infra/k8s/base

# 2. Apply environment overlay
kubectl apply -k infra/k8s/overlays/dev

# 3. Verify deployment
kubectl get pods -n the-order
```

## Documentation Structure

```
deployment/
├── README.md                    # This file
└── azure/                       # Azure-specific guides
    ├── ENVIRONMENT_SETUP.md
    ├── DOTENV_SETUP.md
    ├── SOVEREIGNTY_LANDING_ZONE_DEPLOYMENT.md
    ├── cdn-setup.md
    └── entra-verifiedid.md
```

## Related Documentation

- [Architecture Documentation](../architecture/)
- [Infrastructure Documentation](../../infra/)
- [Service Documentation](../../services/)
- [Integration Documentation](../integrations/)

---

**Last Updated**: 2025-01-27