Nastavení instance jarního cloudového konfiguračního serveru pro vaši službu

Tento článek se týká: ✔️ Java ✔️ C #

V tomto článku se dozvíte, jak připojit instanci jarního cloudového konfiguračního serveru k vaší jarní cloudové službě Azure.

Jarní cloudová konfigurace poskytuje podporu na straně serveru a klienta pro externou konfiguraci v distribuovaném systému. V případě instance konfiguračního serveru máte centrální místo pro správu externích vlastností pro aplikace ve všech prostředích. Další informace najdete v tématu Reference k serveru pro konfiguraci jarního cloudu.

Požadavky

• Předplatné Azure. Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.
• Již zřízené a běžící cloudová služba Azure. Pokud chcete nastavit a spustit službu jarních cloudů Azure, přečtěte si rychlý Start: spuštění aplikace pružiny v jazyce Java pomocí rozhraní příkazového řádku Azure.

Omezení

K dispozici jsou určitá omezení, pokud používáte konfigurační server s back-end Git. Některé vlastnosti jsou automaticky vloženy do prostředí aplikace pro přístup ke konfiguračnímu serveru a zjišťování služby. Pokud tyto vlastnosti nakonfigurujete i ze souborů konfiguračního serveru, může docházet ke konfliktům a neočekávanému chování. Mezi vlastnosti patří:

eureka.client.service-url.defaultZone
eureka.client.tls.keystore
server.port
spring.cloud.config.tls.keystore
spring.application.name
spring.jmx.enabled

Vytvoření souborů konfiguračního serveru

Azure jaře Cloud podporuje Azure DevOps, GitHub, GitLab a Bitbucket pro ukládání souborů konfiguračního serveru. Po přípravě úložiště vytvořte konfigurační soubory podle následujících pokynů a uložte je tam.

Kromě toho jsou některé konfigurovatelné vlastnosti k dispozici pouze pro určité typy. Následující pododdíly uvádějí vlastnosti pro každý typ úložiště.

Veřejné úložiště

Když použijete veřejné úložiště, vaše konfigurovatelné vlastnosti jsou omezené.

Všechny konfigurovatelné vlastnosti, které se používají k nastavení veřejného úložiště Git, jsou uvedené v následující tabulce:

Soukromé úložiště s ověřováním SSH

Všechny konfigurovatelné vlastnosti používané k nastavení privátního úložiště Git pomocí SSH jsou uvedené v následující tabulce:

Privátní úložiště s základním ověřováním

Všechny konfigurovatelné vlastnosti používané k nastavení privátního úložiště Git se základním ověřováním jsou uvedené níže.

Další úložiště Git

Všechny konfigurovatelné vlastnosti používané k nastavení úložišť Git se vzorem jsou uvedené níže.

V následující tabulce jsou uvedeny některé příklady pro Další části úložišť . Další informace najdete v tématu porovnávání vzorů a více úložišť v dokumentaci k pružině.

Připojení úložiště konfiguračního serveru k Azure jaře cloudu

Teď, když jsou konfigurační soubory uložené v úložišti, musíte k ní připojit jarní cloud Azure.

1. Přihlaste se k webu Azure Portal.

2. Přejít na stránku s přehledem jarního cloudu Azure.

3. V levém navigačním podokně vyberte konfigurační server .

4. V části výchozí úložiště nastavte možnost URI na " https://github.com/Azure-Samples/piggymetrics-config ".

5. Vyberte Ověřit.

   

6. Po dokončení ověřování klikněte na použít , aby se změny uložily.

   

7. Aktualizace konfigurace může trvat několik minut.

   

8. Po dokončení konfigurace byste měli obdržet oznámení.

Zadejte informace o úložišti přímo do Azure Portal

Výchozí úložiště

• Veřejné úložiště: v části výchozí úložiště v poli URI vložte identifikátor URI úložiště. Nastavte popisek na config. Zajistěte, aby bylo nastavení ověřování veřejné, a pak vyberte použít k dokončení.

• Soukromé úložiště: Azure jaře Cloud podporuje základní ověřování pomocí hesla nebo tokenu a SSH.

  • Základní ověřování: v části výchozí úložiště v poli URI vložte identifikátor URI úložiště a pak klikněte na tlačítko ověřování (ikona tužky). V podokně Upravit ověřování vyberte v rozevíracím seznamu typ ověřování možnost http Basic a potom zadejte své uživatelské jméno a heslo nebo token pro udělení přístupu k jarnímu cloudu Azure. Vyberte OK a pak vyberte použít k dokončení nastavování instance konfiguračního serveru.

  

  Upozornění

  Některé servery úložiště Git pro základní ověřování používají osobní tokeny nebo přístupový token, jako je třeba heslo. Tento typ tokenu můžete použít jako heslo v Azure jaře cloudu, protože nikdy nevyprší platnost. u jiných serverů úložiště Git, jako je Bitbucket a Azure DevOps Server, platnost přístupového tokenu vyprší jednu nebo dvě hodiny. To znamená, že možnost nebude při použití těchto serverů úložiště u jarního cloudu Azure životaschopná. GitHub odebral podporu pro ověřování hesla, takže budete muset místo ověřování hesla pro GitHub použít osobní přístupový token. Další informace najdete v tématu ověření tokenu.

  • SSH: v části výchozí úložiště v poli URI vložte identifikátor URI úložiště a pak klikněte na tlačítko ověřování (ikona tužky). V podokně Upravit ověřování vyberte v rozevíracím seznamu typ ověřování možnost SSH a potom zadejte svůj privátní klíč. Volitelně můžete zadat klíč hostitele a algoritmus hostitelského klíče. Nezapomeňte do svého úložiště konfiguračního serveru zahrnout svůj veřejný klíč. Vyberte OK a pak vyberte použít k dokončení nastavování instance konfiguračního serveru.

  

Další úložiště

Pokud chcete ke konfiguraci služby použít volitelné Další úložiště , zadejte identifikátor URI a ověřování stejným způsobem jako výchozí úložiště. Nezapomeňte zadat název pro váš vzor a pak kliknutím na použít ho připojte k instanci.

Zadejte informace o úložišti do souboru YAML.

Pokud jste napsali soubor YAML s nastavením úložiště, můžete ho naimportovat přímo z místního počítače do jarního cloudu Azure. Jednoduchý soubor YAML pro privátní úložiště se základním ověřováním by vypadal takto:

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

Vyberte tlačítko importovat nastavení a potom vyberte soubor YAML z adresáře projektu. Vyberte importovat a potom async se v oznámení zobrazí operace z vaší nabídky. Po 1-2 minutách by se mělo ohlásit úspěch.

Informace ze souboru YAML by měly být zobrazeny v Azure Portal. Vyberte použít k dokončení.

použití Azure Repos pro konfiguraci jarního cloudu Azure

Azure Spring Cloud má přístup k úložištím Git, která jsou veřejná nebo jsou zabezpečená protokolem SSH, případně k zabezpečení používají základní ověřování HTTP. Použijeme tuto poslední možnost, protože je snazší vytvořit a spravovat pomocí Azure Repos.

Získat adresu URL a přihlašovací údaje úložiště

1. na portálu Azure Repos pro váš projekt vyberte tlačítko klonování :

   

2. Zkopírujte adresu URL klonu z textového pole. Tato adresa URL bude obvykle ve formátu:

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

   Odeberte vše po https:// a před dev.azure.com , včetně @ . Výsledná adresa URL by měla být ve tvaru:

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

   Tuto adresu URL uložte pro použití v další části.

3. Vyberte Generovat pověření Git. Zobrazí se uživatelské jméno a heslo. Uložte je pro použití v další části.

Konfigurace přístupu Azure Spring Cloudu k úložišti Git

1. Přihlaste se k webu Azure Portal.

2. Přejít na stránku s přehledem jarního cloudu Azure.

3. Vyberte službu, kterou chcete nakonfigurovat.

4. v levém podokně stránky služby v části Nastavení vyberte kartu konfigurační Server . Nakonfigurujte úložiště, které jsme vytvořili dříve:

   • Přidejte adresu URL úložiště, kterou jste uložili z předchozí části.
   • Vyberte ověřování a pak vyberte http Basic.
   • Uživatelské jméno je uživatelské jméno uložené v předchozí části.
   • Heslo je heslo uložené v předchozí části.
   • Vyberte Použít a počkejte na úspěšné dokončení operace.

   

Odstranění konfigurace

Můžete vybrat tlačítko Resetovat, které se zobrazí na kartě Config Server, a úplně tak vymazat stávající nastavení. Nastavení konfiguračního serveru odstraňte, pokud chcete připojit instanci Config Server k jinému zdroji, například přechodem z GitHub na Azure DevOps.

Config Server aktualizace

Při změně vlastností je potřeba, aby služby využívající tyto vlastnosti byly před provedením změn informovány. Výchozím řešením pro Spring Cloud Config je ruční aktivace události aktualizace,která nemusí být možná možná proveditelná, pokud existuje velké množství instancí aplikace. Alternativně můžete Azure Spring Cloud automaticky aktualizovat hodnoty z konfiguračního serveru tím, že umožníte konfiguračnímu klientovi dotazovat se na změny na základě interní aktualizace.

• Nejprve do části závislostí vašeho virtuálního počítače zahrpište spring-cloud-starter-azure-spring-cloud-client pom.xml.

  <dependency>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>spring-cloud-starter-azure-spring-cloud-client</artifactId>
      <version>2.4.0</version>
  </dependency>
  

• Potom povolte automatickou aktualizaci a nastavte odpovídající interval aktualizace v souboru application.yml. V tomto příkladu se klient bude každých 5 sekund dotazovat na změny konfigurace, což je minimální hodnota, kterou můžete nastavit pro interval aktualizace. Ve výchozím nastavení je automatická aktualizace nastavená na false a interval aktualizace je nastavený na 60 sekund.

  spring:
    cloud:
      config:
        auto-refresh: true
        refresh-interval: 5
  

• Nakonec @refreshScope přidejte svůj kód. V tomto příkladu se proměnná connectTimeout automaticky aktualizuje každých 5 sekund.

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

Další kroky

V tomto článku jste zjistili, jak povolit a nakonfigurovat instanci Spring Cloud Config Server instanci. Další informace o správě aplikace najdete v tématu Škálování aplikace v Azure Spring Cloud.