Udostępnij za pośrednictwem


Wewnętrzne Połączenie or usługi

Usługa Połączenie or to dostawca zasobów rozszerzenia platformy Azure zaprojektowany w celu zapewnienia prostego sposobu tworzenia połączeń między usługami platformy Azure i zarządzania nimi.

Usługa Połączenie or oferuje następujące funkcje:

  • Umożliwia łączenie usług platformy Azure z jednym poleceniem interfejsu wiersza polecenia platformy Azure lub w kilku krokach przy użyciu witryny Azure Portal.
  • Obsługuje coraz większą liczbę baz danych, magazynu, usług w czasie rzeczywistym, stanów i magazynów wpisów tajnych, które są używane z natywną aplikacją w chmurze.
  • Konfiguruje ustawienia sieci, uwierzytelnianie i zarządza zmiennymi środowiskowymi połączenia lub właściwościami.
  • Weryfikuje połączenia i udostępnia sugestie dotyczące naprawiania uszkodzonych połączeń.

Omówienie połączenia z usługą

Koncepcja połączenia z usługą jest kluczową koncepcją w modelu zasobów usługi Połączenie or. Połączenie usługi reprezentuje abstrakcję połączenia między dwiema usługami. Połączenia usług mają następujące właściwości:

Właściwości opis
Nazwa połączenia Unikatowa nazwa połączenia usługi.
Typ usługi źródłowej Usługi źródłowe to usługi, które można połączyć z usługami docelowymi. Są to zazwyczaj usługi obliczeniowe platformy Azure i obejmują aplikacja systemu Azure Service, Azure Functions, Azure Container Apps i Azure Spring Apps.
Docelowy typ usługi Usługi docelowe są usługami zapasowymi lub usługami zależności, z którymi łączą się usługi obliczeniowe. Usługa Połączenie or obsługuje różne typy usług docelowych, w tym główne bazy danych, magazyny, usługi czasu rzeczywistego, stan i magazyny wpisów tajnych.
Typ klienta Typ klienta odnosi się do stosu środowiska uruchomieniowego obliczeniowego, struktury programistycznej lub określonego typu biblioteki klienta, która akceptuje określony format zmiennych środowiskowych lub właściwości połączenia.
Typ uwierzytelniania Typ uwierzytelniania używany na potrzeby połączenia z usługą. Może to być wpis tajny/parametry połączenia, tożsamość zarządzana lub jednostka usługi.

Usługi źródłowe i usługi docelowe obsługują wiele równoczesnych połączeń usług, co oznacza, że można połączyć każdy zasób z wieloma zasobami.

Usługa Połączenie or zarządza połączeniami we właściwościach wystąpienia źródłowego. Tworzenie, aktualizowanie i usuwanie połączeń odbywa się bezpośrednio przez otwarcie wystąpienia usługi źródłowej w witrynie Azure Portal lub za pomocą poleceń interfejsu wiersza polecenia usługi źródłowej.

Połączenie można dokonać między subskrypcjami lub dzierżawami, co oznacza, że usługi źródłowe i docelowe mogą należeć do różnych subskrypcji lub dzierżaw. Podczas tworzenia nowego połączenia z usługą zasób połączenia jest tworzony w tym samym regionie co wystąpienie usługi obliczeniowej domyślnie.

Tworzenie i aktualizowanie połączenia z usługą

Usługa Połączenie or uruchamia wiele zadań podczas tworzenia lub aktualizowania połączeń usług, w tym:

  • Konfigurowanie ustawień sieci i zapory. Dowiedz się więcej o rozwiązaniach sieciowych.

  • Konfigurowanie informacji o połączeniu. Dowiedz się więcej o konfiguracjach połączeń.

  • Konfigurowanie informacji o uwierzytelnianiu. Usługa Połączenie or obsługuje wszystkie dostępne typy uwierzytelniania między usługami źródłowymi i usługami docelowymi.

    • Tożsamość zarządzana przypisana przez system. Usługa Połączenie or włącza tożsamość zarządzaną przypisaną przez system w usługach źródłowych, jeśli nie została jeszcze włączona, a następnie przyznaje role RBAC usług docelowych tożsamości zarządzanej. Użytkownik może określić role, które mają zostać przyznane.
    • Tożsamość zarządzana przypisana przez użytkownika. Usługa Połączenie or umożliwia przypisaną przez użytkownika tożsamość zarządzaną w usługach źródłowych, jeśli nie została jeszcze włączona, a następnie przyznaje role RBAC usług docelowych tożsamości zarządzanej. Użytkownik może określić role, które mają zostać przyznane.
    • ciąg Połączenie ion. Usługa Połączenie or pobiera parametry połączenia z usług docelowych, takich jak Storage, Redis Cache itp., lub tworzy parametry połączenia na podstawie danych wejściowych użytkownika, takich jak usługa Azure Database for SQL, PostgreSQL itp.
    • Jednostka usługi. Usługa Połączenie or przyznaje role RBAC usług docelowych tożsamości zarządzanej. Użytkownik może określić role, które mają zostać przyznane.

    Usługa Połączenie or zapisuje odpowiednie konfiguracje uwierzytelniania w usługach źródłowych, na przykład zapisywanie AZURE_CLIENT_ID, AZURE_TENANT_ID AZURE_STORAGEACCOUNT_ENDPOINT dla usługi Storage przy użyciu tożsamości zarządzanej przypisanej przez użytkownika typu uwierzytelniania.

  • Tworzenie lub aktualizowanie wycofywania połączenia w przypadku wystąpienia błędu

Jeśli krok zakończy się niepowodzeniem podczas tego procesu, usługa Połączenie or wycofa wszystkie poprzednie kroki, aby zachować początkowe ustawienia w wystąpieniach źródłowych i docelowych.

Dostawca zasobów

Microsoft.ServiceLinker to nazwa dostawcy zasobów usługi Połączenie or.

Gdy użytkownik otworzy kartę Service Połączenie or w witrynie Azure Portal, dostawca zasobów ServiceLinker zostanie automatycznie zarejestrowany w aktywnej subskrypcji użytkownika. Użytkownik, który wygenerował rejestrację, jest wymieniony jako inicjator zdarzenia rejestracji.

Usługa Połączenie or umożliwia użytkownikom łączenie usług między subskrypcjami. Gdy użytkownik utworzy połączenie z usługą docelową zarejestrowaną w innej subskrypcji, usługa Service Linker również zostanie zarejestrowana w subskrypcji usługi docelowej. Ta rejestracja występuje, gdy użytkownik wybierze kartę Przeglądanie i tworzenie przed utworzeniem połączenia.

Konfiguracje Połączenie ion

konfiguracje Połączenie ion są ustawiane w usłudze źródłowej.

W witrynie Azure Portal otwórz usługę źródłową i przejdź do pozycji Usługa Połączenie or. Rozwiń każde połączenie i wyświetl konfiguracje połączeń.

Screenshot of the Azure portal showing service connection details.

W interfejsie wiersza polecenia użyj list-configuration polecenia , aby uzyskać konfiguracje połączeń.

az webapp connection list-configuration --resource-group <source-service-resource-group> --name <source-service-name> --connection <connection-name>
az spring connection list-configuration --resource-group <source-service-resource-group> --name <source-service-name> --connection <connection-name>
az containerapp connection list-configuration --resource-group <source-service-resource-group> --name <source-service-name> --connection <connection-name>

Konwencja nazewnictwa konfiguracji

Usługa Połączenie or ustawia konfigurację połączenia podczas tworzenia połączenia. Pary klucz-wartość zmiennej środowiskowej są określane na podstawie typu klienta i typu uwierzytelniania. Na przykład użycie zestawu Azure SDK z tożsamością zarządzaną wymaga identyfikatora klienta, klucza tajnego klienta itp. Użycie sterownika JDBC wymaga parametry połączenia bazy danych. Postępuj zgodnie z tymi konwencjami, aby nazwać konfiguracje:

  • Klient Spring Boot: biblioteka Spring Boot dla każdej usługi docelowej ma własną konwencję nazewnictwa. Na przykład ustawienia połączenia MySQL to spring.datasource.url, spring.datasource.username, spring.datasource.password. Ustawienia połączenia platformy Kafka to spring.kafka.properties.bootstrap.servers.

  • Inni klienci:

    • Nazwa klucza pierwszej konfiguracji połączenia używa formatu <Cloud>_<Type>_<Name>. Na przykład , AZURE_STORAGEBLOB_RESOURCEENDPOINT. CONFLUENTCLOUD_KAFKA_BOOTSTRAPSERVER
    • W przypadku tego samego typu zasobu docelowego nazwa klucza drugiej konfiguracji połączenia używa formatu <Cloud>_<Type>_<Connection Name>_<Name>. Na przykład , AZURE_STORAGEBLOB_CONN2_RESOURCEENDPOINT. CONFLUENTCLOUD_KAFKA_CONN2_BOOTSTRAPSERVER

Rozwiązanie sieciowe usługi

Usługa Połączenie or oferuje trzy rozwiązania sieciowe dla użytkowników do wyboru podczas tworzenia połączenia. Te rozwiązania zostały zaprojektowane tak, aby ułatwić bezpieczną i wydajną komunikację między zasobami.

  1. Zapora: to rozwiązanie umożliwia połączenie za pośrednictwem sieci publicznej i zasobów obliczeniowych uzyskujących dostęp do zasobu docelowego przy użyciu publicznego adresu IP. Podczas wybierania tej opcji usługa Połączenie or weryfikuje ustawienia zapory zasobu docelowego i dodaje regułę zezwalającą na połączenia z publicznego adresu IP zasobu źródłowego. Jeśli zapora zasobu obsługuje zezwalanie na dostęp do wszystkich zasobów platformy Azure, usługa Połączenie or włącza to ustawienie. Jeśli jednak zasób docelowy domyślnie odrzuca cały ruch sieciowy publiczny, usługa Połączenie or nie modyfikuje tego ustawienia. W takim przypadku należy wybrać inną opcję lub ręcznie zaktualizować ustawienia sieciowe przed ponowną próbą.

  2. Punkt końcowy usługi: to rozwiązanie umożliwia zasobom obliczeniowym łączenie się z zasobami docelowymi za pośrednictwem sieci wirtualnej, zapewniając, że ruch połączeń nie przechodzi przez sieć publiczną. Jest dostępna tylko wtedy, gdy spełnione są pewne warunki wstępne:

    • Zasób obliczeniowy musi mieć włączoną integrację z siecią wirtualną. W przypadku usługi aplikacja systemu Azure można ją skonfigurować w ustawieniach sieci. W przypadku usługi Azure Spring Apps użytkownicy muszą ustawić iniekcję sieci wirtualnej podczas etapu tworzenia zasobów.
    • Usługa docelowa musi obsługiwać punkt końcowy usługi. Aby uzyskać listę obsługiwanych usług, zobacz Punkty końcowe usługi dla sieci wirtualnej.

    Po wybraniu tej opcji usługa Połączenie or dodaje prywatny adres IP zasobu obliczeniowego w sieci wirtualnej do reguł sieci wirtualnej zasobu docelowego i włącza punkt końcowy usługi w konfiguracji podsieci zasobu źródłowego. Jeśli użytkownik nie ma wystarczających uprawnień lub jednostka SKU zasobu lub region nie obsługuje punktów końcowych usługi, tworzenie połączenia kończy się niepowodzeniem.

  3. Prywatny punkt końcowy: to rozwiązanie jest zalecanym sposobem łączenia zasobów za pośrednictwem sieci wirtualnej i jest dostępny tylko w przypadku spełnienia pewnych warunków wstępnych:

  • Zasób obliczeniowy musi mieć włączoną integrację z siecią wirtualną. W przypadku usługi aplikacja systemu Azure można ją skonfigurować w ustawieniach sieci. W przypadku usługi Azure Spring Apps użytkownicy muszą ustawić iniekcję sieci wirtualnej podczas etapu tworzenia zasobów.

  • Usługa docelowa musi obsługiwać prywatne punkty końcowe. Aby uzyskać listę obsługiwanych usług, zapoznaj się z artykułem Zasób usługi Private-link.

    Po wybraniu tej opcji usługa Połączenie or nie wykonuje więcej konfiguracji w zasobach obliczeniowych ani docelowych. Zamiast tego sprawdza istnienie prawidłowego prywatnego punktu końcowego i kończy się niepowodzeniem połączenia, jeśli nie zostanie znalezione. Dla wygody użytkownicy mogą wybrać pole wyboru "Nowy prywatny punkt końcowy" w witrynie Azure Portal podczas tworzenia połączenia. Dzięki temu usługa Połączenie or automatycznie tworzy wszystkie powiązane zasoby dla prywatnego punktu końcowego w odpowiedniej kolejności, upraszczając proces tworzenia połączenia.

Walidacja połączenia z usługą

Podczas sprawdzania poprawności połączenia łącznik usługi sprawdza następujące elementy:

  • Istnieją zasoby źródłowe i docelowe.
  • Źródło: zarejestrowane są poprawne informacje o połączeniu.
  • Cel: zarejestrowane są poprawne ustawienia sieci i zapory.
  • Zasoby źródłowe i docelowe: zarejestrowane są poprawne informacje o uwierzytelnianiu.

usuwanie Połączenie ion

Po usunięciu połączenia z usługą informacje o połączeniu również zostaną usunięte.

Następne kroki

Zapoznaj się z następującym artykułem koncepcyjnym, aby dowiedzieć się więcej na temat usługi Połączenie or.