Udostępnij za pośrednictwem


Tworzenie funkcji na platformie Azure wyzwalanej przez usługę Blob Storage

Dowiedz się, jak utworzyć funkcję wyzwalaną po przekazaniu lub zaktualizowaniu plików w kontenerze usługi Blob Storage.

Uwaga

Edytowanie w portalu jest obsługiwane tylko w przypadku funkcji JavaScript, PowerShell i C# Script. Edytowanie w portalu języka Python jest obsługiwane tylko w przypadku uruchamiania w planie Zużycie. Aby utworzyć aplikację skryptu języka C#, która obsługuje edycję w portalu, musisz wybrać wersję środowiska uruchomieniowego, która obsługuje model w procesie.

Jeśli to możliwe, należy opracowywać funkcje lokalnie.

Aby dowiedzieć się więcej na temat ograniczeń dotyczących edytowania kodu funkcji w witrynie Azure Portal, zobacz Ograniczenia programistyczne w witrynie Azure Portal.

Wymagania wstępne

Tworzenie aplikacji funkcji platformy Azure

  1. W menu witryny Azure Portal lub na stronie głównej wybierz pozycję Utwórz zasób.

  2. Na stronie Nowy wybierz pozycję Aplikacja funkcji obliczeniowej>.

  3. W obszarze Wybierz opcję hostingu wybierz pozycję Zużycie>Wybierz, aby utworzyć aplikację w domyślnym planie Zużycie. W tej opcji hostingu bezserwerowego płacisz tylko za czas działania funkcji. Plan Premium oferuje również dynamiczne skalowanie. W przypadku uruchomienia w ramach planu usługi App Service musisz zarządzać skalowaniem aplikacji funkcji.

  4. Na stronie Podstawowe użyj ustawień aplikacji funkcji, jak określono w poniższej tabeli:

    Ustawienie Sugerowana wartość opis
    Subskrypcja Twoja subskrypcja Subskrypcja, w ramach której tworzysz nową aplikację funkcji.
    Grupa zasobów myResourceGroup Nazwa nowej grupy zasobów, w której tworzysz aplikację funkcji. Należy utworzyć nową grupę zasobów, ponieważ istnieją znane ograniczenia podczas tworzenia nowych aplikacji funkcji w istniejącej grupie zasobów.
    Nazwa aplikacji funkcji Nazwa unikatowa w skali globalnej Nazwa identyfikująca nową aplikację funkcji. Prawidłowe znaki to a-z (bez uwzględniania wielkości liter), 0-9i -.
    Stos środowiska uruchomieniowego Preferowany język Wybierz środowisko uruchomieniowe, które obsługuje ulubiony język programowania funkcji. Edytowanie w portalu jest dostępne tylko dla skryptów JavaScript, PowerShell, Python, TypeScript i C#.
    Aby utworzyć aplikację skryptu języka C#, która obsługuje edycję w portalu, musisz wybrać wersję środowiska uruchomieniowego, która obsługuje model w procesie.
    Biblioteka klas języka C# i funkcje języka Java muszą być opracowywane lokalnie.
    Wersja Numer wersji Wybierz wersję zainstalowanego środowiska uruchomieniowego.
    Region Preferowany region Wybierz region, który znajduje się blisko Ciebie lub w pobliżu innych usług, do których mogą uzyskiwać dostęp funkcje.
    System operacyjny Windows System operacyjny jest wstępnie wybierany na podstawie wyboru stosu środowiska uruchomieniowego, ale w razie potrzeby możesz zmienić ustawienie. Edytowanie w portalu jest obsługiwane tylko w systemie Windows.
  5. Zaakceptuj opcje domyślne na pozostałych kartach, w tym domyślne zachowanie tworzenia nowego konta magazynu na karcie Magazyn i nowe wystąpienie usługi Application Insights na karcie Monitorowanie . Możesz również użyć istniejącego konta magazynu lub wystąpienia usługi Application Insights.

  6. Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybraną konfigurację aplikacji, a następnie wybierz pozycję Utwórz , aby aprowizować i wdrożyć aplikację funkcji.

  7. Wybierz ikonę Powiadomienia w prawym górnym rogu portalu i poszukaj komunikatu Wdrożenie zakończyło się pomyślnie .

  8. Wybierz pozycję Przejdź do zasobu, aby wyświetlić swoją nową aplikację funkcji. Możesz również wybrać pozycję Przypnij do pulpitu nawigacyjnego. Przypinanie ułatwia powrót do tego zasobu aplikacji funkcji z poziomu pulpitu nawigacyjnego.

    Zrzut ekranu przedstawiający powiadomienie o wdrożeniu.

Pomyślnie utworzono nową aplikację funkcji.

Pomyślnie utworzona aplikacja funkcji.

Następnie należy utworzyć funkcję w nowej aplikacji funkcji.

Tworzenie funkcji wyzwalanej przez usługę Azure Blob Storage

  1. W aplikacji funkcji wybierz pozycję Przegląd, a następnie wybierz pozycję + Utwórz w obszarze Funkcje.

  2. W obszarze Wybierz szablon przewiń w dół i wybierz szablon wyzwalacza usługi Azure Blob Storage.

  3. W obszarze Szczegóły szablonu skonfiguruj nowy wyzwalacz przy użyciu ustawień określonych w tej tabeli, a następnie wybierz pozycję Utwórz:

    Ustawienie Sugerowana wartość opis
    Nowa funkcja Unikatowa w obrębie aplikacji funkcji Nazwa funkcji wyzwalanej przez obiekt blob.
    Ścieżka samples-workitems/{nazwa} Lokalizacja w monitorowanym magazynie obiektów Blob. Nazwa pliku obiektu Blob jest przekazywana w powiązaniu jako parametr nazwa.
    Połączenie konta magazynu AzureWebJobsStorage Możesz skorzystać z połączenia konta magazynu już używanego przez aplikację funkcji lub utworzyć nowe.

    Platforma Azure tworzy funkcję wyzwalaną przez usługę Blob Storage na podstawie podanych wartości.

Następnie utwórz kontener samples-workitems .

Tworzenie kontenera

  1. W funkcji na stronie Przegląd wybierz grupę zasobów.

    Wybierz grupę zasobów witryny Azure Portal.

  2. Znajdź i wybierz konto magazynu grupy zasobów.

    Uzyskaj dostęp do konta magazynu.

  3. Wybierz pozycję Kontenery, a następnie wybierz pozycję + Kontener.

    Dodaj kontener do konta magazynu w witrynie Azure Portal.

  4. W polu Nazwa wpisz samples-workitems, a następnie wybierz pozycję Utwórz.

    Nadaj kontenerowi magazynu nazwę.

Teraz, gdy masz już kontener obiektów Blob, możesz przetestować funkcję, przekazując plik do kontenera.

Testowanie funkcji

  1. Wróć do witryny Azure Portal, przejdź do swoich funkcji, rozwiń pozycję Dzienniki w dolnej części strony i upewnij się, że strumieniowe przesyłanie dzienników nie jest wstrzymane.

    Rozwiń dziennik w witrynie Azure Portal.

  2. W osobnym oknie przeglądarki przejdź do grupy zasobów w witrynie Azure Portal i wybierz konto magazynu.

  3. Wybierz pozycję Kontenery, a następnie wybierz kontener samples-workitems .

    Przejdź do kontenera samples-workitems w witrynie Azure Portal.

  4. Wybierz pozycję Przekaż, a następnie wybierz ikonę folderu, aby wybrać plik do przekazania.

    Przekazywanie pliku do kontenera obiektów Blob.

  5. Przejdź do pliku na komputerze lokalnym, takiego jak plik obrazu, wybierz plik. Wybierz pozycję Otwórz , a następnie pozycję Przekaż.

  6. Wróć do dzienników funkcji i sprawdź, czy obiekt Blob został odczytany.

    Wyświetlanie komunikatu w dziennikach.

    Uwaga

    Gdy aplikacja funkcji zostanie uruchomiona w domyślnym planie Zużycie, może wystąpić nawet kilkuminutowe opóźnienie między dodaniem lub zaktualizowaniem obiektu Blob a wyzwoleniem funkcji. Jeśli zależy Ci na małych opóźnieniach w funkcjach wyzwalanych przez obiekty Blob, rozważ uruchomienie aplikacji funkcji w planie usługi App Service.

Czyszczenie zasobów

Inne przewodniki Szybki start w tej kolekcji bazują na tym przewodniku. Jeśli planujesz pracę z kolejnymi przewodnikami Szybki start, samouczkami lub z dowolną usługą utworzoną w tym przewodniku Szybki start, nie usuwaj zasobów.

Zasoby na platformie Azure dotyczą aplikacji funkcji, funkcji, kont magazynu i tak dalej. Są one grupowane w grupy zasobów i można usunąć wszystkie elementy w grupie, usuwając grupę.

Utworzono zasoby, aby ukończyć te przewodniki Szybki start. Opłaty za te zasoby mogą być naliczane w zależności od stanu konta i cen usług. Jeśli nie potrzebujesz już tych zasobów, oto jak możesz je usunąć:

  1. W witrynie Azure Portal przejdź do strony Grupa zasobów.

    Aby przejść do tej strony ze strony aplikacji funkcji, wybierz kartę Przegląd , a następnie wybierz link w obszarze Grupa zasobów.

    Zrzut ekranu przedstawiający wybieranie grupy zasobów do usunięcia ze strony aplikacji funkcji.

    Aby uzyskać dostęp do tej strony z pulpitu nawigacyjnego, wybierz pozycję Grupy zasobów, a następnie wybierz grupę zasobów użytą w tym artykule.

  2. Na stronie Grupa zasobów przejrzyj listę uwzględnionych zasobów i sprawdź, czy są to te, które chcesz usunąć.

  3. Wybierz pozycję Usuń grupę zasobów i postępuj zgodnie z instrukcjami.

    Usunięcie może potrwać kilka minut. Po jego zakończeniu przez kilka sekund będzie widoczne powiadomienie. Możesz również wybrać ikonę dzwonka w górnej części strony, aby wyświetlić powiadomienie.

Następne kroki

Utworzono funkcję, która jest uruchamiana w momencie dodania obiektu Blob do magazynu obiektów Blob lub zaktualizowania obiektu Blob w magazynie. Aby uzyskać więcej informacji na temat wyzwalaczy magazynu obiektów Blob, zobacz Powiązania magazynu obiektów Blob w usłudze Azure Functions.

Po utworzeniu pierwszej funkcji dodajmy powiązanie wyjściowe do funkcji, która zapisuje komunikat w kolejce usługi Storage.