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.

Wymagania wstępne

  • Subskrypcja platformy Azure. Jeśli nie masz subskrypcji, przed rozpoczęciem utwórz bezpłatne konto.

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 funkcjiobliczeniowej>.

  3. Na stronie Podstawy użyj ustawień aplikacji funkcji określonych w poniższej tabeli:

    Ustawienie Sugerowana wartość Opis
    Subskrypcja Twoja subskrypcja Subskrypcja, w ramach której utworzysz nową aplikację funkcji.
    Grupa zasobów myResourceGroup Nazwa nowej grupy zasobów, w której utworzysz aplikację funkcji.
    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 -.
    Publikowanie Kod Opcja publikowania plików kodu lub kontenera Docker.
    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, TypeScript i C#. Biblioteki klas języka C#, języka Java i języka Python 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.
  4. Wybierz pozycję Dalej: Hosting. Na stronie Hosting wprowadź następujące ustawienia:

    Ustawienie Sugerowana wartość Opis
    Konto magazynu Nazwa unikatowa w skali globalnej Utwórz konto magazynu używane przez aplikację funkcji. Storage nazwy kont muszą mieć długość od 3 do 24 znaków i mogą zawierać tylko cyfry i małe litery. Możesz również użyć istniejącego konta, które musi spełniać wymagania dotyczące konta magazynu.
    System operacyjny Windows System operacyjny jest wstępnie wybrany na podstawie wyboru stosu środowiska uruchomieniowego, ale w razie potrzeby można zmienić to ustawienie. Edytowanie w portalu jest obsługiwane tylko w Windows.
    Planowanie Zużycie (bezserwerowe) Plan hostingu określający sposób przydzielania zasobów do aplikacji funkcji. W domyślnym planie Zużycie zasoby są dodawane dynamicznie zgodnie z wymaganiami funkcji. W tym hostingu bezserwerowym płacisz tylko za czas działania funkcji. W przypadku uruchomienia w ramach planu usługi App Service musisz zarządzać skalowaniem aplikacji funkcji.
  5. Wybierz pozycję Dalej: Monitorowanie. Na stronie Monitorowanie wprowadź następujące ustawienia:

    Ustawienie Sugerowana wartość Opis
    Application Insights Domyślny Tworzy zasób aplikacji Szczegółowe informacje tej samej nazwy aplikacji w najbliższym obsługiwanym regionie. Rozwijając to ustawienie lub wybierając pozycję Utwórz nową, możesz zmienić nazwę Szczegółowe informacje aplikacji lub wybrać inny region w lokalizacji geograficznej platformy Azure, w której chcesz przechowywać dane.
  6. Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybrane opcje konfiguracji aplikacji.

  7. Na stronie Przeglądanie + tworzenie przejrzyj ustawienia, a następnie wybierz pozycję Utwórz , aby aprowizować i wdrożyć aplikację funkcji.

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

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

    Screenshot of deployment notification.

Nowa aplikacja funkcji została pomyślnie utworzona.

Function app successfully created.

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

Tworzenie funkcji wyzwalanej przez usługę Azure Blob Storage

  1. Wybierz pozycję Funkcje, a następnie wybierz pozycję + Dodaj , aby dodać nową funkcję.

    Choose a Function template in the Azure portal.

  2. Wybierz szablon wyzwalacza Azure Blob Storage.

  3. Użyj ustawień w sposób określony w tabeli znajdującej się poniżej obrazu.

    Name and configure the Blob storage triggered function.

    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.
  4. Wybierz pozycję Utwórz funkcję , aby utworzyć funkcję.

    Create the Blob storage triggered function.

Następnie utwórz kontener samples-workitems .

Tworzenie kontenera

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

    Select your Azure portal resource group.

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

    Access the storage account.

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

    Add container to your storage account in the Azure portal.

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

    Name the storage container.

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.

    Expand the log in the Azure portal.

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

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

    Go to your samples-workitems container in the Azure portal.

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

    Upload a file to the blob container.

  5. Przejdź do pliku na komputerze lokalnym, na przykład pliku 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.

    View message in the logs.

    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 dowolnymi usługami utworzonymi w tym przewodniku Szybki start, nie usuwaj zasobów.

Zasoby na platformie Azure dotyczą aplikacji funkcji, funkcji, kont magazynu i tak dalej. Są one pogrupowane w grupy zasobów i można usunąć wszystko 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.

    Screenshot that shows select the resource group to delete from the function app page.

    Aby przejść 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 Storage.