Azure Spring Apps'te uygulamalarınızda uzaktan hata ayıklama

Not

Temel, Standardve Enterprise planları 17 Mart 2025'te kullanımdan kaldırma dönemine girdi. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Bu makale şunlar için geçerlidir:✅ Temel/Standart ✅ Kurumsal

Bu özellik, Azure Spring Apps'te uygulamalarınızda uzaktan hata ayıklamayı etkinleştirmeyi açıklar.

Önkoşullar

  • Azure Spring Apps uzantısıyla Azure CLI . Önceki sürümleri kaldırmak ve en son uzantıyı yüklemek için aşağıdaki komutu kullanın. Spring-cloud uzantısını daha önce yüklediyseniz yapılandırma ve sürüm uyuşmazlıklarını önlemek için bu uzantıyı kaldırın.

    az extension remove --name spring
az extension add --name spring
az extension remove --name spring-cloud

  • Azure Spring Apps'te dağıtılan bir uygulama.

Uzaktan hata ayıklamayı etkinleştirme veya devre dışı bırakma

Güvenlik nedeniyle Azure Spring Apps, uzaktan hata ayıklamayı varsayılan olarak devre dışı bırakır. Şirket ilkenize bağlı olarak, uygulamanız için uzaktan hata ayıklamayı kendiniz etkinleştirebilir veya bir yöneticinin sizin için etkinleştirmesini sağlayabilirsiniz. Azure CLI, Azure portalı veya VS Code uzantısını kullanarak uzaktan hata ayıklamayı etkinleştirebilir veya devre dışı bırakabilirsiniz.

Azure portalını kullanarak uygulamanız için uzaktan hata ayıklamayı etkinleştirmek için aşağıdaki adımları kullanın:

  1. Uygulama sayfanıza gidin.

  2. Sol gezinti bölmesindeki Ayarlar'ın altında Uzaktan hata ayıklama'yı seçin.

  3. Uzaktan hata ayıklama sayfasında, uzaktan hata ayıklamayı etkinleştirin ve hata ayıklama bağlantı noktasını belirtin.

    Uzaktan hata ayıklama ve Hata ayıklama bağlantı noktası seçeneklerinin seçili olduğu Uzaktan hata ayıklama sayfasını gösteren Azure portalının ekran görüntüsü.

Azure rolü atama

Bir uygulama örneğinde uzaktan hata ayıklamak için, veri eylemi iznini içeren rolüne Azure Spring Apps Remote Debugging RoleMicrosoft.AppPlatform/Spring/apps/deployments/remotedebugging/action sahip olmanız gerekir.

Azure portalını veya Azure CLI'yı kullanarak bir Azure rolü atayabilirsiniz.

Azure portalını kullanarak bir Azure rolü atamak için aşağıdaki adımları kullanın.

  1. Azure portalını açın.

  2. Azure Spring Apps hizmet örneğinizi açın.

  3. Gezinti bölmesinde Erişim Denetimi (IAM) öğesini seçin.

  4. Erişim Denetimi (IAM) sayfasında Ekle'yi ve ardından Rol ataması ekle'yi seçin.

    Rol ataması ekle seçeneğinin vurgulandığı bir Azure Spring Apps örneğinin Azure portalı Erişim Denetimi (IAM) sayfasının ekran görüntüsü.

  5. Rol ataması ekle sayfasındaki Ad listesinde Azure Spring Apps Uzaktan Hata Ayıklama Rolü'nü arayıp seçin ve ardından İleri'yi seçin.

    Azure Spring Apps Uzaktan Hata Ayıklama Rolü adının vurgulandığı Rol ataması ekle sayfasını gösteren Azure portalının ekran görüntüsü.

  6. Üyeler'i seçin ve ardından kullanıcı adınızı arayın ve seçin.

  7. Gözden geçir + ata'yı seçin.

Uygulama örneğinde uzaktan hata ayıklama

Azure Toolkit for IntelliJ veya VS Code için Azure Spring Apps uzantısını kullanarak uygulama örneğinde uzaktan hata ayıklayabilirsiniz.

Bu bölümde, Azure Toolkit for IntelliJ kullanılarak bir uygulama örneğinde uzaktan hata ayıklama açıklanmaktadır.

Önkoşullar

Uzaktan hata ayıklamayı etkinleştirme veya devre dışı bırakma

Uzaktan hata ayıklamayı etkinleştirmek veya devre dışı bırakmak için aşağıdaki adımları kullanın:

  1. Azure Gezgini'nde Azure hesabınızda oturum açın.

  2. Bir uygulama örneği seçin ve ardından Uzaktan Hata Ayıklamayı Etkinleştir'i seçin.

    Uzaktan Hata Ayıklamayı Etkinleştir menü seçeneğini gösteren IntelliJ'nin ekran görüntüsü.

Hata ayıklayıcı ekleme

Hata ayıklayıcı eklemek için aşağıdaki adımları kullanın.

  1. Bir uygulama örneği seçin ve ardından Hata Ayıklayıcı Ekle'yi seçin. IntelliJ, uygulama örneğine bağlanır ve uzaktan hata ayıklamayı başlatır.

    IntelliJ'de Hata Ayıklayıcı Ekle menü seçeneğini gösteren ekran görüntüsü.

  2. IntelliJ için Azure Toolkit, uzaktan hata ayıklama yapılandırmasını oluşturur. Bunu Uzak Jvm Hata Ayıklaması altında bulabilirsiniz " Uzaktan hata ayıklama için kullandığınız kaynak kodun modül sınıfı yolunu yapılandırın.

    Çalıştırma/Hata Ayıklama Yapılandırmaları sayfasını gösteren IntelliJ'nin ekran görüntüsü.

Sorun giderme

Bu bölümde sorun giderme bilgileri sağlanır.

  • Hata ayıklayıcı ekleyemezseniz ve veya java.net.SocketException, connection resetgibi Failed to attach to remote debugger, ClosedConnectionException bir hata alırsanız aşağıdaki eylemleri gerçekleştirin:

    • Bir uygulama örneğinde uzaktan hata ayıklama yetkisine sahip olduğunuzdan emin olmak için RBAC rolünü denetleyin.

    • Geçerli bir örneğe bağlandığınızdan emin olun. En son örnekleri almak için dağıtımı yenileyin.

      Uygulama Örnekleri düğümü için Yenile menü seçeneğini gösteren IntelliJ proje gezgininin ekran görüntüsü.

  • Hata ayıklayıcıyı başarıyla ekleyip, ancak uygulama örneğini uzaktan hata ayıklayamıyorsanız aşağıdaki eylemleri gerçekleştirin:

    • IDE'nizin hata ayıklamak istediğiniz kaynak kodunu içerdiğinden emin olun.
    • Hata ayıklama yapılandırmasının doğru modül sınıfı yoluna sahip olduğundan emin olun.

Sınırlamalar

Uzaktan hata ayıklama yalnızca Java uygulamaları için desteklenir.

Planlama Dağıtım türü Desteklenir
Standart ve temel plan Kavanoz Yes
Standart ve temel plan Kaynak kodu (Java) Yes
Standart ve temel plan Özel Görüntü Hayır
Kurumsal plan Java Uygulaması Yes
Kurumsal plan Kaynak kodu (Java) Yes
Kurumsal plan Özel Görüntü Hayır

İpuçları

  • Java uzaktan hata ayıklaması, uzaktan kod yürütülmesine izin verdiğinden tehlikelidir. Azure Spring Apps, istemci IDE'niz ile uzak uygulama arasındaki iletişimin güvenliğini sağlamanıza yardımcı olur. Ancak, uzaktan hata ayıklamayı devre dışı bırakmanız ve bitirdikten sonra RBAC rolünü kaldırmanız gerekir.
  • Trafiğin örneğe yönlendirilebilmesi için uygulama örneğinin ölçeğini bire düşürmelisiniz.

Sonraki adımlar

  • Last updated on