Tworzenie funkcji wyzwalanej czasomierzem na platformie AzureCreate a function in Azure that is triggered by a timer

Dowiedz się, jak za pomocą Azure Functions utworzyć funkcję bezserwerową , która jest uruchamiana na podstawie zdefiniowanego harmonogramu.Learn how to use Azure Functions to create a serverless function that runs based on a schedule that you define.

Wymagania wstępnePrerequisites

W celu ukończenia tego samouczka:To complete this tutorial:

  • Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.If you don't have an Azure subscription, create a free account before you begin.

Tworzenie aplikacji funkcji platformy AzureCreate an Azure Function app

  1. W menu witryny Azure Portal lub na stronie głównej wybierz pozycję Utwórz zasób.From the Azure portal menu or the Home page, select Create a resource.

  2. Na stronie Nowy wybierz pozycję obliczeniowe > aplikacja funkcji.In the New page, select Compute > Function App.

  3. Na stronie podstawowe Użyj ustawień aplikacji funkcji, zgodnie z opisem w poniższej tabeli.On the Basics page, use the function app settings as specified in the following table.

    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    SubskrypcjaSubscription Twoja subskrypcjaYour subscription Subskrypcja, w ramach której jest tworzona ta nowa aplikacja funkcji.The subscription under which this new function app is created.
    Grupa zasobówResource Group myResourceGroupmyResourceGroup Nazwa nowej grupy zasobów, w której ma zostać utworzona aplikacja funkcji.Name for the new resource group in which to create your function app.
    Nazwa aplikacji funkcjiFunction App name Nazwa unikatowa w skali globalnejGlobally unique name Nazwa identyfikująca nową aplikację funkcji.Name that identifies your new function app. Prawidłowe znaki to a-z (bez uwzględniania wielkości liter), 0-9i -.Valid characters are a-z (case insensitive), 0-9, and -.
    PublikowaniePublish KodCode Opcja publikowania plików kodu lub kontenera Docker.Option to publish code files or a Docker container.
    Stos środowiska uruchomieniowegoRuntime stack Preferowany językPreferred language Wybierz środowisko uruchomieniowe, które obsługuje ulubiony język programowania funkcji.Choose a runtime that supports your favorite function programming language. Wybierz pozycję .NET Core dla języków C# i F #.Choose .NET Core for C# and F# functions.
    WersjaVersion Numer wersjiVersion number Wybierz wersję zainstalowanego środowiska uruchomieniowego.Choose the version of your installed runtime.
    RegionRegion Preferowany regionPreferred region Wybierz region znajdujący się w sąsiedztwie lub w najbliższej usłudze dostęp do funkcji.Choose a region near you or near other services your functions access.

    Podstawy

  4. Wybierz pozycję Dalej: hosting.Select Next : Hosting. Na stronie hosting wprowadź następujące ustawienia.On the Hosting page, enter the following settings.

    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    Konto magazynuStorage account Nazwa unikatowa w skali globalnejGlobally unique name Utwórz konto magazynu używane przez aplikację funkcji.Create a storage account used by your function app. Nazwy kont magazynu muszą mieć długość od 3 do 24 znaków i mogą zawierać tylko cyfry i małe litery.Storage account names must be between 3 and 24 characters in length and can contain numbers and lowercase letters only. Możesz również użyć istniejącego konta, które musi spełniać wymagania dotyczące konta magazynu.You can also use an existing account, which must meet the storage account requirements.
    System operacyjnyOperating system Preferowany system operacyjnyPreferred operating system System operacyjny jest wstępnie wybrany na podstawie wybranego stosu środowiska uruchomieniowego, ale w razie potrzeby można zmienić to ustawienie.An operating system is pre-selected for you based on your runtime stack selection, but you can change the setting if necessary.
    PlanowaniePlan Zużycie (bezserwerowe)Consumption (Serverless) Plan hostingu określający sposób przydzielania zasobów do aplikacji funkcji.Hosting plan that defines how resources are allocated to your function app. W domyślnym planie Zużycie zasoby są dodawane dynamicznie zgodnie z wymaganiami funkcji.In the default Consumption plan, resources are added dynamically as required by your functions. W tym przypadku hostingu bezserwerowego płacisz tylko za czas wykonywania funkcji.In this serverless hosting, you pay only for the time your functions run. W przypadku uruchomienia w ramach planu usługi App Service musisz zarządzać skalowaniem aplikacji funkcji.When you run in an App Service plan, you must manage the scaling of your function app.

    Hosting

  5. Wybierz kolejno pozycje Dalej: monitorowanie.Select Next : Monitoring. Na stronie monitorowanie wprowadź następujące ustawienia.On the Monitoring page, enter the following settings.

    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    Application InsightsApplication Insights DomyślneDefault Tworzy zasób Application Insights o tej samej nazwie aplikacji w najbliższym obsługiwanym regionie.Creates an Application Insights resource of the same App name in the nearest supported region. Rozszerzając to ustawienie lub wybierając pozycję Utwórz nowe, możesz zmienić nazwę Application Insights lub wybrać inny region w obszarze geograficznym platformy Azure , w którym chcesz przechowywać dane.By expanding this setting or selecting Create new, you can change the Application Insights name or choose a different region in an Azure geography where you want to store your data.

    Monitorowanie

  6. Wybierz pozycję Przegląd + Utwórz , aby przejrzeć wybrane opcje konfiguracji aplikacji.Select Review + create to review the app configuration selections.

  7. Na stronie Recenzja i tworzenie przejrzyj ustawienia, a następnie wybierz pozycję Utwórz , aby udostępnić i wdrożyć aplikację funkcji.On the Review + create page, review your settings, and then select Create to provision and deploy the function app.

  8. Wybierz ikonę powiadomienia w prawym górnym rogu portalu i obejrzyj komunikat wdrażanie zakończyło się pomyślnie .Select the Notifications icon in the upper-right corner of the portal and watch for the Deployment succeeded message.

  9. Wybierz pozycję Przejdź do zasobu, aby wyświetlić nową aplikację funkcji.Select Go to resource to view your new function app. Możesz również wybrać pozycję Przypnij do pulpitu nawigacyjnego.You can also select Pin to dashboard. Przypinanie ułatwia powrót do tego zasobu aplikacji funkcji z pulpitu nawigacyjnego.Pinning makes it easier to return to this function app resource from your dashboard.

    Powiadomienie dotyczące wdrożenia

Twoja nowa aplikacja funkcji jest gotowa do użycia.Your new function app is ready to use. Następnie utworzysz funkcję w nowej aplikacji funkcji.Next, you'll create a function in the new function app.

Pomyślnie utworzona aplikacja funkcji.

Tworzenie funkcji wyzwalanej czasomierzemCreate a timer triggered function

  1. W aplikacji funkcji wybierz pozycję funkcje, a następnie wybierz pozycję + Dodaj .In your function app, select Functions, and then select + Add

    Pomyślnie utworzona aplikacja funkcji.

  2. Wybierz szablon wyzwalacza czasomierza .Select the Timer trigger template.

    Pomyślnie utworzona aplikacja funkcji.

  3. Skonfiguruj nowy wyzwalacz przy użyciu ustawień określonych w tabeli poniżej obrazu, a następnie wybierz pozycję Utwórz funkcję.Configure the new trigger with the settings as specified in the table below the image, and then select Create Function.

    Pomyślnie utworzona aplikacja funkcji.

    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    NazwaName DomyślneDefault Określa nazwę funkcji wyzwalanej czasomierzem.Defines the name of your timer triggered function.
    ZaplanujSchedule 0 * /1 * * **0 */1 * * * * Składające się z 6 pól wyrażenie CRON planujące uruchamianie funkcji co minutę.A six field CRON expression that schedules your function to run every minute.

Testowanie funkcjiTest the function

  1. W funkcji wybierz pozycję Code + test i rozwiń dzienniki.In your function, select Code + Test and expand the logs.

    Pomyślnie utworzona aplikacja funkcji.

  2. Sprawdź wykonywanie, wyświetlając informacje zapisane w dziennikach.Verify execution by viewing the information written to the logs.

    Pomyślnie utworzona aplikacja funkcji.

Teraz możesz zmienić harmonogram funkcji tak, aby była uruchamiana co godzinę, a nie co minutę.Now, you change the function's schedule so that it runs once every hour instead of every minute.

Aktualizowanie harmonogramu czasomierzaUpdate the timer schedule

  1. W funkcji wybierz pozycję integracja.In your function, select Integration. Tutaj definiujesz powiązania danych wejściowych i wyjściowych dla funkcji, a także ustawisz harmonogram.Here, you define input and output bindings for your function and also set the schedule.

  2. Wybierz czasomierz (Timer).Select Timer (myTimer).

    Pomyślnie utworzona aplikacja funkcji.

  3. Zaktualizuj wartość harmonogramu do 0 0 */1 * * * , a następnie wybierz pozycję Zapisz.Update the Schedule value to 0 0 */1 * * *, and then select Save.

    Pomyślnie utworzona aplikacja funkcji.

Teraz masz funkcję, która jest uruchamiana co godzinę, w ciągu godziny.You now have a function that runs once every hour, on the hour.

Czyszczenie zasobówClean up resources

Inne przewodniki Szybki start w tej kolekcji bazują na tym przewodniku.Other quickstarts in this collection build upon this quickstart. Jeśli planujesz współpracować z kolejnymi przewodnikami Szybki Start, samouczkami lub z dowolnymi usługami utworzonymi w ramach tego przewodnika Szybki Start, nie czyść zasobów.If you plan to work with subsequent quickstarts, tutorials, or with any of the services you have created in this quickstart, do not clean up the resources.

Zasoby na platformie Azure dotyczą aplikacji funkcji, funkcji, kont magazynu i tak dalej.Resources in Azure refer to function apps, functions, storage accounts, and so forth. Są one pogrupowane w grupy zasobów, a wszystkie elementy w grupie można usunąć, usuwając grupę.They're grouped into resource groups, and you can delete everything in a group by deleting the group.

Aby ukończyć te przewodniki Szybki start, zostały utworzone zasoby.You created resources to complete these quickstarts. Za te zasoby może zostać naliczona opłata — zależy to od Twojego stanu konta i cennika usług.You may be billed for these resources, depending on your account status and service pricing. Jeśli nie potrzebujesz już tych zasobów, oto jak możesz je usunąć:If you don't need the resources anymore, here's how to delete them:

  1. W witrynie Azure Portal przejdź do strony Grupa zasobów.In the Azure portal, go to the Resource group page.

    Aby uzyskać dostęp do tej strony na stronie aplikacji funkcji, wybierz kartę Omówienie, a następnie wybierz link w obszarze Grupa zasobów.To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

    Wybierz grupę zasobów do usunięcia ze strony aplikacji funkcji.

    Aby uzyskać dostęp do tej strony z poziomu pulpitu nawigacyjnego, wybierz pozycję Grupy zasobów, a następnie wybierz grupę zasobów, która została użyta na potrzeby tego przewodnika Szybki start.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this quickstart.

  2. Na stronie Grupa zasobów zapoznaj się z listą uwzględnionych zasobów i sprawdź, czy są one tymi, które chcesz usunąć.In the Resource group page, review the list of included resources, and verify that they're the ones you want to delete.

  3. Wybierz pozycję Usuń grupę zasobów, a następnie postępuj zgodnie z instrukcjami.Select Delete resource group, and follow the instructions.

    Usuwanie może potrwać kilka minut.Deletion may take a couple of minutes. Po jego zakończeniu przez kilka sekund będzie widoczne powiadomienie.When it's done, a notification appears for a few seconds. Możesz również wybrać ikonę dzwonka w górnej części strony, aby wyświetlić powiadomienie.You can also select the bell icon at the top of the page to view the notification.

Następne krokiNext steps

Utworzono funkcję, która jest uruchamiana na podstawie harmonogramu.You've created a function that runs based on a schedule. Aby uzyskać więcej informacji na temat wyzwalaczy czasomierza, zobacz Planowanie wykonywania kodu za pomocą usługi Azure Functions.For more information about timer triggers, see Schedule code execution with Azure Functions.

Teraz, po utworzeniu pierwszej funkcji, dodajmy powiązanie danych wyjściowych do funkcji, która zapisuje komunikat w kolejce magazynu.Now that you've created your first function, let's add an output binding to the function that writes a message to a Storage queue.