Udostępnij za pośrednictwem


Dodawanie usługi Azure App Configuration przy użyciu usług połączonych programu Visual Studio

W tym samouczku dowiesz się, jak łatwo dodać wszystko, czego potrzebujesz, aby rozpocząć korzystanie z usługi Azure App Configuration w celu zarządzania flagami konfiguracji i funkcji dla projektów internetowych w programie Visual Studio. Korzystając z funkcji Usługi połączone w programie Visual Studio, program Visual Studio może automatycznie dodawać cały kod, pakiety NuGet i ustawienia konfiguracji, które należy połączyć z zasobem usługi App Configuration na platformie Azure. Aby korzystać z tej funkcji, musisz używać programu Visual Studio 2019 w wersji 16.9 lub nowszej.

Funkcji App Configuration Connected Services można używać w następujących typach projektów:

  • ASP.NET Core
  • Konsola platformy .NET Core
  • Projekty .NET Framework.

Warunki wstępne

Nawiązywanie połączenia z usługą Azure App Configuration przy użyciu połączonych usług

  1. Otwórz projekt w programie Visual Studio.

  2. W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy na węźle usług połączonych , a następnie z menu kontekstowego wybierz pozycję Dodaj usługę połączoną .

    zrzut ekranu przedstawiający ekran

  3. W karcie Usługi połączone wybierz ikonę + dla zależności usług.

    zrzut ekranu przedstawiający ekran

  4. Na stronie Dodawanie zależności wybierz pozycję Azure App Configuration.

    zrzut ekranu przedstawiający ekran

    Jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure. Jeśli nie masz konta Azure, możesz zarejestrować się na bezpłatną wersję próbną.

  5. Na ekranie Konfigurowanie usługi Azure App Configuration wybierz swoją subskrypcję i istniejący sklep konfiguracji. Następnie wybierz pozycję Dalej.

    Jeśli musisz utworzyć repozytorium App Configuration, przejdź dalej. W przeciwnym razie przejdź do kroku 6.

    Zrzut ekranu przedstawiający ekran

  6. Aby utworzyć magazyn konfiguracji aplikacji:

    1. Wybierz ikonę + po prawej stronie nagłówka App Configuration stores.

    2. Wypełnij okno dialogowe Azure App Configuration: Utwórz nowe okno i wybierz pozycję Utwórz. Należy pamiętać, że pole Nazwa zasobu musi być unikatowe.

      Zrzut ekranu pokazujący nowy magazyn konfiguracji aplikacji Azure.

    3. Po wyświetleniu okna dialogowego Azure App Configuration na liście pojawi się nowy magazyn konfiguracji. Wybierz ten nowy sklep, a następnie wybierz pozycję Dalej.

  7. Wprowadź nazwę łańcucha połączenia i wybierz, czy chcesz, aby łańcuch połączenia był przechowywany w lokalnym pliku wpisów tajnych, czy w Azure Key Vault.

    zrzut ekranu przedstawiający ekran

  8. Na ekranie Podsumowanie zmian są wyświetlane wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają ok, wybierz pozycję Zakończ.

    Zrzut ekranu przedstawiający podsumowanie zmian.

  9. Po zakończeniu procesu konfiguracji zależności usługa Azure App Configuration jest teraz wyświetlana w Service Dependencies węźle projektu.

  1. Otwórz projekt w programie Visual Studio.

  2. W Eksploratorze rozwiązańkliknij prawym przyciskiem myszy węzeł Usługi połączone, a następnie z menu kontekstowego wybierz pozycję Dodaj, aby otworzyć menu dostępnych usług.

    Zrzut ekranu przedstawiający opcje menu kontekstowego usług połączonych.

  3. Wybierz pozycję Azure App Configuration. Zostanie wyświetlona strona Połącz z zależnością.

    Zrzut ekranu przedstawiający Połączenie z zależnością dla Azure App Configuration.

    Jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure. Jeśli nie masz konta Azure, możesz zarejestrować się na bezpłatny okres próbny.

  4. Na ekranie Konfigurowanie usługi Azure App Configuration wybierz subskrypcję i istniejący magazyn konfiguracji. Następnie wybierz pozycję Dalej.

    Jeśli musisz utworzyć magazyn App Configuration, przejdź do następnego kroku. W przeciwnym razie przejdź do kroku 6.

    Zrzut ekranu przedstawiający pozycję

  5. Aby utworzyć magazyn konfiguracji aplikacji:

    1. Wybierz ikonę + po prawej stronie nagłówka App Configuration.

    2. Wypełnij okno dialogowe Azure App Configuration: Utwórz nowy, a następnie wybierz Utwórz. Należy pamiętać, że pole Nazwa zasobu musi być unikatowe.

      Zrzut ekranu przedstawiający nowy magazyn konfiguracji aplikacji platformy Azure.

    3. Po wyświetleniu okna dialogowego Azure App Configuration na liście pojawi się nowy magazyn konfiguracji. Wybierz ten nowy sklep, a następnie wybierz pozycję Dalej.

  6. Wprowadź nazwę ciągu połączenia i wybierz, czy chcesz, aby ciąg połączenia był przechowywany w lokalnym pliku sekretów, czy w Azure Key Vault.

    zrzut ekranu przedstawiający ekran

  7. Na ekranie Podsumowanie zmian są wyświetlane wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają ok, wybierz pozycję Zakończ.

    Zrzut ekranu przedstawiający podsumowanie zmian.

    Po zakończeniu procesu konfiguracji zależności , usługa Azure App Configuration jest teraz wyświetlana w węźle Zależności usługi projektu.

  8. W Eksploratorze rozwiązań kliknij dwukrotnie węzeł Usługi połączone, aby otworzyć kartę Usługi połączone. Połączenie zostanie wyświetlone w sekcji Zależności usługi:

    zrzut ekranu przedstawiający sekcję Zależności usługi przedstawiającą połączenie usługi Azure App Configuration.

    Istnieje również wpis Secrets.json, który obsługuje lokalne bezpieczne przechowywanie parametrów połączenia. Przeczytaj o tym, jak to działa na Zrzut ekranu pokazujący bezpieczne przechowywanie tajemnic aplikacji podczas programowania w ASP.NET Core.

    Jeśli klikniesz trzy kropki obok dodanych zależności, możesz zobaczyć różne opcje, takie jak Connect, które pozwala ponownie otworzyć kreatora i zmienić połączenie, a w przypadku Secrets.jsonopcja zarządzania tajnymi informacjami. Możesz również kliknąć trzy kropki w prawym górnym rogu okna, aby wyświetlić opcje uruchamiania zależności lokalnych, zmiany ustawień i nie tylko.