# Multi-Region Landing Zones Guide **Comprehensive guide for multi-region landing zones in Phoenix for sovereign governments** This document provides detailed guidance on implementing multi-region landing zones for international and multi-national sovereign governments using Phoenix cloud services. --- ## Executive Summary Phoenix landing zones enable **sovereign cloud deployments per region/nation** for international and multi-national sovereign governments. Each landing zone provides complete regional autonomy while enabling coordinated governance across regions. **Key Capabilities:** - **Sovereign Cloud Per Region**: Complete regional control and data residency - **Multi-National Support**: Support for international governments with multiple nations - **Decentralized Governance**: Regional autonomy with coordinated governance - **Cross-Border Sovereignty**: Enables sovereignty across distributed regions - **Air-Gapped Support**: Support for air-gapped deployments per region --- ## I. Landing Zone Architecture ### Reference Architecture A Phoenix landing zone is a **sovereign cloud deployment per region/nation** that provides: 1. **Complete Regional Control**: All infrastructure and data under regional control 2. **Data Residency**: Hard enforcement of data residency requirements 3. **Compliance**: Regional compliance profiles and audit capabilities 4. **Network Isolation**: Network boundaries with controlled cross-region connectivity 5. **Identity Federation**: Federated identity with regional control ### Landing Zone Components ``` Landing Zone ├── Control Plane (Regional) │ ├── Commercial Plane │ ├── Tenancy Plane │ ├── Subscription Plane │ ├── Environment Plane │ └── Content & DevOps Plane ├── Infrastructure │ ├── Compute (Proxmox/Kubernetes) │ ├── Storage │ ├── Networking │ └── Security ├── Identity (Keycloak Realm) ├── Governance │ ├── Policies │ ├── Compliance │ └── Audit └── Connectivity ├── Cross-Region (if allowed) └── External (if allowed) ``` ### Landing Zone Types #### Type 1: Standard Sovereign Landing Zone **Characteristics:** - Complete regional control - Data residency enforcement - Cross-region connectivity (controlled) - Federated identity - Coordinated governance **Use Cases:** - Standard sovereign government deployments - Multi-national government coordination - Regional data residency requirements #### Type 2: Air-Gapped Landing Zone **Characteristics:** - Complete network isolation - No external connectivity - No cross-region connectivity - Local identity only - Local governance only **Use Cases:** - Classified government systems - Critical infrastructure - National security systems #### Type 3: Hybrid Landing Zone **Characteristics:** - Regional control with selective external connectivity - Data residency with controlled data sharing - Federated identity with regional control - Coordinated governance with regional autonomy **Use Cases:** - Government with public-facing services - Multi-national coordination with sovereignty - Regulated industries with external requirements --- ## II. Multi-Region Deployment Patterns ### Pattern 1: Single Region Sovereign **Architecture:** - One landing zone per region - Complete regional autonomy - No cross-region connectivity required - Independent governance **Use Case**: Single-nation sovereign government ``` Region A └── Landing Zone A ├── Tenant A ├── Subscription A └── Environment A (PROD) ``` **Characteristics:** - Complete regional control - Data residency in Region A only - Independent identity and governance - No cross-region dependencies ### Pattern 2: Multi-Region Sovereign **Architecture:** - Multiple landing zones (one per region) - Cross-region connectivity (controlled) - Federated identity - Coordinated governance **Use Case**: Multi-national sovereign government ``` Region A Region B Region C └── Landing Zone A └── Landing Zone B └── Landing Zone C ├── Tenant A ├── Tenant B ├── Tenant C ├── Subscription A ├── Subscription B ├── Subscription C └── Environment A └── Environment B └── Environment C (PROD) (PROD) (PROD) Cross-Region Connectivity (Controlled) Federated Identity Coordinated Governance ``` **Characteristics:** - Regional autonomy with coordination - Cross-region connectivity for coordination - Federated identity across regions - Coordinated governance policies ### Pattern 3: Air-Gapped Per Region **Architecture:** - Multiple landing zones (one per region) - No cross-region connectivity - Independent identity per region - Independent governance per region **Use Case**: Multi-national government with classified systems ``` Region A Region B Region C └── Landing Zone A └── Landing Zone B └── Landing Zone C (Air-Gapped) (Air-Gapped) (Air-Gapped) ├── Tenant A ├── Tenant B ├── Tenant C ├── Subscription A ├── Subscription B ├── Subscription C └── Environment A └── Environment B └── Environment C (AIR-GAPPED) (AIR-GAPPED) (AIR-GAPPED) No Cross-Region Connectivity Independent Identity Independent Governance ``` **Characteristics:** - Complete isolation per region - No cross-region connectivity - Independent identity and governance - Air-gapped deployment per region ### Pattern 4: Hub and Spoke **Architecture:** - Central landing zone (hub) for coordination - Regional landing zones (spokes) for sovereignty - Hub-to-spoke connectivity - Limited spoke-to-spoke connectivity **Use Case**: Multi-national government with central coordination ``` Hub Region └── Landing Zone Hub (Coordination) ├── Governance API ├── Event Bus └── Audit Log Spoke Region A Spoke Region B Spoke Region C └── Landing Zone A └── Landing Zone B └── Landing Zone C ├── Tenant A ├── Tenant B ├── Tenant C └── Subscription A └── Subscription B └── Subscription C Hub-to-Spoke Connectivity Limited Spoke-to-Spoke Connectivity Federated Identity via Hub Coordinated Governance via Hub ``` **Characteristics:** - Central coordination point - Regional autonomy in spokes - Hub-to-spoke connectivity - Coordinated governance via hub --- ## III. Sovereign Cloud Per Region/Nation ### Regional Sovereignty **Complete Regional Control:** - All infrastructure under regional control - All data under regional control - Regional identity and governance - Regional compliance and audit **Data Residency:** - Hard enforcement: Data cannot leave region - Soft enforcement: Data preferred in region, warnings if outside - Advisory: Recommendations for data placement **Compliance:** - Regional compliance profiles - Regional audit capabilities - Regional regulatory requirements ### Implementation #### Step 1: Create Landing Zone ```graphql mutation { createLandingZone(input: { name: "landing-zone-region-a" region: "region-a" sovereignCloud: true dataResidency: { requirement: REQUIRED enforcement: HARD } complianceProfile: { standards: [ISO_27001, SOC_2, FEDRAMP] } }) { id name region sovereignCloud } } ``` #### Step 2: Configure Regional Control Plane ```graphql mutation { configureControlPlane(landingZoneId: "landing-zone-id", input: { commercialPlane: { enabled: true regionalAutonomy: true } tenancyPlane: { enabled: true regionalIdentity: true } subscriptionPlane: { enabled: true regionalQuotas: true } environmentPlane: { enabled: true regionalIsolation: true } contentPlane: { enabled: true regionalContent: true } }) { id status } } ``` #### Step 3: Configure Data Residency ```graphql mutation { configureDataResidency(landingZoneId: "landing-zone-id", input: { requirement: REQUIRED enforcement: HARD allowedRegions: ["region-a"] prohibitedRegions: ["region-b", "region-c"] }) { id dataResidency } } ``` --- ## IV. Cross-Region Connectivity ### Connectivity Patterns #### Pattern 1: Full Connectivity **Characteristics:** - All regions can communicate - Full mesh connectivity - Coordinated governance - Federated identity **Use Case**: Multi-national government with full coordination #### Pattern 2: Hub and Spoke Connectivity **Characteristics:** - Hub connects to all spokes - Spokes connect only to hub - Limited spoke-to-spoke connectivity - Coordinated governance via hub **Use Case**: Multi-national government with central coordination #### Pattern 3: Selective Connectivity **Characteristics:** - Selected regions can communicate - Policy-driven connectivity - Regional autonomy with selective coordination - Federated identity for connected regions **Use Case**: Multi-national government with selective coordination #### Pattern 4: No Connectivity (Air-Gapped) **Characteristics:** - No cross-region connectivity - Complete isolation per region - Independent identity and governance - Air-gapped deployment **Use Case**: Classified systems, critical infrastructure ### Implementation #### Configure Cross-Region Connectivity ```graphql mutation { configureCrossRegionConnectivity(input: { fromLandingZone: "landing-zone-a" toLandingZone: "landing-zone-b" connectivityType: ENCRYPTED_TUNNEL allowedTraffic: { governance: true identity: true audit: false data: false } encryption: { algorithm: AES_256 keyManagement: REGIONAL } }) { id status } } ``` --- ## V. Regional Data Residency ### Data Residency Requirements #### Hard Enforcement **Characteristics:** - Data cannot leave region - Enforcement at storage layer - Enforcement at network layer - Enforcement at application layer **Implementation:** - Storage policies prevent data replication outside region - Network policies prevent data transfer outside region - Application policies prevent data access from outside region #### Soft Enforcement **Characteristics:** - Data preferred in region - Warnings if data outside region - Recommendations for data placement - Monitoring and alerting **Implementation:** - Monitoring detects data outside region - Alerts sent to administrators - Recommendations for data placement - Optional enforcement policies #### Advisory **Characteristics:** - Recommendations for data placement - No enforcement - Monitoring and reporting - Best practices guidance **Implementation:** - Monitoring and reporting - Best practices documentation - Recommendations for data placement - No enforcement policies ### Implementation #### Configure Data Residency ```graphql mutation { configureDataResidency(landingZoneId: "landing-zone-id", input: { requirement: REQUIRED enforcement: HARD allowedRegions: ["region-a"] prohibitedRegions: ["region-b", "region-c"] monitoring: { enabled: true alerts: true reporting: true } }) { id dataResidency } } ``` --- ## VI. Multi-National Coordination ### Coordination Patterns #### Pattern 1: Federated Governance **Characteristics:** - Governance policies federated across regions - Regional autonomy with coordination - Cross-region policy enforcement - Coordinated audit **Use Case**: Multi-national government with coordinated governance #### Pattern 2: Independent Governance **Characteristics:** - Independent governance per region - No cross-region policy enforcement - Regional audit only - Complete regional autonomy **Use Case**: Multi-national government with regional autonomy #### Pattern 3: Hybrid Governance **Characteristics:** - Some policies federated, some independent - Selective cross-region policy enforcement - Coordinated audit for federated policies - Regional audit for independent policies **Use Case**: Multi-national government with selective coordination ### Implementation #### Configure Federated Governance ```graphql mutation { configureFederatedGovernance(input: { landingZones: ["landing-zone-a", "landing-zone-b"] policies: { security: FEDERATED compliance: FEDERATED billing: INDEPENDENT identity: FEDERATED } coordination: { eventBus: true governanceAPI: true auditLog: true } }) { id status } } ``` --- ## VII. Federated Identity ### Identity Federation Patterns #### Pattern 1: Full Federation **Characteristics:** - Identity federation across all regions - SSO across regions - Centralized identity management - Regional identity control **Use Case**: Multi-national government with coordinated identity #### Pattern 2: Selective Federation **Characteristics:** - Identity federation for selected regions - SSO for federated regions - Independent identity for non-federated regions - Regional identity control **Use Case**: Multi-national government with selective identity coordination #### Pattern 3: Independent Identity **Characteristics:** - Independent identity per region - No cross-region SSO - Regional identity management - Complete regional identity control **Use Case**: Multi-national government with regional identity autonomy ### Implementation #### Configure Federated Identity ```graphql mutation { configureFederatedIdentity(input: { landingZones: ["landing-zone-a", "landing-zone-b"] federationType: FULL ssoEnabled: true identityProvider: KEYCLOAK regionalControl: true }) { id status } } ``` --- ## VIII. Network Connectivity ### Network Patterns #### Pattern 1: Encrypted Tunnels **Characteristics:** - Encrypted tunnels between regions - VPN or dedicated connections - End-to-end encryption - Regional key management **Use Case**: Secure cross-region connectivity #### Pattern 2: Private Connections **Characteristics:** - Private network connections - Dedicated circuits - No internet transit - Regional network control **Use Case**: High-security cross-region connectivity #### Pattern 3: Internet-Based **Characteristics:** - Internet-based connectivity - Encrypted connections - Public internet transit - Regional network control **Use Case**: Standard cross-region connectivity ### Implementation #### Configure Network Connectivity ```graphql mutation { configureNetworkConnectivity(input: { fromLandingZone: "landing-zone-a" toLandingZone: "landing-zone-b" connectionType: ENCRYPTED_TUNNEL encryption: { algorithm: AES_256 keyManagement: REGIONAL } routing: { allowedNetworks: ["10.1.0.0/16", "10.2.0.0/16"] prohibitedNetworks: [] } }) { id status } } ``` --- ## IX. Regional Compliance ### Compliance Per Landing Zone **Regional Compliance Profiles:** - ISO 27001, ISO 27017, ISO 27018 - SOC 2, SOC 3 - HIPAA, PCI-DSS - GDPR, CCPA - FedRAMP, ITAR - Government-specific standards **Regional Audit:** - Regional audit logging - Regional audit reporting - Regional compliance monitoring - Regional compliance validation ### Implementation #### Configure Regional Compliance ```graphql mutation { configureCompliance(landingZoneId: "landing-zone-id", input: { standards: [ISO_27001, SOC_2, FEDRAMP] certifications: ["cert-1", "cert-2"] auditRequirements: { logging: true reporting: true monitoring: true validation: true } regionalAudit: { enabled: true retention: "7years" reporting: true } }) { id complianceProfile } } ``` --- ## X. Use Cases ### Use Case 1: Multi-National Defense Contractor **Scenario**: Defense contractor with classified and unclassified workloads across multiple nations. **Landing Zone Structure:** - Landing Zone per nation - Classified workloads in AIR-GAPPED landing zones - Unclassified workloads in REGULATED landing zones - Coordinated governance for unclassified workloads - Independent governance for classified workloads **Implementation:** ``` Nation A Nation B Nation C └── Landing Zone A └── Landing Zone B └── Landing Zone C ├── Classified ├── Classified ├── Classified │ (AIR-GAPPED) │ (AIR-GAPPED) │ (AIR-GAPPED) └── Unclassified └── Unclassified └── Unclassified (REGULATED) (REGULATED) (REGULATED) Coordinated Governance (Unclassified Only) Independent Governance (Classified) ``` ### Use Case 2: International Healthcare Agency **Scenario**: Healthcare agency operating across multiple countries with HIPAA requirements. **Landing Zone Structure:** - Landing Zone per country - HIPAA-compliant landing zones - Regional data residency (hard enforcement) - Federated identity for coordination - Coordinated governance for compliance **Implementation:** ``` Country A Country B Country C └── Landing Zone A └── Landing Zone B └── Landing Zone C ├── Tenant A ├── Tenant B ├── Tenant C ├── Subscription A ├── Subscription B ├── Subscription C └── Environment A └── Environment B └── Environment C (REGULATED - HIPAA) (REGULATED - HIPAA) (REGULATED - HIPAA) Federated Identity Coordinated Governance Regional Data Residency (Hard Enforcement) ``` ### Use Case 3: Cross-Border Financial Regulator **Scenario**: Financial regulator coordinating across multiple nations. **Landing Zone Structure:** - Landing Zone per nation - REGULATED landing zones - Cross-region connectivity for coordination - Federated identity - Coordinated governance **Implementation:** ``` Nation A Nation B Nation C └── Landing Zone A └── Landing Zone B └── Landing Zone C ├── Tenant A ├── Tenant B ├── Tenant C ├── Subscription A ├── Subscription B ├── Subscription C └── Environment A └── Environment B └── Environment C (REGULATED) (REGULATED) (REGULATED) Cross-Region Connectivity (Controlled) Federated Identity Coordinated Governance ``` ### Use Case 4: Multi-Region Public Sector Agency **Scenario**: Public sector agency with operations across multiple regions. **Landing Zone Structure:** - Landing Zone per region - Standard landing zones - Cross-region connectivity - Federated identity - Coordinated governance **Implementation:** ``` Region A Region B Region C └── Landing Zone A └── Landing Zone B └── Landing Zone C ├── Tenant A ├── Tenant B ├── Tenant C ├── Subscription A ├── Subscription B ├── Subscription C └── Environment A └── Environment B └── Environment C (PROD) (PROD) (PROD) Cross-Region Connectivity Federated Identity Coordinated Governance ``` --- ## XI. Landing Zone Templates ### Template 1: Standard Sovereign Landing Zone **Configuration:** ```yaml landingZone: name: "landing-zone-standard" region: "region-a" type: "SOVEREIGN" sovereignCloud: true dataResidency: requirement: REQUIRED enforcement: HARD compliance: standards: [ISO_27001, SOC_2] connectivity: crossRegion: true external: false identity: type: KEYCLOAK federation: true governance: type: COORDINATED autonomy: REGIONAL ``` ### Template 2: Air-Gapped Landing Zone **Configuration:** ```yaml landingZone: name: "landing-zone-air-gapped" region: "region-a" type: "AIR_GAPPED" sovereignCloud: true dataResidency: requirement: REQUIRED enforcement: HARD compliance: standards: [ISO_27001, FEDRAMP, ITAR] connectivity: crossRegion: false external: false identity: type: KEYCLOAK federation: false governance: type: INDEPENDENT autonomy: COMPLETE ``` ### Template 3: Hybrid Landing Zone **Configuration:** ```yaml landingZone: name: "landing-zone-hybrid" region: "region-a" type: "HYBRID" sovereignCloud: true dataResidency: requirement: PREFERRED enforcement: SOFT compliance: standards: [ISO_27001, SOC_2, HIPAA] connectivity: crossRegion: true external: true identity: type: KEYCLOAK federation: true governance: type: HYBRID autonomy: REGIONAL ``` --- ## XII. Deployment Automation ### Automated Landing Zone Creation **Terraform Example:** ```hcl resource "phoenix_landing_zone" "region_a" { name = "landing-zone-region-a" region = "region-a" sovereign_cloud = true data_residency { requirement = "REQUIRED" enforcement = "HARD" allowed_regions = ["region-a"] } compliance { standards = ["ISO_27001", "SOC_2", "FEDRAMP"] } connectivity { cross_region = true external = false } identity { type = "KEYCLOAK" federation = true } governance { type = "COORDINATED" autonomy = "REGIONAL" } } ``` ### CI/CD Pipeline for Landing Zone Deployment ```yaml stages: - validate - plan - deploy - verify validate: - terraform validate - terraform fmt -check plan: - terraform plan -out=tfplan deploy: - terraform apply tfplan - configure_control_plane - configure_data_residency - configure_compliance verify: - verify_landing_zone - verify_connectivity - verify_compliance ``` --- ## XIII. Integration with Existing Infrastructure ### Proxmox Integration **Landing Zone → Proxmox Mapping:** - Landing Zone → Proxmox Site - Tenant → Proxmox Access Control - Subscription → Proxmox Resource Pool - Environment → Proxmox Resource Pool **Implementation:** ```graphql mutation { configureProxmoxIntegration(landingZoneId: "landing-zone-id", input: { proxmoxSite: "proxmox-site-region-a" resourcePools: { subscription: "subscription-id" environment: "environment-id" } accessControl: { tenant: "tenant-id" permissions: ["read", "write"] } }) { id status } } ``` ### Kubernetes Integration **Landing Zone → Kubernetes Mapping:** - Landing Zone → Kubernetes Cluster - Tenant → Kubernetes RBAC Namespace - Subscription → Kubernetes ResourceQuota - Environment → Kubernetes Namespace **Implementation:** ```graphql mutation { configureKubernetesIntegration(landingZoneId: "landing-zone-id", input: { kubernetesCluster: "k8s-cluster-region-a" namespaces: { tenant: "tenant-id" environment: "environment-id" } resourceQuotas: { subscription: "subscription-id" quotas: { cpu: "100" memory: "512Gi" } } }) { id status } } ``` ### Cloudflare Integration **Landing Zone → Cloudflare Mapping:** - Landing Zone → Cloudflare Tunnel Endpoint - Tenant → Cloudflare Access Policy - Environment → Cloudflare Tunnel Configuration **Implementation:** ```graphql mutation { configureCloudflareIntegration(landingZoneId: "landing-zone-id", input: { tunnelEndpoint: "tunnel-region-a" accessPolicies: { tenant: "tenant-id" policies: ["policy-1", "policy-2"] } tunnelConfig: { environment: "environment-id" routes: ["route-1", "route-2"] } }) { id status } } ``` --- ## XIV. Best Practices ### Landing Zone Design 1. **Start with Standard Pattern**: Begin with standard sovereign landing zone, expand as needed 2. **Plan for Growth**: Design landing zones to scale with requirements 3. **Regional Autonomy**: Ensure regional autonomy while enabling coordination 4. **Data Residency**: Enforce data residency from the start 5. **Compliance First**: Design compliance into landing zones from the beginning ### Multi-Region Coordination 1. **Federated Governance**: Use federated governance for coordination 2. **Selective Connectivity**: Use selective connectivity based on requirements 3. **Regional Autonomy**: Maintain regional autonomy while coordinating 4. **Audit Coordination**: Coordinate audit across regions where needed ### Security 1. **Network Isolation**: Enforce network isolation per landing zone 2. **Data Isolation**: Enforce data isolation per landing zone 3. **Identity Federation**: Use federated identity with regional control 4. **Audit Logging**: Enable comprehensive audit logging ### Compliance 1. **Compliance Profiles**: Define compliance profiles per landing zone 2. **Audit Capabilities**: Enable audit capabilities from the start 3. **Regional Compliance**: Support regional compliance requirements 4. **Compliance Monitoring**: Monitor compliance continuously --- ## XV. Troubleshooting ### Common Issues #### Issue 1: Cross-Region Connectivity Fails **Symptoms**: Cannot connect between landing zones **Diagnosis**: - Check network connectivity configuration - Verify firewall rules - Check encryption configuration **Resolution**: - Verify network connectivity settings - Update firewall rules - Reconfigure encryption if needed #### Issue 2: Data Residency Violation **Symptoms**: Data detected outside allowed region **Diagnosis**: - Check data residency configuration - Verify storage policies - Check network policies **Resolution**: - Update data residency configuration - Enforce storage policies - Enforce network policies #### Issue 3: Identity Federation Fails **Symptoms**: Cannot authenticate across regions **Diagnosis**: - Check identity federation configuration - Verify Keycloak realm configuration - Check network connectivity **Resolution**: - Reconfigure identity federation - Verify Keycloak realm settings - Ensure network connectivity --- ## References ### Phoenix Operating Model Documentation - **[Operating Model](./OPERATING_MODEL.md)** - Core operating model documentation - **[Architecture Diagrams](./OPERATING_MODEL_DIAGRAMS.md)** - Visual diagrams of the operating model - **[Cloud Provider Mapping](./CLOUD_PROVIDER_MAPPING.md)** - Azure/AWS mapping and competitive analysis - **[MVP Control Plane](./MVP_CONTROL_PLANE.md)** - Minimum viable product specification - **[Migration Guide](./MIGRATION_GUIDE.md)** - Migration from existing systems and cloud providers - **[Product Specification](./PRODUCT_SPEC.md)** - Client-facing product specification --- **Last Updated**: 2025-01-09 **Version**: 1.0 **Status**: Complete Multi-Region Landing Zones Guide