Szybki start: konfigurowanie serwera Spring Cloud Config Server dla usługi Azure Spring Apps
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
Serwer konfiguracji to scentralizowana usługa konfiguracji dla systemów rozproszonych. Używa ona wtyczki warstwy repozytorium, która obecnie obsługuje magazyn lokalny, git i subversion. W tym przewodniku Szybki start skonfigurujesz serwer konfiguracji w celu pobrania danych z repozytorium Git.
Wymagania wstępne
- Ukończenie poprzedniego przewodnika Szybki start w tej serii: Aprowizuj usługę Azure Spring Apps.
- Serwer konfiguracji usługi Azure Spring Apps ma zastosowanie tylko do planu podstawowego lub standardowego.
Procedury konfiguracji serwera
Skonfiguruj serwer konfiguracji z lokalizacją repozytorium Git dla projektu, uruchamiając następujące polecenie. Zastąp <service-instance-name> ciąg nazwą utworzonej wcześniej usługi. Wartość domyślna nazwy wystąpienia usługi ustawiona w poprzednim przewodniku Szybki start nie działa z tym poleceniem.
az spring config-server git set \
--name <service-instance-name> \
--uri https://github.com/Azure-Samples/azure-spring-apps-samples \
--search-paths steeltoe-sample/config
To polecenie informuje serwer konfiguracji o znalezieniu danych konfiguracji w folderze steeltoe-sample/config repozytorium przykładowej aplikacji. Ponieważ nazwa aplikacji, która pobiera dane konfiguracji, to planet-weather-provider, używany plik jest planet-weather-provider.yml.
Wymagania wstępne
- JDK 17
- Subskrypcja Azure. Jeśli nie masz subskrypcji, przed rozpoczęciem utwórz bezpłatne konto .
- Opcjonalnie interfejs wiersza polecenia platformy Azure w wersji 2.45.0 lub nowszej. Zainstaluj rozszerzenie Azure Spring Apps za pomocą następującego polecenia:
az extension add --upgrade --name spring - Opcjonalnie zestaw narzędzi Azure Toolkit for IntelliJ.
Procedury konfiguracji serwera
Poniższa procedura konfiguruje serwer konfiguracji przy użyciu witryny Azure Portal w celu wdrożenia przykładu PetClinic.
Przejdź do strony Przegląd usługi i wybierz pozycję Serwer konfiguracji.
W sekcji Domyślne repozytorium ustaw identyfikator URI na
https://github.com/azure-samples/spring-petclinic-microservices-config.Wybierz Potwierdź. Walidacja sprawdza schemat i ułatwienia dostępu repozytorium Git, aby upewnić się, że jest ona poprawna.
Po zakończeniu walidacji wybierz pozycję Zastosuj , aby zapisać zmiany.
Aktualizowanie konfiguracji może potrwać kilka minut. Po zakończeniu konfiguracji powinno zostać wyświetlone powiadomienie.
Napiwek
Aby uzyskać informacje na temat korzystania z prywatnego repozytorium dla serwera konfiguracji, zobacz Konfigurowanie zarządzanego serwera konfiguracji Spring Cloud w usłudze Azure Spring Apps.
Rozwiązywanie problemów z serwerem konfiguracji usługi Azure Spring Apps
W poniższej procedurze wyjaśniono, jak rozwiązywać problemy z ustawieniami serwera konfiguracji.
W witrynie Azure Portal przejdź do strony Przegląd usługi i wybierz pozycję Dzienniki.
W okienku Zapytania w obszarze Pokaż dzienniki aplikacji zawierające terminy "błąd" lub "wyjątek" wybierz pozycję Uruchom.
Następujący błąd w dziennikach wskazuje, że usługa Spring Apps nie może zlokalizować właściwości z serwera konfiguracji:
java.lang.illegalStateExceptionPrzejdź do strony Przegląd usługi.
Kliknij pozycję Diagnozowanie i rozwiązywanie problemów.
W obszarze Dostępność i wydajność wybierz pozycję Rozwiązywanie problemów.
W witrynie Azure Portal zostanie wyświetlona strona Dostępność i wydajność , która zawiera różne informacje o stanie kondycji serwera konfiguracji.
Czyszczenie zasobów
Jeśli planujesz kontynuować pracę z kolejnymi przewodnikami Szybki start i samouczkami, możesz pozostawić te zasoby na miejscu. Gdy grupa zasobów nie jest już potrzebna, usuń grupę zasobów, która usuwa zasoby w grupie zasobów. Aby usunąć grupę zasobów, wprowadź następujące polecenia w interfejsie wiersza polecenia platformy Azure:
echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."