Configurer une application App Service

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.

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>,...}

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>,...

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
  },
  ...
]

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"

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

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

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.

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>,...}

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>,...

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
  },
  ...
]

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"

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

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

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.

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.

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.

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.

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>

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

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.

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"

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