Hızlı Başlangıç: Azure Uygulama Yapılandırması ile Java Spring uygulaması oluşturma

Bu hızlı başlangıçta, kodundan ayrı Azure Uygulama Yapılandırması uygulama ayarlarının depolanması ve yönetimini merkezileştirmek için bir Java Spring uygulamasına yeni bir uygulama ekleyebilirsiniz.

Önkoşullar

• Azure aboneliği - ücretsiz bir abonelik oluşturun
• Sürüm 8'e sahip desteklenen bir Java Development Kit (JDK).
• Apache Maven sürüm 3.0 veya üzeri.

Uygulama Yapılandırma deposu oluşturma

1. Yeni bir uygulama yapılandırma deposu oluşturmak için Azure Portaloturum açın. Giriş sayfasının sol üst köşesinde kaynak oluştur' u seçin. Market 'te Ara kutusuna uygulama yapılandırması ' nı girin ve ENTER' u seçin.

   

2. Arama sonuçlarından uygulama yapılandırması ' nı seçin ve ardından Oluştur' u seçin.

   

3. Uygulama yapılandırması oluştur bölmesinde, aşağıdaki ayarları girin:

   Ayar	Önerilen değer	Açıklama
   Abonelik	Aboneliğiniz	Uygulama yapılandırmasını test etmek için kullanmak istediğiniz Azure aboneliğini seçin. Hesabınızda yalnızca bir abonelik varsa, bu otomatik olarak seçilir ve abonelik listesi gösterilmez.
   Kaynak grubu	AppConfigTestResources	Uygulama yapılandırma deposu kaynağınız için bir kaynak grubu seçin veya oluşturun. Bu grup, kaynak grubunu silerek aynı anda silmek isteyebileceğiniz birden çok kaynağı düzenlemek için yararlıdır. Daha fazla bilgi için Azure kaynaklarınızı yönetmek için kaynak gruplarını kullanma konusunu inceleyin.
   Kaynak adı	Genel olarak benzersiz bir ad	Uygulama yapılandırma deposu kaynağı için kullanılacak benzersiz bir kaynak adı girin. Ad, 5 ila 50 karakter arasında bir dize olmalı ve yalnızca rakam, harf ve - karakter içermelidir. Ad, karakteriyle başlayamaz veya bitemez - .
   Konum	Central US	Uygulama yapılandırma deponuzın barındırıldığı coğrafi konumu belirtmek için konum ' i kullanın. En iyi performansı elde etmek için, kaynağı uygulamanızın diğer bileşenleriyle aynı bölgede oluşturun.
   Fiyatlandırma katmanı	Ücretsiz	İstediğiniz fiyatlandırma katmanını seçin. Daha fazla bilgi için bkz. uygulama yapılandırma fiyatlandırma sayfası.

4. Ayarlarınızı doğrulamak için gözden geçir + oluştur ' u seçin.

5. Oluştur’u seçin. Dağıtım birkaç dakika sürebilir.

6. Dağıtım bittikten sonra uygulama yapılandırma kaynağına gidin. Ayarlar > Erişim anahtarları öğesini seçin. Birincil salt okunurdur anahtar bağlantı dizesini bir yere unutmayın. Uygulamanızı oluşturduğunuz uygulama yapılandırma deposuyla iletişim kuracak şekilde yapılandırmak için bu bağlantı dizesini daha sonra kullanacaksınız.

7. Aşağıdaki > anahtar-değer çiftlerini eklemek için Yapılandırma Gezgini + > Anahtar-değer Oluştur'a tıklayın:

   Anahtar	Değer
   /application/config.message	Hello

   Etiket ve İçerik Türü'leri şimdilik boş bırakın.

8. Uygula’yı seçin.

Spring Boot oluşturma

Spring Initializr'ı kullanarak yeni bir Spring Boot oluşturun.

1. https://start.spring.io/ adresine gidin.

2. Aşağıdaki seçenekleri belirtin:

   • Java ile bir Maven projesi oluşturun.
   • 2 Spring Boot 2.0'a eşit veya daha büyük bir sürüm belirtin.
   • Uygulamanız için Grup ve Yapıt adlarını belirtin.
   • Spring Web bağımlılığını ekleyin.

3. Önceki seçenekleri belirtdikten sonra Oluştur'Project. İstendiğinde, projeyi yerel bilgisayarınızda bir yola indirin.

Bağlan Yapılandırma deposuna yapılandırma

1. Yerel sisteminize dosyaları ayıkladikten sonra, basit Spring Boot uygulama düzenleme için hazırdır. Uygulamanın pom.xml dizininde dosyanın adını bulun.

2. pom.xml dosyasını bir metin düzenleyicisinde açın ve Spring Cloud Azure Config başlatıcıyı listesine <dependencies> ekleyin:

   Spring Boot 2.4

   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>azure-spring-cloud-appconfiguration-config</artifactId>
       <version>2.0.0</version>
   </dependency>
   

   Not

   Uygulamanın eski bir sürümünü desteklemeye ihtiyacınız Spring Boot eski kitaplığımıza bakın.

3. Uygulamanın package dizininde MessageProperties.java adlı yeni bir Java dosyası oluşturun. Aşağıdaki satırları ekleyin:

   package com.example.demo;
   
   import org.springframework.boot.context.properties.ConfigurationProperties;
   
   @ConfigurationProperties(prefix = "config")
   public class MessageProperties {
       private String message;
   
       public String getMessage() {
           return message;
       }
   
       public void setMessage(String message) {
           this.message = message;
       }
   }
   

4. Uygulamanın package dizininde HelloController.java adlı yeni bir Java dosyası oluşturun. Aşağıdaki satırları ekleyin:

   package com.example.demo;
   
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   public class HelloController {
       private final MessageProperties properties;
   
       public HelloController(MessageProperties properties) {
           this.properties = properties;
       }
   
       @GetMapping
       public String getMessage() {
           return "Message: " + properties.getMessage();
       }
   }
   

5. Ana uygulama Java dosyasını açın ve bu özelliği @EnableConfigurationProperties etkinleştirmek için ekleyin.

   import org.springframework.boot.context.properties.EnableConfigurationProperties;
   
   @SpringBootApplication
   @EnableConfigurationProperties(MessageProperties.class)
   public class DemoApplication {
       public static void main(String[] args) {
           SpringApplication.run(DemoApplication.class, args);
       }
   }
   

6. Uygulamanın resources bootstrap.properties dizininde adlı yeni bir dosya oluşturun ve dosyaya aşağıdaki satırları ekleyin. Örnek değerleri Uygulama Yapılandırma mağazanız için uygun özelliklerle değiştirin.

   spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}
   

7. APP_CONFIGURATION_CONNECTION_STRING adlı bir ortam değişkeni ayarlayın ve bunu Uygulama Yapılandırma mağazanıza erişim anahtarı olarak ayarlayın. Komut satırına aşağıdaki komutu çalıştırın ve değişikliğin etkili olmasına izin vermek için komut istemini yeniden başlatın:

   setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
   

   Aşağıdaki komutu Windows PowerShell çalıştırın:

   $Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
   

   macOS veya Linux kullanıyorsanız aşağıdaki komutu çalıştırın:

   export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
   

Uygulamayı yerel olarak derleme ve çalıştırma

1. Maven Spring Boot uygulamanızı derleme ve çalıştırma, örneğin:

   mvn clean package
   mvn spring-boot:run
   

2. Uygulamanız çalıştır başladıktan sonra curl kullanarak uygulamanızı test sınayın, örneğin:

   curl -X GET http://localhost:8080/
   

   Uygulama Yapılandırma deposuna girdiğiniz iletiyi görüyorsunuz.

Kaynakları temizleme

Bu makalede oluşturulan kaynakları kullanmaya devam etmek istemiyorsanız, ücretlendirmemek için burada oluşturduğunuz kaynak grubunu silin.

1. Azure Portaloturum açın ve kaynak grupları' nı seçin.
2. Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
3. Sonuç listesinde, bir genel bakışı görmek için kaynak grubu adını seçin.
4. Kaynak grubunu sil'i seçin.
5. Kaynak grubunun silinmesini onaylamanız istenir. Onaylamak için kaynak grubunuzun adını girin ve Sil' i seçin.

Birkaç dakika sonra kaynak grubu ve tüm kaynakları silinir.

Sonraki adımlar

Bu hızlı başlangıçta yeni bir Uygulama Yapılandırma deposu oluşturdunız ve bunu bir Java Spring uygulamasıyla kullandınız. Daha fazla bilgi için bkz. Azure'da Spring. Java Spring uygulamanıza yapılandırma ayarlarını dinamik olarak yenilemeyi etkinleştirmeyi öğrenmek için sonraki öğreticiye devam edin.