Een App Service-app configureren

In dit artikel wordt uitgelegd hoe u algemene instellingen configureert voor web-apps, mobiele back-end of API-app. Zie de naslaginformatie over app-instellingen voor Azure Functions voor Azure Functions.

App-instellingen configureren

In App Service zijn app-instellingen variabelen die als omgevingsvariabelen worden doorgegeven aan de toepassingscode. Voor Linux-apps en aangepaste containers geeft App Service app-instellingen door aan de container met behulp van de --env vlag om de omgevingsvariabele in de container in te stellen. In beide gevallen worden ze bij het opstarten van de app in uw app-omgeving geïnjecteerd. Wanneer u app-instellingen toevoegt, verwijdert of bewerkt, wordt App Service een app opnieuw opgestart.

Voor ASP.NET- en ASP.NET Core-ontwikkelaars zijn het instellen van app-instellingen in App Service als het instellen ervan <appSettings> in Web.config of appsettings.json, maar de waarden in App Service overschrijven de instellingen in Web.config of appsettings.json. U kunt de ontwikkelinstellingen (bijvoorbeeld het lokale MySQL-wachtwoord) in Web.config of appsettings.json en productiegeheimen (bijvoorbeeld het wachtwoord van de Azure MySQL-database) veilig bewaren in App Service. Dezelfde code maakt gebruik van uw ontwikkelinstellingen wanneer u lokaal fouten opssport en uw productiegeheimen gebruikt wanneer deze worden geïmplementeerd in Azure.

Andere taalstacks, op dezelfde manier, krijgen de app-instellingen als omgevingsvariabelen tijdens runtime. Zie voor taalstackspecifieke stappen:

App-instellingen worden altijd versleuteld wanneer ze worden opgeslagen (versleuteld-at-rest).

Notitie

App-instellingen kunnen ook worden omgezet vanuit Key Vault met behulp van Key Vault verwijzingen.

  1. Zoek en selecteer App Services in de Azure Portal en selecteer vervolgens uw app.

    Zoeken naar App Services

  2. Selecteer in het linkermenu van de app de instellingen van de configuratietoepassing>.

    Toepassingsinstellingen

    Standaard worden waarden voor app-instellingen verborgen in de portal voor beveiliging. Als u een verborgen waarde van een app-instelling wilt zien, klikt u op het veld Waarde . Als u de verborgen waarden van alle app-instellingen wilt zien, klikt u op de knop Waarden weergeven .

  3. Als u een nieuwe app-instelling wilt toevoegen, klikt u op Nieuwe toepassingsinstelling. Als u een instelling wilt bewerken, klikt u op de knop Bewerken aan de rechterkant.

  4. In het dialoogvenster kunt u de instelling aan de huidige site plakken.

    Namen van app-instellingen mogen geen perioden (.) bevatten. Als een app-instelling een punt bevat, wordt de periode vervangen door een onderstrepingsteken in de container.

    Notitie

    In een standaard-Linux-app-service of een aangepaste Linux-container moet elke geneste JSON-sleutelstructuur in de naam ApplicationInsights:InstrumentationKey van de app-instelling worden geconfigureerd in App Service als ApplicationInsights__InstrumentationKey voor de sleutelnaam. Met andere woorden, elke : moet worden vervangen door __ (dubbele onderstrepingsteken).

  5. Wanneer u klaar bent, klikt u op Bijwerken. Vergeet niet om op Opslaan terug te klikken op de pagina Configuratie .

App-instellingen bulksgewijs bewerken

Klik op de knop Geavanceerd bewerken . Bewerk de instellingen in het tekstgebied. Wanneer u klaar bent, klikt u op Bijwerken. Vergeet niet om op Opslaan terug te klikken op de pagina Configuratie .

App-instellingen hebben de volgende JSON-opmaak:

[
  {
    "name": "<key-1>",
    "value": "<value-1>",
    "slotSetting": false
  },
  {
    "name": "<key-2>",
    "value": "<value-2>",
    "slotSetting": false
  },
  ...
]

Matrices configureren in app-instellingen

U kunt ook matrices configureren in app-instellingen, zoals wordt weergegeven in de onderstaande tabel.

Naam van app-instelling Waarde van app-instelling
MY_ENV_VAR ['entry1', 'entry2', 'entry3']

Verbindingsreeksen configureren

Zoek en selecteer App Services in de Azure Portal en selecteer vervolgens uw app. Selecteer in het linkermenu van de app de instellingen van de configuratietoepassing>.

Toepassingsinstellingen

Voor ASP.NET en ASP.NET Core ontwikkelaars zijn het instellen van verbindingsreeksen in App Service net als het instellen ervan <connectionStrings> in Web.config, maar de waarden die u hebt ingesteld in App Service overschrijven de waarden in Web.config. U kunt ontwikkelinstellingen (bijvoorbeeld een databasebestand) in Web.config en productiegeheimen (bijvoorbeeld SQL Database referenties) veilig bewaren in App Service. Dezelfde code maakt gebruik van uw ontwikkelinstellingen wanneer u lokaal fouten opssport en uw productiegeheimen gebruikt wanneer deze worden geïmplementeerd in Azure.

Voor andere taalstacks is het beter om in plaats daarvan app-instellingen te gebruiken, omdat verbindingsreeksen speciale opmaak in de variabelesleutels vereisen om toegang te krijgen tot de waarden.

Notitie

Er is één geval waarin u mogelijk verbindingsreeksen wilt gebruiken in plaats van app-instellingen voor non-.NET talen: er wordt alleen een back-up gemaakt van bepaalde Azure-databasetypen, samen met de app als u een connection string configureert voor de database in uw App Service-app. Zie Een aangepaste back-up maken voor meer informatie. Als u deze automatische back-up niet nodig hebt, gebruikt u app-instellingen.

Tijdens runtime zijn verbindingsreeksen beschikbaar als omgevingsvariabelen, voorafgegaan door de volgende verbindingstypen:

  • Sqlserver: SQLCONNSTR_
  • Mysql: MYSQLCONNSTR_
  • SQLAzure: SQLAZURECONNSTR_
  • Aangepaste: CUSTOMCONNSTR_
  • Postgresql: POSTGRESQLCONNSTR_

Een MySQL-connection string met de naam connectionstring1 kan bijvoorbeeld worden geopend als de omgevingsvariabeleMYSQLCONNSTR_connectionString1. Zie voor taalstackspecifieke stappen:

Verbindingsreeksen worden altijd versleuteld wanneer ze worden opgeslagen (versleuteld-at-rest).

Notitie

Verbindingsreeksen kunnen ook worden omgezet vanuit Key Vault met behulp van Key Vault verwijzingen.

  1. Zoek en selecteer App Services in de Azure Portal en selecteer vervolgens uw app.

    Zoeken naar App Services

  2. Selecteer in het linkermenu van de app de instellingen van de configuratietoepassing>.

    Toepassingsinstellingen

    Standaard worden waarden voor verbindingsreeksen verborgen in de portal voor beveiliging. Als u een verborgen waarde van een connection string wilt zien, klikt u op het veld Waarde. Als u de verborgen waarden van alle verbindingsreeksen wilt zien, klikt u op de knop Waarde weergeven .

  3. Als u een nieuw connection string wilt toevoegen, klikt u op Nieuw connection string. Als u een connection string wilt bewerken, klikt u op de knop Bewerken aan de rechterkant.

  4. In het dialoogvenster kunt u de connection string op de huidige site plakken.

  5. Wanneer u klaar bent, klikt u op Bijwerken. Vergeet niet om op Opslaan terug te klikken op de pagina Configuratie .

Verbindingsreeksen bulksgewijs bewerken

Klik op de knop Geavanceerd bewerken . Bewerk de verbindingsreeksen in het tekstgebied. Wanneer u klaar bent, klikt u op Bijwerken. Vergeet niet om op Opslaan terug te klikken op de pagina Configuratie .

Verbindingsreeksen hebben de volgende JSON-opmaak:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
    "slotSetting": false
  },
  ...
]

Instellingen voor taalstack configureren

Algemene instellingen configureren

Zoek en selecteer App Services in de Azure Portal en selecteer vervolgens uw app. Selecteer in het linkermenu van de appde instellingen configuratie-algemeen>.

Algemene instellingen

Hier kunt u enkele algemene instellingen voor de app configureren. Voor sommige instellingen moet u omhoog schalen naar hogere prijscategorieën.

  • Stack-instellingen: de softwarestack voor het uitvoeren van de app, inclusief de taal- en SDK-versies.

    Voor Linux-apps kunt u de versie van de taalruntime selecteren en een optionele opstartopdracht of een opstartopdrachtbestand instellen.

    Algemene instellingen voor Linux-containers

  • Platforminstellingen: Hiermee kunt u instellingen configureren voor het hostingplatform, waaronder:

    • FTP-status: alleen FTPS toestaan of FTP helemaal uitschakelen.

    • Bitness: 32-bits of 64-bits. Alleen voor Windows-apps.

    • WebSocket-protocol: bijvoorbeeld voor ASP.NET SignalR of socket.io.

    • AlwaysOn: houdt de app geladen, zelfs wanneer er geen verkeer is. Wanneer AlwaysOn niet is ingeschakeld (standaard), wordt de app na 20 minuten zonder binnenkomende aanvragen verwijderd. De niet-geladen app kan leiden tot een hoge latentie voor nieuwe aanvragen vanwege de opwarmtijd. Wanneer AlwaysOn is ingeschakeld, verzendt de front-end load balancer elke vijf minuten een GET-aanvraag naar de hoofdmap van de toepassing. Met de doorlopende ping voorkomt u dat de app wordt verwijderd.

      AlwaysOn is vereist voor continue webtaken of voor webtaken die worden geactiveerd met behulp van een CRON-expressie.

    • HTTP-versie: ingesteld op 2.0 om ondersteuning voor HTTPS/2-protocol in te schakelen.

    Notitie

    De meeste moderne browsers ondersteunen alleen het HTTP/2-protocol via TLS, terwijl niet-versleuteld verkeer HTTP/1.1 blijft gebruiken. Om ervoor te zorgen dat clientbrowsers verbinding maken met uw app met HTTP/2, moet u uw aangepaste DNS-naam beveiligen. Zie Een aangepaste DNS-naam beveiligen met een TLS/SSL-binding in Azure App Service voor meer informatie.

    • ARR-affiniteit: In een implementatie met meerdere exemplaren moet u ervoor zorgen dat de client wordt doorgestuurd naar hetzelfde exemplaar voor de levensduur van de sessie. U kunt deze optie instellen op Uit voor staatloze toepassingen.
  • Foutopsporing: schakel externe foutopsporing in voor ASP.NET, ASP.NET Core of Node.js-apps. Deze optie wordt na 48 uur automatisch uitgeschakeld.

  • Binnenkomende clientcertificaten: clientcertificaten vereisen in wederzijdse verificatie.

Standaarddocumenten configureren

Deze instelling is alleen voor Windows-apps.

Het standaarddocument is de webpagina die wordt weergegeven in de hoofd-URL van een App Service-app. Het eerste overeenkomende bestand in de lijst wordt gebruikt. Als de app modules gebruikt die worden gerouteerd op basis van URL in plaats van statische inhoud, is er geen standaarddocumenten nodig.

  1. Zoek en selecteer App Services in de Azure Portal en selecteer vervolgens uw app.

  2. Selecteer in het linkermenu van de app de optie Standaarddocumenten voor configuratie>.

    Standaarddocumenten

  3. Als u een standaarddocument wilt toevoegen, klikt u op Nieuw document. Als u een standaarddocument wilt verwijderen, klikt u rechts op Verwijderen .

Een URL-pad toewijzen aan een map

Standaard start App Service uw app vanuit de hoofdmap van uw app-code. Bepaalde web-frameworks starten echter niet in de hoofdmap. Bijvoorbeeld: Laravel start in de submap public. Een dergelijke app is bijvoorbeeld toegankelijk ophttp://contoso.com/public, maar u wilt in plaats daarvan meestal naar de public map leidenhttp://contoso.com. Als het opstartbestand van uw app zich in een andere map bevindt of als uw opslagplaats meer dan één toepassing heeft, kunt u virtuele toepassingen en mappen bewerken of toevoegen.

  1. Zoek en selecteer App Services in de Azure Portal en selecteer vervolgens uw app.

  2. Selecteer in het linkermenu van de appde toewijzingenvan het configuratiepad>

  3. Klik op Nieuwe virtuele toepassing of map.

    • Als u een virtuele map wilt toewijzen aan een fysiek pad, laat u het selectievakje Map ingeschakeld. Geef de virtuele map en het bijbehorende relatieve (fysieke) pad op naar de hoofdmap van de website (D:\home).
    • Als u een virtuele map als een webtoepassing wilt markeren, schakelt u het selectievakje Map uit.

    Selectievakje Map

  4. Klik op OK.

Handlertoewijzingen configureren

Voor Windows-apps kunt u de IIS-handlertoewijzingen en virtuele toepassingen en mappen aanpassen. Met handlertoewijzingen kunt u aangepaste scriptprocessors toevoegen om aanvragen voor specifieke bestandsextensies te verwerken.

Een aangepaste handler toevoegen:

  1. Zoek en selecteer App Services in de Azure Portal en selecteer vervolgens uw app.

  2. Selecteer in het linkermenu van de appde toewijzingenvan configuratiepaden>.

    Padtoewijzingen

  3. Klik op Nieuwe handlertoewijzing. Configureer de handler als volgt:

    • Extensie. De bestandsextensie die u wilt verwerken, zoals *.php of handler.fcgi.
    • Scriptprocessor. Het absolute pad van de scriptprocessor naar u. Aanvragen voor bestanden die overeenkomen met de bestandsextensie worden verwerkt door de scriptprocessor. Gebruik het pad D:\home\site\wwwroot om te verwijzen naar de hoofdmap van uw app.
    • Argumenten. Optionele opdrachtregelargumenten voor de scriptprocessor.
  4. Klik op OK.

Aangepaste containers configureren

Volgende stappen