Kör bakgrunds aktiviteter med WebJobs i Azure App ServiceRun background tasks with WebJobs in Azure App Service

Den här artikeln visar hur du distribuerar WebJobs med hjälp av Azure Portal för att ladda upp en körbar fil eller ett skript.This article shows how to deploy WebJobs by using the Azure portal to upload an executable or script. Information om hur du utvecklar och distribuerar WebJobs med hjälp av Visual Studio finns i Distribuera WebJobs med Visual Studio.For information about how to develop and deploy WebJobs by using Visual Studio, see Deploy WebJobs using Visual Studio.

ÖversiktOverview

WebJobs är en funktion i Azure App Service som gör att du kan köra ett program eller skript i samma kontext som en WEBBAPP, API-app eller mobilapp.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. Det kostar inget extra att använda WebJobs.There is no additional cost to use WebJobs.

Viktigt

WebJobs stöds ännu inte för App Service i Linux.WebJobs is not yet supported for App Service on Linux.

Azure WebJobs SDK kan användas med WebJobs för att förenkla många programmerings aktiviteter.The Azure WebJobs SDK can be used with WebJobs to simplify many programming tasks. Mer information finns i Vad är WebJobs SDK.For more information, see What is the WebJobs SDK.

Azure Functions är ett annat sätt att köra program och skript.Azure Functions provides another way to run programs and scripts. En jämförelse mellan WebJobs och Functions finns i Välj mellan Flow, Logic Apps, Functions och WebJobs.For a comparison between WebJobs and Functions, see Choose between Flow, Logic Apps, Functions, and WebJobs.

Webb jobb typerWebJob types

I följande tabell beskrivs skillnaderna mellan kontinuerliga och utlösta WebJobs.The following table describes the differences between continuous and triggered WebJobs.

Kontinuerlig igenkänningContinuous UtlösesTriggered
Startar omedelbart när webb jobbet skapas.Starts immediately when the WebJob is created. För att det ska gå att avsluta jobbet fungerar programmet eller skriptet vanligt vis i en oändlig slinga.To keep the job from ending, the program or script typically does its work inside an endless loop. Om jobbet har slutförts kan du starta om det.If the job does end, you can restart it. Startar bara när de utlöses manuellt eller enligt ett schema.Starts only when triggered manually or on a schedule.
Körs på alla instanser som webbappen körs på.Runs on all instances that the web app runs on. Du kan också begränsa webbjobbet till en enda instans.You can optionally restrict the WebJob to a single instance. Körs på en enda instans som Azure väljer för belastnings utjämning.Runs on a single instance that Azure selects for load balancing.
Stöder fjärrfelsökning.Supports remote debugging. Stöder inte fjärrfelsökning.Doesn't support remote debugging.

Anteckning

En webbapp kan ta lång tid efter 20 minuters inaktivitet.A web app can time out after 20 minutes of inactivity. Endast begär anden till den faktiska webbappen återställer timern.Only requests to the actual web app reset the timer. Om du visar appens konfiguration i Azure Portal eller gör förfrågningar till webbplatsen för avancerade verktyg (https://<app_name>.scm.azurewebsites.net) återställs inte timern.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. Om din app kör kontinuerliga eller schemalagda webbjobber, aktiverar du Always on för att säkerställa att webbjobben körs på ett tillförlitligt sätt.If your app runs continuous or scheduled (Timer trigger) WebJobs, enable Always On to ensure that the WebJobs run reliably. Den här funktionen är endast tillgänglig på pris nivåernaBasic, standard och Premium.This feature is available only in the Basic, Standard, and Premium pricing tiers.

Filtyper som stöds för skript eller programSupported file types for scripts or programs

Följande filtyper stöds:The following file types are supported:

  • . cmd,. bat,. exe (med Windows cmd).cmd, .bat, .exe (using Windows cmd)
  • . ps1 (med PowerShell).ps1 (using PowerShell)
  • . sh (med bash).sh (using Bash)
  • . php (med PHP).php (using PHP)
  • . py (med python).py (using Python)
  • . js (med Node. js).js (using Node.js)
  • . jar (med Java).jar (using Java)

Skapa ett kontinuerligt webbjobbCreate a continuous WebJob

  1. I Azure Portalgår du till App Service sidan i din app service webbapp, API-app eller mobilapp.In the Azure portal, go to the App Service page of your App Service web app, API app, or mobile app.

  2. Välj WebJobs.Select WebJobs.

    Välj webbjobb

  3. På sidan WebJobs väljer du Lägg till.In the WebJobs page, select Add.

    Webb jobbs sida

  4. Använd Lägg till webb jobb inställningar som anges i tabellen.Use the Add WebJob settings as specified in the table.

    Sidan Lägg till webb jobb

    InställningSetting ExempelvärdeSample value BeskrivningDescription  
    NamnName myContinuousWebJobmyContinuousWebJob Ett namn som är unikt inom en App Service-app.A name that is unique within an App Service app. Måste börja med en bokstav eller en siffra och får inte innehålla specialtecken förutom "-" och "".Must start with a letter or a number and cannot contain special characters other than "-" and "".
    Fil uppladdningFile Upload ConsoleApp. zipConsoleApp.zip En zip -fil som innehåller din körbara fil eller skript fil samt alla stödfiler som behövs för att köra programmet eller skriptet.A .zip file that contains your executable or script file as well as any supporting files needed to run the program or script. Den körbara filen eller skript fil typerna som stöds finns i avsnittet filtyper som stöds .The supported executable or script file types are listed in the Supported file types section.
    TypType Kontinuerlig igenkänningContinuous Webb jobbs typerna beskrivs tidigare i den här artikeln.The WebJob types are described earlier in this article.
    SkalningScale Flera instanserMulti instance Endast tillgängligt för kontinuerliga WebJobs.Available only for Continuous WebJobs. Bestämmer om programmet eller skriptet körs på alla instanser eller bara en instans.Determines whether the program or script runs on all instances or just one instance. Alternativet att köra på flera instanser gäller inte för pris nivåernakostnads fri eller delad.The option to run on multiple instances doesn't apply to the Free or Shared pricing tiers.
  5. Klicka på OKClick OK.

    Det nya webb jobbet visas på sidan WebJobs .The new WebJob appears on the WebJobs page.

    Lista över WebJobs

  6. För att stoppa eller starta om ett kontinuerligt webbjobb, högerklickar du på webb jobbet i listan och klickar på stoppa eller Starta.To stop or restart a continuous WebJob, right-click the WebJob in the list and click Stop or Start.

    Stoppa ett kontinuerligt webbjobb

Skapa ett manuellt utlöst webbjobbCreate a manually triggered WebJob

  1. I Azure Portalgår du till App Service sidan i din app service webbapp, API-app eller mobilapp.In the Azure portal, go to the App Service page of your App Service web app, API app, or mobile app.

  2. Välj WebJobs.Select WebJobs.

    Välj webbjobb

  3. På sidan WebJobs väljer du Lägg till.In the WebJobs page, select Add.

    Webb jobbs sida

  4. Använd Lägg till webb jobb inställningar som anges i tabellen.Use the Add WebJob settings as specified in the table.

    Sidan Lägg till webb jobb

    InställningSetting ExempelvärdeSample value BeskrivningDescription  
    NamnName myTriggeredWebJobmyTriggeredWebJob Ett namn som är unikt inom en App Service-app.A name that is unique within an App Service app. Måste börja med en bokstav eller en siffra och får inte innehålla specialtecken förutom "-" och "".Must start with a letter or a number and cannot contain special characters other than "-" and "".
    Fil uppladdningFile Upload ConsoleApp. zipConsoleApp.zip En zip -fil som innehåller din körbara fil eller skript fil samt alla stödfiler som behövs för att köra programmet eller skriptet.A .zip file that contains your executable or script file as well as any supporting files needed to run the program or script. Den körbara filen eller skript fil typerna som stöds finns i avsnittet filtyper som stöds .The supported executable or script file types are listed in the Supported file types section.
    TypType UtlösesTriggered Webb jobbs typerna beskrivs tidigare i den här artikeln.The WebJob types are described earlier in this article.
    UtlösareTriggers ManuelltManual
  5. Klicka på OKClick OK.

    Det nya webb jobbet visas på sidan WebJobs .The new WebJob appears on the WebJobs page.

    Lista över WebJobs

  6. Om du vill köra webb jobbet högerklickar du på namnet i listan och klickar på Kör.To run the WebJob, right-click its name in the list and click Run.

    Kör webbjobb

Skapa ett schemalagt webb jobbCreate a scheduled WebJob

  1. I Azure Portalgår du till App Service sidan i din app service webbapp, API-app eller mobilapp.In the Azure portal, go to the App Service page of your App Service web app, API app, or mobile app.

  2. Välj WebJobs.Select WebJobs.

    Välj webbjobb

  3. På sidan WebJobs väljer du Lägg till.In the WebJobs page, select Add.

    Webb jobbs sida

  4. Använd Lägg till webb jobb inställningar som anges i tabellen.Use the Add WebJob settings as specified in the table.

    Sidan Lägg till webb jobb

    InställningSetting ExempelvärdeSample value BeskrivningDescription  
    NamnName myScheduledWebJobmyScheduledWebJob Ett namn som är unikt inom en App Service-app.A name that is unique within an App Service app. Måste börja med en bokstav eller en siffra och får inte innehålla specialtecken förutom "-" och "".Must start with a letter or a number and cannot contain special characters other than "-" and "".
    Fil uppladdningFile Upload ConsoleApp. zipConsoleApp.zip En zip -fil som innehåller din körbara fil eller skript fil samt alla stödfiler som behövs för att köra programmet eller skriptet.A .zip file that contains your executable or script file as well as any supporting files needed to run the program or script. Den körbara filen eller skript fil typerna som stöds finns i avsnittet filtyper som stöds .The supported executable or script file types are listed in the Supported file types section.
    TypType UtlösesTriggered Webb jobbs typerna beskrivs tidigare i den här artikeln.The WebJob types are described earlier in this article.
    UtlösareTriggers SchemalagdScheduled Aktivera funktionen Always on för att schemalägga arbetet på ett tillförlitligt sätt.For the scheduling to work reliably, enable the Always On feature. Always On är bara tillgängligt på pris nivåerna Basic, standard och Premium.Always On is available only in the Basic, Standard, and Premium pricing tiers.
    CRON-uttryckCRON Expression 0 0/20 * * * *0 0/20 * * * * Cron-uttryck beskrivs i följande avsnitt.CRON expressions are described in the following section.
  5. Klicka på OKClick OK.

    Det nya webb jobbet visas på sidan WebJobs .The new WebJob appears on the WebJobs page.

    Lista över WebJobs

NCRONTAB-uttryckNCRONTAB expressions

Du kan ange ett NCRONTAB-uttryck i portalen eller inkludera en settings.job-fil i roten av din webb jobb . zip -fil, som i följande exempel: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 * * * *"
}

Mer information finns i Schemalägga ett utlöst webb jobb.To learn more, see Scheduling a triggered WebJob.

Anteckning

Standard tids zonen som används för att köra CRON uttryck är Coordinated Universal Time (UTC).The default time zone used to run CRON expressions is Coordinated Universal Time (UTC). Om du vill att ditt CRON-uttryck ska köras baserat på en annan tidszon skapar du en app-inställning för din Function-app med namnet WEBSITE_TIME_ZONE.To have your CRON expression run based on another time zone, create an app setting for your function app named WEBSITE_TIME_ZONE. Läs mer i NCRONTAB tids zoner.To learn more, see NCRONTAB time zones.

Visa jobb historikenView the job history

  1. Välj det webbjobb som du vill visa historik för och välj sedan knappen loggar .Select the WebJob you want to see history for, and then select the Logs button.

    Knappen loggar

  2. På sidan information om webb jobb väljer du en tid för att visa information om en körning.In the WebJob Details page, select a time to see details for one run.

    Information om webb jobb

  3. På sidan jobb körnings information väljer du Växla utdata för att se texten i logg innehållet.In the WebJob Run Details page, select Toggle Output to see the text of the log contents.

    Körnings information för webb jobb

    Om du vill visa utmatnings texten i ett separat webbläsarfönster väljer du Hämta.To see the output text in a separate browser window, select download. Om du vill ladda ned själva texten högerklickar du på Ladda ned och använder webbläsarens alternativ för att spara filens innehåll.To download the text itself, right-click download and use your browser options to save the file contents.

  4. Välj länken WebJobs -länk överst på sidan för att gå till en lista med WebJobs.Select the WebJobs breadcrumb link at the top of the page to go to a list of WebJobs.

    Webb jobbets dynamiska adress

    Lista med WebJobs på Historik panelen

Nästa stegNext steps

Azure WebJobs SDK kan användas med WebJobs för att förenkla många programmerings aktiviteter.The Azure WebJobs SDK can be used with WebJobs to simplify many programming tasks. Mer information finns i Vad är WebJobs SDK.For more information, see What is the WebJobs SDK.