Configurer une application App Service

Cet article explique comment configurer des paramètres courants pour les applications web, un back-end mobile ou 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

Dans Azure App Service, les paramètres d’application sont des variables passées en tant que variables d’environnement au code de l’application. Les conditions suivantes s’appliquent aux paramètres de l’application :

• 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 pour Linux avec la valeur "pa$$w0rd\", la chaîne du paramètre d’application doit être "pa\$\$w0rd\\".

Pour les applications Linux et les conteneurs personnalisés, App Service transmet les paramètres d’application au conteneur à l’aide de 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.

Pour les développeurs ASP.NET et ASP.NET Core, configurer les paramètres de l'application dans App Service, c'est comme les configurer dans <appSettings>, Web.config ou appsettings.json. Les valeurs dans App Service remplacent celles dans Web.config ou appsettings.json. Vous pouvez conserver les paramètres de développement, tels que le mot de passe MySQL local, dans Web.config ou appsettings.json. Vous pouvez conserver des secrets de production, tels que le mot de passe de base de données Azure MySQL, en toute sécurité dans App Service. Le même code utilise vos paramètres de développement lorsque vous déboguez localement. Il utilise vos secrets de production lorsque vous le déployez sur Azure.

D’autres piles de langage obtiennent les paramètres de l’application en tant que variables d’environnement au moment de l’exécution. Pour connaître les étapes spécifiques à chaque pile de langues, consultez :

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

Les paramètres d’application sont toujours chiffrés lorsqu’ils sont stockés (chiffrés au repos).

Remarque

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

portail Azure

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 Paramètres>Variables d’environnement. Sélectionnez ensuite les 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 afficher une valeur masquée d’un paramètre d’application, sous Valeur, sélectionnez Afficher la valeur. Pour afficher les valeurs masquées de tous les paramètres d’application, sélectionnez Afficher les valeurs.

   Remarque

   Les autorisations utilisateur en lecture/écriture sont requises pour afficher cette section dans le portail Azure. Les rôles intégrés RBAC disposant d’autorisations suffisantes sont Propriétaire, Contributeur et Contributeur de site web. Le rôle Lecteur seul n’est pas autorisé à accéder à cette page.

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

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é, toute structure de clé JSON imbriquée dans le nom du paramètre d’application doit être configurée différemment pour le nom de la clé. Remplacez n’importe quel signe deux-points (:) par un trait de soulignement double (__). Remplacez tout point (.) par un trait de soulignement (_). Par exemple, ApplicationInsights:InstrumentationKey doit être configuré dans App Service comme ApplicationInsights__InstrumentationKey pour le nom de clé.

5. Ensuite, cliquez sur Appliquer. Sélectionnez Ensuite Appliquer dans la page Variables d’environnement .

Azure CLI

Ajoutez ou modifiez un paramètre d’application à l’aide d’az webapp config app settings set :

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

Remplacez <setting-name> par le nom du paramètre. Remplacez <value> par la valeur à affecter au paramètre.

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

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

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

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

Azure PowerShell

Définissez un ou plusieurs paramètres d’application à l’aide de Set-AzWebApp :

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

Cette applet de commande remplace l’ensemble entier 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 table de hachage 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 hash table
$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 spécifique à un emplacement, utilisez Get-AzWebAppSlotConfigName :

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

Pour rendre une ou plusieurs configurations de paramètres d'application spécifiques à 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

portail Azure

1. Sélectionnez Modification avancée.
2. Modifiez les paramètres dans la zone de texte.
3. Lorsque vous avez terminé, sélectionnez OK. Sélectionnez Ensuite 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 avec le nom du fichier JSON :

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

Conseil

L’habillage du nom de fichier avec des guillemets n’est requis que dans PowerShell.

Le format de fichier nécessaire est un tableau JSON de paramètres dans lequel le champ de 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 liste az webapp config appsettings.

# Save the settings
az webapp config appsettings list --resource-group <group-name> --name <app-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

Cette section explique comment configurer des chaînes de connexion.

Remarque

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

Pour les développeurs ASP.NET et ASP.NET Core, la définition de chaînes de connexion dans App Service ressemble à les définir dans <connectionStrings>Web.config. Les valeurs que vous définissez dans App Service remplacent celles dans Web.config. Vous pouvez conserver les paramètres de développement, tels qu’un fichier de base de données, dans Web.config. Vous pouvez conserver des secrets de production, tels que les informations d’identification de base de données SQL, en toute sécurité dans App Service. Le même code utilise vos paramètres de développement lorsque vous déboguez localement. Il utilise vos secrets de production lorsque vous le déployez sur Azure.

Pour les autres piles de langage, il est préférable d’utiliser les paramètres de l’application à la place. Les chaînes de connexion nécessitent une mise en forme spéciale dans les clés de variable pour accéder aux valeurs.

Il existe un cas où vous souhaiterez peut-être utiliser des chaînes de connexion au lieu des paramètres d’application pour les langues non-.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 :

• SQL Server : SQLCONNSTR_
• MySQL : MYSQLCONNSTR_
• Azure SQL : SQLAZURECONNSTR_
• Personnalisé : CUSTOMCONNSTR_
• PostgreSQL : POSTGRESQLCONNSTR_
• Azure Notification Hubs : NOTIFICATIONHUBCONNSTR_
• Azure Service Bus : SERVICEBUSCONNSTR_
• Azure Event Hubs : EVENTHUBCONNSTR_
• Azure Cosmos DB : DOCDBCONNSTR_
• Cache Redis : REDISCACHECONNSTR_

Remarque

Les applications .NET qui ciblent PostgreSQL, Notification Hubs, Service Bus, Event Hubs, Azure Cosmos DB et le cache Redis doivent définir la chaîne de connexion sur Custom comme solution de contournement pour 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 connaître les étapes spécifiques à chaque pile de langues, consultez :

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

Les chaînes de connexion sont toujours chiffrées lorsqu’elles sont stockées (chiffrées au repos).

Remarque

Vous pouvez également résoudre les chaînes de connexion à partir de Key Vault à l’aide de références Key Vault.

portail Azure

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 Paramètres>Variables d’environnement. Sélectionnez ensuite 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 afficher une valeur masquée d’une chaîne de connexion, sous Valeur, sélectionnez Afficher la valeur. Pour afficher les valeurs masquées de toutes les chaînes de connexion, sélectionnez Afficher les valeurs.

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. Ensuite, cliquez sur Appliquer. Sélectionnez Ensuite Appliquer dans la page Variables d’environnement .

Azure CLI

Ajoutez ou modifiez un paramètre d'application à l'aide de az webapp config connection-string set :

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

Remplacez <string-name> par le nom de la chaîne de connexion. Remplacez <value> par la valeur à affecter à la chaîne de connexion. Pour les valeurs possibles de <type> telles que SQLAzure, consultez la documentation de la commande CLI.

Afficher toutes les chaînes de connexion et leurs valeurs à l’aide d’az webapp config connection-string list :

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

Supprimez une ou plusieurs chaînes de connexion à l’aide d’az webapp config connection-string delete :

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

Azure PowerShell

Définissez une ou plusieurs chaînes de connexion à l’aide de 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. Le type est une valeur numérique qui correspond à l’un des champs d’énumérateur ConnectionStringType . Par exemple, pour Azure SQL, spécifiez type="2".

Cette applet de commande remplace l’ensemble entier 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 table de hachage 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 hash table
$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 spécifique à un emplacement, utilisez Get-AzWebAppSlotConfigName :

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

Pour rendre un ou plusieurs emplacements de chaînes de connexion spécifiques, utilisez Set-AzWebAppSlotConfigName :

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

Modifier des chaînes de connexion en bloc

portail Azure

1. Sélectionnez Modification avancée.
2. Modifiez les chaînes de connexion dans la zone de texte.
3. Ensuite, cliquez sur 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 avec le nom du fichier JSON :

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

Conseil

L’habillage du nom de fichier avec des guillemets n’est requis que dans PowerShell.

Le format de fichier nécessaire est un tableau JSON de chaînes de connexion où le champ de 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 des chaînes de connexion existantes dans un fichier JSON à l’aide d’az webapp config connection-string list.

# 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

Pour configurer les paramètres de la pile linguistique, consultez les ressources suivantes :

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

Configurer les paramètres généraux

Pour configurer les paramètres généraux, suivez les étapes de vos outils préférés.

portail Azure

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 des paramètres>. Ensuite, sélectionnez 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 pile : configurez les paramètres de la pile logicielle pour exécuter l’application, y compris la langue et les versions du SDK.

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

• Paramètres de la plateforme : Configurez les paramètres de la plateforme d’hébergement, notamment :

  • Plateforme : choisissez 32 bits ou 64 bits. Pour applications Windows uniquement.

  • État FTP : autorisez uniquement FTPS ou désactivez complètement FTP.

  • Version HTTP : définissez sur 2.0 pour activer la prise en charge du protocole HTTPS/2 .

    Remarque

    La plupart des navigateurs modernes prennent uniquement en charge le protocole HTTP/2 sur TLS. 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 Fournir une sécurité pour un nom DNS personnalisé avec une liaison TLS/SSL dans App Service.

  • Web sockets : Configurez pour ASP.NET SignalR ou socket.io, par exemple.

  • Always On : activez si vous souhaitez conserver l’application chargée même s’il n’y a pas de trafic.

    Lorsque Always On est désactivé (par défaut), l’application est déchargée après 20 minutes sans aucune demande entrante. 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 Always On est activé, l’équilibreur de charge frontal envoie une GET requête à la racine de l’application toutes les cinq minutes. La commande ping continue empêche le déchargement de l’application.

    Always On est requis pour les WebJobs continus ou pour les WebJobs qu’une expression cron déclenche.

  • Affinité de session : dans un déploiement à plusieurs instances, assurez-vous que le client est acheminé vers la même instance pour la durée de vie de la session. Vous pouvez définir cette option sur Off (Désactivée) pour les applications sans état.

  • Proxy d’affinité de session : activez 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é à partir du proxy inverse.

  • HTTPS uniquement : activez si vous souhaitez rediriger tout le trafic HTTP vers HTTPS.

  • Version TLS minimale : sélectionnez la version minimale de chiffrement TLS 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 : exiger des certificats clients dans l’authentification mutuelle.

Azure CLI

Vous pouvez définir de nombreuses options configurables courantes à l’aide du az webapp config set. L’exemple suivant montre un sous-ensemble 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 de nombreuses options configurables courantes à l’aide de Set-AzWebApp. L’exemple suivant montre un sous-ensemble 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

Le document par défaut est la page web qui apparaît à 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.

Le paramètre de configuration des documents par défaut est uniquement destiné aux applications Windows.

portail Azure

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. Sélectionnez ensuite les 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.

La fonctionnalité de mappage d’un répertoire virtuel à un chemin d’accès physique est disponible uniquement sur les applications Windows.

portail Azure

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 des paramètres>. Ensuite, sélectionnez mappages de chemin.

3. Sélectionnez Nouvelle application virtuelle ou nouveau répertoire virtuel. Effectuez ensuite l’une des actions suivantes :

   • Pour mapper un répertoire virtuel à un chemin d’accès physique, laissez Le répertoire sélectionné. 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ésélectionnez Répertoire.

   

4. Sélectionnez OK. Sélectionnez Ensuite Enregistrer dans la page Configuration .

Azure CLI

L’exemple suivant définit le chemin racine / vers le sous-répertoire public, qui fonctionne pour Laravel. Il ajoute également une deuxième application virtuelle au chemin d’accès /app2 . Pour l’exécuter, créez un fichier appelé 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 lorsque vous exécutez 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 / vers le sous-répertoire public, qui fonctionne pour Laravel. Il ajoute également une deuxième application virtuelle au chemin d’accès /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 de l’application, sélectionnez Configuration des paramètres>. Ensuite, sélectionnez mappages de chemin.

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

   • d’extension . Extension de fichier que vous souhaitez gérer, telle que *.php ou handler.fcgi.
   • Processeur de script. Chemin d'accès absolu du processeur de script vers vous. Le processeur de script traite les demandes adressées aux fichiers qui correspondent à l’extension de fichier. 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. Sélectionnez OK. Sélectionnez Ensuite Enregistrer dans la page Configuration .

Configurer des conteneurs personnalisés

• Configurer un conteneur personnalisé pour Azure App Service
• Monter stockage Azure en tant que partage local dans App Service

Contenu connexe

• Variables d’environnement et paramètres d’application dans Azure App Service
• Configurer un domaine personnalisé existant dans Azure App Service
• Configurer des environnements intermédiaires dans Azure App Service
• Activer HTTPS pour un domaine personnalisé dans Azure App Service
• Activer la journalisation des diagnostics pour les applications dans Azure App Service
• Montez une application en puissance dans Azure App Service
• Quotas et alertes Azure App Service
• Modifier les paramètres applicationHost.config avec applicationHost.xdt