Een App Service-app configureren in de Azure Portal

In dit artikel wordt uitgelegd hoe u algemene instellingen voor web-apps, mobiele back-end of API-app configureert met behulp van [de Azure Portal.]

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 vlag om de --env 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, App Service een app opnieuw opstarten. Namen van app-instellingen mogen geen punten bevatten ( . ). Als een app-instelling een punt bevat, wordt de periode vervangen door een onderstrepingsteken in de container.

Zoek en Azure Portalin de App Services en selecteer vervolgens uw app.

Selecteer configuratietoepassingsinstellingen in het linkermenu > van de app.

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

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

• ASP.NET Core
• Node.js
• PHP
• Python
• Java
• Ruby
• Aangepaste containers

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

Verborgen waarden tonen

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 van die instelling. Als u de waarden van alle app-instellingen wilt zien, klikt u op de knop Waarde weergeven.

Toevoegen of bewerken

Als u een nieuwe app-instelling wilt toevoegen, klikt u op Nieuwe toepassingsinstelling. In het dialoogvenster kunt u de instelling tot de huidige sleuf houden.

Als u een instelling wilt bewerken, klikt u op de knop Bewerken aan de rechterkant.

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

Bulksgewijs bewerken

Als u app-instellingen bulksgewijs wilt toevoegen of bewerken, klikt u op de knop Geavanceerd bewerken. Wanneer u klaar bent, klikt u op Bijwerken. Vergeet niet om op de pagina Configuratie op Opslaan te klikken.

App-instellingen hebben de volgende JSON-indeling:

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

App-instellingen automatiseren met de Azure CLI

U kunt de Azure CLI gebruiken om instellingen te maken en beheren vanaf de opdrachtregel.

• Wijs een waarde toe aan een instelling met az webapp config app settings set:

  az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings <setting-name>="<value>"
  

  Vervang <setting-name> door de naam van de instelling en door de waarde die u aan de instelling wilt <value> toewijzen. Met deze opdracht maakt u de instelling als deze nog niet bestaat.

• Alle instellingen en hun waarden worden weergegeven met az webapp config appsettings list:

  az webapp config appsettings list --name <app-name> --resource-group <resource-group-name>
  

• Verwijder een of meer instellingen met az webapp config app settings delete:

  az webapp config appsettings delete --name <app-name> --resource-group <resource-group-name> --setting-names {<names>}
  

  Vervang <names> door een door spatie gescheiden lijst met instellingsnamen.

Verbindingsreeksen configureren

Zoek en Azure Portalin de App Services en selecteer vervolgens uw app. Selecteer configuratietoepassingsinstellingen in het linkermenu > van de app.

Voor ASP.NET- en ASP.NET Core-ontwikkelaars is het instellen van verbindingsreeksen in App Service hetzelfde als het instellen in inWeb.config, maar de waarden die u in App Service instelt, overschrijven de waarden <connectionStrings> in Web.config. ** U kunt ontwikkelinstellingen (bijvoorbeeld een databasebestand) veilig in Web.config- en productiegeheimen (bijvoorbeeld SQL Database-referenties) in de App Service. Dezelfde code maakt gebruik van uw ontwikkelingsinstellingen wanneer u lokaal fouten opsport en gebruikt uw productiegeheimen 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 vereisen in de variabele sleutels om toegang te krijgen tot de waarden.

Tijdens runtime zijn verbindingsreeksen beschikbaar als omgevingsvariabelen, met het voorvoegsel de volgende verbindingstypen:

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

Een MySql-connection string de naam connectionstring1 kan bijvoorbeeld worden gebruikt als de omgevingsvariabele MYSQLCONNSTR_connectionString1 . Zie voor specifieke stappen voor taalstack:

• ASP.NET Core
• Node.js
• PHP
• Python
• Java
• Ruby
• Aangepaste containers

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

Verborgen waarden tonen

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

Toevoegen of bewerken

Als u een nieuwe connection string wilt toevoegen, klikt u op Nieuw connection string. In het dialoogvenster kunt u de connection string de huidige sleuf houden.

Als u een instelling wilt bewerken, klikt u op de knop Bewerken aan de rechterkant.

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

Bulksgewijs bewerken

Als u verbindingsreeksen bulksgewijs wilt toevoegen of bewerken, klikt u op de knop Geavanceerd bewerken. Wanneer u klaar bent, klikt u op Bijwerken. Vergeet niet om op de pagina Configuratie op Opslaan te klikken.

Verbindingsreeksen hebben de volgende JSON-indeling:

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

Algemene instellingen configureren

Zoek en Azure Portalin de App Services en selecteer vervolgens uw app. Selecteer in het linkermenu van de app Configuratie > Algemene instellingen.

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

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

  Voor Linux-apps en aangepaste container-apps kunt u de runtimeversie van de taal selecteren en een optionele opstartopdracht of een opstartopdrachtbestand instellen.

  

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

  • Bitness: 32-bits of 64-bits. (De standaardwaarde is 32-bits voor App Service gemaakt in de portal.)

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

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

    Always On is vereist voor doorlopende webjobs of voor webjobs die worden geactiveerd met behulp van een CRON-expressie.

  • Versie van beheerde pijplijn: de IIS-pijplijnmodus . [] Stel deze optie in op Klassiek als u een verouderde app hebt die een oudere versie van IIS vereist.

  • HTTP-versie: stel in op 2.0 om ondersteuning voor het HTTPS/2-protocol in te stellen.

  Notitie

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

  • ARR-affiniteit: Zorg er bij een implementatie met meerdere exemplaren voor dat de client voor de levensduur van de sessie wordt doorgeleid naar hetzelfde exemplaar. U kunt deze optie instellen op Uit voor staatloze toepassingen.

• Debugging: schakel externe debugging in voor ASP.NET-, ASP.NET Core-ofNode.jsapps. Deze optie wordt na 48 uur automatisch uitgeschakeld.

• Binnenkomende clientcertificaten: vereisen clientcertificaten in wederzijdse verificatie.

Standaarddocumenten configureren

Deze instelling is alleen van Windows apps.

Zoek en Azure Portalin de App Services en selecteer vervolgens uw app. Selecteer standaarddocumenten configureren in het menu links > van de app.

Het standaarddocument is de webpagina die wordt weergegeven op de basis-URL voor een website. Het eerste overeenkomende bestand in de lijst wordt gebruikt. Klik op Nieuw document om een nieuw standaarddocument toe te voegen. Vergeet niet om op Opslaan te klikken.

Als de app gebruikmaakt van modules die worden gerouteerd op basis van url in plaats van statische inhoud te leveren, is er geen standaarddocumenten nodig.

Padtoewijzingen configureren

Zoek en Azure Portalin de App Services en selecteer vervolgens uw app. Selecteer in het linkermenu van de app > Configuratiepadtoewijzingen.

Windows apps (niet-gecontaineriseerd)

Voor Windows apps kunt u de toewijzingen van IIS-handler en virtuele toepassingen en mappen aanpassen.

Met handlertoewijzingen kunt u aangepaste scriptprocessors toevoegen om aanvragen voor specifieke bestandsextensies te verwerken. Als u een aangepaste handler wilt toevoegen, klikt u 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 naar de hoofdmap van uw app te verwijzen.
• Argumenten. Optionele opdrachtregelargumenten voor de scriptprocessor.

Elke app heeft het standaard hoofdpad ( ) dat is ingesteld op , waarbij / uw code standaard wordt D:\home\site\wwwroot geïmplementeerd. Als de hoofdmap van uw app zich in een andere map of als uw opslagplaats meer dan één toepassing heeft, kunt u hier virtuele toepassingen en mappen bewerken of toevoegen.

Klik op het tabblad Padtoewijzingen op Nieuwe virtuele toepassing of map.

• Als u een virtuele map wilt toevoegen 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, moet u het selectievakje Map uit.

  

In containers geplaatste apps

U kunt aangepaste opslag toevoegen voor uw container-app. In containers geplaatste apps omvatten alle Linux-apps en ook de aangepaste Windows en Linux-containers die worden uitgevoerd op App Service. Klik op Nieuw Azure Storage aangepaste opslag als volgt te configureren:

• Naam: de weergavenaam.
• Configuratieopties: Basic of Advanced.
• Storage accounts: het opslagaccount met de container die u wilt.
• Storage: Azure Blobs of Azure Files.

  Notitie

  Windows container-apps bieden alleen ondersteuning voor Azure Files.

• Storage container: voor de basisconfiguratie de container die u wilt.
• Sharenaam: voor geavanceerde configuratie de naam van de bestands share.
• Toegangssleutel: voor geavanceerde configuratie de toegangssleutel.
• Pad voor het mounten: het absolute pad in uw container om de aangepaste opslag te mounten.

Zie Access Azure Storage as a network share from a container in App Service (Toegang tot toegang Azure Storage als een netwerk share vanuit een container in App Service).

Instellingen voor taalstack configureren

• ASP.NET Core
• Node.js
• PHP
• Python
• Java
• Ruby

Aangepaste containers configureren

Zie Een aangepaste Linux-container configureren voor Azure App Service

Volgende stappen

• Naslag voor omgevingsvariabelen en app-instellingen
• Een aangepaste domeinnaam configureren in Azure App Service
• Faseringsomgevingen in Azure App Service instellen
• Een aangepaste DNS-naam beveiligen met een TLS/SSL-binding in Azure App Service
• Diagnostische logboeken inschakelen
• Een app schalen in Azure App Service
• Basisprincipes van bewaking in Azure App Service
• Instellingen applicationHost.config wijzigen met applicationHost.xdt