Háttérben futó feladatok futtatása webjobs-feladatokkal Azure App ServiceRun background tasks with WebJobs in Azure App Service

Ez a cikk bemutatja, hogyan telepíthet webjobs-feladatokat a Azure Portal használatával egy végrehajtható fájl vagy parancsfájl feltöltéséhez.This article shows how to deploy WebJobs by using the Azure portal to upload an executable or script. További információ a webjobs-feladatok a Visual Studióval való fejlesztéséről és üzembe helyezéséről: Webjobs-feladatok üzembe helyezése a Visual Studióval.For information about how to develop and deploy WebJobs by using Visual Studio, see Deploy WebJobs using Visual Studio.

ÁttekintésOverview

A webjobs olyan Azure app Service szolgáltatása, amely lehetővé teszi, hogy egy programot vagy parancsfájlt egy webalkalmazás, egy API-alkalmazás vagy egy Mobile App használatával azonos környezetben futtasson.WebJobs is a feature of Azure App Service that enables you to run a program or script in the same context as a web app, API app, or mobile app. A webjobs használata nem jár további díjszabással.There is no additional cost to use WebJobs.

Fontos

A webjobs-feladatok még nem támogatottak a Linux rendszeren való App Service.WebJobs is not yet supported for App Service on Linux.

A Azure WebJobs SDK a webjobs használatával számos programozási feladatot egyszerűsítheti.The Azure WebJobs SDK can be used with WebJobs to simplify many programming tasks. További információ: Mi a Webjobs SDK.For more information, see What is the WebJobs SDK.

A Azure Functions egy másik módszert biztosít a programok és parancsfájlok futtatásához.Azure Functions provides another way to run programs and scripts. A webjobs és a functions közötti összehasonlításért lásd: választás a flow, a Logic apps, a functions és a webjobs között.For a comparison between WebJobs and Functions, see Choose between Flow, Logic Apps, Functions, and WebJobs.

Webjobs-típusokWebJob types

Az alábbi táblázat a folyamatos és az aktivált webjobs közötti különbségeket ismerteti.The following table describes the differences between continuous and triggered WebJobs.

FolyamatosContinuous KiváltottTriggered
Azonnal elindul a Webjobs létrehozásakor.Starts immediately when the WebJob is created. A feladatok befejezésének megtartásához a program vagy a szkript általában egy végtelen hurokon belül végzi a munkáját.To keep the job from ending, the program or script typically does its work inside an endless loop. Ha a feladattípus véget ért, újraindíthatja.If the job does end, you can restart it. Csak akkor indul el, ha manuálisan vagy ütemezetten indítja el.Starts only when triggered manually or on a schedule.
Minden olyan példányon fut, amelyen a webalkalmazás fut.Runs on all instances that the web app runs on. Lehetősége van arra is, hogy a Webjobs egyetlen példányra korlátozza.You can optionally restrict the WebJob to a single instance. Egyetlen példányban fut, amelyet az Azure kiválaszt a terheléselosztáshoz.Runs on a single instance that Azure selects for load balancing.
Támogatja a távoli hibakeresést.Supports remote debugging. Nem támogatja a távoli hibakeresést.Doesn't support remote debugging.

Megjegyzés

A webalkalmazások 20 perc inaktivitás után időtúllépést okozhatnak.A web app can time out after 20 minutes of inactivity. Csak a tényleges webalkalmazásnak küldött kérések állítják vissza az időzítőt.Only requests to the actual web app reset the timer. Ha megtekinti az alkalmazás konfigurációját a Azure Portalban, vagy kéréseket tesz ahttps://<app_name>.scm.azurewebsites.netspeciális eszközök helyének (), ne állítsa alaphelyzetbe az időzítőt.Viewing the app's configuration in the Azure portal or making requests to the advanced tools site (https://<app_name>.scm.azurewebsites.net) don't reset the timer. Ha az alkalmazás folyamatos vagy ütemezett (időzítő trigger) webjobs-feladatokat futtat, engedélyezze a mindig be lehetőséget a webjobs megbízható működésének biztosításához.If your app runs continuous or scheduled (Timer trigger) WebJobs, enable Always On to ensure that the WebJobs run reliably. Ez a funkció csak az alapszintű, a standard és a prémium szintű díjszabásbanérhető el.This feature is available only in the Basic, Standard, and Premium pricing tiers.

Támogatott fájltípusok parancsfájlokhoz vagy programokhozSupported file types for scripts or programs

A következő fájltípusok támogatottak:The following file types are supported:

  • . cmd,. bat,. exe (a Windows cmd használatával).cmd, .bat, .exe (using Windows cmd)
  • . ps1 (a PowerShell használatával).ps1 (using PowerShell)
  • . sh (bash használatával).sh (using Bash)
  • . php (PHP használatával).php (using PHP)
  • . a (Python használatával).py (using Python)
  • . js (a Node. js használatával).js (using Node.js)
  • . jar (Java használatával).jar (using Java)

Folyamatos Webjobs létrehozásaCreate a continuous WebJob

  1. A Azure Portalnyissa meg a app Service webalkalmazás, az API-alkalmazás vagy a mobile app app Service lapját.In the Azure portal, go to the App Service page of your App Service web app, API app, or mobile app.

  2. Válassza a Webjobselemet.Select WebJobs.

    Webjobs-feladatok kiválasztása

  3. A webjobs lapon válassza a Hozzáadáslehetőséget.In the WebJobs page, select Add.

    Webjobs lap

  4. Használja a táblázatban megadott Webjobs-beállítások hozzáadása beállítást.Use the Add WebJob settings as specified in the table.

    Webjobs hozzáadása lap

    BeállításSetting MintaértékSample value LeírásDescription  
    Name (Név)Name myContinuousWebJobmyContinuousWebJob Egy App Service alkalmazáson belül egyedi név.A name that is unique within an App Service app. Betűvel vagy számmal kell kezdődnie, és nem tartalmazhat olyan speciális karaktereket, mint a "-" és a "".Must start with a letter or a number and cannot contain special characters other than "-" and "".
    FájlfeltöltésFile Upload ConsoleApp. zipConsoleApp.zip A végrehajtható fájlt vagy parancsfájlt tartalmazó . zip fájl, valamint a program vagy a parancsfájl futtatásához szükséges összes támogató fájl.A .zip file that contains your executable or script file as well as any supporting files needed to run the program or script. A támogatott végrehajtható fájlok vagy parancsfájl-típusok a támogatott fájltípusok szakaszban vannak felsorolva.The supported executable or script file types are listed in the Supported file types section.
    TípusType FolyamatosContinuous A webjobs-típusok leírását a cikk korábbi részében találja.The WebJob types are described earlier in this article.
    MéretezésScale Több példányMulti instance Csak a folyamatos webjobs-feladatok esetében érhető el.Available only for Continuous WebJobs. Meghatározza, hogy a program vagy a parancsfájl az összes példányon vagy csak egy példányon fusson-e.Determines whether the program or script runs on all instances or just one instance. A több példányon való futtatás lehetősége nem vonatkozik az ingyenes vagy a közös díjszabási szintekre.The option to run on multiple instances doesn't apply to the Free or Shared pricing tiers.
  5. Kattintson az OK gombra.Click OK.

    Az új Webjobs megjelenik a webjobs oldalon.The new WebJob appears on the WebJobs page.

    Webjobs-feladatok listája

  6. Folyamatos Webjobs leállításához vagy újraindításához kattintson a jobb gombbal a Webjobs a listában, majd kattintson a Leállítás vagy az Indításparancsra.To stop or restart a continuous WebJob, right-click the WebJob in the list and click Stop or Start.

    Folyamatos Webjobs leállítása

Manuálisan aktivált Webjobs létrehozásaCreate a manually triggered WebJob

  1. A Azure Portalnyissa meg a app Service webalkalmazás, az API-alkalmazás vagy a mobile app app Service lapját.In the Azure portal, go to the App Service page of your App Service web app, API app, or mobile app.

  2. Válassza a Webjobselemet.Select WebJobs.

    Webjobs-feladatok kiválasztása

  3. A webjobs lapon válassza a Hozzáadáslehetőséget.In the WebJobs page, select Add.

    Webjobs lap

  4. Használja a táblázatban megadott Webjobs-beállítások hozzáadása beállítást.Use the Add WebJob settings as specified in the table.

    Webjobs hozzáadása lap

    BeállításSetting MintaértékSample value LeírásDescription  
    Name (Név)Name myTriggeredWebJobmyTriggeredWebJob Egy App Service alkalmazáson belül egyedi név.A name that is unique within an App Service app. Betűvel vagy számmal kell kezdődnie, és nem tartalmazhat olyan speciális karaktereket, mint a "-" és a "".Must start with a letter or a number and cannot contain special characters other than "-" and "".
    FájlfeltöltésFile Upload ConsoleApp. zipConsoleApp.zip A végrehajtható fájlt vagy parancsfájlt tartalmazó . zip fájl, valamint a program vagy a parancsfájl futtatásához szükséges összes támogató fájl.A .zip file that contains your executable or script file as well as any supporting files needed to run the program or script. A támogatott végrehajtható fájlok vagy parancsfájl-típusok a támogatott fájltípusok szakaszban vannak felsorolva.The supported executable or script file types are listed in the Supported file types section.
    TípusType KiváltottTriggered A webjobs-típusok leírását a cikk korábbi részében találja.The WebJob types are described earlier in this article.
    EseményindítókTriggers KéziManual
  5. Kattintson az OK gombra.Click OK.

    Az új Webjobs megjelenik a webjobs oldalon.The new WebJob appears on the WebJobs page.

    Webjobs-feladatok listája

  6. A Webjobs futtatásához kattintson a jobb gombbal a nevére a listában, majd kattintson a Futtatásparancsra.To run the WebJob, right-click its name in the list and click Run.

    Webjobs futtatása

Ütemezett Webjobs létrehozásaCreate a scheduled WebJob

  1. A Azure Portalnyissa meg a app Service webalkalmazás, az API-alkalmazás vagy a mobile app app Service lapját.In the Azure portal, go to the App Service page of your App Service web app, API app, or mobile app.

  2. Válassza a Webjobselemet.Select WebJobs.

    Webjobs-feladatok kiválasztása

  3. A webjobs lapon válassza a Hozzáadáslehetőséget.In the WebJobs page, select Add.

    Webjobs lap

  4. Használja a táblázatban megadott Webjobs-beállítások hozzáadása beállítást.Use the Add WebJob settings as specified in the table.

    Webjobs hozzáadása lap

    BeállításSetting MintaértékSample value LeírásDescription  
    Name (Név)Name myScheduledWebJobmyScheduledWebJob Egy App Service alkalmazáson belül egyedi név.A name that is unique within an App Service app. Betűvel vagy számmal kell kezdődnie, és nem tartalmazhat olyan speciális karaktereket, mint a "-" és a "".Must start with a letter or a number and cannot contain special characters other than "-" and "".
    FájlfeltöltésFile Upload ConsoleApp. zipConsoleApp.zip A végrehajtható fájlt vagy parancsfájlt tartalmazó . zip fájl, valamint a program vagy a parancsfájl futtatásához szükséges összes támogató fájl.A .zip file that contains your executable or script file as well as any supporting files needed to run the program or script. A támogatott végrehajtható fájlok vagy parancsfájl-típusok a támogatott fájltípusok szakaszban vannak felsorolva.The supported executable or script file types are listed in the Supported file types section.
    TípusType KiváltottTriggered A webjobs-típusok leírását a cikk korábbi részében találja.The WebJob types are described earlier in this article.
    EseményindítókTriggers ÜtemezettScheduled Ahhoz, hogy az ütemezés megbízhatóan működjön, engedélyezze az Always On funkciót.For the scheduling to work reliably, enable the Always On feature. Az Always on csak az alapszintű, a standard és a prémium szintű díjszabásban érhető el.Always On is available only in the Basic, Standard, and Premium pricing tiers.
    CRON kifejezésCRON Expression 0 0/20 * * * *0 0/20 * * * * A cron-kifejezéseket a következő szakasz ismerteti.CRON expressions are described in the following section.
  5. Kattintson az OK gombra.Click OK.

    Az új Webjobs megjelenik a webjobs oldalon.The new WebJob appears on the WebJobs page.

    Webjobs-feladatok listája

NCRONTAB kifejezésekNCRONTAB expressions

Megadhat egy NCRONTAB kifejezést a portálon, vagy belefoglalhat egy settings.job fájlt a webjobs . zip fájl gyökerébe, ahogy az alábbi példában is látható:You can enter a NCRONTAB expression in the portal or include a settings.job file at the root of your WebJob .zip file, as in the following example:

{
    "schedule": "0 */15 * * * *"
}

További információ: aktivált Webjobs ütemezése.To learn more, see Scheduling a triggered WebJob.

Megjegyzés

A CRON-kifejezések futtatásához használt alapértelmezett időzóna az egyezményes világidő (UTC) szerint van megadva.The default time zone used to run CRON expressions is Coordinated Universal Time (UTC). Ha azt szeretné, hogy a CRON-kifejezés egy másik időzóna alapján fusson, hozzon létre egy WEBSITE_TIME_ZONE nevű Function alkalmazás-beállítást.To have your CRON expression run based on another time zone, create an app setting for your function app named WEBSITE_TIME_ZONE. További információ: NCRONTAB Time Zones.To learn more, see NCRONTAB time zones.

A feladatok előzményeinek megtekintéseView the job history

  1. Válassza ki azt a Webjobs, amelyben meg szeretné jeleníteni az előzményeket, majd kattintson a naplók gombra.Select the WebJob you want to see history for, and then select the Logs button.

    Naplók gomb

  2. A Webjobs részletei lapon válasszon ki egy időpontot egy Futtatás részleteinek megtekintéséhez.In the WebJob Details page, select a time to see details for one run.

    Webjobs részletei

  3. A webjobs-Futtatás részletei lapon a kimenet váltása elemre kattintva jelenítse meg a napló tartalmának szövegét.In the WebJob Run Details page, select Toggle Output to see the text of the log contents.

    Webes feladatok futtatásának részletei

    Ha egy különálló böngészőablakban szeretné megtekinteni a kimeneti szöveget, válassza a Letöltéslehetőséget.To see the output text in a separate browser window, select download. A szöveg letöltéséhez kattintson a jobb gombbal a Letöltés elemre, és használja a böngésző beállításait a fájl tartalmának mentéséhez.To download the text itself, right-click download and use your browser options to save the file contents.

  4. Válassza ki az oldal tetején található webjobs navigációs hivatkozást, hogy megnyissa a webjobs-feladatok listáját.Select the WebJobs breadcrumb link at the top of the page to go to a list of WebJobs.

    Webjobs morzsa

    Webjobs-feladatok listája az előzmények irányítópultján

Következő lépésekNext steps

A Azure WebJobs SDK a webjobs használatával számos programozási feladatot egyszerűsítheti.The Azure WebJobs SDK can be used with WebJobs to simplify many programming tasks. További információ: Mi a Webjobs SDK.For more information, see What is the WebJobs SDK.