Samouczek: wdrażanie aplikacji internetowej połączonej z usługą Azure Blob Storage za pomocą łącznika usługi

Z tego samouczka dowiesz się, jak uzyskać dostęp do usługi Azure Blob Storage dla aplikacji internetowej (nie zalogowanego użytkownika) uruchomionej w usłudze aplikacja systemu Azure Przy użyciu tożsamości zarządzanych. W tym samouczku użyjesz interfejsu wiersza polecenia platformy Azure, aby wykonać następujące zadania:

• Konfigurowanie środowiska początkowego przy użyciu interfejsu wiersza polecenia platformy Azure
• Utwórz konto magazynu i kontener usługi Azure Blob Storage.
• Wdrażanie kodu w usłudze aplikacja systemu Azure i nawiązywanie połączenia z magazynem przy użyciu tożsamości zarządzanej przy użyciu łącznika usługi

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.

• Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.

  

• Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.

  • Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.

  • Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.

  • Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.

Konfigurowanie środowiska początkowego

1. Sprawdź, czy interfejs wiersza polecenia platformy Azure ma wersję 2.30.0 lub nowszą:

   az --version
   

   Jeśli chcesz uaktualnić, uruchom az upgrade polecenie (wymaga wersji 2.11 lub nowszej).

2. Zaloguj się do platformy Azure przy użyciu interfejsu wiersza polecenia:

   az login
   

   To polecenie otwiera przeglądarkę w celu zebrania poświadczeń. Po zakończeniu polecenia zostanie wyświetlone dane wyjściowe JSON zawierające informacje o subskrypcjach.

   Po zalogowaniu można uruchamiać polecenia platformy Azure za pomocą interfejsu wiersza polecenia platformy Azure, aby pracować z zasobami w ramach subskrypcji.

Klonowanie lub pobieranie przykładowej aplikacji

1. Sklonuj przykładowe repozytorium:

   git clone https://github.com/Azure-Samples/serviceconnector-webapp-storageblob-dotnet.git
   

2. Przejdź do folderu głównego repozytorium:

   cd serviceconnector-webapp-storageblob-dotnet
   

Tworzenie aplikacji usługi App Service

1. W terminalu upewnij się, że jesteś w folderze repozytorium WebAppStorageMISample zawierającym kod aplikacji.

2. Utwórz aplikację usługi App Service (proces hosta) za pomocą poniższego az webapp up polecenia i zastąp symbole zastępcze własnymi danymi:

   • W przypadku argumentu --location użyj regionu obsługiwanego przez łącznik usługi.
   • Zastąp <app-name> ciąg unikatową nazwą na platformie Azure. Punkt końcowy serwera to https://<app-name>.azurewebsites.net. Dozwolone znaki to <app-name> A-Z,-09 i .- Dobrym wzorcem jest użycie kombinacji nazwy firmy i identyfikatora aplikacji.

    az webapp up --name <app-name> --sku B1 --location eastus --resource-group ServiceConnector-tutorial-rg
   

Tworzenie konta magazynu i kontenera usługi Blob Storage

W terminalu uruchom następujące polecenie, aby utworzyć konto magazynu ogólnego przeznaczenia w wersji 2 i kontener usługi Blob Storage.

az storage account create --name <storage-name> --resource-group ServiceConnector-tutorial-rg --sku Standard_RAGRS --https-only

Zastąp ciąg <storage-name> unikatową nazwą. Nazwa kontenera musi mieć małe litery, zaczynać się literą lub cyfrą i może zawierać tylko litery, cyfry i znak kreski (-).

Łączenie aplikacji usługi App Service z kontenerem usługi Blob Storage przy użyciu tożsamości zarządzanej

W terminalu uruchom następujące polecenie, aby połączyć aplikację internetową z magazynem obiektów blob przy użyciu tożsamości zarządzanej.

az webapp connection create storage-blob -g ServiceConnector-tutorial-rg -n <app-name> --tg ServiceConnector-tutorial-rg --account <storage-name> --system-identity

Zastąp następujące symbole zastępcze własnymi danymi:

• Zastąp <app-name> ciąg nazwą aplikacji internetowej użytą w kroku 3.
• Zastąp <storage-name> ciąg nazwą aplikacji magazynu użytą w kroku 4.

Uwaga

Jeśli zostanie wyświetlony komunikat o błędzie "Subskrypcja nie jest zarejestrowana do korzystania z microsoft.ServiceLinker", uruchom polecenie az provider register -n Microsoft.ServiceLinker , aby zarejestrować dostawcę zasobów łącznika usługi i ponownie uruchomić polecenie połączenia.

Uruchamianie przykładowego kodu

W terminalu uruchom następujące polecenie, aby otworzyć przykładową aplikację w przeglądarce. Zastąp <app-name> element nazwą użytej wcześniej aplikacji internetowej.

az webapp browse --name <app-name> 

Przykładowy kod to aplikacja internetowa. Za każdym razem, gdy odświeżysz stronę indeksu, aplikacja tworzy lub aktualizuje obiekt blob z tekstem Hello Service Connector! Current is {UTC Time Now} w kontenerze magazynu i odczytuje go z powrotem, aby wyświetlić go na stronie indeksu.

Następny krok

Aby dowiedzieć się więcej na temat łącznika usługi, przeczytaj poniższy przewodnik.

Pojęcia dotyczące łącznika usług