Azure Container Apps'te dağıtım etiketleri

Dağıtım etiketleri, belirli kapsayıcı revizyonlarına geliştirme, test veya üretim gibi anlamlı isimler atamanıza yardımcı olur. Bu adları uyguladığınızda karmaşık dağıtım senaryolarını ve ortam yönetimini kolaylaştırırsınız.

Dağıtım etiketlerini kullanarak şunları yapabilirsiniz:

  • Düzeltmelere açık ve açıklayıcı etiketler atayın.
  • Yönlendirme ve trafik yönetimi etiketlerine otomatik olarak yeni düzeltmeler atayın.
  • Düzeltme adlarını değiştirmek yerine trafiği etiketlere göre yönlendirme.
  • Etiketleri yeniden atayarak düzeltmeleri yükseltin veya indirgeyin.
  • Etiket geçmişini kullanarak önceki düzeltmelere geri dönün.

Önemli

Dağıtım etiketlerini kullanabilmeniz için önce kapsayıcı uygulamanız için portalda dağıtım etiketlerini etkinleştirme adımlarını izlemeniz gerekir.

Temel özellikler

Dağıtım etiketleri, aşağıdaki özellikleri kullanarak uygulama yaşam döngünüz üzerinde denetim sahibi olurken gelişmiş dağıtım stratejileri oluşturmanıza olanak tanır:

  • Etiket ataması: Kapsayıcı revizyonlarına anlamlı etiketler oluşturup atamak, geliştirme, test ve canlı gibi ortamları yönetmeyi kolaylaştırır.

  • Trafik bölme ve A/B testi: Trafik bölme, kör geri alma ve A/B testi desteği, yeni özelliklerin aşamalı olarak kullanıma alınmasına ve test edilmesine olanak tanır.

  • Hazırlama sürümleri ve otomatik değiştirme: Otomatik düzeltme etkinleştirme, sorunsuz bir şekilde yeni düzeltmeler oluşturmanıza ve trafiği almak için bunları yeni veya mevcut etiketlere atamanıza olanak tanır. Bir etiket tarafından artık referans alınmayan düzeltmeler otomatik olarak kapatılır.

Dağıtım etiketlerini kullanma

Varsayılan olarak dağıtım etiketleri kapsayıcı uygulamanız tarafından kullanılamaz. Dağıtım etiketlerini etkinleştirmek için Azure portalında şu adımları izleyin:

  1. Kapsayıcı uygulamanızı Azure portalında açın.

  2. Menüde, Uygulama bölümünün altında Düzeltmeler ve çoğaltmalar'ı seçin.

  3. Dağıtım modu'nu seçin.

  4. Dağıtım etiketleri sütununu seçin.

  5. seçin, sonra daUygula'yı seçin.

Yeni etiket oluşturma

Portalda mevcut etiketleri temel alarak yeni etiketler oluşturun. Varsayılan olarak, Container Apps label-1 adlı ilk etiketinizi oluşturur. CLI veya Bicep aracılığıyla etiketler oluşturduğunuzda, bunları mevcut düzeltmelerle veya yeni bir düzeltmeyle ilişkilendirebilirsiniz.

  1. Kapsayıcı uygulamanızı Azure portalında açın.

  2. Menüde, Uygulama bölümünün altında Etiketler'i seçin.

  3. Yeni etiket'i seçin.

  4. Yeni etiketinizi temel almak istediğiniz mevcut etiketi seçin.

  5. Metin kutusuna yeni etiket adını girin.

  6. Çoğalt'ı seçin.

Etiket geçmişi ve geri alma işlemleri

Aşağıdaki adımları kullanarak bir etiketin tam geçmişini görüntüleyebilirsiniz:

  1. Kapsayıcı uygulamanızı Azure portalında açın.

  2. Menüden Uygulama'nın altında Etiketler'i seçin.

  3. İlgilendiğiniz etiket için Geçmişi göster'i seçin.

Herhangi bir etiket için Geçmişi göster seçeneğini kullanarak:

  • Etiketin düzeltme geçmişini gözden geçirin.
  • Etiketi farklı bir kapsayıcı düzeltmesine işaret ederek önceki bir düzeltmeye geri dönün.

Dağıtım etiketlerini kullanma

Dağıtım etiketlerini etkinleştirmek için Azure CLI'da şu adımları izleyin:

  1. Terminalinizi açın.

  2. Aşağıdaki ortam değişkenlerini oluşturun.

     CONTAINER_APP_NAME="my-container-app"
 CONTAINER_APP_IMAGE="mcr.microsoft.com/k8se/quickstart:latest"
 LOCATION="centralus"
 RESOURCE_GROUP="my-container-apps-rg"
 ENVIRONMENT_NAME="my-container-apps-env"
 TARGET_LABEL="stage"

  3. Etiketli yeni bir uygulama ve düzeltme oluşturmak için aşağıdaki komutu kullanın:

    az containerapp create \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--image $CONTAINER_APP_IMAGE \
--environment $ENVIRONMENT_NAME \
--location $LOCATION \
--ingress external \
--target-port 0 \
--revisions-mode labels \
--target-label $TARGET_LABEL

  4. Yeni veya mevcut bir etiketle yeni bir düzeltme oluşturmak için aşağıdaki komutu kullanın:

    az containerapp update \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--image $CONTAINER_APP_IMAGE \
--target-label $TARGET_LABEL

  5. Etiket geçmişini göstermek için aşağıdaki komutu kullanın:

    az containerapp label-history show \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--label $TARGET_LABEL

  6. Etiket uygulaması trafiğini göstermek için aşağıdaki komutu kullanın:

    az containerapp ingress traffic show \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \

  7. Düzeltmeye etiket eklemek için aşağıdaki komutları kullanın:

    az containerapp revision label add \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--revision $REVISION_NAME \
--label $TARGET_LABEL

  8. Düzeltmeden etiket kaldırmak için aşağıdaki komutları kullanın:

    az containerapp revision label remove \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--label $TARGET_LABEL

Desteklenen senaryolar

  • Mavi-yeşil dağıtımlar: Düzeltmeleri etiketleyerek ve bunlar arasında geçiş yaparak mavi-yeşil dağıtımları kolayca yönetin. Bu yaklaşım, tüm ortam değiştirme işlemlerini işlemek için basit bir yol sağlar.

  • A/B testi: Özellik testi için trafiğin yüzdesini farklı düzeltmelere yönlendirin. Bu uygulama, tam dağıtımdan önce kullanıcıların bir alt kümesiyle yeni işlevleri doğrulamanızı sağlar.

  • Aşamalı dağıtımlar: Trafik yüzdelerini ayarlayarak trafiği aşamalı olarak yeni bir revizyona yönlendirin.

  • Ortam yalıtımı: Ayrı geliştirme, hazırlama ve üretim ortamlarını korumak için etiketleri kullanın. Her ortam, net bir yükseltme yolu korunarak bağımsız olarak güncelleştirilebilir.

İş akışı örneği

Dağıtım etiketlerini kullanan tipik bir iş akışı aşağıda verilmişti:

  1. İlk etiketleri oluşturma: Başlangıçta aynı düzeltmeye işaret eden "stage" ve "production" gibi etiketler oluşturun.

  2. Etiketi güncelleştirme: Yeni kapsayıcılar, ölçeklendirme veya birim ayarlarıyla güncelleştirmek için bir etiket seçin (örneğin, "aşama").

  3. Değişiklikleri test etme: Yeni düzeltme dağıtıldığında, trafiğin bir bölümünü güncelleştirilmiş etikete yönlendirin.

  4. Değişiklikleri yayına alma: Üretim sürümüne güvendiğinizde, üretim etiketini aynı sürüme işaret edecek şekilde güncelleyin.

  5. Gerekirse izleme ve geri alma: Sorun oluşursa önceki sürüme geri dönmek için etiket geçmişini kullanın.

İlgili içerik

Düzeltme etiketleri

  • Son güncelleştirme: