Przewodnik dla deweloperów Azure Functions

W Azure Functions wszystkie funkcje dzielą się podstawowymi pojęciami i składnikami technicznymi, niezależnie od preferowanego języka lub środowiska programistycznego. Ten artykuł jest specyficzny dla języka. Wybierz preferowany język w górnej części artykułu.

Ten artykuł zakłada, że przeczytałeś już przegląd Azure Functions.

Jeśli wolisz przejść bezpośrednio, możesz ukończyć samouczek Szybki start przy użyciu Visual Studio, Visual Studio Code lub z monitu.

Jeśli wolisz przejść bezpośrednio, możesz ukończyć samouczek Szybki start przy użyciu Maven (wiersz polecenia), Eclipse, IntelliJ IDEA, Gradle, Quarkus, Spring Cloud, lub Visual Studio Code.

Jeśli wolisz przejść bezpośrednio, możesz ukończyć samouczek Szybki start przy użyciu Visual Studio Code lub z poziomu monitu.

Jeśli wolisz przejść bezpośrednio, możesz ukończyć samouczek Szybki start przy użyciu Visual Studio Code lub z poziomu monitu.

Jeśli wolisz przejść bezpośrednio, możesz ukończyć samouczek Szybki start przy użyciu Visual Studio Code lub z poziomu monitu.

Jeśli wolisz przejść bezpośrednio, możesz ukończyć samouczek Szybki start przy użyciu Visual Studio Code lub z poziomu monitu.

Projekt kodu

Podstawą Azure Functions jest projekt kodu specyficzny dla języka, który implementuje co najmniej jedną jednostki wykonywania kodu o nazwie functions. Funkcje to po prostu metody uruchamiane w chmurze Azure na podstawie zdarzeń, w odpowiedzi na żądania HTTP lub zgodnie z harmonogramem. Projekt kodu Azure Functions można traktować jako mechanizm organizowania, wdrażania i zbiorowego zarządzania poszczególnymi funkcjami w projekcie podczas ich uruchamiania w Azure. Aby uzyskać więcej informacji, zobacz Organizowanie funkcji.

Sposób układania projektu kodu i sposobu wskazywania metod w projekcie zależy od języka programowania projektu. Aby uzyskać szczegółowe wskazówki dotyczące języka, zobacz przewodnik deweloperów języka C#.

Sposób układania projektu kodu i sposobu wskazywania metod w projekcie zależy od języka programowania projektu. Aby uzyskać wskazówki specyficzne dla języka, zobacz przewodnik dla deweloperów Java.

Sposób układania projektu kodu i sposobu wskazywania metod w projekcie zależy od języka programowania projektu. Aby uzyskać wskazówki specyficzne dla języka, zobacz przewodnik dla deweloperów Node.js.

Sposób układania projektu kodu i sposobu wskazywania metod w projekcie zależy od języka programowania projektu. Aby uzyskać wskazówki specyficzne dla języka, zobacz Przewodnik deweloperów programu PowerShell.

Sposób układania projektu kodu i sposobu wskazywania metod w projekcie zależy od języka programowania projektu. Aby uzyskać wskazówki specyficzne dla języka, zobacz przewodnik dla deweloperów Python.

Sposób układania projektu kodu i sposobu wskazywania metod w projekcie zależy od języka programowania projektu. Wskazówki dotyczące języka znajdziesz w przewodniku dla deweloperów Go.

Wszystkie funkcje muszą mieć wyzwalacz, który definiuje sposób uruchamiania funkcji i może udostępniać dane wejściowe funkcji. Funkcje mogą opcjonalnie definiować powiązania wejściowe i wyjściowe. Te powiązania upraszczają połączenia z innymi usługami bez konieczności pracy z zestawami SDK klienta. Aby uzyskać więcej informacji, zobacz pojęcia Azure Functions wyzwalacze i powiązania.

Azure Functions udostępnia zestaw szablonów projektów i funkcji specyficznych dla języka, które ułatwiają tworzenie nowych projektów kodu i dodawanie funkcji do projektu. Możesz użyć dowolnego z narzędzi, które obsługują tworzenie Azure Functions, aby wygenerować nowe aplikacje i funkcje przy użyciu tych szablonów.

Narzędzia programistyczne

Następujące narzędzia zapewniają lokalne i zintegrowane doświadczenie programistyczne i publikujące Azure Functions w preferowanym przez Ciebie języku:

Te narzędzia integrują się z narzędziami Azure Functions Core Tools aby można było uruchamiać i debugować na komputerze lokalnym przy użyciu środowiska uruchomieniowego usługi Functions. Aby uzyskać więcej informacji, zobacz Code i przetestuj Azure Functions lokalnie.

W portalu Azure jest też edytor, którego możesz użyć do aktualizacji kodu i pliku definicji function.json bezpośrednio w portalu. Używaj tego edytora tylko do drobnych zmian lub tworzenia funkcji dowodzących koncepcję. Zawsze rozwijaj swoje funkcje lokalnie, jeśli to możliwe. Aby uzyskać więcej informacji, zobacz Utwórz pierwszą funkcję w portalu Azure.

Edytowanie portalu jest obsługiwane tylko w przypadku Node.js w wersji 3, która używa pliku function.json.

Wdrożenie

Podczas publikowania projektu kodu w celu Azure zasadniczo wdrażasz projekt w istniejącym zasobie aplikacji funkcji. Aplikacja funkcji udostępnia kontekst wykonywania w Azure, w którym działają funkcje. W związku z tym jest to jednostka wdrażania i zarządzania funkcjami. Z perspektywy zasobu Azure aplikacja funkcji jest równoważna zasobowi witryny (Microsoft.Web/sites) w Azure App Service, który jest odpowiednikiem aplikacji internetowej.

Aplikacja funkcjonalna składa się z jednej lub więcej indywidualnych funkcji, którymi zarządzasz, wdrażasz i skalujesz razem. Wszystkie funkcje w aplikacji funkcji mają ten sam plan cenowy, metodę wdrażania i wersję środowiska uruchomieniowego. Aby uzyskać więcej informacji, zobacz Jak zarządzać aplikacją funkcji.

Gdy aplikacja funkcjonalna i inne wymagane zasoby nie istnieją jeszcze w Azure, musisz je utworzyć, zanim będziesz mógł wdrożyć pliki projektu. Te zasoby można utworzyć na jeden z następujących sposobów:

Oprócz publikowania opartego na narzędziach usługa Functions obsługuje inne technologie wdrażania kodu źródłowego w istniejącej aplikacji funkcji. Aby uzyskać więcej informacji, zobacz technologie Deployment w Azure Functions.

Łączenie z usługami

Głównym wymaganiem każdej usługi obliczeniowej opartej na chmurze jest odczytywanie danych z i zapisywanie danych w innych usługach w chmurze. Funkcje udostępnia obszerny zestaw powiązań, które ułatwiają łączenie się z usługami bez konieczności pracy z zestawami SDK klienta.

Niezależnie od tego, czy korzystasz z rozszerzeń powiązanych oferowanych przez Functions, czy pracujesz bezpośrednio z klientskimi SDK, bezpiecznie przechowujesz dane połączenia i nie uwzględniasz ich w kodzie.

Domyślna pamięć hosta

Usługa Azure Functions wymaga konta Azure Storage podczas tworzenia aplikacji funkcji. To domyślne konto pamięci jest używane wewnętrznie przez host Functions oraz niektóre rozszerzenia wiązania.

Aby dowiedzieć się, jak bezpiecznie zdefiniować połączenia z domyślnym kontem pamięci, zobacz Definiuj połączenia.

Powiązania

Funkcje udostępniają powiązania dla wielu usług Azure i kilku usług innych firm, które są implementowane jako rozszerzenia. Aby uzyskać więcej informacji, zobacz pełną listę obsługiwanych powiązań.

Rozszerzenia powiązań mogą obsługiwać zarówno dane wejściowe, jak i wyjściowe, a wiele wyzwalaczy działa również jako powiązania wejściowe. Powiązania umożliwiają skonfigurowanie połączenia z usługami, aby host usługi Functions mógł obsłużyć dostęp do danych. Aby uzyskać więcej informacji, zobacz pojęcia Azure Functions wyzwalacze i powiązania.

Jeśli masz problemy z błędami pochodzącymi z powiązań, zapoznaj się z dokumentacją Azure Functions Powiązania kodów błędów. Aby dowiedzieć się, jak bezpiecznie definiować połączenia w powiązaniach z usługami zdalnymi, zobacz Definiuj połączenia.

Typowe właściwości połączeń opartych na tożsamościach

Połączenia oparte na tożsamości dla Azure Functions wykorzystują zarządzane tożsamości do uwierzytelniania. Domyślnie używana jest tożsamość przypisana przez system, ale można określić tożsamość przypisaną przez użytkownika za pomocą credential właściwości i clientId (a). Szczegółowe informacje o konfiguracji połączeń opartych na tożsamościach, w tym wymaganych ustawień aplikacji i uprawnień RBAC, można znaleźć w artykule Definiuj połączenia tożsamości zarządzanej.

Programowanie lokalne z połączeniami opartymi na tożsamościach

Podczas działania lokalnego połączenia oparte na tożsamościach korzystają z tożsamości deweloperskiej (takiej jak logowanie do Azure CLI) zamiast z tożsamości zarządzanej. Nie musisz ustawiać nieruchomości credential podczas clientId lokalnego rozwoju. Aby uzyskać więcej informacji, zobacz Programowanie lokalne przy użyciu połączeń opartych na tożsamościach.

Zestawy SDK klienta

Chociaż Functions oferuje powiązania ułatwiające dostęp do danych w kodzie funkcji, możesz także użyć SDK klienta w projekcie, aby bezpośrednio uzyskać dostęp do danej usługi. Możesz potrzebować bezpośrednio korzystać z klientskich SDK, jeśli twoje funkcje wymagają funkcjonalności bazowego SDK, która nie jest obsługiwana przez rozszerzenie binding. Kod funkcji nie może uzyskać dostępu do bazowych klientów używanych przez rozszerzenia wiązania. Musisz samodzielnie tworzyć i zarządzać instancjami klientów, które musisz wykorzystać w swoich funkcjach.

Weź pod uwagę te kwestie podczas tworzenia i używania SDK klienta w kodzie funkcji:

  • Stosuj ten sam proces przechowywania i dostępu do ciągów połączeń, co rozszerzenia wiązań. Aby dowiedzieć się więcej, zobacz Definiuj powiązania.

  • Gdy hostujesz aplikację w planie Konsumpcyjnym, istnieje limit na łączną liczbę połączeń wychodzących we wszystkich instancjach. Ten limit oznacza, że musisz uważać, aby uniknąć wyczerpania portu. Aby dowiedzieć się więcej, zobacz Zarządzaj połączeniami klientów SDK.

  • Gdy tworzysz instancję SDK klienta w swoich funkcjach, pobieraj informacje o połączeniu wymagane przez klienta ze zmiennych środowiska.
  • Gdy tworzysz instancję SDK klienta w swoich funkcjach, pobieraj informacje o połączeniu wymagane przez klienta ze zmiennych środowiska.
  • Gdy tworzysz instancję SDK klienta w swoich funkcjach, pobieraj informacje o połączeniu wymagane przez klienta ze zmiennych środowiska.
  • Gdy tworzysz instancję SDK klienta w swoich funkcjach, pobieraj informacje o połączeniu wymagane przez klienta ze zmiennych środowiska.
  • Gdy tworzysz instancję SDK klienta w swoich funkcjach, pobieraj informacje o połączeniu wymagane przez klienta ze zmiennych środowiska.

Raportowanie problemów

Produkt opis Łącze
Środowisko uruchomieniowe Host skryptów, wyzwalacze i powiązania, obsługa języków Plik problemu
Szablony Problemy z kodem dotyczące szablonu tworzenia Plik problemu

Repozytoria typu open source

Kod Azure Functions jest open source. Kluczowe komponenty znajdziesz w tych repozytoriach GitHub:

Aby uzyskać więcej informacji, zobacz następujące zasoby:

  • Last updated on