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

Makale
06/14/2024

Not

Azure Spring Apps, Azure Spring Cloud hizmetinin yeni adıdır. Hizmetin yeni bir adı olsa da, ekran görüntüleri, videolar ve diyagramlar gibi varlıkları güncelleştirmek için çalışırken bazı yerlerde eski adı bir süre görürsünüz.

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.

Not

Yapılandırma sunucusunu Standart tüketim ve ayrılmış planda kullanmak için önce bunu etkinleştirmeniz gerekir. Daha fazla bilgi için bkz . Azure Spring Apps'te Spring Cloud Config Server'ı etkinleştirme ve devre dışı bırakma.

Önkoşullar

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

Temel veya Standart plan kullanılarak önceden sağlanan ve çalıştırılan bir Azure Spring Apps hizmet örneği. Azure Spring Apps hizmetini ayarlamak ve başlatmak için bkz . Hızlı Başlangıç: İlk uygulamanızı Azure Spring Apps'e dağıtma.

Zaten sağlanan ve çalışan bir Azure Spring Apps hizmet örneği. Azure Spring Apps hizmetini ayarlamak ve başlatmak için bkz . Hızlı Başlangıç: Kurumsal planı kullanarak uygulamaları derleme ve Azure Spring Apps'e dağıtma.

Git.

Spring Cloud Config Server'ın etkinleştirilmesi

Bir Azure Spring Apps Kurumsal plan hizmeti örneği sağlarken Spring Cloud Config Server'ı etkinleştirebilirsiniz. Zaten bir Azure Spring Apps Kurumsal plan örneğiniz varsa, bu makalenin Mevcut kurumsal plan örneğinde Spring Cloud Config Server'ı yönetme bölümüne bakın.

Spring Cloud Config Server'a Azure portalını veya Azure CLI'yı kullanarak etkinleştirebilirsiniz.

Azure portalı
Azure CLI

Spring Cloud Config Server'ı etkinleştirmek için aşağıdaki adımları kullanın:

Azure portalını açın.
Temel Bilgiler sekmesinde Fiyatlandırma bölümünde Kurumsal katman'ıseçin ve gerekli bilgileri belirtin. Ardından İleri: Yönetilen bileşenler'i seçin.
Yönetilen bileşenler sekmesinde Spring Cloud Config Server'ı etkinleştir (önizleme)'yi seçin.
Diğer ayarları belirtin ve ardından Gözden Geçir ve Oluştur'u seçin.
Oluşturma işlemini gözden geçir sekmesinde Spring Cloud Config Server'ı etkinleştir (önizleme) seçeneğinin Evet olarak ayarlandığından emin olun. Kurumsal plan örneğini oluşturmak için Oluştur'u seçin.

Spring Cloud Config Server etkinleştirilmiş bir Azure Spring Apps hizmet örneği sağlamak için aşağıdaki adımları kullanın.

Azure CLI'da oturum açmak ve etkin aboneliğinizi seçmek için aşağıdaki komutları kullanın:
```
az login
az account list --output table
az account set --subscription <subscription-ID>
```
Azure Spring Apps Enterprise planının yasal koşullarını ve gizlilik bildirimlerini kabul etmek için aşağıdaki komutları kullanın. Bu adım yalnızca aboneliğiniz Azure Spring Apps'in Kurumsal plan örneğini oluşturmak için hiç kullanılmamışsa gereklidir.
```
az provider register --namespace Microsoft.SaaS
az term accept \
    --publisher vmware-inc \
    --product azure-spring-cloud-vmware-tanzu-2 \
    --plan asa-ent-hr-mtr
```
Bir konum seçin. Konumun Azure Spring Apps Enterprise planını desteklemesi gerekir. Daha fazla bilgi için bkz . Azure Spring Apps SSS.
Kaynak grubu oluşturmak için aşağıdaki komutu kullanın:
```
az group create \
    --name <resource-group-name> \
    --location <location>
```
Kaynak grupları hakkında daha fazla bilgi için bkz. Azure Resource Manager nedir?
Azure Spring Apps hizmet örneğiniz için bir ad hazırlayın. Ad 4 ile 32 karakter uzunluğunda olmalıdır ve yalnızca küçük harf, sayı ve kısa çizgi içerebilir. Hizmet adının ilk karakteri bir harf, son karakter ise harf veya sayı olmalıdır.

Spring Cloud Config Server etkinleştirilmiş bir Azure Spring Apps hizmet örneği oluşturmak için aşağıdaki komutu kullanın:

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

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

Dikkat

Bu özellikleri Yapılandırma Sunucusu uygulama dosyalarınıza yerleştirmekten kaçının.

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.

Not

Yapılandırma Sunucusu, belirtmezseniz varsayılan etiket olarak (Git'te) alır master . Ancak GitHub kısa süre önce varsayılan dalını olarak mastermaindeğiştirmiştir. Azure Spring Apps Yapılandırma Sunucusu hatasından kaçınmak için, özellikle yeni oluşturulan depolar için GitHub ile Yapılandırma Sunucusu'nu ayarlarken varsayılan etikete dikkat ettiğinizden emin olun.

Sözcükleri ayırmak için kısa çizgi (-) kullanmak şu anda desteklenen tek özellik adlandırma kuralıdır. Örneğin, kullanabilirsiniz, ancak kullanamazsınızdefault-labeldefaultLabel.

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:

Özellik	Zorunlu	Özellik
`uri`	Yes	Yapılandırma Sunucusu arka ucu olarak kullanılan Git deposunun URI'sini. , , `https://git@`veya `ssh://`ile `http://`başlamalıdır.
`default-label`	Hayır	Git deposunun varsayılan etiketi. Depoda dal adı, etiket adı veya işleme kimliği olmalıdır.
`search-paths`	Hayır	Git deposunun alt dizinlerini aramak için kullanılan dize dizisi.

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:

Özellik	Zorunlu	Özellik
`uri`	Yes	Yapılandırma Sunucusu arka ucu olarak kullanılan Git deposunun URI'sini. , , `https://git@`veya `ssh://`ile `http://`başlamalıdır.
`default-label`	Hayır	Git deposunun varsayılan etiketi. Deponun dal adı, etiket adı veya işleme kimliği olmalıdır.
`search-paths`	Hayır	Git deposunun alt dizinlerini aramak için kullanılan dize dizisi.
`private-key`	Hayır	Git deposuna erişmek için SSH özel anahtarı. URI veya `ssh://`ile `git@` başladığında gereklidir.
`host-key`	Hayır	Git deposu sunucusunun konak anahtarı. tarafından kapsanan `host-key-algorithm`algoritma ön ekini içermemelidir.
`host-key-algorithm`	Hayır	Konak anahtar algoritması. , , `ssh-rsa`, `ecdsa-sha2-nistp256ecdsa-sha2-nistp384`veya `ecdsa-sha2-nistp521`olmalıdır`ssh-dss`. Yalnızca varsa `host-key` gereklidir.
`strict-host-key-checking`	Hayır	Özel `host-key`kullanılırken başlayıp başlamadığını gösteren Yapılandırma Sunucusu göstergesi. (varsayılan değer) veya `false`olmalıdır `true` .

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:

Özellik	Zorunlu	Özellik
`uri`	Yes	Yapılandırma Sunucusu arka ucu olarak kullanılan Git deposunun URI'sini. , , `https://git@`veya `ssh://`ile `http://`başlamalıdır.
`default-label`	Hayır	Git deposunun varsayılan etiketi. Depoda dal adı, etiket adı veya commit-id olmalıdır.
`search-paths`	Hayır	Git deposunun alt dizinlerini aramak için kullanılan dize dizisi.
`username`	Hayır	Git deposu sunucusuna erişmek için kullanılan kullanıcı adı. Git deposu sunucusu HTTP temel kimlik doğrulamasını desteklediğinde gereklidir.
`password`	Hayır	Git deposu sunucusuna erişmek için kullanılan parola veya kişisel erişim belirteci. Git deposu sunucusu HTTP temel kimlik doğrulamasını desteklediğinde gereklidir.

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.

Diğer Git depoları

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

Özellik	Zorunlu	Özellik
`repos`	Hayır	Belirli bir ada sahip git deposunun ayarlarından oluşan bir harita.
`repos."uri"`	Evet tarihinde `repos`	Yapılandırma Sunucusu arka ucu olarak kullanılan Git deposunun URI'sini. , , `https://git@`veya `ssh://`ile `http://`başlamalıdır.
`repos."name"`	Evet tarihinde `repos`	Depoyu tanımlamak için bir ad; örneğin, `team-A` veya `team-B`. Yalnızca varsa `repos` gereklidir.
`repos."pattern"`	Hayır	Uygulama adıyla eşleştirmek için kullanılan dize dizisi. Her desen için biçimini `{application}/{profile}` joker karakterlerle kullanın.
`repos."default-label"`	Hayır	Git deposunun varsayılan etiketi. Deponun dal adı, etiket adı veya işleme IOD'si olmalıdır.
`repos."search-paths`"	Hayır	Git deposunun alt dizinlerini aramak için kullanılan dize dizisi.
`repos."username"`	Hayır	Git deposu sunucusuna erişmek için kullanılan kullanıcı adı. Git deposu sunucusu HTTP temel kimlik doğrulamasını desteklediğinde gereklidir.
`repos."password"`	Hayır	Git deposu sunucusuna erişmek için kullanılan parola veya kişisel erişim belirteci. Git deposu sunucusu HTTP temel kimlik doğrulamasını desteklediğinde gereklidir.
`repos."private-key"`	Hayır	Git deposuna erişmek için SSH özel anahtarı. URI veya `ssh://`ile `git@` başladığında gereklidir.
`repos."host-key"`	Hayır	Git deposu sunucusunun konak anahtarı. tarafından kapsanan `host-key-algorithm`algoritma ön ekini içermemelidir.
`repos."host-key-algorithm"`	Hayır	Konak anahtar algoritması. , , `ssh-rsa`, `ecdsa-sha2-nistp256ecdsa-sha2-nistp384`veya `ecdsa-sha2-nistp521`olmalıdır`ssh-dss`. Yalnızca varsa `host-key` gereklidir.
`repos."strict-host-key-checking"`	Hayır	Özel `host-key`kullanılırken Yapılandırma Sunucusu örneğinin başlatılıp başlatılmadığını gösterir. (varsayılan değer) veya `false`olmalıdır `true` .

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.

Desenler	Açıklama
`test-config-server-app-0/*`	Desen ve depo URI'si, herhangi bir profille adlı `test-config-server-app-0` spring önyükleme uygulamasıyla eşleşir.
`test-config-server-app-1/dev`	Desen ve depo URI'si, adlı `test-config-server-app-1` bir Spring önyükleme uygulamasıyla bir geliştirme profiliyle eşleşir.
`test-config-server-app-2/prod`	Desen ve depo URI'si, bir üretim profiliyle adlı `test-config-server-app-2` spring önyükleme uygulamasıyla eşleşir.

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:

Azure Portal’ında oturum açın.
Azure Spring Apps'e Genel Bakış sayfanıza gidin.
Gezinti bölmesinde Spring Cloud Config Server'ı seçin.
Varsayılan depo bölümünde URI'yi olarak https://github.com/Azure-Samples/piggymetrics-configayarlayın.
Doğrula'yı seçin.
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:

Varsayılan depo bölümündeki Uri kutusuna depo URI'sini yapıştırın.
Etiket ayarı için config girin.
Kimlik Doğrulaması ayarının Genel olduğundan emin olun.
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:

Varsayılan depo bölümündeki Uri kutusuna depo URI'sini yapıştırın.
Kimlik Doğrulaması'nın altında Kimlik Doğrulamayı Düzenle'yi seçin.
Kimlik Doğrulamasını Düzenle bölmesinde, Kimlik doğrulama türü açılan listesinde HTTP Temel'i seçin.
Azure Spring Apps'e erişim vermek için kullanıcı adınızı ve parolanızı/belirtecinizi girin.
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:

Varsayılan depo bölümündeki Uri kutusuna depo URI'sini yapıştırın.
Kimlik Doğrulaması'nın altında Kimlik Doğrulamayı Düzenle'yi seçin.
Kimlik Doğrulamasını Düzenle bölmesindeki Kimlik doğrulama türü açılan listesinde SSH'yi seçin.
Özel anahtarınızı girin. İsteğe bağlı olarak konak anahtarınızı ve konak anahtarı algoritmanızı belirtin.
Ortak anahtarınızı Yapılandırma Sunucusu deponuza ekleyin.
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:

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.
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:

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.
İç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:

Projenizin Azure Repos portalında Kopyala'yı seçin.
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.
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:

Azure Portal’ında oturum açın.
Azure Spring Apps'e Genel Bakış sayfanıza gidin.
Yapılandırılan hizmeti seçin.
Hizmet sayfasının sol bölmesinde, Ayarlar'ın altında Spring Cloud Config Server sekmesini seçin.
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ınaltı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.

Uygulamayı Spring Cloud Config Server'a bağlama

Bir uygulamayı Spring Cloud Config Server'a bağlamak için aşağıdaki komutu kullanarak uygulamanın Yapılandırma Sunucusu'ndan yapılandırmaları çekmesini sağlayın.

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

Uygulama bağlamasını aşağıdaki ekran görüntüsünde gösterildiği gibi Azure portalından da ayarlayabilirsiniz:

Not

Yapılandırma sunucusu durumu değiştiğinde bu değişikliklerin tüm uygulamalara yayılması birkaç dakika sürer.

Bağlama/bağlamayı kaldırma durumunu değiştirirseniz uygulamayı yeniden başlatmanız veya yeniden dağıtmanız gerekir.

Şimdi aşağıdaki komutu kullanarak yeni bir uygulama oluştururken uygulamanızı doğrudan Spring Cloud Config Server'a bağlamayı seçebilirsiniz:

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

Aşağıdaki ekran görüntüsünde gösterildiği gibi uygulamanızı Azure portalından Spring Cloud Config Sunucusu'na da bağlayabilirsiniz:

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:

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);
        }
    }
}

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
```

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.

Mevcut kurumsal plan örneğinde Spring Cloud Config Server'ı yönetme

Hizmet oluşturulduktan sonra Azure portalını veya Azure CLI'yı kullanarak Spring Cloud Config Server'ı etkinleştirebilir ve devre dışı bırakabilirsiniz. Spring Cloud Config Server'ı devre dışı bırakmadan önce tüm uygulamalarınızın bağlantısını kaldırmanız gerekir.

Azure portalı
Azure CLI

Spring Cloud Config Server'ı etkinleştirmek veya devre dışı bırakmak için aşağıdaki adımları kullanın:

Hizmet örneğinize gidin ve Spring Cloud Config Server'ı seçin.
Yönet'i seçin.
Spring Cloud Config Server'ı Etkinleştir'i seçin veya seçimini kaldırın ve ardından Kaydet'i seçin.
Artık Spring Cloud Config Server'ın durumunu Spring Cloud Config Server sayfasında görüntüleyebilirsiniz.

Spring Cloud Config Server'ı etkinleştirmek veya devre dışı bırakmak için aşağıdaki Azure CLI komutlarını kullanı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>

Azure Spring Apps

Aracılığıyla paylaş

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

Önkoşullar

Spring Cloud Config Server'ın etkinleştirilmesi

Kısıtlamalar

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

Genel depo

SSH kimlik doğrulaması ile özel depo

Temel kimlik doğrulaması ile özel depo

Diğer Git depoları

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

Depo bilgilerini doğrudan Azure portalına girin

Varsayılan depo

Ek depolar

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

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

Depo URL'sini ve kimlik bilgilerini alma

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

Uygulamayı Spring Cloud Config Server'a bağlama

Yapılandırmanızı silme

Yapılandırma Sunucusunu Yenile

Mevcut kurumsal plan örneğinde Spring Cloud Config Server'ı yönetme

Geri Bildirim

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

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

Önkoşullar

Spring Cloud Config Server'ın etkinleştirilmesi

Kısıtlamalar

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

Genel depo

SSH kimlik doğrulaması ile özel depo

Temel kimlik doğrulaması ile özel depo

Diğer Git depoları

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

Depo bilgilerini doğrudan Azure portalına girin

Varsayılan depo

Ek depolar

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

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

Depo URL'sini ve kimlik bilgilerini alma

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

Uygulamayı Spring Cloud Config Server'a bağlama

Yapılandırmanızı silme

Yapılandırma Sunucusunu Yenile

Mevcut kurumsal plan örneğinde Spring Cloud Config Server'ı yönetme

İlgili içerik

Geri Bildirim

Geri Bildirim

Ek kaynaklar