Nasazení typu blue-green v Azure Container Apps

Blue-Green Deployment je strategie uvedení softwaru, která minimalizuje výpadky a snižuje riziko nasazení nových verzí aplikace. V modrém nasazení nastavíte dvě identická prostředí s názvem "modrá" a "zelená". Jedno prostředí (modré) spustí aktuální verzi aplikace a druhé prostředí (zelené) spustí novou verzi aplikace.

Jakmile otestujete zelené prostředí, směrujete do něj živý provoz. Modré prostředí použijete k nasazení nové verze aplikace během dalšího cyklu nasazení.

Modré nasazení v Azure Container Apps můžete povolit kombinací revizí aplikací kontejnerů, váhy provozu a popisků revizí.

Snímek obrazovky s Azure Container Apps: Nasazení Blue/Green

Pomocí revizí můžete vytvářet instance modrých a zelených verzí aplikace.

Revize Popis
Modrá revize Revize označená jako modrá je aktuálně spuštěná a stabilní verze aplikace. Uživatelé pracují s touto revizí a tato revize je cílem produkčního provozu.
Zelená revize Revize označená jako zelená je kopií modré revize kromě toho, že používá novější verzi kódu aplikace a případně novou sadu proměnných prostředí. Na začátku neobdrží žádný produkční provoz, ale je přístupný prostřednictvím plně kvalifikovaného názvu domény (FQDN).

Po otestování a ověření nové revize můžete směrovat produkční provoz na novou revizi. Pokud narazíte na problémy, můžete se snadno vrátit k předchozí verzi.

Akce Popis
Testování a ověření Důkladně otestujte a ověřte zelenou revizi, abyste měli jistotu, že nová verze aplikace funguje podle očekávání. Toto testování může zahrnovat různé úlohy, včetně funkčních testů, testů výkonnosti a kontrol kompatibility.
Přepínač provozu Jakmile zelená revize projde všemi potřebnými testy, můžete přepnout provoz tak, aby zelená revize začala obsluhovat produkční zátěž. Tento přechod provedete řízeným způsobem, aby byl zajištěn hladký přechod.
Vrácení zpět Pokud dojde k problémům se zelenou revizí, můžete vrátit přepínač provozu a směrovat provoz zpět na stabilní modrou revizi. Toto vrácení zpět zajišťuje minimální dopad na uživatele, pokud v nové verzi dochází k problémům. Zelená revize je stále k dispozici pro další nasazení.
Změna role Role modrých a zelených revizí se po úspěšném nasazení změní na zelenou revizi. Během dalšího cyklu vydání představuje zelená revize stabilní produkční prostředí při nasazování a testování nové verze kódu aplikace v modré revizi.

V tomto článku se dozvíte, jak implementovat modré zelené nasazení v aplikaci kontejneru. Abyste mohli spustit následující příklady, potřebujete prostředí kontejnerové aplikace, ve kterém můžete vytvořit novou aplikaci.

Poznámka:

Úplný příklad pracovního postupu GitHubu, který implementuje modré zelené nasazení pro Container Apps, najdete v tématu containerapps-blue-green repository.

Vytvoření aplikace typu kontejner s povolenými několika aktivními revizemi

Pokud chcete povolit rozdělení síťového provozu, nastavte configuration.activeRevisionsMode vlastnost na multiple. Pokud chcete získat deterministické názvy revizí, nastavte template.revisionSuffix nastavení konfigurace na řetězcovou hodnotu, která jednoznačně identifikuje verzi. Můžete například použít čísla buildů nebo krátké hash kódy potvrzení Gitu.

Následující příkazy používají sadu hodnot hash potvrzení.

export APP_NAME=<APP_NAME>
export APP_ENVIRONMENT_NAME=<APP_ENVIRONMENT_NAME>
export RESOURCE_GROUP=<RESOURCE_GROUP>

# A commitId that is assumed to correspond to the app code currently in production
export BLUE_COMMIT_ID=fb699ef
# A commitId that is assumed to correspond to the new version of the code to be deployed
export GREEN_COMMIT_ID=c6f1515

# create a new app with a new revision
az containerapp create --name $APP_NAME \
  --environment $APP_ENVIRONMENT_NAME \
  --resource-group $RESOURCE_GROUP \
  --image mcr.microsoft.com/k8se/samples/test-app:$BLUE_COMMIT_ID \
  --revision-suffix $BLUE_COMMIT_ID \
  --env-vars REVISION_COMMIT_ID=$BLUE_COMMIT_ID \
  --ingress external \
  --target-port 80 \
  --revisions-mode multiple

# Fix 100% of traffic to the revision
az containerapp ingress traffic set \
  --name $APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --revision-weight $APP_NAME--$BLUE_COMMIT_ID=100

# give that revision a label 'blue'
az containerapp revision label add \
  --name $APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --label blue \
  --revision $APP_NAME--$BLUE_COMMIT_ID

Uložte následující kód do souboru s názvem main.bicep.

targetScope = 'resourceGroup'
param location string = resourceGroup().location

@minLength(1)
@maxLength(64)
@description('Name of containerapp')
param appName string

@minLength(1)
@maxLength(64)
@description('Container environment name')
param containerAppsEnvironmentName string

@minLength(1)
@maxLength(64)
@description('CommitId for blue revision')
param blueCommitId string

@maxLength(64)
@description('CommitId for green revision')
param greenCommitId string = ''

@maxLength(64)
@description('CommitId for the latest deployed revision')
param latestCommitId string = ''

@allowed([
  'blue'
  'green'
])
@description('Name of the label that gets 100% of the traffic')
param productionLabel string = 'blue'

var currentCommitId = !empty(latestCommitId) ? latestCommitId : blueCommitId

resource containerAppsEnvironment 'Microsoft.App/managedEnvironments@2022-03-01' existing = {
  name: containerAppsEnvironmentName
}

resource blueGreenDeploymentApp 'Microsoft.App/containerApps@2022-11-01-preview' = {
  name: appName
  location: location
  tags: {
    blueCommitId: blueCommitId
    greenCommitId: greenCommitId
    latestCommitId: currentCommitId
    productionLabel: productionLabel
  }
  properties: {
    environmentId: containerAppsEnvironment.id
    configuration: {
      maxInactiveRevisions: 10 // Remove old inactive revisions
      activeRevisionsMode: 'multiple' // Multiple active revisions mode is required when using traffic weights
      ingress: {
        external: true
        targetPort: 80
        traffic: !empty(blueCommitId) && !empty(greenCommitId) ? [
          {
            revisionName: '${appName}--${blueCommitId}'
            label: 'blue'
            weight: productionLabel == 'blue' ? 100 : 0
          }
          {
            revisionName: '${appName}--${greenCommitId}'
            label: 'green'
            weight: productionLabel == 'green' ? 100 : 0
          }
        ] : [
          {
            revisionName: '${appName}--${blueCommitId}'
            label: 'blue'
            weight: 100
          }
        ]
      }
    }
    template: {
      revisionSuffix: currentCommitId
      containers:[
        {
          image: 'mcr.microsoft.com/k8se/samples/test-app:${currentCommitId}'
          name: appName
          resources: {
            cpu: json('0.5')
            memory: '1.0Gi'
          }
          env: [
            {
              name: 'REVISION_COMMIT_ID'
              value: currentCommitId
            }
          ]
        }
      ]
    }
  }
}

output fqdn string = blueGreenDeploymentApp.properties.configuration.ingress.fqdn
output latestRevisionName string = blueGreenDeploymentApp.properties.latestRevisionName

Pomocí tohoto příkazu nasaďte aplikaci se souborem Bicep:

export APP_NAME=<APP_NAME>
export APP_ENVIRONMENT_NAME=<APP_ENVIRONMENT_NAME>
export RESOURCE_GROUP=<RESOURCE_GROUP>

# A commitId that is assumed to belong to the app code currently in production
export BLUE_COMMIT_ID=fb699ef
# A commitId that is assumed to belong to the new version of the code to be deployed
export GREEN_COMMIT_ID=c6f1515

# create a new app with a blue revision
az deployment group create \
    --name createapp-$BLUE_COMMIT_ID \
    --resource-group $RESOURCE_GROUP \
    --template-file main.bicep \
    --parameters appName=$APP_NAME blueCommitId=$BLUE_COMMIT_ID containerAppsEnvironmentName=$APP_ENVIRONMENT_NAME \
    --query properties.outputs.fqdn

Nasazení nové revize a přiřazení popisků

Modrý popisek aktuálně odkazuje na revizi, která přebírá produkční provoz přicházející do plně kvalifikovaného názvu domény aplikace. Zelený popisek odkazuje na novou verzi aplikace, kterou plánujete zavést do produkčního prostředí. Nová hodnota hash potvrzení identifikuje novou verzi kódu aplikace. Následující příkaz nasadí novou revizi hodnoty hash potvrzení a označí ji zeleným popiskem.

#create a second revision for green commitId
az containerapp update --name $APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --image mcr.microsoft.com/k8se/samples/test-app:$GREEN_COMMIT_ID \
  --revision-suffix $GREEN_COMMIT_ID  \
  --set-env-vars REVISION_COMMIT_ID=$GREEN_COMMIT_ID

#give that revision a 'green' label
az containerapp revision label add \
  --name $APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --label green \
  --revision $APP_NAME--$GREEN_COMMIT_ID

#deploy a new version of the app to green revision
az deployment group create \
    --name deploy-to-green-$GREEN_COMMIT_ID \
    --resource-group $RESOURCE_GROUP \
    --template-file main.bicep \
    --parameters appName=$APP_NAME blueCommitId=$BLUE_COMMIT_ID greenCommitId=$GREEN_COMMIT_ID latestCommitId=$GREEN_COMMIT_ID productionLabel=blue containerAppsEnvironmentName=$APP_ENVIRONMENT_NAME \
    --query properties.outputs.fqdn

Následující příklad ukazuje, jak je oddíl provozu nakonfigurovaný. Revize s modroucommitId přebírá 100% produkčního provozu, zatímco nově nasazená revize se zelenoucommitId nepřebírá žádný produkční provoz.

{ 
  "traffic": [
    {
      "revisionName": "<APP_NAME>--fb699ef",
      "weight": 100,
      "label": "blue"
    },
    {
      "revisionName": "<APP_NAME>--c6f1515",
      "weight": 0,
      "label": "green"
    }
  ]
}

Nově nasazenou revizi můžete otestovat pomocí FQDN specifického pro štítek:

#get the containerapp environment default domain
export APP_DOMAIN=$(az containerapp env show -g $RESOURCE_GROUP -n $APP_ENVIRONMENT_NAME --query properties.defaultDomain -o tsv | tr -d '\r\n')

#Test the production FQDN
curl -s https://$APP_NAME.$APP_DOMAIN/api/env | jq | grep COMMIT

#Test the blue label FQDN
curl -s https://$APP_NAME---blue.$APP_DOMAIN/api/env | jq | grep COMMIT

#Test the green label FQDN
curl -s https://$APP_NAME---green.$APP_DOMAIN/api/env | jq | grep COMMIT

Odeslání produkčního provozu do zelené revize

Po potvrzení, že kód aplikace v zelené revizi funguje podle očekávání, odešlete do revize 100% produkčního provozu. Zelená revize se teď stane produkční revizí.

# Set 100% of traffic to green revision
az containerapp ingress traffic set \
  --name $APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --label-weight blue=0 green=100


# Make green the prod revision
az deployment group create \
    --name make-green-prod-$GREEN_COMMIT_ID \
    --resource-group $RESOURCE_GROUP \
    --template-file main.bicep \
    --parameters appName=$APP_NAME blueCommitId=$BLUE_COMMIT_ID greenCommitId=$GREEN_COMMIT_ID latestCommitId=$GREEN_COMMIT_ID productionLabel=green containerAppsEnvironmentName=$APP_ENVIRONMENT_NAME \
    --query properties.outputs.fqdn

Následující příklad ukazuje, jak traffic je oddíl nakonfigurovaný po tomto kroku. Zelená revize s novým kódem aplikace přebírá veškerý uživatelský provoz, zatímco modrá revize se starou verzí aplikace nepřijímá žádosti uživatelů.

{ 
  "traffic": [
    {
      "revisionName": "<APP_NAME>--fb699ef",
      "weight": 0,
      "label": "blue"
    },
    {
      "revisionName": "<APP_NAME>--c6f1515",
      "weight": 100,
      "label": "green"
    }
  ]
}

Vrácení nasazení zpět, pokud došlo k problémům

Pokud po spuštění v produkčním prostředí zjistíte, že nová revize má chyby, můžete se vrátit zpět do předchozího dobrého stavu. Po vrácení zpět se do staré verze v modré revizi odešle 100 % provozu a tato revize se znovu označí jako produkční revize.

# Set 100% of traffic to green revision
az containerapp ingress traffic set \
  --name $APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --label-weight blue=100 green=0

# Roll back traffic to blue revision
az deployment group create \
    --name rollback-to-blue-$GREEN_COMMIT_ID \
    --resource-group $RESOURCE_GROUP \
    --template-file main.bicep \
    --parameters appName=$APP_NAME blueCommitId=$BLUE_COMMIT_ID greenCommitId=$GREEN_COMMIT_ID latestCommitId=$GREEN_COMMIT_ID productionLabel=blue containerAppsEnvironmentName=$APP_ENVIRONMENT_NAME \
    --query properties.outputs.fqdn

Po opravení chyb se nová verze aplikace znovu nasadí jako zelená revize. Zelená verze se nakonec stane produkční revizí.

Další cyklus nasazení

Teď zelený popisek označí revizi, ve které je aktuálně spuštěn stabilní produkční kód.

Během dalšího cyklu nasazení modrá identifikuje revizi s novou verzí aplikace, která se zavádí do produkčního prostředí.

Následující příkazy ukazují, jak se připravit na další cyklus nasazení.

# Set the new commitId
export BLUE_COMMIT_ID=ad1436b

# Create a third revision for blue commitId
az containerapp update --name $APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --image mcr.microsoft.com/k8se/samples/test-app:$BLUE_COMMIT_ID \
  --revision-suffix $BLUE_COMMIT_ID  \
  --set-env-vars REVISION_COMMIT_ID=$BLUE_COMMIT_ID

# Give that revision a 'blue' label
az containerapp revision label add \
  --name $APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --label blue \
  --revision $APP_NAME--$BLUE_COMMIT_ID

# Set the new commitId
export BLUE_COMMIT_ID=ad1436b

# deploy new version of the app to blue revision
az deployment group create \
    --name deploy-to-blue-$BLUE_COMMIT_ID \
    --resource-group $RESOURCE_GROUP \
    --template-file main.bicep \
    --parameters appName=$APP_NAME blueCommitId=$BLUE_COMMIT_ID greenCommitId=$GREEN_COMMIT_ID latestCommitId=$BLUE_COMMIT_ID productionLabel=green containerAppsEnvironmentName=$APP_ENVIRONMENT_NAME \
    --query properties.outputs.fqdn

Další kroky

Hmotnosti provozu

  • Last updated on