Udostępnij za pośrednictwem

Migrowanie serwera Spring Cloud Config Server z usługi Azure Spring Apps do usługi Azure Container Apps

  • Artykuł

Uwaga

Plany Podstawowa, Standardowa i Enterprise zostaną wycofane od połowy marca 2025 r. z 3-letnim okresem emerytalnym. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Zużycie standardowe i dedykowany plan zostaną wycofane od 30 września 2024 r. z całkowitym zamknięciem po sześciu miesiącach. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz Migrowanie użycia usługi Azure Spring Apps w warstwie Standardowa i dedykowanego planu do usługi Azure Container Apps.

Ten artykuł dotyczy:✅ Podstawowa/Standardowa ✅ Enterprise

W tym artykule opisano sposób migracji serwera Spring Cloud Config Server do programu Config Server for Spring w usłudze Azure Container Apps. Usługa Azure Container Apps zarządza serwerem konfiguracji dla platformy Spring, który ma podobne funkcje jak serwer Spring Cloud Config Server w usłudze Azure Spring Apps.

Wymagania wstępne

  • Wystąpienie usługi Azure Spring Apps z włączonym konfigurowaniem serwera.
  • Środowisko usługi Azure Container Apps dla serwera konfiguracji i wystąpienia usługi Azure Container Apps.

Aprowizuj serwer konfiguracji

W poniższych krokach pokazano, jak aprowizować serwer konfiguracji dla platformy Spring w usłudze Azure Container Apps:

  1. Przejdź do środowiska usługi Azure Container Apps w witrynie Azure Portal.

  2. W menu wybierz pozycję Usługi>.

  3. Otwórz listę rozwijaną Konfigurowanie , a następnie wybierz pozycję Składnik Java.

  4. W panelu Konfigurowanie składnika Java wprowadź następujące wartości:

    Właściwości Wartość
    Typ składnika Java Wybierz pozycję Config Server for Spring (Serwer konfiguracji dla platformy Spring).
    Nazwa składnika Java Wprowadź wartość configserver.

  5. W sekcji Repozytoria Git wybierz pozycję Dodaj, a następnie zmigruj wartości z usługi konfiguracji aplikacji do tego miejsca, jak pokazano w poniższej tabeli. Wybierz jedno repozytorium jako domyślne repozytorium serwera konfiguracji dla platformy Spring.

    Właściwości Wartość
    Type Wybierz pozycję DOMYŚLNE.
    Identyfikator URI Wprowadź wartość identyfikatora URI repozytorium.
    Nazwa gałęzi Wprowadź wartość etykiety repozytorium.
    Ścieżki wyszukiwania Wprowadź wartość ścieżki wyszukiwania repozytorium.
    Authentication Wybierz typ uwierzytelniania repozytorium i wprowadź odpowiednie informacje.

    Pozostaw pozostałe pola z wartościami domyślnymi, a następnie wybierz pozycję Dodaj.

  6. Jeśli masz wiele repozytoriów, wybierz pozycję Dodaj , aby przeprowadzić migrację innych repozytoriów. W polu Typ wybierz pozycję Inne, a następnie zmigruj inne właściwości, jak pokazano w poprzednim kroku i w poniższej tabeli:

    Właściwości Wartość
    Type Wybierz pozycję DOMYŚLNE.
    Wzorzec Wprowadź wartość Patterns dla repozytorium w {application} formacie lub {application}/{profile} .

  7. W sekcji Powiązanie otwórz listę rozwijaną, aby wybrać aplikacje, które mają być powiązane z serwerem konfiguracji dla platformy Spring.

  8. Wybierz Dalej.

  9. Aby skonfigurować serwer konfiguracji, na karcie Przegląd wybierz pozycję Konfiguruj, a następnie postępuj zgodnie z instrukcjami w sekcji konfiguracji.

Po pomyślnym utworzeniu widać, że stan aprowizacji serwera konfiguracji dla platformy Spring to Powodzenie.

Alokacja zasobów

Alokacja zasobów kontenera dla zarządzanego serwera konfiguracji w usłudze Azure Container Apps jest stała na następujące wartości:

  • Procesor CPU: 0,5 procesorów wirtualnych
  • Pamięć: 1 Gi

Aby skonfigurować liczbę wystąpień serwera konfiguracji dla platformy Spring, należy zaktualizować parametry --min-replicas i --max-replicas przy użyciu tej samej wartości. Ta konfiguracja gwarantuje, że liczba wystąpień pozostaje stała. Obecnie system nie obsługuje konfiguracji skalowania automatycznego na potrzeby skalowania dynamicznego.

Konfigurowanie serwera konfiguracji

Zamapuj domyślne repozytorium Git i dodatkowe repozytoria skonfigurowane w programie Spring Cloud Config Server w usłudze Azure Spring Apps do domyślnych i innych repozytoriów na serwerze konfiguracji platformy Spring wdrożonym w usłudze Azure Container Apps. W poniższej tabeli przedstawiono relacje mapowania właściwości:

Nazwa właściwości w usłudze Azure Spring Apps CONFIGURATION_KEY CONFIGURATION_VALUE
uri spring.cloud.config.server.git.uri
spring.cloud.config.server.git.repos.{repoName}.uri		 Repozytorium uri zdalne.
search path spring.cloud.config.server.git.search-paths
spring.cloud.config.server.git.repos.{repoName}.search-paths		 Wyszukaj ścieżki do użycia w lokalnej kopii roboczej. Domyślnie wyszukuje tylko katalog główny.
label spring.cloud.config.server.git.default-label
spring.cloud.config.server.git.repos.{repoName}.default-label		 Etykieta używana dla usługi Git.
name w dodatkowych repozytoriach {repoName} w następujących konfiguracjach.
Patterns w dodatkowych repozytoriach spring.cloud.config.server.git.repos.{repoName}.pattern
username spring.cloud.config.server.git.username
spring.cloud.config.server.git.repos.{repoName}.username		 Wprowadź wartość username dla uwierzytelniania z repozytorium zdalnym, jeśli typ uwierzytelniania to HTTP Basic.
password spring.cloud.config.server.git.password
spring.cloud.config.server.git.repos.{repoName}.password		 Wprowadź wartość password dla uwierzytelniania z repozytorium zdalnym, jeśli typ uwierzytelniania to HTTP Basic.
private key spring.cloud.config.server.git.private-key
spring.cloud.config.server.git.repos.{repoName}.private-key		 Prawidłowy klucz prywatny SSH, jeśli typ uwierzytelniania to SSH.
host key spring.cloud.config.server.git.host-key
spring.cloud.config.server.git.repos.{repoName}.host-key		 Prawidłowy klucz hosta SSH, jeśli typ uwierzytelniania to SSH. Należy ustawić wartość , jeśli host-key-algorithm jest również ustawiona.
host key algorithm spring.cloud.config.server.git.host-key-algorithm
spring.cloud.config.server.git.repos.{repoName}.host-key-algorithm		 ssh-dssJeden z , , ssh-ed25519ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384lubecdsa-sha2-nistp521, jeśli typ uwierzytelniania to SSH. Należy ustawić, jeśli ustawiono również klucz-hosta.

Aby uzyskać więcej właściwości serwera konfiguracji, zobacz sekcję Opcje konfiguracji w sekcji Łączenie z zarządzanym serwerem konfiguracji dla platformy Spring w usłudze Azure Container Apps.

Wdrażanie aplikacji w usłudze Azure Container Apps

Po przetestowaniu aplikacji lokalnie możesz wdrożyć nowy obraz w aplikacji Azure Container Apps.

Aby wdrożyć następujące kroki:

  1. Przejdź do aplikacji usługi Azure Container Apps w witrynie Azure Portal.
  2. W menu wybierz pozycję Kontenery aplikacji>.
  3. Wybierz pozycję Edytuj i wdróż , aby otworzyć stronę Tworzenie i wdrażanie nowej poprawki .
  4. W sekcji Obraz kontenera wybierz obraz, a następnie wybierz pozycję Edytuj.
  5. W sekcji Edytowanie kontenera na karcie Właściwości wybierz nowy obraz aplikacji.
  6. Na karcie Zmienne środowiskowe w polu Nazwa określ spring.application.name. Następnie w polu Źródło wybierz pozycję Wpis ręczny i określ nazwę pliku konfiguracji, w którym aplikacja korzysta z konfiguracji.
  7. Wybierz pozycję Zapisz , aby wdrożyć nową wersję.

Rozwiązywanie problemów

Dzienniki zarządzanego serwera konfiguracji dla platformy Spring w usłudze Azure Container Apps można wyświetlić przy użyciu usługi Log Analytics. Wykonaj następujące kroki:

  1. Przejdź do środowiska usługi Azure Container Apps w witrynie Azure Portal.

  2. Wybierz menu Dzienniki monitorowania>.

  3. Aby wyświetlić dzienniki, wprowadź zapytanie w edytorze zapytań dla ContainerAppSystemLogs_CL tabeli, jak pokazano w poniższym przykładzie:

    ContainerAppSystemLogs_CL
| where ComponentType_s == "SpringCloudConfig"
| project Time=TimeGenerated, ComponentName=ComponentName_s, Message=Log_s
| take 100

Aby uzyskać więcej informacji na temat wykonywania zapytań dotyczących dzienników, zobacz Obserwowanie zarządzanych składników Java w usłudze Azure Container Apps.