Configurar um aplicativo do Serviço de Aplicativo

1. No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.

   

2. No menu à esquerda do aplicativo, selecione Variáveis de ambiente>Configurações do aplicativo.

   

   Por padrão e visando a segurança, os valores das configurações do aplicativo ficam ocultos no portal. Para ver um valor oculto de uma configuração de aplicativo, selecione o campo Valor. Para ver os valores ocultos de todas as configurações do aplicativo, selecione o botão Mostrar valores.

3. Para adicionar uma nova configuração de aplicativo, selecione Adicionar. Para editar uma configuração, clique nela.

4. Na caixa de diálogo, você pode fixar a configuração no slot atual.

   Observação

   Em um serviço de aplicativo padrão ou um contêiner personalizado do Linux, qualquer estrutura de chave JSON aninhada no nome da configuração do aplicativo como ApplicationInsights:InstrumentationKey precisa ser configurada no Serviço de Aplicativo como ApplicationInsights__InstrumentationKey para o nome da chave. Em outras palavras, qualquer : deve ser substituído por __ (sublinhado duplo). Todos os períodos no nome da configuração do aplicativo serão substituídos por um _ (sublinhado único).

5. Quando terminar, selecione Aplicar. Não se esqueça de selecionar Aplicar na página Variáveis de ambiente.

Adicione ou edite uma configuração de aplicativo com az webapp config app settings set:

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

Substitua <setting-name> pelo nome da configuração e <value> pelo valor que será atribuído a ela.

Mostre todas as configurações e seus valores com az webapp config appsettings list:

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

Remova uma ou mais configurações com az webapp config app settings delete:

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

Defina uma ou mais configurações de aplicativo com Set-AzWebApp:

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

Esse cmdlet substitui todo o conjunto de configurações de aplicativo por aquelas que você especificar. Para adicionar ou editar uma configuração de aplicativo em um conjunto existente, inclua as configurações de aplicativo existentes em sua tabela de hash de entrada usando o cmdlet Get-AzWebApp. Por exemplo:

# 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

Para verificar se uma configuração de aplicativo é específica a um slot, use Get-AzWebAppSlotConfigName:

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

Para tornar uma ou mais configurações de aplicativo específicas a um slot, use Set-AzWebAppSlotConfigName:

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

Selecione o botão Edição avançada. Edite as configurações na área de texto. Ao terminar, selecione OK. Não se esqueça de selecionar Aplicar na página Variáveis de ambiente.

As configurações do aplicativo têm a seguinte formatação JSON:

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

Execute az webapp config app settings set com o nome do arquivo JSON.

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

O formato de arquivo necessário é uma matriz JSON de configurações, em que o campo de configuração de slot é opcional. Por exemplo:

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

Para sua conveniência, você pode salvar as configurações existentes em um arquivo JSON com az webapp config appsettings list. O exemplo a seguir pode ser executado no 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

Não é possível editar as configurações do aplicativo em massa usando um arquivo JSON com o Azure PowerShell.

1. No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.

   

2. No menu à esquerda do aplicativo, selecione Variáveis de ambiente>Cadeias de conexão.

   

   Por padrão e visando a segurança, os valores das cadeias de conexão ficam ocultas no portal. Para ver um valor oculto de uma cadeia de conexão, selecione o campo Valor. Para ver os valores ocultos de todas as cadeias de conexão, selecione o botão Mostrar valor.

3. Para adicionar uma nova cadeia de conexão, selecione Adicionar. Para editar uma cadeia de conexão, selecione a cadeia de conexão.

4. Na caixa de diálogo, você pode fixar a cadeia de conexão no slot atual.

5. Quando terminar, selecione Aplicar. Não se esqueça de selecionar Aplicar na página Variáveis de ambiente.

Adicione ou edite uma configuração de aplicativo com 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>'

Substitua <string-name> pelo nome da cadeia de conexão e <value> pelo valor que será atribuído a ela. Para ver os valores possíveis <type> de (por exemplo, SQLAzure), confira a documentação do comando da CLI.

Mostre todas as cadeias de conexão e os respectivos valores com az webapp config connection-string list:

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

Remova uma ou mais cadeias de conexão com 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>,...}

Defina uma ou mais cadeias de conexão com 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

Cada cadeia de conexão contém um nome (<string-name1>), um valor (<connection-string1>) e o tipo, que é um valor numérico que corresponde a um dos campos de enumeração ConnectionStringType. Por exemplo, para o SQL do Azure, especifique type="2".

Esse cmdlet substituirá todo o conjunto de cadeias de conexão por aquelas que você especificar. Para adicionar ou editar uma configuração de aplicativo em um conjunto existente, inclua as configurações de aplicativo existentes em sua tabela de hash de entrada usando o cmdlet Get-AzWebApp. Por exemplo:

# 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

Para verificar se uma cadeia de conexão é específica a um slot, use Get-AzWebAppSlotConfigName:

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

Para tornar uma ou mais cadeias de conexão específicas a um slot, use Set-AzWebAppSlotConfigName:

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

Selecione o botão Edição avançada. Editar cadeias de conexão na área de texto. Quando terminar, selecione Aplicar. Não se esqueça de selecionar Aplicar na página Variáveis de ambiente.

As cadeias de conexão têm a seguinte formatação JSON:

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

Execute az webapp config connection-string set com o nome do arquivo JSON.

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

O formato de arquivo necessário é uma matriz JSON de cadeias de conexão, em que o campo de configuração de slot é opcional. Por exemplo:

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

Para sua conveniência, você pode salvar cadeias de conexão existentes em um arquivo JSON com az webapp config connection-string list. O exemplo a seguir pode ser executado no 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

Não é possível editar as cadeias de conexão em massa usando um arquivo JSON com o Azure PowerShell.

No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo. No menu à esquerda do aplicativo, selecione Configuração>Configurações gerais.

Aqui, você pode definir algumas configurações comuns do aplicativo. Algumas configurações exigem Escalar verticalmente para os tipos de preço mais altos.

• Configurações de pilha: a pilha do software para executar o aplicativo, incluindo as versões de linguagem e SDK.

  Para aplicativos do Linux, é possível selecionar a versão de runtime da linguagem e definir um Comando de inicialização opcional ou um arquivo de comando de inicialização.

  

• Configurações de plataforma: permite que você defina as configurações da plataforma de hospedagem, incluindo:

  • Bitness da plataforma: 32 bits ou 64 bits. Somente aplicativos do Windows.
  • Estado FTP: permita apenas FTPS ou desabilite totalmente o FTP.
  • Versão HTTP: defina como 2.0 para habilitar o suporte para o protocolo HTTPS/2.

  Observação

  A maioria dos navegadores modernos dá suporte para protocolo HTTP/2 somente em TLS, enquanto o tráfego não criptografado continua usando HTTP / 1.1. Para garantir que os navegadores cliente se conectem ao seu aplicativo com HTTP/2, proteja seu nome DNS personalizado. Para obter mais informações, confira Proteger um nome DNS personalizado com uma associação TLS/SSL no Serviço de Aplicativo do Azure.

  • Soquetes Web: por exemplo para ASP.NET SignalR ou socket.io.

  • Always On: mantém o aplicativo carregado mesmo quando não há tráfego. Quando Always On estiver desligado (padrão), o aplicativo é descarregado após 20 minutos sem solicitações de entrada. O aplicativo descarregado pode causar alta latência para novas solicitações devido ao tempo de aquecimento. Quando Always On está ligado, o balanceador de carga de front-end envia uma solicitação GET para a raiz do aplicativo a cada cinco minutos. É importante garantir que essa solicitação receba uma resposta 200 OK para garantir que todas as operações de recriação de imagem sejam executadas corretamente. O ping contínuo impede que o aplicativo seja descarregado.

    O Always On é necessário para WebJobs contínuos ou que são disparados usando uma expressão CRON.

  • Afinidade de sessão: em uma implantação de várias instâncias, verifique se o cliente é roteado para a mesma instância durante a vida útil da sessão. Você pode definir essa opção como Desligado para aplicativos sem estado.

  • Proxy de afinidade de sessão: o proxy de afinidade de sessão pode ser ativado se o aplicativo estiver por trás de um proxy reverso (como o Gateway de Aplicativo do Azure ou o Azure Front Door) e você estiver usando o nome do host padrão. O domínio do cookie de afinidade de sessão será alinhado com o nome do host encaminhado do proxy reverso.

  • Somente HTTPS: quando habilitado, todo o tráfego HTTP é redirecionado para HTTPS.

  • Versão mínima do TLS: selecione a versão mínima de criptografia TLS exigida pelo seu aplicativo.

• Depuração: habilite a depuração remota para aplicativos ASP.NET, ASP.NET Core ou Node.js. Esta opção é desativada automaticamente depois de 48 horas.

• Certificados de cliente de entrada: requer certificados de cliente na autenticação mútua.

Você pode definir muitas das opções configuráveis comuns usando az webapp config set. O exemplo a seguir mostra um subconjunto das opções configuráveis.

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

Para mostrar as configurações existentes, use o comando az webapp config show.

Você pode definir muitas das opções configuráveis comuns usando Set-AzWebApp. O exemplo a seguir mostra um subconjunto das opções configuráveis.

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

Para mostrar as configurações existentes, use o comando Get-AzWebApp.

1. No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.

2. No menu à esquerda do aplicativo, selecione Configuração>Documentos padrão.

   

3. Para adicionar um documento padrão, selecione Novo documento. Para remover um documento padrão, selecione Excluir à direita dele.

Adicione um documento padrão usando 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>

Adicione um documento padrão modificando o objeto do PowerShell do aplicativo de atualização:

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

1. No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.

2. No menu à esquerda do aplicativo, selecione Configuração>Mapeamentos de caminho

3. Selecione Novo aplicativo ou diretório virtual.

   • Para mapear um diretório virtual para um caminho físico, marque a caixa de seleção Diretório. Especifique o diretório virtual e o caminho relativo (físico) correspondente para a raiz do site (D:\home).
   • Para marcar um diretório virtual como um aplicativo Web, desmarque a caixa de seleção Diretório.

   

4. Selecione OK. Não se esqueça de selecionar Salvar na página Configuração.

O exemplo a seguir define o caminho raiz / para o subdiretório public (que funciona para Laravel) e também adiciona um segundo aplicativo virtual no caminho /app2. Para executá-lo, crie um arquivo chamado json.txt com o conteúdo a seguir.

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

Altere <group-name> e <app-name> dos recursos e execute o comando a seguir. Esteja ciente dos caracteres de escape ao executar este comando. Para obter mais informações sobre os caracteres de escape, consulte Dicas para usar a CLI do Azure com êxito.

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

O exemplo a seguir define o caminho raiz / para o subdiretório public (que funciona para Laravel) e também adiciona um segundo aplicativo virtual no caminho /app2. Para executá-lo, altere <group-name> e <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