Öğretici: Linux ve Azure Cosmos DB'de Azure Uygulaması Hizmeti ile Java Spring Boot web uygulaması oluşturma

Bu öğreticide, Azure'daki bir MongoDB veritabanına (mongoDB API'sine sahip bir Cosmos DB veritabanı) bağlanan Azure Uygulaması Service'te güvenli bir Spring Boot uygulaması oluşturmayı, yapılandırmayı ve dağıtmayı öğreneceksiniz. İşiniz bittiğinde, Linux üzerinde Azure Uygulaması Hizmeti üzerinde çalışan bir Java SE uygulamanız olur.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

• MongoDB API'siyle Azure Uygulaması Hizmeti ve Azure Cosmos DB için varsayılan olarak güvenli bir mimari oluşturun.
• Yönetilen kimlik ve Key Vault başvurularını kullanarak bağlantı gizli dizilerinin güvenliğini sağlama.
• GitHub deposundan App Service'e Spring Boot örnek uygulaması dağıtın.
• Uygulama kodundaki App Service uygulama ayarlarını alır.
• Güncelleştirmeler yapın ve uygulama kodunu yeniden dağıtın.
• Tanılama günlüklerini App Service'ten akışla aktarabilirsiniz.
• Uygulamayı Azure portalında yönetin.
• Azure Geliştirici CLI'sını kullanarak aynı mimariyi sağlayın ve dağıtın.
• GitHub Codespaces ve GitHub Copilot ile geliştirme iş akışınızı iyileştirin.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Azure hesabınız yoksa ücretsiz olarak bir hesap oluşturabilirsiniz.
• Bir GitHub hesabı. Ücretsiz olarak da bir tane alabilirsiniz.
• Spring Framework geliştirmesi ile Java bilgisi.
• (İsteğe bağlı) GitHub Copilot hesabı olan GitHub Copilot'ı denemek için. 30 günlük ücretsiz deneme sürümü mevcuttur.

• Etkin aboneliği olan bir Azure hesabı. Azure hesabınız yoksa ücretsiz olarak bir hesap oluşturabilirsiniz.
• Azure Geliştirici CLI'sı yüklü. Azure Geliştirici CLI'sı zaten yüklü olduğundan Azure Cloud Shell ile adımları izleyebilirsiniz.
• Spring Framework geliştirmesi ile Java bilgisi.
• (İsteğe bağlı) GitHub Copilot hesabı olan GitHub Copilot'ı denemek için. 30 günlük ücretsiz deneme sürümü mevcuttur.

Sona atla

Bu öğreticide örnek uygulamayı hızla dağıtabilir ve Azure'da çalıştığını görebilirsiniz. Azure Cloud Shell'de aşağıdaki komutları çalıştırmanız ve istemi izlemesi gerekir:

mkdir msdocs-spring-boot-mongodb-sample-app
cd msdocs-spring-boot-mongodb-sample-app
azd init --template msdocs-spring-boot-mongodb-sample-app
azd up

1. Örneği çalıştırın

İlk olarak, başlangıç noktası olarak örnek bir veri temelli uygulama ayarlarsınız. Kolaylık sağlamak için örnek depo bir geliştirme kapsayıcısı yapılandırması içerir. Geliştirme kapsayıcısı MongoDB veritabanı, önbellek ve örnek uygulamanın ihtiyaç duyduğu tüm ortam değişkenleri dahil olmak üzere bir uygulama geliştirmek için ihtiyacınız olan her şeye sahiptir. Geliştirme kapsayıcısı GitHub kod alanında çalıştırılabilir; başka bir deyişle örneği web tarayıcısıyla herhangi bir bilgisayarda çalıştırabilirsiniz.

1. Adım: Yeni bir tarayıcı penceresinde:

1. GitHub hesabınıza giriş yapın.
2. Şuraya gidin: https://github.com/Azure-Samples/msdocs-spring-boot-mongodb-sample-app/fork
3. Yalnızca ana dalı kopyala seçimini kaldırın. Tüm dalları istiyorsun.
4. Çatal oluştur'u seçin.

2. Adım: GitHub çatalında:

1. Başlangıç dalı için main>starter-no-infra öğesini seçin. Bu dal yalnızca örnek projeyi içerir ve Azure ile ilgili dosya veya yapılandırma içermez.
2. Starter-no-infra üzerinde Kod>Oluştur kod alanı'na tıklayın. Kod alanının ayarlanması birkaç dakika sürer.

3. Adım: Codespace terminalinde:

1. mvn package spring-boot:run'i çalıştırın.
2. Bildirimi Your application running on port 8080 is available.gördüğünüzde Tarayıcıda Aç'ı seçin. Örnek uygulamayı yeni bir tarayıcı sekmesinde görmeniz gerekir. Jetty sunucusunu durdurmak için yazın Ctrl+C.

İpucu

GitHub Copilot'a bu depo hakkında soru sorabilirsiniz. Örneğin:

• @workspace Bu proje ne yapar?
• @workspace Uygulama veritabanına nasıl bağlanır?
• @workspace .devcontainer klasörü ne yapar?

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

2. App Service ve Cosmos DB oluşturma

İlk olarak Azure kaynaklarını oluşturursunuz. Bu öğreticide kullanılan adımlar, App Service ve Azure Cosmos DB içeren varsayılan olarak güvenli bir kaynak kümesi oluşturur. Oluşturma işlemi için şunları belirtirsiniz:

• Web uygulamasının Adı. Uygulamanızın DNS adının bir parçası olarak biçiminde https://<app-name>-<hash>.<region>.azurewebsites.netkullanılır.
• Uygulamayı dünyada fiziksel olarak çalıştırılacak Bölge. Ayrıca uygulamanızın DNS adının bir parçası olarak da kullanılır.
• Uygulamanın Çalışma Zamanı yığını . Burası, uygulamanız için kullanılacak Java sürümünü seçtiğiniz yerdir.
• Uygulama için Barındırma planı . Bu, uygulamanız için özellik kümesini ve ölçeklendirme kapasitesini içeren fiyatlandırma katmanıdır.
• Uygulamanın Kaynak Grubu . Kaynak grubu, uygulama için gereken tüm Azure kaynaklarını gruplandırmanıza (mantıksal bir kapsayıcıda) olanak tanır.

Azure portalında oturum açın ve Azure Uygulaması Hizmeti kaynaklarınızı oluşturmak için bu adımları izleyin.

1. Adım: Azure portalında:

1. Azure portalının üst kısmındaki arama çubuğuna "web uygulaması veritabanı" yazın.
2. Market başlığının altında Web Uygulaması + Veritabanı etiketli öğeyi seçin. Doğrudan oluşturma sihirbazına da gidebilirsiniz.

2. Adım: Web Uygulaması + Veritabanı Oluştur sayfasında, formu aşağıdaki gibi doldurun.

1. Kaynak Grubu: Yeni oluştur'u seçin ve msdocs-spring-cosmosdb-tutorial adını kullanın.
2. Bölge: Size yakın herhangi bir Azure bölgesi.
3. Ad: msdocs-spring-cosmosdb-XYZ burada XYZ herhangi bir rastgele karakterdir. Bu ad Azure genelinde benzersiz olmalıdır.
4. Çalışma zamanı yığını: Java 21.
5. Java web sunucusu yığını: Java SE (Embedded Web Server).
6. Altyapı: MongoDB için Cosmos DB API'si. Cosmos DB, Azure'da hizmet olarak tam olarak yönetilen bir NoSQL, ilişkisel ve vektör veritabanıdır.
7. Barındırma planı: Temel. Hazır olduğunuzda, ölçeği bir üretim fiyatlandırma katmanına kadar artırabilirsiniz.
8. Gözden geçir ve oluştur’u seçin.
9. Doğrulama tamamlandıktan sonra Oluştur'u seçin.

3. Adım: Dağıtımın tamamlanması birkaç dakika sürer. Dağıtım tamamlandıktan sonra Kaynağa git düğmesini seçin. Doğrudan App Service uygulamasına yönlendirilirsiniz, ancak aşağıdaki kaynaklar oluşturulur:

• Kaynak grubu: Oluşturulan tüm kaynaklar için kapsayıcı.
• App Service planı: App Service için işlem kaynaklarını tanımlar. Temel katmanda bir Linux planı oluşturulur.
• App Service: Uygulamanızı temsil eder ve App Service planında çalışır.
• Sanal ağ: App Service uygulamasıyla tümleştirilmiş ve arka uç ağ trafiğini yalıtıyor.
• Azure Cosmos DB: Yalnızca özel uç noktasının arkasından erişilebilir. Veritabanı hesabında sizin için bir veritabanı oluşturulur.
• Özel uç noktalar: Veritabanı sunucusu ve sanal ağdaki Redis önbelleği için erişim uç noktaları.
• Özel DNS bölgeleri: Sanal ağda veritabanı sunucusunun ve Redis önbelleğinin DNS çözümlemesini etkinleştirin.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

3. Bağlantı gizli dizilerinin güvenliğini sağlama

Oluşturma sihirbazı bağlantı dizesini sizin için zaten bir uygulama ayarı olarak oluşturdu. Ancak en iyi güvenlik uygulaması, gizli dizileri App Service'in dışında tutmaktır. Hizmet Bağlayıcıları yardımıyla gizli dizilerinizi bir anahtar kasasına taşıyacak ve uygulama ayarınızı Key Vault başvurusu olarak değiştireceksiniz.

1. Adım: App Service sayfasında:

1. Sol menüde Ayarlar > Ortam değişkenleri'ni seçin.
2. AZURE_COSMOS_CONNECTIONSTRING yanında Değeri göster'i seçin. Bu bağlantı dizesi, özel uç noktanın arkasında güvenliği sağlanan Cosmos DB veritabanına bağlanmanızı sağlar. Ancak gizli dizi doğrudan App Service uygulamasına kaydedilir ve bu en iyisi değildir. Bunu değiştireceksin.

2. Adım: Gizli dizilerin güvenli yönetimi için bir anahtar kasası oluşturun.

1. Üstteki arama çubuğuna "key vault" yazın ve Market Anahtar Kasası'nı> seçin.
2. Kaynak Grubu'nda msdocs-spring-cosmosdb-tutorial öğesini seçin.
3. Anahtar kasası adı alanına yalnızca harf ve sayılardan oluşan bir ad yazın.
4. Bölge'de, kaynak grubu olarak örnek konuma ayarlayın.

3. Adım:

1. Ağ sekmesini seçin.
2. Genel erişimi etkinleştir'in seçimini kaldırın.
3. Özel uç nokta oluştur'u seçin.
4. Kaynak Grubu'nda msdocs-spring-cosmosdb-tutorial öğesini seçin.
5. Anahtar kasası adı alanına yalnızca harf ve sayılardan oluşan bir ad yazın.
6. Bölge'de, kaynak grubu olarak örnek konuma ayarlayın.
7. İletişim kutusundaki Konum'da App Service uygulamanızla aynı konumu seçin.
8. Kaynak Grubu'nda msdocs-spring-cosmosdb-tutorial öğesini seçin.
9. Ad alanına msdocs-spring-cosmosdb-XYZVaultEndpoint yazın.
10. Sanal ağ'da msdocs-spring-cosmosdb-XYZVnet öğesini seçin.
11. Alt ağda msdocs-spring-cosmosdb-XYZSubnet.
12. Tamam'ı seçin.
13. Gözden Geçir + oluştur’u ve sonra da Oluştur’u seçin. Anahtar kasası dağıtımının tamamlanmasını bekleyin. "Dağıtımınız tamamlandı" ifadesini görmeniz gerekir.

4. Adım:

1. Üst arama çubuğuna msdocs-spring-cosmosdb yazın ve ardından msdocs-spring-cosmosdb-XYZ adlı App Service kaynağını yazın.
2. App Service sayfasındaki sol menüde Ayarlar > Hizmet Bağlayıcısı'nı seçin. Uygulama oluşturma sihirbazının sizin için oluşturduğu bir bağlayıcı zaten var.
3. Bağlayıcının yanındaki onay kutusunu ve ardından Düzenle'yi seçin.
4. Temel Bilgiler sekmesinde İstemci türü'nü SpringBoot olarak ayarlayın. Bu seçenek Spring Boot'a özgü ortam değişkenlerini sizin için oluşturur.
5. Kimlik Doğrulaması sekmesini seçin.
6. Key Vault'ta Gizli Dizi Depola'ya tıklayın.
7. Key Vault Bağlantısı'nın altında Yeni oluştur'u seçin. Düzenle iletişim kutusunun üzerinde Bağlantı oluştur iletişim kutusu açılır.

5. Adım: Key Vault bağlantısı için Bağlantı oluştur iletişim kutusunda:

1. Key Vault'ta daha önce oluşturduğunuz anahtar kasasını seçin.
2. Gözden geçir + Oluştur’u seçin. Sistem tarafından atanan yönetilen kimliğin Seçili olarak ayarlandığını görmeniz gerekir.
3. Doğrulama tamamlandığında Oluştur'u seçin.

6. Adım: DefaultConnector için düzenleme iletişim kutusuna geri dönersiniz.

1. Kimlik Doğrulaması sekmesinde anahtar kasası bağlayıcısının oluşturulmasını bekleyin. Tamamlandığında, Key Vault Bağlantısı açılan listesinde otomatik olarak seçilir.
2. İleri: Ağ'ı seçin.
3. Hedef hizmete erişimi etkinleştirmek için Güvenlik duvarı kurallarını yapılandır'ı seçin. "Hedef hizmette Özel Uç Nokta Yok" iletisini görürseniz, bunu yoksayın. Uygulama oluşturma sihirbazı Cosmos DB veritabanının güvenliğini özel bir uç noktayla zaten sağladı.
4. Kaydet'i seçin. Güncelleştirme başarılı bildirimi görünene kadar bekleyin.

7. Adım: Değişikliklerinizi doğrulamak için:

1. Soldaki menüden Ortam değişkenleri'ni yeniden seçin.
2. spring.data.mongodb.uri ayarının mevcut olduğundan emin olun. Varsayılan bağlayıcı bunu sizin için oluşturdu ve Spring Boot uygulamanız zaten değişkenini kullanıyor.
3. Uygulama ayarının yanında Değeri göster'i seçin. değeri olmalıdır @Microsoft.KeyVault(...); bu da bir anahtar kasası başvurusu olduğu anlamına gelir çünkü gizli dizi artık anahtar kasasında yönetilir.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

4. Örnek kodu dağıtma

Bu adımda GitHub Actions'ı kullanarak GitHub dağıtımını yapılandıracaksınız. App Service'e dağıtmanın birçok yolundan yalnızca biridir, aynı zamanda dağıtım sürecinizde sürekli tümleştirmeye sahip olmanın harika bir yoludur. Varsayılan olarak, GitHub deponuzun her git push örneği derleme ve dağıtma eylemini başlatıyor.

1. Adım: Soldaki menüde Dağıtım>Dağıtım Merkezi'ni seçin.

2. Adım: Dağıtım Merkezi sayfasında:

1. Kaynak bölümünde GitHub'ı seçin. GitHub Actions varsayılan olarak derleme sağlayıcısı olarak seçilir.
2. GitHub hesabınızda oturum açın ve Azure'ı yetkilendirme istemini izleyin.
3. Kuruluş'ta hesabınızı seçin.
4. Depo'da msdocs-spring-boot-mongodb-sample-app öğesini seçin.
5. Branch'te starter-no-infra'yı seçin. Bu, Azure ile ilgili dosyalar veya yapılandırmalar olmadan örnek uygulamanızla birlikte çalıştığınız dalla aynıdır.
6. Kimlik doğrulama türü için Kullanıcı tarafından atanan kimlik'i seçin.
7. Üstteki menüde Kaydet'i seçin. App Service, .github/workflows dizinde seçilen GitHub deposuna bir iş akışı dosyası işler. Varsayılan olarak, dağıtım merkezi Microsoft Entra (OIDC kimlik doğrulaması) kullanarak kimlik doğrulaması yapmak üzere iş akışı için kullanıcı tarafından atanan bir kimlik oluşturur. Alternatif kimlik doğrulama seçenekleri için bkz . GitHub Actions kullanarak App Service'e dağıtma.

3. Adım:

1. Günlükler sekmesini seçin. Yeni bir dağıtımın zaten çalıştırıldığını ancak durumun Başarısız olduğunu görün.
2. Günlükleri Oluştur/Dağıt'ı seçin. GitHub'da çatallanmış deponuzun Eylemler sekmesinde bir tarayıcı sekmesi açılır. Ek Açıklamalar'da hatasını The string 'java21' is not valid SeVer notation for a Java versiongörürsünüz. İsterseniz, daha fazla bilgi edinmek için sayfadaki başarısız derleme adımını seçin.

4. Adım: Hata, GitHub iş akışı sırasında bir sorun olduğunu gösterir. Bunu düzeltmek için önce en son değişiklikleri kod alanınıza çekin. Örnek çatalınızın GitHub kod alanında komutunu çalıştırın git pull origin starter-no-infra. Bu, yeni işlenen iş akışı dosyasını kod alanınıza çeker.

5. Adım (Seçenek 1: GitHub Copilot ile):

1. Sohbet görünümünü ve ardından öğesini seçerek +yeni bir sohbet oturumu başlatın.
2. "@workspace GitHub eylemlerinde neden hata alıyorum: 'java21' dizesi Java sürümü için geçerli SemVer gösterimi değil" sorusunu sorun. Copilot size bir açıklama verebilir ve hatta düzeltmeniz gereken iş akışı dosyasının bağlantısını verebilir.
3. Gezginde .github/workflows/starter-no-infra_msdocs-spring-cosmosdb-123.yaml dosyasını açın ve önerilen düzeltmeyi yapın. GitHub Copilot size her seferinde aynı yanıtı vermez. Yanıtta ince ayar yapmak için daha fazla soru sormanız gerekebilir. İpuçları için bkz . Kod alanımda GitHub Copilot ile ne yapabilirim?.

5. Adım (Seçenek 2: GitHub Copilot olmadan):

1. Gezginde .github/workflows/starter-no-infra_msdocs-spring-cosmosdb-123.yaml dosyasını açın ve eylemi bulunsetup-java@v4.
2. değerini java-version olarak '21'değiştirin.

6. Adım:

1. Kaynak Denetimi uzantısını seçin.
2. Metin kutusuna gibi Fix error in java-versionbir işleme iletisi yazın. Alternatif olarak GitHub Copilot'un sizin için bir işleme iletisi oluşturmasını seçip bırakın.
3. İşle'yi seçin, ardından Evet ile onaylayın.
4. Değişiklikleri eşitle 1'i seçin, ardından Tamam ile onaylayın.

7. Adım: Azure portalındaki Dağıtım Merkezi sayfasına geri dönün:

1. Günlükler sekmesinde Yenile'yi seçin. İşlemiş değişikliklerinizden yeni bir dağıtım çalıştırması zaten başlatılıyor.
2. Dağıtım çalıştırmasının günlük öğesinde, en son zaman damgasını içeren Derleme/Dağıtma Günlükleri girdisini seçin.

8. Adım: GitHub deponuza yönlendirilirsiniz ve GitHub eyleminin çalıştığını görürsünüz. İş akışı dosyası derleme ve dağıtma olarak iki ayrı aşama tanımlar. GitHub çalıştırmasının Tamamlandı durumunu göstermesini bekleyin.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

5. Uygulamaya göz atın

1. Adım: App Service sayfasında:

1. Sol menüden Genel Bakış'ı seçin.
2. Uygulamanızın URL'sini seçin.

2. Adım: Listeye birkaç görev ekleyin. Tebrikler, Azure Cosmos DB'ye güvenli bağlantı ile Azure Uygulaması Hizmeti'nde bir web uygulaması çalıştırıyorsunuz.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

6. Tanılama günlüklerini akışla aktarma

Azure Uygulaması Hizmeti, uygulamanızla ilgili sorunları tanılamanıza yardımcı olmak için konsola gönderilen tüm iletileri yakalar. Örnek uygulama, aşağıdaki kod parçacığında gösterildiği gibi bu özelliği göstermek için standart Log4j günlük deyimlerini içerir:

private static Logger logger = LoggerFactory.getLogger(TodoListController.class);

@Autowired
private TodoItemRepository todoItemRepository;

public TodoListController() {
}

/**
 * HTTP GET
 */
@GetMapping(path = "/api/todolist/{index}", produces = {MediaType.APPLICATION_JSON_VALUE})
public TodoItem getTodoItem(@PathVariable("index") String index) {
    logger.info("GET request access '/api/todolist/{}' path.", index);
    return todoItemRepository.findById(index).get();
}

1. Adım: App Service sayfasında:

1. Sol menüden App Service günlükleri'ni seçin.
2. Uygulama günlüğü'nin altında Dosya Sistemi'ne tıklayın.
3. Üstteki menüde Kaydet'i seçin.

2. Adım: Soldaki menüden Günlük akışı'nı seçin. Kapsayıcının içinden platform günlükleri ve günlükler de dahil olmak üzere uygulamanızın günlüklerini görürsünüz.

.NET, Node.js, Python ve Java uygulamaları için Azure İzleyici OpenTelemetry'yi etkinleştirme konusundaki serideki Java uygulamalarında oturum açma hakkında daha fazla bilgi edinin.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

7. Kaynakları temizleme

İşiniz bittiğinde, kaynak grubunu silerek Azure aboneliğinizdeki tüm kaynakları silebilirsiniz.

1. Adım: Azure portalının üst kısmındaki arama çubuğunda:

1. Kaynak grubu adını girin.
2. Kaynak grubunu seçin.

2. Adım: Kaynak grubu sayfasında Kaynak grubunu sil'i seçin.

3. Adım:

1. Kaynak grubu adını yazarak silme işleminizi onaylayın.
2. Sil'i seçin.
3. Sil ile yeniden onaylayın.

2. Azure kaynakları oluşturma ve örnek uygulama dağıtma

Bu adımda Azure kaynaklarını oluşturur ve Linux üzerinde App Service için örnek bir uygulama dağıtırsınız. Bu öğreticide kullanılan adımlar, App Service ve Azure Cosmos DB içeren varsayılan olarak güvenli bir kaynak kümesi oluşturur.

Geliştirme kapsayıcısı zaten Azure Geliştirici CLI'sine (AZD) sahiptir.

1. Depo kökünden komutunu çalıştırın azd init.

   azd init --template javase-app-service-cosmos-redis-infra
   

2. İstendiğinde aşağıdaki yanıtları verin:

   Soru	Yanıt
   Geçerli dizin boş değil. Burada '<your-directory>' içinde bir proje başlatmak istiyor musunuz?	Y
   Bu dosyalarla ne yapmak istiyorsunuz?	Mevcut dosyalarımı değiştirmeden tut
   Yeni bir ortam adı girin	Benzersiz bir ad yazın. AZD şablonu, Azure'da (<app-name>-<hash>.azurewebsites.net) web uygulamanızın DNS adının bir parçası olarak bu adı kullanır. Alfasayısal karakterlere ve kısa çizgilere izin verilir.

3. komutunu çalıştırıp azd auth login istemi izleyerek Azure'da oturum açın:

   azd auth login
   

4. Gerekli Azure kaynaklarını oluşturun ve komutuyla uygulama kodunu dağıtın azd up . İstemi izleyerek Azure kaynakları için istenen aboneliği ve konumu seçin.

   azd up
   

   Komutun azd up tamamlanması yaklaşık 15 dakika sürer (Redis önbelleği en çok zaman alır). Ayrıca uygulama kodunuzu derleyip dağıtır, ancak kodunuzu daha sonra App Service ile çalışacak şekilde değiştireceksiniz. Komutu çalışırken, Azure'daki dağıtıma bir bağlantı da dahil olmak üzere sağlama ve dağıtım işlemiyle ilgili iletiler sağlar. Tamamlandığında, komut dağıtım uygulamasının bağlantısını da görüntüler.

   Bu AZD şablonu, aşağıdaki Azure kaynaklarıyla varsayılan olarak güvenli bir mimari oluşturan dosyaları (azure.yaml ve infra dizini) içerir:

   • Kaynak grubu: Oluşturulan tüm kaynaklar için kapsayıcı.
   • App Service planı: App Service için işlem kaynaklarını tanımlar. B1 katmanında bir Linux planı oluşturulur.
   • App Service: Uygulamanızı temsil eder ve App Service planında çalışır.
   • Sanal ağ: App Service uygulamasıyla tümleştirilmiş ve arka uç ağ trafiğini yalıtıyor.
   • MongoDB API'sine sahip Azure Cosmos DB hesabı: Yalnızca özel uç noktasının arkasından erişilebilir. Sunucuda sizin için bir veritabanı oluşturulur.
   • Redis için Azure Cache: Yalnızca sanal ağ içinden erişilebilir.
   • Anahtar kasası: Yalnızca özel uç noktasının arkasından erişilebilir. App Service uygulamasının gizli dizilerini yönetmek için kullanılır.
   • Özel uç noktalar: Sanal ağdaki anahtar kasası, veritabanı sunucusu ve Redis önbelleği için erişim uç noktaları.
   • Özel DNS bölgeleri: Cosmos DB veritabanının, Redis önbelleğinin ve sanal ağdaki anahtar kasasının DNS çözümlemesini etkinleştirin.
   • Log Analytics çalışma alanı: Uygulamanızın günlüklerini göndermesi için hedef kapsayıcı görevi görür ve burada günlükleri de sorgulayabilirsiniz.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

3. bağlantı dizesi doğrulama

Kullandığınız AZD şablonu, sizin için zaten uygulama ayarları olarak bağlantı değişkenlerini oluşturmuş ve size kolaylık sağlamak için bunları terminale çıkış olarak göndermektedir. Uygulama ayarları, bağlantı gizli dizilerini kod deponuzun dışında tutmanın bir yoludur.

1. AZD çıkışında uygulama ayarını spring.data.mongodb.uribulun. Yalnızca ayar adları görüntülenir. AZD çıkışında aşağıdakine benzerler:

    App Service app has the following app settings:
            - spring.data.mongodb.uri
            - spring.data.mongodb.database
            - spring.redis.host
            - spring.redis.port
            - spring.redis.password
            - spring.redis.database
            - spring.redis.ssl
            - spring.cloud.azure.keyvault.secret.credential.managed_identity_enabled
            - spring.cloud.azure.keyvault.secret.endpoint
            - azure.keyvault.uri
            - azure.keyvault.scope
    

   spring.data.mongodb.uri Azure'daki Cosmos DB veritabanına bağlantı URI'sini içerir. Bu, uygulamanızın src/main/resources/application.properties dosyasında zaten kullandığı standart bir Spring Data değişkenidir.

2. Gezginde src/main/resources/application.properties adresine gidin ve Spring Boot uygulamanızın spring.data.mongodb.uri verilere erişmek için değişkeni zaten kullandığını görün.

3. Size kolaylık olması için AZD şablonu çıkışı, uygulamanın uygulama ayarları sayfasına doğrudan bağlantıyı gösterir. Bağlantıyı bulun ve yeni bir tarayıcı sekmesinde açın.

   değerine bakarsanız değeri spring.data.mongodb.uriolmalıdır@Microsoft.KeyVault(...). Bu, anahtar kasası başvurusu olduğu anlamına gelir çünkü gizli dizi anahtar kasasında yönetilir.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

4. Uygulamaya göz atın

1. AZD çıkışında uygulamanızın URL'sini bulun ve tarayıcıda bu URL'ye gidin. URL, AZD çıkışında şöyle görünür:

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>-<hash>.azurewebsites.net/
    

2. Listeye birkaç görev ekleyin.

   

   Tebrikler, Azure Cosmos DB'ye güvenli bağlantı ile Azure Uygulaması Hizmeti'nde bir web uygulaması çalıştırıyorsunuz.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

5. Tanılama günlüklerini akışla aktarma

Azure Uygulaması Hizmeti, uygulamanızla ilgili sorunları tanılamanıza yardımcı olmak için konsol günlüklerini yakalayabilir. Kolaylık olması için AZD şablonu yerel dosya sisteminde günlüğe kaydetmeyi zaten etkinleştirdi ve günlükleri Log Analytics çalışma alanına gönderiyor.

Örnek uygulama, aşağıdaki kod parçacığında gösterildiği gibi bu özelliği göstermek için standart Log4j günlük deyimlerini içerir:

private static Logger logger = LoggerFactory.getLogger(TodoListController.class);

@Autowired
private TodoItemRepository todoItemRepository;

public TodoListController() {
}

/**
 * HTTP GET
 */
@GetMapping(path = "/api/todolist/{index}", produces = {MediaType.APPLICATION_JSON_VALUE})
public TodoItem getTodoItem(@PathVariable("index") String index) {
    logger.info("GET request access '/api/todolist/{}' path.", index);
    return todoItemRepository.findById(index).get();
}

AZD çıkışında App Service günlüklerinin akışının bağlantısını bulun ve tarayıcıda bu bağlantıya gidin. Bağlantı, AZD çıkışında şöyle görünür:

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

.NET, Node.js, Python ve Java uygulamaları için Azure İzleyici OpenTelemetry'yi etkinleştirme konusundaki serideki Java uygulamalarında oturum açma hakkında daha fazla bilgi edinin.

Sorun mu yaşıyorsunuz? Sorun Giderme bölümüne bakın.

6. Kaynakları temizleme

Geçerli dağıtım ortamındaki tüm Azure kaynaklarını silmek için komutunu çalıştırın azd down ve istemleri izleyin.

azd down

Sorun giderme

• Azure Cosmos DB için portal dağıtım görünümü Çakışma durumu gösteriyor
• Dağıtılan örnek uygulama, görev listesi uygulamasını göstermiyor

Azure Cosmos DB için portal dağıtım görünümü Çakışma durumu gösteriyor

Aboneliğinize ve seçtiğiniz bölgeye bağlı olarak Azure Cosmos DB'nin Conflictdağıtım durumunu, İşlem ayrıntıları bölümünde aşağıdaki iletiyle görebilirsiniz:

Sorry, we are currently experiencing high demand in <region> region, and cannot fulfill your request at this time.

Hatanın nedeni büyük olasılıkla seçtiğiniz bölge için aboneliğinizdeki bir sınırdır. Dağıtımınız için farklı bir bölge seçmeyi deneyin.

Dağıtılan örnek uygulama, görev listesi uygulamasını göstermiyor

Görev listesi uygulaması yerine bir Hey, Java developers! sayfa görüyorsanız, App Service büyük olasılıkla en son kod dağıtımınızdan güncelleştirilmiş kapsayıcıyı yüklemeye devam ediyordur. Birkaç dakika bekleyin ve sayfayı yenileyin.

Sık sorulan sorular

• Bu kurulumun maliyeti ne kadardır?
• Sanal ağın arkasındaki Cosmos DB veritabanıyla veritabanı geçişini Nasıl yaparım? çalıştırabilirsiniz?
• Yerel uygulama geliştirme GitHub Actions ile nasıl çalışır?
• Kullanıcı tarafından atanan kimlik oluşturma iznim yok

Bu kurulumun maliyeti ne kadardır?

Oluşturulan kaynakların fiyatlandırması aşağıdaki gibidir:

• App Service planı Temel katmanda oluşturulur ve ölçeği artırılabilir veya azaltılabilir. Bkz. App Service fiyatlandırması.
• Azure Cosmos DB hesabı Sunucusuz katmanında oluşturulur ve bu katmanla ilişkili küçük bir maliyet vardır. Bkz. Azure Cosmos DB fiyatlandırması.
• Redis için Azure Cache temel katmanda en düşük önbellek boyutuyla oluşturulur. Bu katmanla ilişkili küçük bir maliyet vardır. Daha yüksek kullanılabilirlik, kümeleme ve diğer özellikler için ölçeğini daha yüksek performans katmanlarına artırabilirsiniz. Bkz. Redis için Azure Cache fiyatlandırma.
• Eşleme gibi ek işlevler yapılandırmadığınız sürece sanal ağ ücret ödemez. Bkz. Azure Sanal Ağ fiyatlandırması.
• Özel DNS bölgesi küçük bir ücrete tabi. Bkz. Azure DNS fiyatlandırması.

Sanal ağın arkasındaki Cosmos DB veritabanıyla veritabanı geçişini Nasıl yaparım? çalıştırabilirsiniz?

App Service'teki Java SE kapsayıcısının Cosmos DB'ye zaten ağ bağlantısı vardır, ancak herhangi bir geçiş aracı veya diğer MongoDB araçlarını içermez. Birkaç seçeneğiniz vardır:

• Uygulama başlangıcında, örneğin Hazırda Beklet ve veya Flyway ile veritabanı geçişlerini otomatik olarak çalıştırın.
• Uygulamanın SSH oturumunda Flyway CLI gibi bir geçiş aracı yükleyin ve geçiş betiğini çalıştırın. Yüklü aracın uygulama yeniden başlatıldıktan sonra /home dizininde olmadığı sürece kalıcı olmayacağı unutmayın.
• Azure cloud shell'i sanal ağ ile tümleştirin ve buradan veritabanı geçişlerini çalıştırın.

Yerel uygulama geliştirme GitHub Actions ile nasıl çalışır?

Örnek olarak App Service'ten otomatik olarak oluşturulan iş akışı dosyasının kullanılması, yeni git push bir derleme ve dağıtım çalıştırması başlatır. GitHub deposunun yerel bir kopyasından istediğiniz güncelleştirmeleri yapar ve GitHub'a gönderebilirsiniz. Örneğin:

git add .
git commit -m "<some-message>"
git push origin main

Kullanıcı tarafından atanan kimlik oluşturma iznim yok

Bkz . Dağıtım Merkezi'nden GitHub Actions dağıtımını ayarlama.

Kod alanımda GitHub Copilot ile ne yapabilirim?

Kod alanını oluştururken GitHub Copilot sohbet görünümünün zaten sizin için orada olduğunu fark edebilirsiniz. Kolaylık sağlamak için kapsayıcı tanımına GitHub Copilot sohbet uzantısını dahil ediyoruz (bkz . .devcontainer/devcontainer.json). Ancak, bir GitHub Copilot hesabına ihtiyacınız vardır (30 günlük ücretsiz deneme sürümü kullanılabilir).

GitHub Copilot ile konuşurken size birkaç ipucu:

• Tek bir sohbet oturumunda, sorular ve yanıtlar birbirleri üzerinde derlenebilir ve sorularınızı ayarlayarak, elde ettiğiniz yanıta ince ayar yapabilirsiniz.
• Varsayılan olarak, GitHub Copilot'un deponuzdaki hiçbir dosyaya erişimi yoktur. Dosya hakkında soru sormak için önce düzenleyicide dosyayı açın.
• GitHub Copilot'ın yanıtlarını hazırlarken depodaki tüm dosyalara erişmesine izin vermek için sorunuza ile @workspacebaşlayın. Daha fazla bilgi için bkz. Use the @workspace agent.
• Sohbet oturumunda, GitHub Copilot değişiklikleri önerebilir ve (ile @workspace) değişikliklerin yapılacağı yeri bile önerebilir, ancak değişiklikleri sizin için yapmasına izin verilmez. Önerilen değişiklikleri eklemek ve test etmek size bağlı.

Sonraki adımlar

• Java Geliştiricileri için Azure
• Spring Boot
• Azure Cosmos DB için Spring Data
• Azure Cosmos DB ve -App Service Linux

Geliştirici kılavuzunda App Service'te Java uygulamalarını çalıştırma hakkında daha fazla bilgi edinin.

Azure Uygulaması Hizmetinde Java uygulaması yapılandırma

Özel bir etki alanı ve sertifikayla uygulamanızın güvenliğini sağlamayı öğrenin.

 Özel etki alanı ve sertifika ile güvenli