Azure Spring Apps'te hazırlama ortamı ayarlama

Not

Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış plan, altı ay sonra tamamen kapatılarak 30 Eylül 2024'den itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps Standart tüketimini ve ayrılmış planı Azure Container Apps'e geçirme.

Bu makale şunlar için geçerlidir: ✔️ Java ❌ C#

Bu makale şunlar için geçerlidir:❌ Temel ✔️ Standart ✔️ Kurumsal

Bu makalede, Azure Spring Apps'te mavi-yeşil dağıtım desenini kullanarak hazırlama dağıtımının nasıl ayarlanacağı açıklanmaktadır. Mavi-yeşil dağıtım, yeni (yeşil) bir sürüm dağıtılırken mevcut (mavi) sürümü canlı tutmaya dayalı bir Azure DevOps sürekli teslim düzenidir. Bu makalede, üretim dağıtımını değiştirmeden hazırlama dağıtımını üretime nasıl yerleştirdiğiniz gösterilmektedir.

Önkoşullar

  • Standart planda mevcut bir Azure Spring Apps örneği.
  • Azure CLI.

Bu makalede Spring Initializr'dan oluşturulmuş bir uygulama kullanılır. Bu örnek için farklı bir uygulama kullanmak istiyorsanız, hazırlama dağıtımınızı üretim dağıtımından ayırt etmek için uygulamanın genel kullanıma yönelik bir bölümünde değişiklik yapın.

İpucu

Azure Cloud Shell , bu makaledeki yönergeleri çalıştırmak için kullanabileceğiniz ücretsiz bir etkileşimli kabukdur. Git, JDK, Maven ve Azure CLI'nın en son sürümleri de dahil olmak üzere yaygın, önceden yüklenmiş Azure araçlarına sahiptir. Azure aboneliğinizde oturum açtıysanız Cloud Shell örneğinizi başlatın. Daha fazla bilgi edinmek için bkz . Azure Cloud Shell'e genel bakış.

Azure Spring Apps'te mavi-yeşil dağıtımı ayarlamak için sonraki bölümlerde yer alan yönergeleri izleyin.

Azure CLI uzantısını yükleme

Aşağıdaki komutu kullanarak Azure CLI için Azure Spring Apps uzantısını yükleyin:

az extension add --name spring

Uygulamayı ve dağıtımları hazırlama

Uygulamayı oluşturmak için şu adımları izleyin:

  1. Bu yapılandırmayla Spring Initializr kullanarak örnek uygulamanın kodunu oluşturun.

  2. Kodu indirin.

  3. *\src\main\java\com\example\hellospring* klasörüne aşağıdaki HelloController.java kaynak dosyasını ekleyin:

    package com.example.hellospring;
    import org.springframework.web.bind.annotation.RestController;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    @RestController
    
    public class HelloController {
    
    @RequestMapping("/")
    
      public String index() {
          return "Greetings from Azure Spring Apps!";
      }
    
    }
    
  4. .jar dosyasını oluşturun:

    mvn clean package -DskipTests
    
  5. Uygulamayı Azure Spring Apps örneğinizde oluşturun:

    az spring app create \
        --resource-group <resource-group-name> \
        --service <Azure-Spring-Apps-instance-name> \
        --name demo \
        --runtime-version Java_17 \
        --assign-endpoint
    
  6. Uygulamayı Azure Spring Apps'e dağıtma:

    az spring app deploy \
        --resource-group <resource-group-name> \
        --service <Azure-Spring-Apps-instance-name> \
        --name demo \
        --artifact-path target\hellospring-0.0.1-SNAPSHOT.jar
    
  7. Hazırlama dağıtımınızın kodunu değiştirin:

    package com.example.hellospring;
    import org.springframework.web.bind.annotation.RestController;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    @RestController
    
    public class HelloController {
    
    @RequestMapping("/")
    
      public String index() {
          return "Greetings from Azure Spring Apps! THIS IS THE GREEN DEPLOYMENT";
      }
    
    }
    
  8. .jar dosyasını yeniden oluşturun:

    mvn clean package -DskipTests
    
  9. Yeşil dağıtımı oluşturun:

    az spring app deployment create \
        --resource-group <resource-group-name> \
        --service <Azure-Spring-Apps-instance-name> \
        --app demo \
        --name green \
        --runtime-version Java_17 \
        --artifact-path target\hellospring-0.0.1-SNAPSHOT.jar
    

Uygulamaları ve dağıtımları görüntüleme

Dağıtılan uygulamaları görüntülemek için aşağıdaki adımları kullanın.

  1. Azure portalında Azure Spring Apps örneğine gidin.

  2. Hizmet örneğinizin uygulamalarını görüntülemek için gezinti bölmesinden Uygulamalar bölmesini açın.

    Hizmet örneğinizin uygulamalarını gösteren Uygulamalar bölmesinin ekran görüntüsü.

  3. Ayrıntıları görüntülemek için bir uygulama seçin.

    Kullanılabilir ayarları içeren Genel Bakış sayfasını gösteren tanıtım uygulamasının ekran görüntüsü.

  4. Uygulamanın tüm dağıtımlarını görmek için Dağıtımlar'ı açın. Kılavuzda hem üretim hem de hazırlama dağıtımları gösterilir.

    Listelenen uygulama dağıtımlarını gösteren ekran görüntüsü.

  5. Şu anda dağıtılan uygulamayı açmak için URL'yi seçin.

    Dağıtılan uygulamanın URL'sini gösteren ekran görüntüsü.

  6. Varsayılan uygulamayı görmek için Durum sütununda Üretim'i seçin.

    Varsayılan uygulamanın URL'sini gösteren ekran görüntüsü.

  7. Hazırlama uygulamasını görmek için Durum sütununda Hazırlama'yı seçin.

    Hazırlama uygulamasının URL'sini gösteren ekran görüntüsü.

İpucu

CSS dosyasının doğru yüklendiğinden emin olmak için test uç noktanızın eğik çizgiyle (/) sona erdiğini onaylayın. Tarayıcınız sayfayı görüntülemek için oturum açma kimlik bilgilerini girmenizi gerektiriyorsa, test uç noktanızın kodunu çözmek için URL kodunu çözmeyi kullanın. URL kodunu çözme, biçiminde https://\<username>:\<password>@\<cluster-name>.test.azuremicroservices.io/demo/greenbir URL döndürür. Uç noktanıza erişmek için bu biçimi kullanın. Test uç noktanız için temel kimlik doğrulamasını devre dışı bırakmak istiyorsanız aşağıdaki Azure CLI komutunu çalıştırın: az spring app update --resource-group <resource-group-name> --service <Azure-Spring-Apps-instance-name> --name demo --disable-test-endpoint-auth true

Not

Yapılandırma sunucusu ayarları hem hazırlama ortamınıza hem de üretim ortamınıza uygulanır. Örneğin, yapılandırma sunucusunda uygulama tanıtımınızın bağlam yolunu (server.servlet.context-path) somepath olarak ayarlarsanız, yeşil dağıtımınızın yolu olarak https://\<username>:\<password>@\<cluster-name>.test.azuremicroservices.io/demo/green/somepath/...değişir.

Bu noktada genel kullanıma yönelik uygulama tanıtımınızı ziyaret ederseniz, yeni değişikliğiniz olmadan eski sayfayı görmeniz gerekir.

Yeşil dağıtımı üretim ortamı olarak ayarlama

  1. Hazırlık ortamınızdaki değişikliğinizi doğruladıktan sonra üretim ortamına gönderebilirsiniz. Uygulama>Dağıtımları sayfasında, şu anda Üretim'de olan uygulamayı seçin.

  2. Yeşil dağıtımın Kayıt durumu'nun ardından üç noktayı seçin ve ardından Üretim olarak ayarla'yı seçin.

    Hazırlama derlemesini üretime ayarlama seçimlerini gösteren ekran görüntüsü.

  3. Uygulamanın URL'sinde değişikliklerinizin görüntülendiğini onaylayın.

    Artık üretimde olan uygulamanın URL'sini gösteren ekran görüntüsü.

Not

Yeşil dağıtımı üretim ortamı olarak ayarladıktan sonra, önceki dağıtım hazırlama dağıtımı olur.

Hazırlama dağıtımını değiştirme

Değişikliğinizden memnun değilseniz, Azure CLI kullanarak uygulama kodunuzu değiştirebilir, yeni bir .jar paketi oluşturabilir ve yeşil dağıtımınıza yükleyebilirsiniz:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name demo \
    --deployment green \
    --artifact-path demo.jar

Hazırlama dağıtımını silme

Hazırlama dağıtımınızı Azure portalından silmek için hazırlama dağıtımınızın sayfasına gidin ve Sil düğmesini seçin.

Alternatif olarak, aşağıdaki komutu çalıştırarak hazırlama dağıtımınızı Azure CLI'dan silin:

az spring app deployment delete \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <staging-deployment-name> \
    --app demo

Sonraki adımlar