Udostępnij przez


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

Uwaga

Plany Basic, Standardi Enterprise weszły w okres wycofywania 17 marca 2025 r. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring 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

  • Instancja Azure Spring Apps z włączoną funkcją Configure Server.
  • Środowisko usługi Azure Container Apps dla serwera konfiguracji oraz instancja usługi Azure Container Apps.

Skonfiguruj 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 Konfiguracji składnika Java wprowadź te wartości:

    Własność Wartość
    Typ składnika Java Wybierz pozycję Config Server for Spring (Serwer konfiguracji dla platformy Spring).
    Nazwa składnika Java Wprowadź 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łasność Wartość
    Typ Wybierz opcję DOMYŚLNE.
    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łasność Wartość
    Typ Wybierz opcję DOMYŚLNE.
    Wzorzec Wprowadź wartość Patterns dla repozytorium w formacie {application} 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 Zakończono pomyślnie.

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:

  • CPU: 0,5 wCPU
  • 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-rsassh-ed25519, 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ć, wykonaj następujące kroki:

  1. Przejdź do aplikacji usługi Azure Container Apps w witrynie Azure Portal.
  2. W menu wybierz Aplikacja>Kontenery.
  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, z którego aplikacja pobiera konfigurację.
  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 Monitorowanie>Dzienniki.

  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.