Azure Spring Apps'te yönetilen Spring Cloud Config Sunucusu yapılandırma

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

Bu makale şunlar için geçerlidir: ✔️ Standart tüketim ve ayrılmış (Önizleme) ✔️ Temel/Standart ✔️ Kurumsal

Bu makalede, Azure Spring Apps'te yönetilen Spring Cloud Config Server'ı yapılandırma adımları gösterilmektedir.

Spring Cloud Config Server, dağıtılmış bir sistemdeki dışlaştırılmış yapılandırma için sunucu ve istemci tarafı desteği sağlar. Spring Cloud Config Server örneği, tüm ortamlardaki uygulamaların dış özelliklerini yönetmek için merkezi bir yer sağlar. Daha fazla bilgi için bkz . Spring Cloud Config.

Önkoşullar

• Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

• Git.

Kısıtlamalar

Git arka ucuyla Yapılandırma Sunucusu'nu kullandığınızda bazı kısıtlamalar vardır. Aşağıdaki özellikler, Yapılandırma Sunucusu ve Hizmet Bulma'ya erişmek için uygulama ortamınıza otomatik olarak eklenir. Yapılandırma Sunucusu dosyalarınızdan da bu özellikleri yapılandırdıysanız, çakışmalar ve beklenmeyen davranışlarla karşılaşabilirsiniz.

• eureka.client.service-url.defaultZone
• eureka.client.tls.keystore
• eureka.instance.preferIpAddress
• eureka.instance.instance-id
• server.port
• spring.cloud.config.tls.keystore
• spring.config.import
• spring.application.name
• spring.jmx.enabled
• management.endpoints.jmx.exposure.include

Yapılandırma Sunucusu dosyalarınızı oluşturma

Azure Spring Apps, Config Server dosyalarınızı depolamak için Azure DevOps Server, GitHub, GitLab ve Bitbucket'i destekler. Deponuz hazır olduğunda yapılandırma dosyalarını oluşturabilir ve orada depolayabilirsiniz.

Bazı yapılandırılabilir özellikler yalnızca belirli türler için kullanılabilir. Aşağıdaki bölümlerde her depo türünün özellikleri açıklanmaktadır.

Genel depo

Genel depo kullandığınızda yapılandırılabilir özellikleriniz özel depoda olduğundan daha sınırlı olur.

Aşağıdaki tabloda, genel Git deposu ayarlamak için kullanabileceğiniz yapılandırılabilir özellikler listelenir:

SSH kimlik doğrulaması ile özel depo

Aşağıdaki tabloda, SSH ile özel bir Git deposu ayarlamak için kullanabileceğiniz yapılandırılabilir özellikler listelenir:

Temel kimlik doğrulaması ile özel depo

Aşağıdaki tabloda, temel kimlik doğrulamasıyla özel bir Git deposu ayarlamak için kullanabileceğiniz yapılandırılabilir özellikler listelenir:

Diğer Git depoları

Aşağıdaki tabloda Git depolarını bir desenle ayarlamak için kullanabileceğiniz yapılandırılabilir özellikler listelenir:

Aşağıdaki tabloda, hizmetinizi isteğe bağlı bir ek depoyla yapılandırmaya yönelik bazı desen örnekleri gösterilmektedir. Daha fazla bilgi için bu makaledeki Ek depolar bölümüne ve Spring Cloud Config'in Desen Eşleştirme ve Birden Çok Depo bölümüne bakın.

Config Server'a karşı Git deposu yapılandırma

Yapılandırma dosyalarınızı bir depoya kaydettikten sonra Azure Spring Apps'i depoya bağlamak için aşağıdaki adımları kullanın:

1. Azure Portal’ında oturum açın.

2. Azure Spring Apps'e Genel Bakış sayfanıza gidin.

3. Gezinti bölmesinde Spring Cloud Config Server'ı seçin.

4. Varsayılan depo bölümünde URI'yi olarak https://github.com/Azure-Samples/piggymetrics-configayarlayın.

5. Doğrula'yı seçin.

   

   

6. Doğrulama tamamlandığında, değişikliklerinizi kaydetmek için Uygula'yı seçin.

   

   

Yapılandırmanın güncelleştirilmesi birkaç dakika sürebilir. Yapılandırma tamamlandığında bir bildirim almalısınız.

Depo bilgilerini doğrudan Azure portalına girin

Varsayılan depo ve isteğe bağlı olarak ek depolar için depo bilgilerini girebilirsiniz.

Varsayılan depo

Bu bölümde, genel veya özel bir depo için depo bilgilerini nasıl gireceğiniz gösterilmektedir. Özel bir depo için Temel kimlik doğrulaması veya SSH kullanabilirsiniz.

Genel bir deponun depo bilgilerini girmek için aşağıdaki adımları kullanın:

1. Varsayılan depo bölümündeki Uri kutusuna depo URI'sini yapıştırın.
2. Etiket ayarı için config girin.
3. Kimlik Doğrulaması ayarının Genel olduğundan emin olun.
4. Uygula’yı seçin.

Temel parola/belirteç tabanlı kimlik doğrulaması kullanarak özel bir deponun depo bilgilerini girmek için aşağıdaki adımları kullanın:

1. Varsayılan depo bölümündeki Uri kutusuna depo URI'sini yapıştırın.

2. Kimlik Doğrulaması'nın altında Kimlik Doğrulamayı Düzenle'yi seçin.

3. Kimlik Doğrulamasını Düzenle bölmesinde, Kimlik doğrulama türü açılan listesinde HTTP Temel'i seçin.

4. Azure Spring Apps'e erişim vermek için kullanıcı adınızı ve parolanızı/belirtecinizi girin.

5. Tamam'ı ve ardından Uygula'yı seçerek Yapılandırma Sunucusu örneğinizi ayarlamayı tamamlayın.

   

   Not

   Birçok Git deposu sunucusu, HTTP temel kimlik doğrulaması için parolalar yerine belirteç kullanımını destekler. Bazı depolar belirteçlerin süresiz olarak kalıcı olmasını sağlar. Ancak Azure DevOps Server da dahil olmak üzere bazı Git depo sunucuları belirteçlerin süresinin birkaç saat içinde dolmasına zorlar. Belirteçlerin süresinin dolmasına neden olan depolarda Azure Spring Apps ile belirteç tabanlı kimlik doğrulaması kullanılmamalıdır. Böyle bir belirteç kullanıyorsanız süresi dolmadan önce güncelleştirmeyi unutmayın.

   GitHub, parola kimlik doğrulaması desteğini kaldırdığından GitHub için parola kimlik doğrulaması yerine kişisel erişim belirteci kullanmanız gerekir. Daha fazla bilgi için bkz . Git işlemleri için belirteç kimlik doğrulaması gereksinimleri.

SSH kullanarak özel bir deponun depo bilgilerini girmek için aşağıdaki adımları kullanın:

1. Varsayılan depo bölümündeki Uri kutusuna depo URI'sini yapıştırın.

2. Kimlik Doğrulaması'nın altında Kimlik Doğrulamayı Düzenle'yi seçin.

3. Kimlik Doğrulamasını Düzenle bölmesindeki Kimlik doğrulama türü açılan listesinde SSH'yi seçin.

4. Özel anahtarınızı girin. İsteğe bağlı olarak konak anahtarınızı ve konak anahtarı algoritmanızı belirtin.

5. Ortak anahtarınızı Yapılandırma Sunucusu deponuza ekleyin.

6. Tamam'ı ve ardından Uygula'yı seçerek Yapılandırma Sunucusu örneğinizi ayarlamayı tamamlayın.

   

Ek depolar

Hizmetinizi isteğe bağlı bir ek depoyla yapılandırmak istiyorsanız aşağıdaki adımları kullanın:

1. Varsayılan depo için yaptığınız gibi Uri ve Kimlik Doğrulama ayarlarını belirtin. Deseniniz için bir Ad ayarı eklediğinizden emin olun.
2. Depoyu örneğinize eklemek için Uygula'yı seçin.

YAML dosyasını içeri aktararak Git deposunu yapılandırma

Depo ayarlarınızla bir YAML dosyası yazdıysanız, dosyayı doğrudan yerel makinenizden Azure Spring Apps'e aktarabilirsiniz. Aşağıdaki örnekte, temel kimlik doğrulamasına sahip özel bir depo için basit bir YAML dosyası gösterilmektedir:

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/azure-spring-apps-samples-pr/config-server-repository.git
          username: <username>
          password: <password/token>

YAML dosyasını içeri aktarmak için aşağıdaki adımları kullanın:

1. Ayarları içeri aktar'ı ve ardından proje dizininizden YAML dosyasını seçin. İçeri aktar'ı seçin.

   

   

   Bildirimler bölmesinde bir async işlem görüntülenir. Yapılandırma Sunucusu 1-2 dakika sonra başarılı olduğunu bildirmelidir. YAML dosyanızdaki bilgiler Azure portalında görüntülenir.

2. İçeri aktarma işlemini tamamlamak için Uygula'yı seçin.

Azure Repos'ı Yapılandırma Sunucusu ile yapılandırma

Azure Spring Apps genel, SSH ile güvenliği sağlanan veya HTTP temel kimlik doğrulaması kullanılarak güvenliği sağlanan Git depolarına erişebilir. HTTP temel kimlik doğrulaması, Azure Depoları ile depo oluşturma ve yönetme seçeneklerinin en kolayıdır.

Depo URL'sini ve kimlik bilgilerini alma

Depo URL'nizi ve kimlik bilgilerinizi almak için aşağıdaki adımları kullanın:

1. Projenizin Azure Repos portalında Kopyala'yı seçin.

2. Metin kutusundan kopya URL'sini kopyalayın. Bu URL genellikle aşağıdaki biçimdedir:

   https://<organization name>@dev.azure.com/<organization name>/<project name>/_git/<repository name>
   

   simgesi de dahil olmak üzere ve sonrasındaki @ dev.azure.comher şeyi https:// kaldırın. Sonuçta elde edilen URL aşağıdaki biçimde olmalıdır:

   https://dev.azure.com/<organization name>/<project name>/_git/<repository name>
   

   Daha sonra kullanmak için bu URL'yi kaydedin.

3. Kullanıcı adı ve parola görüntülemek için Git Kimlik Bilgileri Oluştur'a tıklayın. Aşağıdaki bölümde kullanmak üzere bu kullanıcı adını ve parolayı kaydedin.

Config Server'a karşı Git deposu yapılandırma

Depoyu yapılandırmak için aşağıdaki adımları kullanın:

1. Azure Portal’ında oturum açın.

2. Azure Spring Apps'e Genel Bakış sayfanıza gidin.

3. Yapılandırılan hizmeti seçin.

4. Hizmet sayfasının sol bölmesinde, Ayarlar'ın altında Spring Cloud Config Server sekmesini seçin.

5. Oluşturduğunuz depoyu yapılandırmak için aşağıdaki adımları kullanın:

   • Daha önce kaydettiğiniz depo URI'sini ekleyin.
   • Kimlik Doğrulamasını Düzenle bölmesini açmak için Kimlik Doğrulaması'nın altındaki ayarı seçin.
   • Kimlik doğrulama türü için HTTP Temel'i seçin.
   • Kullanıcı adı için, daha önce kaydettiğiniz kullanıcı adını belirtin.
   • Parola için daha önce kaydettiğiniz parolayı belirtin.
   • Tamam'ı seçin ve işlemin tamamlanmasını bekleyin.

   

az spring config-server bind \
    --resource-group <resource-group> \
    --service <service-name> \
    --app <app-name>

az spring app create \ 
    --resource-group <resource-group> \ 
    --service <service-name> \ 
    --name <app-name> \ 
    --bind-config-server

Yapılandırmanızı silme

Mevcut ayarlarınızı silmek için Spring Cloud Config Server sekmesinde Sıfırla'yı seçin. GitHub'dan Azure DevOps Server'a geçerken olduğu gibi, Yapılandırma Sunucusu örneğinizi başka bir kaynağa bağlamak istiyorsanız yapılandırma sunucusu ayarlarını silin.

Yapılandırma Sunucusunu Yenile

Özellikler değiştirildiğinde, değişikliklerin yapılabilmesi için önce bu özellikleri kullanan hizmetlere bildirilmesi gerekir. Spring Cloud Config Server için varsayılan çözüm, yenileme olayını el ile tetiklemektir. Bu işlem çok sayıda uygulama örneği varsa mümkün olmayabilir. Daha fazla bilgi için bkz . Merkezi Yapılandırma

Bunun yerine, yapılandırma istemcisinin bir yenileme iç öğesini temel alan değişiklikler için yoklamasına izin vererek yapılandırma sunucusundan değerleri otomatik olarak yenileyebilirsiniz.

Yapılandırma Sunucusu'ndan değerleri otomatik olarak yenilemek için aşağıdaki adımları kullanın:

1. Aşağıdaki örnekte gösterildiği gibi belirli bir aralıkta bağlamı yenilemek için zamanlanmış bir görevi kaydedin:

   @ConditionalOnBean({RefreshEndpoint.class})
   @Configuration
   @AutoConfigureAfter({RefreshAutoConfiguration.class, RefreshEndpointAutoConfiguration.class})
   @EnableScheduling
   public class ConfigClientAutoRefreshConfiguration implements SchedulingConfigurer {
       @Value("${spring.cloud.config.refresh-interval:60}")
       private long refreshInterval;
       @Value("${spring.cloud.config.auto-refresh:false}")
       private boolean autoRefresh;
       private RefreshEndpoint refreshEndpoint;
       public ConfigClientAutoRefreshConfiguration(RefreshEndpoint refreshEndpoint) {
           this.refreshEndpoint = refreshEndpoint;
       }
       @Override
       public void configureTasks(ScheduledTaskRegistrar scheduledTaskRegistrar) {
           if (autoRefresh) {
               // set minimal refresh interval to 5 seconds
               refreshInterval = Math.max(refreshInterval, 5);
               scheduledTaskRegistrar.addFixedRateTask(() -> refreshEndpoint.refresh(), refreshInterval * 1000);
           }
       }
   }
   

2. otomatik başvuruyu etkinleştirin ve application.yml dosyanızda uygun yenileme aralığını ayarlayın. Aşağıdaki örnekte, istemci yapılandırma değişikliklerini her 60 saniyede bir yoklar. Bu, yenileme aralığı için ayarlayabileceğiniz en düşük değerdir.

   Varsayılan olarak, autorefresh olarak ayarlanır false ve yenileme aralığı olarak 60 secondsayarlanır.

   spring:
       cloud:
            config:
             auto-refresh: true
             refresh-interval: 60
   management:
       endpoints:
            web:
             exposure:
               include:
                 - refresh
   

3. Kodunuza ekleyin @RefreshScope . Aşağıdaki örnekte değişken connectTimeout her 60 saniyede bir otomatik olarak yenilenir.

   @RestController
   @RefreshScope
   public class HelloController {
       @Value("${timeout:4000}")
       private String connectTimeout;
   }
   

Daha fazla bilgi için config-client-polling örneğine bakın.

az spring config-server create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

az spring config-server delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

İlgili içerik

Azure Spring Apps