Szybki start: tworzenie połączenia usługi w usłudze Azure Functions przy użyciu interfejsu wiersza polecenia platformy Azure
W tym przewodniku Szybki start pokazano, jak połączyć usługę Azure Functions z innymi zasobami w chmurze przy użyciu interfejsu wiersza polecenia platformy Azure i łącznika usług. Łącznik usług umożliwia szybkie łączenie usług obliczeniowych z usługami w chmurze przy jednoczesnym zarządzaniu uwierzytelnianiem połączenia i ustawieniami sieci.
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Wymagania wstępne
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.
- Ten przewodnik Szybki start wymaga wersji 2.30.0 lub nowszej interfejsu wiersza polecenia platformy Azure. W przypadku korzystania z usługi Azure Cloud Shell najnowsza wersja jest już zainstalowana.
- W tym przewodniku Szybki start założono, że masz już funkcję platformy Azure. Jeśli jeszcze jej nie masz, utwórz funkcję platformy Azure.
- W tym przewodniku Szybki start założono, że masz już konto usługi Azure Storage. Jeśli jeszcze go nie masz, utwórz konto usługi Azure Storage.
Początkowa konfiguracja
Jeśli używasz łącznika usługi po raz pierwszy, uruchom polecenie az provider register , aby zarejestrować dostawcę zasobów łącznika usług.
az provider register -n Microsoft.ServiceLinker
Napiwek
Możesz sprawdzić, czy dostawca zasobów został już zarejestrowany, uruchamiając polecenie
az provider show -n "Microsoft.ServiceLinker" --query registrationState
. Jeśli dane wyjściowe toRegistered
, łącznik usługi został już zarejestrowany.Opcjonalnie użyj polecenia az functionapp connection list-support-types interfejsu wiersza polecenia platformy Azure, aby uzyskać listę obsługiwanych usług docelowych dla aplikacji funkcji.
az functionapp connection list-support-types --output table
Tworzenie połączenia z usługą
Ważne
Korzystanie z tożsamości zarządzanej wymaga uprawnienia do przypisania roli usługi Azure AD. Jeśli nie masz uprawnień, tworzenie połączenia zakończy się niepowodzeniem. Możesz poprosić właściciela subskrypcji o uprawnienie lub użyć klucza dostępu, aby utworzyć połączenie.
Użyj polecenia az functionapp connection interfejsu wiersza polecenia platformy Azure, aby utworzyć połączenie usługi z usługą Blob Storage z tożsamością zarządzaną przypisaną przez system, podając następujące informacje:
- Nazwa źródłowej grupy zasobów usługi obliczeniowej: nazwa grupy zasobów aplikacji funkcji.
- Nazwa aplikacji funkcji: nazwa aplikacji funkcji, która łączy się z usługą docelową.
- Nazwa grupy zasobów usługi docelowej: nazwa grupy zasobów usługi Blob Storage.
- Nazwa konta magazynu: nazwa konta usługi Blob Storage.
az functionapp connection create storage-blob --system-identity
Uwaga
Jeśli nie masz usługi Blob Storage, możesz uruchomić polecenie az functionapp connection create storage-blob --new --system-identity
, aby aprowizować nowy i bezpośrednio nawiązać połączenie z aplikacją funkcji.
Wyświetlanie połączeń
Użyj polecenia az functionapp connection list interfejsu wiersza polecenia platformy Azure, aby wyświetlić listę połączeń z aplikacją funkcji, podając następujące informacje:
- Nazwa źródłowej grupy zasobów usługi obliczeniowej: nazwa grupy zasobów aplikacji funkcji.
- Nazwa aplikacji funkcji: nazwa aplikacji funkcji, która łączy się z usługą docelową.
az functionapp connection list -g "<your-function-app-resource-group>" -n "<your-function-app-name>" --output table
Następne kroki
Postępuj zgodnie z poniższymi samouczkami, aby rozpocząć tworzenie własnej aplikacji funkcji za pomocą łącznika usługi.