Administración de la aplicación de funcionesManage your function app

En Azure Functions, una Function App ofrece el contexto de ejecución de funciones individuales.In Azure Functions, a function app provides the execution context for your individual functions. Los comportamientos de Function App se aplican a todas las funciones hospedadas en una Function App determinada.Function app behaviors apply to all functions hosted by a given function app. Todas las funciones de una aplicación de funciones deben compartir el mismo lenguaje.All functions in a function app must be of the same language.

Las funciones individuales de una aplicación de funciones se implementan y escalan juntas.Individual functions in a function app are deployed together and are scaled together. Todas las funciones de la misma aplicación de funciones comparten recursos (por instancia) a medida que se escala la aplicación de funciones.All functions in the same function app share resources, per instance, as the function app scales.

Las cadenas de conexión, las variables de entorno y otras opciones de configuración de la aplicación se definen por separado para cada aplicación de funciones.Connection strings, environment variables, and other application settings are defined separately for each function app. Los datos que se deben compartir entre las aplicaciones de funciones deben almacenarse externamente en un almacén persistente.Any data that must be shared between function apps should be stored externally in a persisted store.

En este artículo se describe cómo configurar y administrar la aplicación de funciones.This article describes how to configure and manage your function apps.

Sugerencia

Muchas opciones de configuración también se pueden administrar mediante la CLI de Azure.Many configuration options can also be managed by using the Azure CLI.

Introducción a Azure PortalGet started in the Azure portal

  1. Para comenzar, vaya a Azure Portal e inicie sesión en la cuenta de Azure.To begin, go to the Azure portal and sign in to your Azure account. En la barra de búsqueda en la parte superior del portal, escriba el nombre de la aplicación de funciones y selecciónela en la lista.In the search bar at the top of the portal, enter the name of your function app and select it from the list.

  2. En Configuración en el panel izquierdo, seleccione Configuración .Under Settings in the left pane, select Configuration .

    Información general sobre las aplicaciones de funciones en Azure Portal

Puede navegar a todo lo que necesita para administrar Function App desde la página de información general, en particular la Configuración de la aplicación y las Características de la plataforma .You can navigate to everything you need to manage your function app from the overview page, in particular the Application settings and Platform features .

Configuración de la aplicaciónApplication settings

La pestaña Configuración de la aplicación mantiene la configuración de la aplicación que la aplicación de funciones usa.The Application settings tab maintains settings that are used by your function app. Esta configuración se almacena cifrada y debe seleccionar Mostrar valores para ver los valores en el portal.These settings are stored encrypted, and you must select Show values to see the values in the portal. También puede acceder a esta configuración de la aplicación mediante la CLI de Azure.You can also access application settings by using the Azure CLI.

PortalPortal

Para agregar una configuración en el portal, seleccione Nueva configuración de la aplicación y agregue el nuevo par clave-valor.To add a setting in the portal, select New application setting and add the new key-value pair.

Configuración de Function App en Azure Portal.

Azure CLIAzure CLI

El comando az functionapp config appsettings list devuelve la configuración de la aplicación existente, como en el ejemplo siguiente:The az functionapp config appsettings list command returns the existing application settings, as in the following example:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

El comando az functionapp config appsettings set agrega o actualiza una configuración de la aplicación.The az functionapp config appsettings set command adds or updates an application setting. En el ejemplo siguiente se crea una configuración con una clave denominada CUSTOM_FUNCTION_APP_SETTING y un valor de 12345:The following example creates a setting with a key named CUSTOM_FUNCTION_APP_SETTING and a value of 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Uso de la configuración de la aplicaciónUse application settings

Esta configuración de la aplicación de función también se puede leer en el código como variables de entorno.The function app settings values can also be read in your code as environment variables. Para más información, consulte la sección Variables de entorno de estos temas de referencia específicos del lenguaje:For more information, see the Environment variables section of these language-specific reference topics:

Al desarrollar una aplicación de funciones localmente, debe mantener copias locales de estos valores en el archivo del proyecto local.settings.json.When you develop a function app locally, you must maintain local copies of these values in the local.settings.json project file. Para más información, consulte el archivo de configuración local.To learn more, see Local settings file.

Características de la plataformaPlatform features

Las aplicaciones de funciones se ejecutan en la plataforma de Azure App Service, donde también se realiza su mantenimiento.Function apps run in, and are maintained by, the Azure App Service platform. Por tanto, Function App tiene acceso a la mayoría de las características de la plataforma de hospedaje web principal de Azure.As such, your function apps have access to most of the features of Azure's core web hosting platform. En el panel de la izquierda puede acceder a muchas características de la plataforma de App Service que puede usar en las aplicaciones de funciones.The left pane is where you access the many features of the App Service platform that you can use in your function apps.

Nota

No todas las características de App Service están disponibles cuando una Function App se ejecuta con el plan de hospedaje de consumo.Not all App Service features are available when a function app runs on the Consumption hosting plan.

El resto de este artículo se centra en las siguientes características de App Service en Azure Portal que resultan útiles para Functions:The rest of this article focuses on the following App Service features in the Azure portal that are useful for Functions:

Para más información sobre cómo trabajar con la configuración de App Service, vea Configuración de Azure App Service.For more information about how to work with App Service settings, see Configure Azure App Service Settings.

Editor de App ServiceApp Service editor

Editor de App Service

El Editor de App Service es un editor en portal avanzado que puede usar para modificar archivos de configuración JSON y archivos de código similares.The App Service editor is an advanced in-portal editor that you can use to modify JSON configuration files and code files alike. Al seleccionar esta opción se inicia una pestaña de explorador independiente con un editor básico.Choosing this option launches a separate browser tab with a basic editor. Esto le permite realizar la integración con el repositorio Git, ejecutar y depurar código y modificar la configuración de Function App.This enables you to integrate with the Git repository, run and debug code, and modify function app settings. Este editor proporciona un entorno de desarrollo mejorado para las funciones en comparación con el editor de funciones integrado.This editor provides an enhanced development environment for your functions compared with the built-in function editor.

Se recomienda que considere la posibilidad de desarrollar las funciones en el equipo local.We recommend that you consider developing your functions on your local computer. Al desarrollar localmente y publicar en Azure, los archivos del proyecto son de solo lectura en el portal.When you develop locally and publish to Azure, your project files are read-only in the portal. Para más información, consulte Codificación y comprobación de las funciones de Azure Functions en un entorno local.To learn more, see Code and test Azure Functions locally.

ConsolaConsole

Consola de Function App

La consola del portal es una herramienta ideal para desarrolladores si prefiere interactuar con Function App desde la línea de comandos.The in-portal console is an ideal developer tool when you prefer to interact with your function app from the command line. Los comandos comunes incluyen creación de archivos y directorios y navegación por los mismos, así como la ejecución de archivos y scripts por lotes.Common commands include directory and file creation and navigation, as well as executing batch files and scripts.

Al desarrollar localmente, se recomienda usar Azure Functions Core Tools y la CLI de Azure.When developing locally, we recommend using the Azure Functions Core Tools and the Azure CLI.

Herramientas avanzadas (Kudu)Advanced tools (Kudu)

Configurar Kudu

Las herramientas avanzadas para App Service (también conocidas como Kudu) proporcionan acceso a las características administrativas avanzadas de la Function App.The advanced tools for App Service (also known as Kudu) provide access to advanced administrative features of your function app. Con Kudu, puede administrar la información del sistema, la configuración de las aplicaciones, las variables del entorno, las extensiones del sitio, los encabezados HTTP y las variables del servidor.From Kudu, you manage system information, app settings, environment variables, site extensions, HTTP headers, and server variables. También puede iniciar Kudu si examina el punto de conexión de SCM de la Function App, como https://<myfunctionapp>.scm.azurewebsites.net/.You can also launch Kudu by browsing to the SCM endpoint for your function app, like https://<myfunctionapp>.scm.azurewebsites.net/

Centro de implementaciónDeployment Center

Cuando se usa una solución de control de código fuente para desarrollar y mantener el código de las funciones, el Centro de implementación le permite compilar e implementar desde el control de código fuente.When you use a source control solution to develop and maintain your functions code, Deployment Center lets you build and deploy from source control. El proyecto se compila e implementa en Azure cuando se realizan actualizaciones.Your project is built and deployed to Azure when you make updates. Para más información, vea Tecnologías de implementación en Azure Functions.For more information, see Deployment technologies in Azure Functions.

Uso compartido de recursos entre orígenesCross-origin resource sharing

Para evitar la ejecución de código malintencionado en el cliente, los exploradores modernos bloquean las solicitudes de las aplicaciones web en los recursos que se ejecutan en un dominio independiente.To prevent malicious code execution on the client, modern browsers block requests from web applications to resources running in a separate domain. El Intercambio de Recursos de Origen Cruzado (CORS) permite a un encabezado Access-Control-Allow-Origin declarar qué orígenes pueden llamar a los puntos de conexión en la aplicación de funciones.Cross-origin resource sharing (CORS) lets an Access-Control-Allow-Origin header declare which origins are allowed to call endpoints on your function app.

PortalPortal

Al configurar la lista de orígenes permitidos para la aplicación de funciones, el encabezado Access-Control-Allow-Origin se agrega automáticamente a todas las respuestas de los puntos de conexión HTTP en la aplicación de funciones.When you configure the Allowed origins list for your function app, the Access-Control-Allow-Origin header is automatically added to all responses from HTTP endpoints in your function app.

Configuración de la lista de CORS de la aplicación de funciones

Cuando se usa el carácter comodín (*), se omiten todos los demás dominios.When the wildcard (*) is used, all other domains are ignored.

Use el comando az functionapp cors add para agregar un dominio a la lista de orígenes permitidos.Use the az functionapp cors add command to add a domain to the allowed origins list. En el ejemplo siguiente se agrega el dominio contoso.com:The following example adds the contoso.com domain:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

Use el comando az functionapp cors show para enumerar los orígenes permitidos actuales.Use the az functionapp cors show command to list the current allowed origins.

AutenticaciónAuthentication

Configuración de la autenticación de una Function App

Si las funciones usan un desencadenador HTTP, puede requerir que las llamadas se autentiquen primero.When functions use an HTTP trigger, you can require calls to first be authenticated. App Service admite la autenticación de Azure Active Directory y el inicio de sesión en proveedores locales, como Facebook, Microsoft y Twitter.App Service supports Azure Active Directory authentication and sign-in with social providers, such as Facebook, Microsoft, and Twitter. Para más información sobre cómo configurar los proveedores de autenticación específicos, consulte Autenticación y autorización en Azure App Service.For details on configuring specific authentication providers, see Azure App Service authentication overview.

Pasos siguientesNext steps