Configurar um aplicativo do serviço de aplicativo no portal do AzureConfigure an App Service app in the Azure portal

Este artigo explica como definir configurações comuns para aplicativos Web, back-end móvel ou aplicativo de API usando o portal do Azure.This article explains how to configure common settings for web apps, mobile back end, or API app using the Azure portal.

Definir configurações de aplicativoConfigure app settings

No serviço de aplicativo, as configurações de aplicativo são variáveis passadas como variáveis de ambiente para o código do aplicativo.In App Service, app settings are variables passed as environment variables to the application code. Para aplicativos Linux e contêineres personalizados, o serviço de aplicativo passa configurações de aplicativo para o contêiner usando o --env sinalizador para definir a variável de ambiente no contêiner.For Linux apps and custom containers, App Service passes app settings to the container using the --env flag to set the environment variable in the container.

No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.In the Azure portal, search for and select App Services, and then select your app.

Pesquisar serviços de aplicativos

No menu à esquerda do aplicativo, selecione > configurações do aplicativo de configuração.In the app's left menu, select Configuration > Application settings.

Configurações do aplicativo

Para os desenvolvedores de ASP.NET e ASP.NET Core, definir configurações de aplicativo no serviço de aplicativo é como configurá-los em <appSettings> Web.config ou appsettings.jsem, mas os valores no serviço de aplicativo substituem aqueles em Web.config ou appsettings.jsem.For ASP.NET and ASP.NET Core developers, setting app settings in App Service are like setting them in <appSettings> in Web.config or appsettings.json, but the values in App Service override the ones in Web.config or appsettings.json. Você pode manter as configurações de desenvolvimento (por exemplo, a senha do MySQL local) em Web.config ouappsettings.jsos segredos de produção e do Azure (por exemplo, a senha do banco de dados MySQL) com segurança no serviço de aplicativo.You can keep development settings (for example, local MySQL password) in Web.config or appsettings.json and production secrets (for example, Azure MySQL database password) safely in App Service. O mesmo código usa suas configurações de desenvolvimento quando você depura localmente e usa seus segredos de produção quando implantado no Azure.The same code uses your development settings when you debug locally, and it uses your production secrets when deployed to Azure.

Outras pilhas de idiomas, da mesma forma, obtêm as configurações do aplicativo como variáveis de ambiente no tempo de execução.Other language stacks, likewise, get the app settings as environment variables at runtime. Para obter as etapas específicas da pilha de idiomas, consulte:For language-stack specific steps, see:

As configurações do aplicativo são sempre criptografadas quando armazenadas (criptografadas em repouso).App settings are always encrypted when stored (encrypted-at-rest).

Observação

As configurações do aplicativo também podem ser resolvidas de Key Vault usando referências Key Vault.App settings can also be resolved from Key Vault using Key Vault references.

Mostrar valores ocultosShow hidden values

Por padrão, os valores para as configurações do aplicativo ficam ocultos no portal para segurança.By default, values for app settings are hidden in the portal for security. Para ver um valor oculto de uma configuração de aplicativo, clique no campo valor dessa configuração.To see a hidden value of an app setting, click the Value field of that setting. Para ver os valores de todas as configurações de aplicativo, clique no botão Mostrar valor .To see the values of all app settings, click the Show value button.

Adicionar ou editarAdd or edit

Para adicionar uma nova configuração de aplicativo, clique em nova configuração de aplicativo.To add a new app setting, click New application setting. Na caixa de diálogo, você pode fixar a configuração no slot atual.In the dialog, you can stick the setting to the current slot.

Para editar uma configuração, clique no botão Editar no lado direito.To edit a setting, click the Edit button on the right side.

Quando terminar, clique em Atualizar.When finished, click Update. Não se esqueça de clicar em salvar de volta na página de configuração .Don't forget to click Save back in the Configuration page.

Observação

Em um contêiner do Linux 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.In a default Linux container or a custom Linux container, any nested JSON key structure in the app setting name like ApplicationInsights:InstrumentationKey needs to be configured in App Service as ApplicationInsights__InstrumentationKey for the key name. Em outras palavras, qualquer um : deve ser substituído por __ (sublinhado duplo).In other words, any : should be replaced by __ (double underscore).

Editar em massaEdit in bulk

Para adicionar ou editar as configurações do aplicativo em massa, clique no botão de edição avançado .To add or edit app settings in bulk, click the Advanced edit button. Quando terminar, clique em Atualizar.When finished, click Update. Não se esqueça de clicar em salvar de volta na página de configuração .Don't forget to click Save back in the Configuration page.

As configurações do aplicativo têm a seguinte formatação JSON:App settings have the following JSON formatting:

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

Automatize as configurações do aplicativo com o CLI do AzureAutomate app settings with the Azure CLI

Você pode usar o CLI do Azure para criar e gerenciar configurações na linha de comando.You can use the Azure CLI to create and manage settings from the command line.

  • Atribua um valor a uma configuração com AZ webapp config app Settings Set:Assign a value to a setting with az webapp config app settings set:

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

    Substitua <setting-name> pelo nome da configuração e <value> pelo valor a ser atribuído a ela.Replace <setting-name> with the name of the setting, and <value> with the value to assign to it. Esse comando criará a configuração se ela ainda não existir.This command creates the setting if it doesn't already exist.

  • Mostre todas as configurações e seus valores com AZ webapp config appSettings List:Show all settings and their values with az webapp config appsettings list:

    az webapp config appsettings list --name <app-name> --resource-group <resource-group-name>
    
  • Remova uma ou mais configurações com AZ webapp config app Settings Delete:Remove one or more settings with az webapp config app settings delete:

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

    Substitua <names> por uma lista separada por espaços de nomes de configuração.Replace <names> with a space-separated list of setting names.

Configurar cadeias de conexãoConfigure connection strings

No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.In the Azure portal, search for and select App Services, and then select your app. No menu à esquerda do aplicativo, selecione > configurações do aplicativo de configuração.In the app's left menu, select Configuration > Application settings.

Configurações do aplicativo

Para desenvolvedores de ASP.NET e ASP.NET Core, definir cadeias de conexão no serviço de aplicativo é como configurá-los em <connectionStrings> no Web.config, mas os valores definidos no serviço de aplicativo substituem aqueles em Web.config. Você pode manter as configurações de desenvolvimento (por exemplo, um arquivo de banco de dados) em Web.config e os segredos de produção (por exemplo, credenciais do banco de dados SQL) com segurança no serviço de aplicativo.For ASP.NET and ASP.NET Core developers, setting connection strings in App Service are like setting them in <connectionStrings> in Web.config, but the values you set in App Service override the ones in Web.config. You can keep development settings (for example, a database file) in Web.config and production secrets (for example, SQL Database credentials) safely in App Service. O mesmo código usa suas configurações de desenvolvimento quando você depura localmente e usa seus segredos de produção quando implantado no Azure.The same code uses your development settings when you debug locally, and it uses your production secrets when deployed to Azure.

Para outras pilhas de idiomas, é melhor usar as configurações do aplicativo , pois as cadeias de conexão exigem formatação especial nas chaves variáveis para acessar os valores.For other language stacks, it's better to use app settings instead, because connection strings require special formatting in the variable keys in order to access the values.

Observação

Há um caso em que você talvez queira usar cadeias de conexão em vez de configurações do aplicativo para idiomas non-.NET: certos tipos de banco de dados do Azure são submetidos a backup junto com o aplicativo somente se você configurar uma cadeia de conexão para o banco de dados em seu aplicativo do serviço de aplicativo.There is one case where you may want to use connection strings instead of app settings for non-.NET languages: certain Azure database types are backed up along with the app only if you configure a connection string for the database in your App Service app. Para obter mais informações, consulte o que é feitobackup.For more information, see What gets backed up. Se você não precisar desse backup automatizado, use as configurações do aplicativo.If you don't need this automated backup, then use app settings.

Em tempo de execução, as cadeias de conexão estão disponíveis como variáveis de ambiente, prefixadas com os seguintes tipos de conexão:At runtime, connection strings are available as environment variables, prefixed with the following connection types:

  • SqlServer SQLCONNSTR_SQLServer: SQLCONNSTR_
  • MySQL: MYSQLCONNSTR_MySQL: MYSQLCONNSTR_
  • SQLAzure SQLAZURECONNSTR_SQLAzure: SQLAZURECONNSTR_
  • Personalizado: CUSTOMCONNSTR_Custom: CUSTOMCONNSTR_
  • PostgreSQL POSTGRESQLCONNSTR_PostgreSQL: POSTGRESQLCONNSTR_

Por exemplo, uma cadeia de conexão do MySql chamada connectionstring1 pode ser acessada como a variável de ambiente MYSQLCONNSTR_connectionString1 .For example, a MySql connection string named connectionstring1 can be accessed as the environment variable MYSQLCONNSTR_connectionString1. Para obter as etapas específicas da pilha de idiomas, consulte:For language-stack specific steps, see:

As cadeias de conexão são sempre criptografadas quando armazenadas (criptografadas em repouso).Connection strings are always encrypted when stored (encrypted-at-rest).

Observação

As cadeias de conexão também podem ser resolvidas de Key Vault usando referências Key Vault.Connection strings can also be resolved from Key Vault using Key Vault references.

Mostrar valores ocultosShow hidden values

Por padrão, os valores para cadeias de conexão ficam ocultos no portal para segurança.By default, values for connection strings are hidden in the portal for security. Para ver um valor oculto de uma cadeia de conexão, basta clicar no campo valor dessa cadeia de caracteres.To see a hidden value of a connection string, just click the Value field of that string. Para ver os valores de todas as cadeias de conexão, clique no botão Mostrar valor .To see the values of all connection strings, click the Show value button.

Adicionar ou editarAdd or edit

Para adicionar uma nova cadeia de conexão, clique em nova cadeia de conexão.To add a new connection string, click New connection string. Na caixa de diálogo, você pode colocar a cadeia de conexão no slot atual.In the dialog, you can stick the connection string to the current slot.

Para editar uma configuração, clique no botão Editar no lado direito.To edit a setting, click the Edit button on the right side.

Quando terminar, clique em Atualizar.When finished, click Update. Não se esqueça de clicar em salvar de volta na página de configuração .Don't forget to click Save back in the Configuration page.

Editar em massaEdit in bulk

Para adicionar ou editar cadeias de conexão em massa, clique no botão de edição avançado .To add or edit connection strings in bulk, click the Advanced edit button. Quando terminar, clique em Atualizar.When finished, click Update. Não se esqueça de clicar em salvar de volta na página de configuração .Don't forget to click Save back in the Configuration page.

As cadeias de conexão têm a seguinte formatação JSON:Connection strings have the following JSON formatting:

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

Definir as configurações geraisConfigure general settings

No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.In the Azure portal, search for and select App Services, and then select your app. No menu à esquerda do aplicativo, selecione configuração > geral configurações.In the app's left menu, select Configuration > General settings.

Configurações gerais

Aqui, você pode definir algumas configurações comuns para o aplicativo.Here, you can configure some common settings for the app. Algumas configurações exigem que você Escale verticalmente para os tipos de preço mais altos.Some settings require you to scale up to higher pricing tiers.

  • Configurações de pilha: a pilha de software para executar o aplicativo, incluindo as versões de idioma e SDK.Stack settings: The software stack to run the app, including the language and SDK versions.

    Para aplicativos do Linux e aplicativos de contêiner personalizados, você pode selecionar a versão do Language Runtime e definir um comando de inicialização opcional ou um arquivo de comando de inicialização.For Linux apps and custom container apps, you can select the language runtime version and set an optional Startup command or a startup command file.

    Configurações gerais para contêineres do Linux

  • Configurações de plataforma: permite que você defina as configurações para a plataforma de hospedagem, incluindo:Platform settings: Lets you configure settings for the hosting platform, including:

    • Bit de bits: 32 bits ou 64 bits.Bitness: 32-bit or 64-bit.
    • Protocolo WebSocket: para ASP.net signalr ou Socket.Io, por exemplo.WebSocket protocol: For ASP.NET SignalR or socket.io, for example.
    • Always on: mantém o aplicativo carregado mesmo quando não há tráfego.Always On: Keeps the app loaded even when there's no traffic. Ele é necessário para trabalhos Web contínuos ou para trabalhos Web que são disparados usando uma expressão CRON.It's required for continuous WebJobs or for WebJobs that are triggered using a CRON expression.

      Observação

      Com o recurso Always On, o balanceador de carga de front-end envia uma solicitação para a raiz do aplicativo.With the Always On feature, the front end load balancer sends a request to the application root. Este ponto de extremidade do aplicativo do serviço de aplicativo não pode ser configurado.This application endpoint of the App Service can't be configured.

    • Versão do pipeline gerenciado: o modo de pipelinedo IIS.Managed pipeline version: The IIS pipeline mode. Defina-o como clássico se você tiver um aplicativo herdado que exija uma versão mais antiga do IIS.Set it to Classic if you have a legacy app that requires an older version of IIS.
    • Versão de http: defina como 2,0 para habilitar o suporte para o protocolo https/2 .HTTP version: Set to 2.0 to enable support for HTTPS/2 protocol.

    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.Most modern browsers support HTTP/2 protocol over TLS only, while non-encrypted traffic continues to use HTTP/1.1. Para garantir que os navegadores cliente se conectem ao seu aplicativo com HTTP/2, proteja seu nome DNS personalizado.To ensure that client browsers connect to your app with HTTP/2, secure your custom DNS name. Para obter mais informações, consulte proteger um nome DNS personalizado com uma associação TLS/SSL no serviço Azure app.For more information, see Secure a custom DNS name with a TLS/SSL binding in Azure App Service.

    • Afinidade de arr: 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.ARR affinity: In a multi-instance deployment, ensure that the client is routed to the same instance for the life of the session. Você pode definir essa opção como off para aplicativos sem estado.You can set this option to Off for stateless applications.
  • Depuração: habilite a depuração remota para aplicativos ASP.net, ASP.NET Coreou Node.js .Debugging: Enable remote debugging for ASP.NET, ASP.NET Core, or Node.js apps. Essa opção é desativada automaticamente após 48 horas.This option turns off automatically after 48 hours.

  • Certificados de cliente de entrada: requer certificados de cliente na autenticação mútua.Incoming client certificates: require client certificates in mutual authentication.

Configurar documentos padrãoConfigure default documents

Essa configuração é apenas para aplicativos do Windows.This setting is only for Windows apps.

No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.In the Azure portal, search for and select App Services, and then select your app. No menu à esquerda do aplicativo, selecione configuração > documentos padrão.In the app's left menu, select Configuration > Default documents.

Documentos padrão

O documento padrão é a página da Web que é exibida na URL raiz de um site.The default document is the web page that's displayed at the root URL for a website. O primeiro arquivo correspondente na lista é usado.The first matching file in the list is used. Para adicionar um novo documento padrão, clique em novo documento.To add a new default document, click New document. Não se esqueça de clicar em salvar.Don't forget to click Save.

Se o aplicativo usa módulos que roteiam com base na URL em vez de fornecer conteúdo estático, não há necessidade de documentos padrão.If the app uses modules that route based on URL instead of serving static content, there is no need for default documents.

Configurar mapeamentos de caminhoConfigure path mappings

No Azure portal, pesquise e selecione Serviços de Aplicativos e, em seguida, selecione o nome do seu aplicativo.In the Azure portal, search for and select App Services, and then select your app. No menu à esquerda do aplicativo, selecione > mapeamentos de caminho de configuração.In the app's left menu, select Configuration > Path mappings.

Mapeamentos de caminho

Observação

A guia mapeamentos de caminho pode exibir configurações específicas do sistema operacional que diferem do exemplo mostrado aqui.The Path mappings tab may display OS-specific settings that differ from the example shown here.

Aplicativos do Windows (não-contêinered)Windows apps (uncontainerized)

Para aplicativos do Windows, você pode personalizar os mapeamentos de manipulador do IIS e os diretórios e aplicativos virtuais.For Windows apps, you can customize the IIS handler mappings and virtual applications and directories.

Mapeamentos de manipulador permitem que você adicione processadores de script personalizados para manipular solicitações para extensões de arquivo específicas.Handler mappings let you add custom script processors to handle requests for specific file extensions. Para adicionar um manipulador personalizado, clique em novo mapeamento de manipulador.To add a custom handler, click New handler mapping. Configure o manipulador da seguinte maneira:Configure the handler as follows:

  • Extensão.Extension. A extensão de arquivo que você deseja manipular, como * . php ou Handler. fcgi.The file extension you want to handle, such as *.php or handler.fcgi.
  • Processador de script.Script processor. O caminho absoluto do processador de script para você.The absolute path of the script processor to you. As solicitações para arquivos que correspondem à extensão de arquivo são processadas pelo processador de script.Requests to files that match the file extension are processed by the script processor. Use o caminho D:\home\site\wwwroot para se referir ao diretório raiz do seu aplicativo.Use the path D:\home\site\wwwroot to refer to your app's root directory.
  • Argumentos.Arguments. Argumentos de linha de comando opcionais para o processador de script.Optional command-line arguments for the script processor.

Cada aplicativo tem o caminho raiz padrão ( / ) mapeado para D:\home\site\wwwroot , onde seu código é implantado por padrão.Each app has the default root path (/) mapped to D:\home\site\wwwroot, where your code is deployed by default. Se a raiz do aplicativo estiver em uma pasta diferente ou se o repositório tiver mais de um aplicativo, você poderá editar ou adicionar diretórios e aplicativos virtuais aqui.If your app root is in a different folder, or if your repository has more than one application, you can edit or add virtual applications and directories here.

Na guia mapeamentos de caminho , clique em novo aplicativo virtual ou diretório.From the Path mappings tab, click New virtual application or directory.

  • Para mapear um diretório virtual para um caminho físico, deixe a caixa de seleção diretório marcada.To map a virtual directory to a physical path, leave the Directory check box selected. Especifique o diretório virtual e o caminho relativo (físico) correspondente para a raiz do site ( D:\home ).Specify the virtual directory and the corresponding relative (physical) path to the website root (D:\home).

  • Para marcar um diretório virtual como um aplicativo Web, desmarque a caixa de seleção diretório .To mark a virtual directory as a web application, clear the Directory check box.

    Caixa de seleção de diretório

Aplicativos em contêineresContainerized apps

Você pode Adicionar armazenamento personalizado para seu aplicativo em contêiner.You can add custom storage for your containerized app. Os aplicativos em contêineres incluem todos os aplicativos do Linux e também os contêineres personalizados do Windows e Linux em execução no serviço de aplicativo.Containerized apps include all Linux apps and also the Windows and Linux custom containers running on App Service. Clique em nova montagem de armazenamento do Azure e configure seu armazenamento personalizado da seguinte maneira:Click New Azure Storage Mount and configure your custom storage as follows:

  • Nome: o nome de exibição.Name: The display name.
  • Opções de configuração: básico ou avançado.Configuration options: Basic or Advanced.
  • Contas de armazenamento: a conta de armazenamento com o contêiner desejado.Storage accounts: The storage account with the container you want.
  • Tipo de armazenamento: BLOBs do Azure ou arquivos do Azure.Storage type: Azure Blobs or Azure Files.

    Observação

    Os aplicativos de contêiner do Windows só dão suporte a arquivos do Azure.Windows container apps only support Azure Files.

  • Contêiner de armazenamento: para configuração básica, o contêiner desejado.Storage container: For basic configuration, the container you want.
  • Nome do compartilhamento: para configuração avançada, o nome do compartilhamento de arquivos.Share name: For advanced configuration, the file share name.
  • Chave de acesso: para configuração avançada, a chave de acesso.Access key: For advanced configuration, the access key.
  • Caminho de montagem: o caminho absoluto em seu contêiner para montar o armazenamento personalizado.Mount path: The absolute path in your container to mount the custom storage.

Para obter mais informações, consulte acessar o armazenamento do Azure como um compartilhamento de rede de um contêiner no serviço de aplicativo.For more information, see Access Azure Storage as a network share from a container in App Service.

Definir configurações de pilha de idiomasConfigure language stack settings

Para aplicativos do Linux, consulte:For Linux apps, see:

Configurar contêineres personalizadosConfigure custom containers

Consulte configurar um contêiner personalizado do Linux para o serviço Azure appSee Configure a custom Linux container for Azure App Service

Próximas etapasNext steps