Cloud Environments Management

Environment Overview

Integration Environments

# Create integration environment
magento-cloud environment:create feature/checkout

# List environments
magento-cloud environment:list

# Get environment info
magento-cloud environment:info feature/checkout

# View environment URL
magento-cloud environment:url feature/checkout

Staging Environment

# Activate staging
magento-cloud environment:activate staging

# Sync data to staging
magento-cloud snapshot:create --environment staging

# Restore staging
magento-cloud snapshot:restore --environment staging

Production Environment

# Production is activated from main branch
git checkout main
git merge feature/checkout
git push origin main

# Check production status
magento-cloud environments:info production

Key Takeaway

Each environment type serves different purposes. Integration for development, staging for validation, production for live traffic.

Environment Variables

# Set environment-specific variables
magento-cloud variable:create \
    --name env:ENABLE_DEBUG \
    --value 1 \
    --level environment \
    --environment feature/checkout

# Set project-level variables
magento-cloud variable:create \
    --name env:MAGENTO_CLOUD_PROJECT_ID \
    --value $PROJECT_ID \
    --level project

# List variables
magento-cloud variable:list --environment staging

Environment-Specific Services

# .magento/services.yaml (project level)
mysql:
    type: mysql:10.6
    disk: 2048

# Override for staging
# staging branch .magento/services.yaml
mysql:
    type: mysql:10.6
    disk: 1024  # Smaller disk for staging

Environment Routes

# .magento/routes.yaml
'http://{default}/':
    type: upstream
    upstream: magento:php

# Integration environment URL
# https://feature-checkout-projectid.us-3.magentosite.cloud/

# Staging URL
# https://staging-projectid.us-3.magentosite.cloud/

Configuration Management

# Set config for specific environment
magento-cloud variable:create \
    --name env:STORE_NAME \
    --value "My Store" \
    --environment staging

# Use in app/etc/env.php
$storeName = getenv('STORE_NAME');

Key Takeaway

Environment variables configure settings per environment. Override services and routes for different environments. Use project-level variables for shared settings.

Branch Deployment

# Create feature branch
git checkout -b feature/new-checkout

# Make changes
git add .
git commit -m "feat(checkout): add new checkout flow"
git push origin feature/new-checkout

# Cloud creates integration environment automatically
# URL: https://feature-new-checkout-projectid.us-3.magentosite.cloud/

Promote to Staging

# Merge to staging branch
git checkout staging
git merge feature/new-checkout
git push origin staging

# Cloud deploys to staging environment
# URL: https://staging-projectid.us-3.magentosite.cloud/

Deploy to Production

# Merge to main branch
git checkout main
git merge staging
git push origin main

# Cloud deploys to production
# URL: https://www.example.com/

Deployment Commands

# Check deployment status
magento-cloud environments:info

# View deployment log
magento-cloud environment:log

# View build log
magento-cloud builds:list

# SSH and check status
magento-cloud ssh
bin/magento cache:status

Key Takeaway

Git push triggers deployment. Feature branches create integration environments. Merge to staging for validation, then to main for production.

Common Issues

# Check environment status
magento-cloud environments:info

# View error logs
magento-cloud environment:log

# SSH and check logs
magento-cloud ssh
bin/magento cache:status
var/log/system.log
tail -f var/log/exception.log

Build Failures

# Check build log
magento-cloud builds:list
magento-cloud builds:log <build-id>

# Common issues
# 1. Composer dependencies
composer install --prefer-dist

# 2. DI compilation
bin/magento setup:di:compile

# 3. Static content deploy
bin/magento setup:static-content:deploy -f

Deploy Failures

# Check deploy log
magento-cloud environment:log

# Common issues
# 1. Database connection
bin/magento setup:install --dry-run

# 2. Setup upgrade
bin/magento setup:upgrade --dry-run

# 3. Cache issues
bin/magento cache:flush

Performance Issues

# Check Redis
redis-cli info stats

# Check Elasticsearch
curl -s localhost:9200/_cluster/health

# Check MySQL
mysqladmin status

# Check PHP-FPM
ps aux | grep php-fpm

Debug Mode

# Enable developer mode
bin/magento deploy:mode:set developer

# Enable verbose logging
bin/magento config:set dev/log/verbosity 4

# Clear cache
bin/magento cache:flush

Key Takeaway

Check environment status, view logs, and verify services. Common issues: build failures, deploy failures, performance problems. Use SSH for direct debugging.