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

Este tópico explica como definir configurações comuns para aplicativos Web, back-end móvel ou aplicativo de API usando o portal do Azure.This topic 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 --env o contêiner usando o 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.

Na portal do Azure, navegue até a página de gerenciamento do aplicativo.In the Azure portal, navigate to your app's management page. No menu à esquerda do aplicativo, clique emconfigurações do aplicativode configuração > .In the app's left menu, click 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 é <appSettings> como configurá-los no Web. config ou appSettings. JSON, mas os valores no serviço de aplicativo substituem aqueles em Web. config ou appSettings. JSON.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 local do MySQL) em Web. config ou appSettings. JSON, mas os segredos de produção (por exemplo, a senha do banco de dados MySQL do Azure) são seguros no serviço de aplicativo.You can keep development settings (for example, local MySQL password) in Web.config or appsettings.json, but production secrets (for example, Azure MySQL database password) safe 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 ApplicationInsights:InstrumentationKey da configuração do aplicativo como 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
  },
  ...
]

Configurar cadeias de conexãoConfigure connection strings

Na portal do Azure, navegue até a página de gerenciamento do aplicativo.In the Azure portal, navigate to the app's management page. No menu à esquerda do aplicativo, clique emconfigurações do aplicativode configuração > .In the app's left menu, click 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 é <connectionStrings> como configurá-los 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 segredos de produção (por exemplo, credenciais do banco de dados SQL) seguras 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) safe 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. Aqui está uma exceção. no entanto: certos tipos de banco de dados do Azure são submetidos a backup junto com o aplicativo se você configurar suas cadeias de conexão em seu aplicativo.Here's one exception, however: certain Azure database types are backed up along with the app if you configure their connection strings in your 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:

  • SQL Server: SQLCONNSTR_SQL Server: SQLCONNSTR_
  • MySQL: MYSQLCONNSTR_MySQL: MYSQLCONNSTR_
  • Banco de Dados SQL: SQLAZURECONNSTR_SQL Database: SQLAZURECONNSTR_
  • Personalizado: CUSTOMCONNSTR_Custom: CUSTOMCONNSTR_

Por exemplo, uma cadeia de conexão do MySql chamada connectionstring1 pode ser acessada MYSQLCONNSTR_connectionString1como a variável de ambiente.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 configurações geraisConfigure general settings

Na portal do Azure, navegue até a página de gerenciamento do aplicativo.In the Azure portal, navigate to the app's management page. No menu à esquerda do aplicativo, clique emconfigurações do aplicativode configuração > .In the app's left menu, click Configuration > Application 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 linguagem 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ê também pode definir um arquivo ou comando de inicialização opcional.For Linux apps and custom container apps, you can also set an optional start-up command or file.
  • Configurações da 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: Mantenha o aplicativo carregado mesmo quando não houver tráfego.Always On: Keep 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.
    • 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 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, compre um certificado do serviço de aplicativo para o domínio personalizado do aplicativo ou associe um certificado deterceiros.To ensure that client browsers connect to your app with HTTP/2, either buy an App Service Certificate for the app's custom domain or bind a third party certificate.

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

Na portal do Azure, navegue até a página de gerenciamento do aplicativo.In the Azure portal, navigate to the app's management page. No menu à esquerda do aplicativo, clique em configuração > documentos padrão.In the app's left menu, click Configuration > Default documents.

Configurações gerais

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

Na portal do Azure, navegue até a página de gerenciamento do aplicativo.In the Azure portal, navigate to the app's management page. No menu à esquerda do aplicativo, clique em mapeamentos decaminhode configuração > .In the app's left menu, click Configuration > Path mappings.

Configurações gerais

A página Mapeamentos de caminho mostra diferentes coisas com base no tipo de sistema operacional.The Path mappings page shows you different things based on the OS type.

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 manipulador.To add a custom handler, click New handler. 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. Clique em novo aplicativo virtual ou diretório.Click New virtual application or directory.

Para configurar aplicativos e diretórios virtuais, especifique cada diretório virtual e seu caminho físico correspondente em relação à raiz do siteD:\home().To configure virtual applications and directories, specify each virtual directory and its corresponding physical path relative to the website root (D:\home). Opcionalmente, você pode marcar a caixa de seleção Aplicativo para marcar um diretório virtual como um aplicativo.Optionally, you can select the Application checkbox to mark a virtual directory as an application.

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 a 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 fornecer conteúdo do armazenamento do Azure no serviço de aplicativo no Linux.For more information, see Serve content from Azure Storage in App Service on Linux.

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