101 lines
2.9 KiB
Markdown
101 lines
2.9 KiB
Markdown
|
# 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
|