Configurer une application App Service

Remarque

Depuis le 1er juin 2024, toutes les applications App Service nouvellement créées ont la possibilité de générer un nom d’hôte par défaut unique en utilisant la convention d’affectation de noms <app-name>-<random-hash>.<region>.azurewebsites.net. Les noms d’application existants restent inchangés.

Exemple : myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Pour plus d’informations, reportez-vous à Nom d’hôte par défaut unique pour la ressource App Service.

Cet article explique comment configurer les paramètres courants d’une application web, d’un back-end mobile ou d’une application API. Pour Azure Functions, consultez Informations de référence sur les paramètres d’application d’Azure Functions.

Configuration des paramètres d’application

Remarque

• Les noms des paramètres d’application peuvent contenir uniquement des lettres, des chiffres (0-9), des points (« . ») et des traits de soulignement (« _ »)
• Les caractères spéciaux dans la valeur d’un paramètre d’application doivent être positionnés dans une séquence d’échappement en fonction des besoins du système d’exploitation cible

Par exemple, pour définir une variable d’environnement dans App Service Linux avec la valeur "pa$$w0rd\", la chaîne du paramètre d’application doit être :"pa\$\$w0rd\\"

Dans App Service, les paramètres d’application sont des variables transmises comme des variables d’environnement au code de l’application. Pour les applications Linux et les conteneurs personnalisés, App Service envoie les paramètres d’application au conteneur via l’indicateur --env pour définir la variable d'environnement dans le conteneur. Dans les deux cas, ils sont injectés dans votre environnement d’application au démarrage de l’application. Quand vous ajoutez, supprimez ou modifiez des paramètres d’application, App Service déclenche un redémarrage de l’application.

Les développeurs ASP.NET et ASP.NET Core définissent les paramètres de l'application dans App Service comme ils le font avec <appSettings> dans Web.config ou appsettings.json, mais les valeurs dans App Service remplacent celles du fichier Web.config ou appsettings.json. Vous pouvez conserver de façon sécurisée les paramètres de développement (par exemple, le mot de passe MySQL local) dans Web.config ou appsettings.json, ainsi que les secrets de production (par exemple le mot de passe de la base de données MySQL Azure) dans App Service. Le même code utilise vos paramètres de développement lorsque vous déboguez localement, et utilise vos secrets de production lorsque vous les déployez sur Azure.

De la même façon, d'autres piles de langage récupèrent les paramètres de l'application en tant que variables d'environnement lors de l'exécution. Pour les étapes spécifiques à la pile de langage, voir :

• ASP.NET Core
• Node.JS
• PHP
• Python
• Java
• Conteneurs personnalisés

Une fois stockés, les paramètres d’application sont toujours chiffrés (chiffrement au repos).

Remarque

Si vous stockez des secrets dans les paramètres de l’application, pensez à utiliser des références Key Vault. Si vos secrets sont destinés à la connectivité aux ressources principales, envisagez des options de connectivité plus sécurisées qui ne nécessitent pas de secrets du tout. Pour plus d’informations, consultez Connectivité sécurisée aux services et bases de données Azure à partir d’Azure App Service.

Azure portal

1. Dans le portail Azure, recherchez et sélectionnez App Services, puis sélectionnez votre application.

   

2. Dans le menu de gauche de l’application, sélectionnez Variables d’environnement>Paramètres de l’application.

   

   Par défaut, les valeurs des paramètres de l'application sont masquées dans le portail pour des raisons de sécurité. Pour voir la valeur masquée d'un paramètre spécifique de l'application, sélectionnez le champ Valeur correspondant. Pour voir les valeurs masquées de tous les paramètres de l’application, sélectionnez le bouton Afficher les valeurs.

3. Sélectionnez Ajouter pour ajouter un nouveau paramètre d’application. Pour modifier un paramètre, cliquez dessus.

4. Dans la boîte de dialogue, vous pouvez conserver le paramètre dans l'emplacement actuel.

   Remarque

   Dans un service d’application Linux par défaut ou un conteneur Linux personnalisé, une structure de clé JSON imbriquée dans le nom du paramètre de l’application, par exemple ApplicationInsights:InstrumentationKey, doit être configurée dans App Service en tant que ApplicationInsights__InstrumentationKey pour le nom de la clé. En d’autres termes, vous devez remplacer : par __ (trait de soulignement double). Toutes les périodes du nom du paramètre d’application sont remplacées par un _ (trait de soulignement unique).

5. Lorsque vous avez terminé, sélectionnez Appliquer. N’oubliez pas de sélectionner Appliquer dans la page Variables d’environnement.

Azure CLI

Ajoutez ou modifiez un paramètre avec az webapp config app settings set :

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

Remplacez <setting-name> par le nom du paramètre, et <value> par la valeur à assigner à celui-ci.

Affichez tous les paramètres et leurs valeurs avec az webapp config appsettings list :

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

Supprimez un ou plusieurs paramètres avec az webapp config app settings delete :

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

Azure PowerShell

Définissez un ou plusieurs paramètres d’application avec Set-AzWebApp :

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

Cette applet de commande remplace l’ensemble des paramètres d’application par ceux que vous spécifiez. Pour ajouter ou modifier un paramètre d’application dans un ensemble existant, incluez les paramètres d’application existants dans votre hashtable d’entrée à l’aide de l’applet de commande Get-AzWebApp. Par exemple :

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new Hashtable
$appSettings = @{}
ForEach ($item in $webapp.SiteConfig.AppSettings) {
$appSettings[$item.Name] = $item.Value
}

# Add or edit one or more app settings
$appSettings['<setting-name1>'] = '<value1>'
$appSettings['<setting-name2>'] = '<value2>'

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings $appSettings

Pour vérifier si un paramètre d’application est propre à un emplacement, utilisez Get-AzWebAppSlotConfigName :

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select AppSettingNames

Pour créer un ou plusieurs paramètres d’application propres à un emplacement, utilisez Set-AzWebAppSlotConfigName :

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -AppSettingNames <setting-name1>,<setting-name2>,...

Modifier des paramètres d’application en bloc

Azure portal

Sélectionnez le bouton Modification avancée. Modifiez les paramètres dans la zone de texte. Lorsque vous avez terminé, sélectionnez OK. N’oubliez pas de sélectionner Appliquer dans la page Variables d’environnement.

Les paramètres de l'application affichent le format JSON suivant :

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

Azure CLI

Exécutez az webapp config app settings set en indiquant le nom du fichier JSON.

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Conseil

L’ajout de guillemets autour du nom de fichier n’est nécessaire que dans PowerShell.

Le format de fichier doit être un tableau JSON de paramètres où le champ du paramètre d’emplacement est facultatif. Par exemple :

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

Pour plus de commodité, vous pouvez enregistrer les paramètres existants dans un fichier JSON à l’aide de la commande az webapp config appsettings list. L’exemple suivant peut être exécuté dans Bash.

# Save the settings
az webapp config appsettings list --name <app-name> --resource-group <group-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Il n’est pas possible de modifier les paramètres d’application en bloc en utilisant un fichier JSON avec Azure PowerShell.

Configuration des chaînes de connexion

Remarque

Envisagez des options de connectivité plus sécurisées qui ne nécessitent pas de secrets de connexion du tout. Pour plus d’informations, consultez Connectivité sécurisée aux services et bases de données Azure à partir d’Azure App Service.

Les développeurs ASP.NET et ASP.NET Core définissent les chaînes de connexion dans App Service comme ils le font avec <connectionStrings> dans Web.config, mais les valeurs que vous définissez dans App Service remplacent celles du fichier Web.config. Vous pouvez conserver en lieu sûr les paramètres de développement (par exemple un fichier de base de données) dans Web.config et les secrets de production (par exemple des informations d’identification SQL Database) dans App Service. Le même code utilise vos paramètres de développement lorsque vous déboguez localement, et utilise vos secrets de production lorsque vous les déployez sur Azure.

Pour d’autres piles de langage, il est préférable d'utiliser des paramètres d’application car les chaînes de connexion nécessitent un formatage spécial dans les clés variables pour pouvoir accéder aux valeurs.

Notes

Il existe un cas où vous pouvez utiliser des chaînes de connexion au lieu des paramètres d’application pour les langages autre que .NET : certains types de base de données Azure sont sauvegardés avec l’application uniquement si vous configurez une chaîne de connexion pour la base de données dans votre application App Service. Pour plus d’informations, consultez Créer une sauvegarde personnalisée. Si vous n'avez pas besoin de cette sauvegarde automatisée, utilisez les paramètres de l'application.

Lors de l'exécution, les chaînes de connexion sont disponibles en tant que variables d'environnement, préfixées par les types de connexion suivants :

• SQLServer : SQLCONNSTR_
• MySQL : MYSQLCONNSTR_
• SQLAzure : SQLAZURECONNSTR_
• Personnalisé : CUSTOMCONNSTR_
• PostgreSQL : POSTGRESQLCONNSTR_
• Hub de notification : NOTIFICATIONHUBCONNSTR_
• Service Bus : SERVICEBUSCONNSTR_
• Event Hub : EVENTHUBCONNSTR_
• Document DB : DOCDBCONNSTR_
• Cache Redis : REDISCACHECONNSTR_

Remarque

Les applications .NET ciblant PostgreSQL, le Hub de notification, Service Bus, Event Hub, Document Db et le Cache Redis doivent définir la chaîne de connexion sur Personnalisée comme solution de contournement pour d’un problème connu dans .NET EnvironmentVariablesConfigurationProvider

Par exemple, une chaîne de connexion MySQL nommée connectionstring1 est accessible comme variable d’environnement MYSQLCONNSTR_connectionString1. Pour les étapes spécifiques à la pile de langage, voir :

• ASP.NET Core
• Node.JS
• PHP
• Python
• Java
• Conteneurs personnalisés

Une fois stockées, les chaînes de connexion sont toujours chiffrées (chiffrement au repos).

Notes

Les chaînes de connexion peuvent également être résolues à partir de Key Vault à l’aide des références Key Vault.

Azure portal

1. Dans le portail Azure, recherchez et sélectionnez App Services, puis sélectionnez votre application.

   

2. Dans le menu de gauche de l’application, sélectionnez Variables d’environnement>Chaînes de connexion.

   

   Par défaut, les valeurs des chaînes de connexion sont masquées dans le portail pour des raisons de sécurité. Pour voir la valeur masquée d’une chaîne de connexion, sélectionnez le champ Valeur correspondant. Pour voir les valeurs masquées de toutes les chaînes de connexion, sélectionnez le bouton Afficher la valeur.

3. Pour ajouter une chaîne de connexion, sélectionnez Ajouter. Pour modifier une chaîne de connexion, sélectionnez-la.

4. Dans la boîte de dialogue, vous pouvez conserver la chaîne de connexion dans l'emplacement actuel.

5. Lorsque vous avez terminé, sélectionnez Appliquer. N’oubliez pas de sélectionner Appliquer dans la page Variables d’environnement.

Azure CLI

Ajoutez ou modifiez un paramètre avec la commande az webapp config connection-string set :

az webapp config connection-string set --name <app-name> --resource-group <group-name> --connection-string-type <type> --settings <string-name>='<value>'

Remplacez <string-name> par le nom de la chaîne de connexion, et <value> par la valeur à lui attribuer. Pour connaître les valeurs possibles de <type> (par exemple, SQLAzure), consultez la documentation sur les commandes CLI.

Affichez toutes les chaînes de connexion et leurs valeurs avec az webapp config connection-string list :

az webapp config connection-string list --name <app-name> --resource-group <group-name>

Supprimez une ou plusieurs chaînes de connexion avec az webapp config connection-string delete :

az webapp config connection-string delete --name <app-name> --resource-group <group-name> --setting-names {<string-name1>,<string-name2>,...}

Azure PowerShell

Définissez une ou plusieurs chaînes de connexion avec Set-AzWebApp :

$PropertiesObject = @{
  "<string-name1>" = @{
    value="<connection-string1>";
    type="<type>"};
  "<string-name2>" = @{
    value="<connection-string2>";
    type="<type>"}
}

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $PropertiesObject

Chaque chaîne de connexion contient un nom (<string-name1>), une valeur (<connection-string1>) et le type, qui est une valeur numérique correspondant à l’un des champs d’énumération ConnectionStringType. Par exemple, pour SQL Azure, spécifiez type="2".

Cette applet de commande remplace l’ensemble des chaînes de connexion par celles que vous spécifiez. Pour ajouter ou modifier un paramètre d’application dans un ensemble existant, incluez les paramètres d’application existants dans votre hashtable d’entrée à l’aide de l’applet de commande Get-AzWebApp. Par exemple :

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hashtable
$connStrings = @{}
ForEach ($item in $webapp.SiteConfig.ConnectionStrings) {
    $connStrings[$item.Name] = @{value=$item.ConnectionString; type=$item.Type.ToString()}
}

# Add or edit one or more connection strings
$connStrings['<string-name1>'] = @{value='<connection-string1>', type='<type>'}
$connStrings['<string-name2>'] = @{value='<connection-string2>', type='<type>'}

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $connStrings

Pour vérifier si une chaîne de connexion est propre à un emplacement, utilisez Get-AzWebAppSlotConfigName :

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select ConnectionStringNames

Pour créer une ou plusieurs chaînes de connexion propres à un emplacement, utilisez Set-AzWebAppSlotConfigName :

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -ConnectionStringNames <string-name1>,<string-name2>,...

Modifier des chaînes de connexion en bloc

Azure portal

Sélectionnez le bouton Modification avancée. Modifiez les chaînes de connexion dans la zone de texte. Lorsque vous avez terminé, sélectionnez Appliquer. N’oubliez pas de sélectionner Appliquer dans la page Variables d’environnement.

Les chaînes de connexion affichent le format JSON suivant :

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

Azure CLI

Exécutez az webapp config connection-string set en indiquant le nom du fichier JSON.

az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Conseil

L’ajout de guillemets autour du nom de fichier n’est nécessaire que dans PowerShell.

Le format de fichier nécessaire doit être un tableau JSON des chaînes de connexion où le champ du paramètre d’emplacement est facultatif. Par exemple :

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

Pour plus de commodité, vous pouvez enregistrer les chaînes de connexion existantes dans un fichier JSON à l’aide de la commande az webapp config connection-string list. L’exemple suivant peut être exécuté dans Bash.

# Save the connection strings
az webapp config connection-string list --resource-group <group-name> --name <app-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Il n’est pas possible de modifier les chaînes de connexion en bloc en utilisant un fichier JSON avec Azure PowerShell.

Configurer les paramètres de la pile de langage

• ASP.NET Core
• Node.JS
• PHP
• Python
• Java

Configurer les paramètres généraux

Azure portal

Dans le portail Azure, recherchez et sélectionnez App Services, puis sélectionnez votre application. Dans le menu de gauche de l'application, sélectionnez Configuration>Paramètres généraux.

Ici, vous pouvez configurer quelques paramètres communs pour l'application. Certains paramètres vous obligent à monter en puissance vers des niveaux de tarification supérieurs.

• Paramètres de la pile : La pile logicielle pour exécuter l'application, y compris le langage et les versions SDK.

  Pour les applications Linux, vous pouvez sélectionner la version du runtime de langage et définir une commande de démarrage facultative ou un fichier de commandes de démarrage.

  

• Paramètres de la plateforme : Vous permet de configurer les paramètres de la plateforme d'hébergement, notamment :

  • Nombre de bits de la plateforme : 32 bits ou 64 bits. Pour applications Windows uniquement.
  • État FTP : autoriser uniquement FTPS ou désactiver le protocole FTP.
  • Version HTTP : Utilisez la version 2.0 pour activer la prise en charge du protocole HTTPS/2.

  Notes

  Les navigateurs les plus récents prennent en charge le protocole HTTP/2 sur TLS uniquement, alors que le trafic non chiffré continue d’utiliser HTTP/1.1. Pour vous assurer que les navigateurs clients se connectent à votre application avec le protocole HTTP/2, sécurisez votre nom DNS personnalisé. Pour plus d’informations, consultez Sécuriser un nom DNS personnalisé avec une liaison TLS/SSL dans Azure App Service.

  • Sockets web : Pour ASP.NET SignalR ou socket.io, par exemple.

  • Toujours actif : Garde l'application chargée même s’il n'y a aucun trafic. Lorsque l’option Toujours actif n’est pas activée (par défaut),l’application est déchargée après 20 minutes sans requêtes entrantes. L’application déchargée peut provoquer une latence élevée pour les nouvelles requêtes en raison de son temps de préparation. Lorsque l’option Always on est activée, l’équilibreur de charge frontal envoie une requête GET à la racine de l’application toutes les cinq minutes. Il est important de s’assurer que cette demande reçoit une réponse 200 OK pour que les opérations de recréation d’image soient effectuées correctement. La commande ping continue empêche le déchargement de l’application.

    Vous devez activer Always On pour les WebJobs continus ou pour les WebJobs déclenchés à l’aide d’une expression CRON.

  • Affinité de session : dans un déploiement multi-instance, vérifiez que le client est routé vers la même instance pendant toute la session. Vous pouvez définir cette option sur Off (Désactivée) pour les applications sans état.

  • Proxy d’affinité de session : vous pouvez activer le proxy d’affinité de session si votre application se trouve derrière un proxy inverse (comme Azure Application Gateway ou Azure Front Door) et que vous utilisez le nom d’hôte par défaut. Le domaine du cookie d’affinité de session s’aligne sur le nom d’hôte transféré du proxy inverse.

  • HTTPS uniquement : lorsqu’il est activé, tout le trafic HTTP est redirigé vers HTTPS.

  • Version TLS minimum : Sélectionnez la version de chiffrement TLS minimale requise par votre application.

• Débogage : Activez le débogage à distance pour les applications ASP.NET, ASP.NET Core ou Node.js. Cette option se désactive automatiquement au bout de 48 heures.

• Certificats clients entrants : demander des certificats clients dans une authentification mutuelle.

Azure CLI

Vous pouvez définir un grand nombre d’options configurables courantes avec az webapp config set. L’exemple suivant présente certaines des options configurables.

az webapp config set --resource-group <group-name> --name <app-name> --use-32bit-worker-process [true|false] --web-sockets-enabled [true|false] --always-on [true|false]--http20-enabled --auto-heal-enabled [true|false] --remote-debugging-enabled [true|false] --number-of-workers

Pour afficher les paramètres existants, utilisez la commande az webapp config show.

Azure PowerShell

Vous pouvez définir un grand nombre d’options configurables courantes avec Set-AzWebApp. L’exemple suivant présente certaines des options configurables.

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [True|False] -WebSocketsEnabled [True|False] -AlwaysOn [True|False] -NumberOfWorkers

Pour afficher les paramètres existants, utilisez la commande Get-AzWebApp.

Configurer les documents par défaut

Ce paramètre ne concerne pour les applications Windows.

Le document par défaut est la page web qui s’affiche à l’URL racine d’une application App Service. Le premier fichier correspondant dans la liste est utilisé. Si l’application utilise des modules qui effectuent un routage en fonction de l’URL, au lieu de proposer du contenu statique, il n’existe aucun document par défaut.

Azure portal

1. Dans le portail Azure, recherchez et sélectionnez App Services, puis sélectionnez votre application.

2. Dans le menu de gauche de l'application, sélectionnez Configuration>Documents par défaut.

   

3. Pour ajouter un document par défaut, sélectionnez Nouveau document. Pour supprimer un document par défaut, sélectionnez Supprimer à droite.

Azure CLI

Ajoutez un document par défaut avec la commande az resource update :

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

Azure PowerShell

Ajoutez un document par défaut en modifiant l’objet PowerShell de l’application mise à jour :

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

Mapper un chemin d’URL à un répertoire

Par défaut, App Service démarre votre application à partir du répertoire racine de votre code d’application. Cependant, certains frameworks web ne démarrent pas dans le répertoire racine. Par exemple, Laravel démarre dans le sous-répertoire public. Une telle application serait accessible à partir de l’adresse http://contoso.com/public, par exemple, mais il est préférable de diriger http://contoso.com vers le répertoire public. Si le ficher de démarrage de votre application se trouve dans un autre dossier, ou si votre référentiel contient plusieurs applications, vous pouvez modifier ou ajouter des applications et des répertoires virtuels.

Important

La fonctionnalité de répertoire virtuel vers un chemin physique est disponible uniquement sur les applications Windows.

Azure portal

1. Dans le portail Azure, recherchez et sélectionnez App Services, puis sélectionnez votre application.

2. Dans le menu de gauche de l’application, sélectionnez Configuration>Mappages de chemin d’accès.

3. Sélectionnez Nouvelle application virtuelle ou nouveau répertoire virtuel.

   • Pour mapper un répertoire virtuel à un chemin d’accès physique, laissez la case à cocher Répertoire activée. Indiquez le répertoire virtuel et le chemin d’accès relatif (physique) correspondant à la racine du site web (D:\home).
   • Pour marquer un répertoire virtuel en tant qu’application web, désactivez la case à cocher Répertoire.

   

4. Cliquez sur OK. N'oubliez pas de sélectionnez Enregistrer dans la page Configuration.

Azure CLI

L’exemple suivant définit le chemin racine / sur le sous-répertoire public (celui de l’application Laravel) et il ajoute également une deuxième application virtuelle au chemin /app2. Pour l’exécuter, créez un fichier nommé json.txt avec le contenu suivant.

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

Modifiez <group-name> et <app-name> pour vos ressources et exécutez la commande suivante. Tenez compte des caractères d’échappement lors de l’exécution de cette commande. Pour plus d’informations sur les caractères d’échappement, consultez Conseils pour l’utilisation réussie d’Azure CLI.

az resource update --resource-group <group-name> --resource-type Microsoft.Web/sites/config --name <app-name>/config/web --set properties.virtualApplications="@json.txt"

Azure PowerShell

L’exemple suivant définit le chemin racine / sur le sous-répertoire public (celui de l’application Laravel) et il ajoute également une deuxième application virtuelle au chemin /app2. Pour l’exécuter, modifiez <group-name> et <app-name>.

$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Set default / path to public subdirectory
$webapp.SiteConfig.VirtualApplications[0].PhysicalPath= "site\wwwroot\public"

# Add a virtual application
$virtualApp = New-Object Microsoft.Azure.Management.WebSites.Models.VirtualApplication
$virtualApp.VirtualPath = "/app2"
$virtualApp.PhysicalPath = "site\wwwroot\app2"
$virtualApp.PreloadEnabled = $false
$webapp.SiteConfig.VirtualApplications.Add($virtualApp)

# Save settings
Set-AzWebApp $webapp

Configurer les mappages de gestionnaire

Pour les applications Windows, vous pouvez personnaliser les mappages de gestionnaire IIS ainsi que les applications et répertoires virtuels. Les mappages de gestionnaire vous permettent d’ajouter des processeurs de script personnalisés pour gérer les requêtes portant sur des extensions de fichiers spécifiques.

Pour ajouter un gestionnaire personnalisé :

1. Dans le portail Azure, recherchez et sélectionnez App Services, puis sélectionnez votre application.

2. Dans le menu de gauche, sélectionnez Configuration>Mappages de chemin d’accès.

   

3. Sélectionnez Nouveau mappage de gestionnaire. Configurez le gestionnaire comme suit :

   • Extension. Extension de fichier à gérer, par exemple *.php ou handler.fcgi.
   • Processeur de script. Chemin d'accès absolu du processeur de script vers vous. Les requêtes de fichiers qui correspondent à l'extension de fichier sont traitées par le processeur de script. Utilisez le chemin D:\home\site\wwwroot pour faire référence au répertoire racine de votre application Web.
   • Arguments. Arguments de ligne de commande facultatifs pour le processeur de script.

4. Cliquez sur OK. N'oubliez pas de sélectionnez Enregistrer dans la page Configuration.

Configurer des conteneurs personnalisés

• Configurer un conteneur personnalisé pour Azure App Service
• Ajouter du stockage personnalisé pour votre application conteneurisée

Étapes suivantes

• Informations de référence sur les variables d’environnement et les paramètres d’application
• Configuration d’un nom de domaine personnalisé dans Azure App Service
• Configurer des environnements intermédiaires dans Azure App Service
• Sécuriser un nom DNS personnalisé avec une liaison TLS/SSL dans Azure App Service
• Activer les journaux de diagnostic
• Mettre à l’échelle une application dans Azure App Service
• Concepts de base de la supervision dans Azure App Service
• Modifier les paramètres applicationHost.config avec applicationHost.xdt