Mapuj nazwy DNS na aplikacje w wielu wystąpieniach usługi Azure Spring Apps w tej samej sieci wirtualnej

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 pokazano, jak mapować nazwy systemu nazw domen (DNS) na aplikacje w celu uzyskania dostępu do wielu wystąpień usługi Azure Spring Apps w tej samej sieci wirtualnej.

Wymagania wstępne

• Subskrypcja platformy Azure. Jeśli nie masz subskrypcji, przed rozpoczęciem utwórz bezpłatne konto .
• Interfejs wiersza polecenia platformy Azure w wersji 2.45.0 lub nowszej. Użyj następującego polecenia, aby zainstalować rozszerzenie Azure Spring Apps: az extension add --name spring
• Sieć wirtualna wdrożona w wystąpieniu usługi Azure Spring Apps. Aby uzyskać więcej informacji, zobacz Wdrażanie usługi Azure Spring Apps w sieci wirtualnej platformy Azure (iniekcja sieci wirtualnej).

Omówienie

W tym artykule opisano następujące dwa podejścia do mapowania nazw DNS na aplikacje:

• Przy użyciu w pełni kwalifikowanej nazwy domeny (FQDN) dostarczonej przez firmę Microsoft.

  Takie podejście jest stosunkowo prostym i uproszczonym sposobem mapowania nazw DNS w porównaniu z podejściem do domeny niestandardowej. Ta metoda jest zalecana, jeśli nie potrzebujesz podejścia z symbolami wieloznacznymi w strefie DNS.

  Takie podejście wymaga rekordu DNS dla każdej aplikacji.

• Używanie domeny niestandardowej.

  Jeśli masz już domenę niestandardową lub chcesz, aby podejście wieloznaczne działało w scenariuszu z wieloma wystąpieniami, użyj tego podejścia.

  Takie podejście wymaga rekordu DNS dla każdego wystąpienia usługi Azure Spring Apps oraz domeny niestandardowej skonfigurowanej dla każdej aplikacji.

Na przykład w tym artykule są używane azure-spring-apps-1 nazwy dwóch wystąpień usługi Azure Spring Apps w tej samej sieci wirtualnej i azure-spring-apps-2 jako nazwy tych dwóch wystąpień usługi Azure Spring Apps.

Rozpocznij od sekcji Wstępne kroki mapowania DNS, a następnie przejdź do preferowanego podejścia:

• Mapowanie DNS z podaną przez firmę Microsoft nazwą FQDN
• Mapowanie DNS z domeną niestandardową

Na koniec przetestuj mapowanie zgodnie z opisem w sekcji Access private FQDN URL for private applications (Uzyskiwanie dostępu do prywatnych adresów URL nazw FQDN dla aplikacji prywatnych).

Wstępne kroki mapowania DNS

Wykonaj kroki opisane w tej sekcji zarówno dla nazwy FQDN, jak i podejścia domeny niestandardowej do mapowania nazw DNS.

Znajdowanie adresów IP aplikacji

Oba podejścia wymagają adresu IP dla każdej aplikacji w wystąpieniu usługi Azure Spring Apps, które chcesz mapować. Aby znaleźć adresy IP, wykonaj następujące czynności:

Witryna Azure Portal

1. Przejdź do sieci wirtualnej utworzonej dla wystąpienia usługi Azure Spring Apps, a następnie wybierz pozycję Połączone urządzenia w okienku nawigacji.

2. Na stronie Połączone urządzenia wyszukaj ciąg kubernetes-internal.

3. W wynikach wyszukiwania znajdź każde urządzenie połączone z podsiecią środowiska uruchomieniowego usługi Azure Spring Apps i skopiuj jego adres IP. Na poniższym zrzucie ekranu na poniższym zrzucie ekranu adres IP to azure-spring-apps-1 10.1.0.6, a adres IP elementu azure-spring-apps-2 to 10.1.2.6.

   

Interfejs wiersza polecenia platformy Azure

1. Użyj następujących poleceń, aby zdefiniować zmienne dla subskrypcji, grupy zasobów, wystąpienia usługi Azure Spring Apps i sieci wirtualnej. Dostosuj wartości na podstawie środowiska.

   export SUBSCRIPTION='<subscription-ID>'
   export RESOURCE_GROUP='<resource-group-name>'
   export AZURE_SPRING_APPS_NAME='<Azure-Spring-Apps-instance-name>'
   export VIRTUAL_NETWORK_NAME='<Azure-Spring-Apps-VNET-name>'
   

2. Użyj następujących poleceń, aby ustawić zmienne dla grupy zasobów sieci środowiska uruchomieniowego usługi i adresu IP:

   export SERVICE_RUNTIME_RG=$(az spring show \
       --resource-group $RESOURCE_GROUP \
       --name $AZURE_SPRING_APPS_NAME \
       --query "properties.networkProfile.serviceRuntimeNetworkResourceGroup" \
       --output tsv)
   export IP_ADDRESS=$(az network lb frontend-ip list \
       --lb-name kubernetes-internal \
       --resource-group $SERVICE_RUNTIME_RG \
       --query "[0].privateIpAddress" \
       --output tsv)
   

Tworzenie prywatnej strefy DNS

Wykonaj poniższe kroki, aby utworzyć prywatną strefę DNS dla aplikacji w sieci prywatnej.

Uwaga

Jeśli używasz platformy Microsoft Azure obsługiwanej przez firmę 21Vianet, zastąp ciąg private.azuremicroservices.io ciągiem private.microservices.azure.cn w tym artykule. Aby uzyskać więcej informacji, zobacz Sprawdzanie punktów końcowych na platformie Azure.

Witryna Azure Portal

1. Na stronie głównej platformy Azure wyszukaj strefy Prywatna strefa DNS.

2. Na stronie strefy Prywatna strefa DNS wybierz pozycję Utwórz.

3. Wypełnij formularz na stronie Tworzenie strefy Prywatna strefa DNS. W obszarze Szczegóły wystąpienia w polu Nazwa określ private.azuremicroservices.io jako nazwę prywatnej strefy DNS.

4. Wybierz pozycję Przejrzyj pozycję Utwórz.

5. Wybierz pozycję Utwórz.

Interfejs wiersza polecenia platformy Azure

1. Użyj następujących poleceń, aby zalogować się do interfejsu wiersza polecenia platformy Azure i ustawić aktywną subskrypcję:

   az login
   az account set --subscription ${SUBSCRIPTION}
   

2. Użyj następującego polecenia, aby utworzyć prywatną strefę DNS.

   az network private-dns zone create \
       --resource-group $RESOURCE_GROUP \
       --name private.azuremicroservices.io
   

Tworzenie strefy może potrwać kilka minut.

Łączenie sieci wirtualnej

Aby połączyć prywatną strefę DNS utworzoną z siecią wirtualną, należy utworzyć łącze sieci wirtualnej.

Witryna Azure Portal

Aby utworzyć ten link, wykonaj następujące czynności:

1. Przejdź do prywatnej strefy DNS utworzonej o nazwie private.azuremicroservices.io. Może istnieć kilka z tą nazwą, dlatego określ poprawną nazwę według jej grupy zasobów i subskrypcji.

2. W okienku nawigacji wybierz pozycję Łącza sieci wirtualnej, a następnie wybierz pozycję Dodaj.

3. W polu Nazwa linku wprowadź ciąg azure-spring-apps-dns-link.

4. W obszarze Sieć wirtualna wybierz sieć wirtualną utworzoną dla wymagań wstępnych.

   

5. Wybierz przycisk OK.

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby utworzyć ten link:

az network private-dns link vnet create \
    --resource-group $RESOURCE_GROUP \
    --name azure-spring-apps-dns-link \
    --zone-name private.azuremicroservices.io \
    --virtual-network $VIRTUAL_NETWORK_NAME \
    --registration-enabled false

Przypisywanie prywatnej nazwy FQDN dla aplikacji

Przypisz prywatną nazwę FQDN dla aplikacji.

Witryna Azure Portal

Aby zaktualizować aplikację przy użyciu przypisanego punktu końcowego, wykonaj następujące kroki:

1. Przejdź do wystąpienia usługi Azure Spring Apps wdrożonego w sieci wirtualnej, a następnie wybierz pozycję Aplikacje w okienku nawigacji.

2. Wybierz aplikację.

3. Wybierz pozycję Przypisz punkt końcowy , aby przypisać prywatną nazwę FQDN do aplikacji. Przypisywanie nazwy FQDN może potrwać kilka minut.

   

4. Powtórz te kroki dla każdej aplikacji, którą chcesz mapować.

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby zaktualizować aplikację przy użyciu przypisanego punktu końcowego. Dostosuj wartość nazwy aplikacji na podstawie rzeczywistego środowiska.

export SPRING_CLOUD_APP='<app-name>'
az spring app update \
    --resource-group $RESOURCE_GROUP \
    --name $SPRING_CLOUD_APP \
    --service $SPRING_CLOUD_NAME \
    --assign-endpoint true

Mapowanie DNS z podaną przez firmę Microsoft nazwą FQDN

Korzystając z tego podejścia, należy utworzyć rekord DNS dla każdej aplikacji jako wymaganie w przypadku korzystania z w pełni kwalifikowanej nazwy domeny (FQDN) dostarczonej przez firmę Microsoft. Aby uzyskać podstawową wiedzę na temat tego procesu, zobacz Uzyskiwanie dostępu do aplikacji w sieci prywatnej.

Po wdrożeniu aplikacji w wystąpieniu usługi Azure Spring Apps z przypisanym punktem końcowym w sieci wirtualnej punkt końcowy jest prywatną nazwą FQDN. Domyślnie w pełni kwalifikowana nazwa domeny jest unikatowa dla każdej aplikacji w wystąpieniach usługi. Format nazwy FQDN to <service-name>-<app-name>.private.azuremicroservices.io.

Tworzenie rekordów DNS dla wszystkich aplikacji

Aby użyć prywatnej strefy DNS do tłumaczenia i rozpoznawania nazw DNS, należy utworzyć rekord typu "A" w strefie dla każdej aplikacji. W tym przykładzie nazwa aplikacji to hello-vnet , a nazwa wystąpienia usługi Azure Springs Apps to azure-spring-apps-1.

Potrzebny jest adres IP dla każdej aplikacji. Skopiuj go zgodnie z opisem w sekcji Znajdowanie adresu IP dla aplikacji w sekcji Uzyskiwanie dostępu do aplikacji w sieci prywatnej. W tym przykładzie adres IP to 10.1.0.6.

Witryna Azure Portal

Aby utworzyć rekord DNS, wykonaj następujące czynności:

1. Przejdź do utworzonej wcześniej prywatnej strefy DNS: private.azuremicroservices.io

2. Wybierz pozycję Zestaw rekordów.

3. W okienku Dodawanie zestawu rekordów wprowadź wartości z poniższej tabeli.

   Ustawienie	Wartość
   Nazwisko	azure-spring-apps-1-hello-vnet
   Typ	A
   TTL	1
   Jednostka TTL	Godzin
   Adres IP	(wklej ze schowka)

4. Wybierz przycisk OK.

   

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby utworzyć rekord DNS:

az network private-dns record-set a add-record \
    --resource-group $RESOURCE_GROUP \
    --zone-name private.azuremicroservices.io \
    --record-set-name 'azure-spring-apps-1-hello-vnet' \
    --ipv4-address $IP_ADDRESS

Powtórz te kroki zgodnie z potrzebami, aby dodać rekord DNS dla innych aplikacji.

Mapowanie DNS z domeną niestandardową

Korzystając z tego podejścia, musisz tylko dodać rekord DNS dla każdego wystąpienia usługi Azure Spring Apps, ale musisz skonfigurować domenę niestandardową dla każdej aplikacji. Aby uzyskać podstawową wiedzę na temat tego procesu, zobacz Mapuj istniejącą domenę niestandardową na usługę Azure Spring Apps.

W tym przykładzie ponownie użyto prywatnej strefy private.azuremicroservices.io DNS w celu dodania niestandardowego rekordu DNS powiązanego z domeną. Prywatna nazwa FQDN ma format <app-name>.<service-name>.private.azuremicroservices.io.

Technicznie możesz użyć dowolnej w pełni kwalifikowanej nazwy domeny prywatnej. W takim przypadku należy utworzyć nową prywatną strefę DNS odpowiadającą w pełni kwalifikowanej nazwie domeny.

Mapuj domenę niestandardową na aplikację w wystąpieniu usługi Azure Spring Apps

Wykonaj następujące kroki, aby zamapować domenę niestandardową na każdą z aplikacji w wystąpieniu usługi Azure Spring Apps:

Witryna Azure Portal

1. Otwórz wystąpienie usługi Azure Spring Apps i wybierz pozycję Aplikacje w okienku nawigacji.

2. Na stronie Aplikacje wybierz aplikację.

3. Wybierz pozycję Domena niestandardowa w okienku nawigacji.

4. Wybierz pozycję Dodaj domenę niestandardową.

5. W okienku Dodawanie domeny niestandardowej wprowadź nazwę FQDN, której chcesz użyć, i upewnij się, że odpowiada ona certyfikatowi do użycia na potrzeby powiązania TLS/SSL później. W tym przykładzie użyto wartości hello-vnet.azure-spring-apps-1.private.azuremicroservices.io. Możesz zignorować część CNAME.

6. Wybierz Potwierdź.

7. W przypadku weryfikacji wybierz pozycję Dodaj.

   

Gdy domena niestandardowa zostanie pomyślnie zamapowana na aplikację, zostanie wyświetlona w tabeli domeny niestandardowej.

Interfejs wiersza polecenia platformy Azure

1. Użyj następującego polecenia, aby powiązać domenę niestandardową z aplikacją:

   az spring app custom-domain bind \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --domain-name <fqdn-domain-name> \
       --app <app-name>
   

2. Użyj następującego polecenia, aby wyświetlić listę wszystkich domen niestandardowych aplikacji:

   az spring app custom-domain list \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --app <app-name> \
   

Uwaga

Wartość stanu TLS/SSL dla domeny niestandardowej oznacza, że nie jest jeszcze powiązana z certyfikatem TLS/SSL. Każde żądanie HTTPS z przeglądarki do domeny niestandardowej otrzyma błąd lub ostrzeżenie.

Dodawanie powiązania TLS/SSL

Przed wykonaniem tego kroku upewnij się, że certyfikaty zostały przygotowane i zaimportowane do usługi Azure Spring Apps. Aby uzyskać więcej informacji, zobacz Mapuj istniejącą domenę niestandardową na usługę Azure Spring Apps.

Witryna Azure Portal

Wykonaj następujące kroki, aby zaktualizować domenę niestandardową aplikacji przy użyciu certyfikatu:

1. Otwórz wystąpienie usługi Azure Spring Apps i wybierz pozycję Aplikacje w okienku nawigacji.

2. Na stronie Aplikacje wybierz aplikację.

3. Wybierz pozycję Domena niestandardowa w okienku nawigacji.

4. Wybierz przycisk wielokropka (...) dla domeny niestandardowej, a następnie wybierz pozycję Powiąż protokół TLS/SSL.

5. W okienku powiązania TLS/SSL wybierz pozycję Certyfikat, a następnie wybierz lub zaimportuj certyfikat.

6. Wybierz pozycję Zapisz.

   

Po pomyślnym dodaniu powiązania TLS/SSL stan domeny będzie bezpieczny, jak pokazano w przypadku wartości stanu TLS/SSL w dobrej kondycji.

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby zaktualizować domenę niestandardową aplikacji przy użyciu certyfikatu:

az spring app custom-domain update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --domain-name <domain-name> \
    --certificate <cert-name> \
    --app <app-name> 

Konfigurowanie domeny niestandardowej dla wszystkich aplikacji

Aby użyć prywatnej strefy DNS do tłumaczenia i rozpoznawania nazw DNS, należy utworzyć rekord typu "A" w strefie dla każdego wystąpienia usługi Azure Spring Apps. W tym przykładzie nazwa aplikacji to hello-vnet , a nazwa wystąpienia usługi Azure Springs Apps to azure-spring-apps-1.

Potrzebny jest adres IP dla każdej aplikacji. Skopiuj go zgodnie z opisem w sekcji Znajdowanie adresu IP dla aplikacji w sekcji Uzyskiwanie dostępu do aplikacji w sieci prywatnej. W tym przykładzie adres IP to 10.1.0.6.

Witryna Azure Portal

Wykonaj następujące kroki, aby utworzyć rekord A w strefie DNS:

1. Przejdź do utworzonej wcześniej prywatnej strefy DNS: private.azuremicroservices.io

2. Wybierz pozycję Zestaw rekordów.

3. W okienku Dodawanie zestawu rekordów wprowadź wartości z poniższej tabeli.

   Ustawienie	Wartość
   Nazwisko	*.azure-spring-apps-1
   Typ	A
   TTL	1
   Jednostka TTL	Godzin
   Adres IP	(wklej ze schowka)

4. Wybierz przycisk OK.

   

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby utworzyć rekord A w strefie DNS:

az network private-dns record-set a add-record \
    --resource-group $RESOURCE_GROUP \
    --zone-name private.azuremicroservices.io \
    --record-set-name '*.azure-spring-apps-1' \
    --ipv4-address $IP_ADDRESS

Powtórz w razie potrzeby, aby skonfigurować domenę niestandardową dla innych aplikacji.

Uzyskiwanie dostępu do prywatnej nazwy FQDN dla aplikacji

Po przypisaniu nazw FQDN i mapowaniu DNS dla obu metod można uzyskać dostęp do prywatnej nazwy FQDN wszystkich aplikacji w sieci prywatnej. Można na przykład utworzyć serwer przesiadkowy lub maszynę wirtualną w tej samej sieci wirtualnej lub w równorzędnej sieci wirtualnej i mieć dostęp do wszystkich prywatnych nazw FQDN aplikacji.

W poniższych przykładach przedstawiono metodę FQDN:

• https://hello-vnet.azure-spring-apps-1.private.azuremicroservices.io
• https://hello-vnet.azure-spring-apps-2.private.azuremicroservices.io

W poniższych przykładach przedstawiono podejście do domeny niestandardowej:

• https://azure-spring-apps-1-hello-vnet.private.azuremicroservices.io
• https://azure-spring-apps-2-hello-vnet.private.azuremicroservices.io

Poniższy zrzut ekranu przedstawia adres URL aplikacji Spring przy użyciu nazwy FQDN:

Poniższy zrzut ekranu przedstawia adres URL aplikacji Spring przy użyciu domeny niestandardowej:

Czyszczenie zasobów

Jeśli planujesz kontynuować pracę z kolejnymi artykułami, możesz pozostawić te zasoby na swoim miejscu. Gdy grupa zasobów nie będzie już potrzebna, usuń grupę zasobów, która usuwa zasoby w grupie zasobów. Aby usunąć grupę zasobów przy użyciu interfejsu wiersza polecenia platformy Azure, użyj następującego polecenia:

az group delete --name $RESOURCE_GROUP

Następne kroki

• Wdrażanie usługi Azure Spring Apps w sieci wirtualnej platformy Azure (iniekcja sieci wirtualnej)
• Uzyskiwanie dostępu do aplikacji w sieci prywatnej