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
- Visual Studio (zobacz [Pliki do pobrania Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) z zainstalowanym pakietem roboczym do tworzenia aplikacji w Azure .
- Projekt jednego z obsługiwanych typów
- Konto platformy Azure. Jeśli nie masz konta platformy Azure, aktywuj korzyści platformy Azure dla subskrybentów programu Visual Studio lub załóż konto bezpłatnej wersji próbnej.
Nawiązywanie połączenia z usługą Azure App Configuration przy użyciu połączonych usług
Otwórz projekt w programie Visual Studio.
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ą .
W karcie Usługi połączone wybierz ikonę + dla zależności usług.
Na stronie Dodawanie zależności wybierz pozycję 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łatną wersję próbną.
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.
Aby utworzyć magazyn konfiguracji aplikacji:
Wybierz ikonę + po prawej stronie nagłówka App Configuration stores.
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.
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.
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.
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.
Po zakończeniu procesu konfiguracji zależności usługa Azure App Configuration jest teraz wyświetlana w Service Dependencies węźle projektu.
Otwórz projekt w programie Visual Studio.
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.
Wybierz pozycję Azure App Configuration. Zostanie wyświetlona strona Połącz z zależnością.
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.
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.
Aby utworzyć magazyn konfiguracji aplikacji:
Wybierz ikonę + po prawej stronie nagłówka App Configuration.
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.
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.
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.
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.
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.
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:
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.