Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La CLI de Azure Functions es la siguiente versión principal (v5) del entorno de ejecución de desarrollo local y las herramientas para Azure Functions. Esta versión de func.exe presenta una arquitectura basada en cargas de trabajo, por lo que solo descargas lo que necesitas para la pila con la que trabajas.
Importante
La CLI de Azure Functions (v5) está actualmente en versión preliminar. Esta versión preliminar aún no soporta Java y PowerShell. Para trabajar con lenguajes actualmente no soportados, sigue usando Azure Functions Core Tools v4.
Hay dos versiones de func.exe usadas para el desarrollo de Azure Functions local:
| v4 | v5 | |
|---|---|---|
| Nombre de la API | Azure Functions Core Tools | Azure Functions CLI |
| Nivel de soporte técnico | Disponibilidad general (GA) | Preview |
| Superficie de instalación | Binario completo que incluye todos los comandos y funcionalidades de todos los lenguajes nativos. | Instalación base pequeña, además de cargas de trabajo por idioma y otras características que agregue según sea necesario. El host se entrega como una carga de trabajo independiente, por lo que obtienes la versión más reciente del host sin tener que volver a descargar la CLI. |
| Se utiliza cuando... | Necesitas soporte completo en disponibilidad general para todos los flujos de trabajo de desarrollo. | Quiere una experiencia ligera basada en cargas de trabajo con nuevas características, como plantillas de inicio rápido y perfiles que mantienen el entorno local sincronizado con la configuración del plan de hospedaje de Azure. |
Para obtener la referencia de comandos, consulte la referencia de la CLI de Azure Functions.
Actualmente, los ejemplos no están disponibles por falta de compatibilidad del stack de idiomas.
Instalación de la CLI de Azure Functions
La CLI de Azure Functions se distribuye como una pequeña instalación base más cargas de trabajo que se agregan para las pilas en las que se desarrolla. Microsoft publica paquetes de instalador para Windows, macOS y Linux. Después de la instalación, el func archivo binario está en PATH.
Note
Aunque la CLI de Azure Functions está en versión preliminar, instale la versión preliminar más reciente desde la página de versiones de Azure Functions Core Tools. La guía de instalación final se publica con la versión de disponibilidad general.
Compruebe la instalación:
func --version
Después de instalar la CLI principal, instala las cargas de trabajo para tu pila. La forma más rápida es func setup, que instala el host, el trabajo de lenguaje, los conjuntos de extensiones (cuando es necesario), la carga de trabajo de pila y la carga de trabajo de plantillas en un paso.
Por ejemplo:
func setup --features dotnet
func setup --features node
func setup --features python
func setup --features go
También puede instalar cargas de trabajo individualmente mediante func workload install. En cualquier caso, la primera vez que ejecute func init, func newo func run sin las cargas de trabajo necesarias instaladas, la CLI le pedirá que las instale.
Workloads
La CLI de Azure Functions usa un modelo workload. La instalación base func es pequeña e independiente del idioma. Las cargas de trabajo se instalan a petición para obtener herramientas específicas de la pila, el host de Functions, los trabajos de lenguaje, las agrupaciones de extensiones y las plantillas.
Las cargas de trabajo se dividen en estas categorías:
-
Host: tiempo de ejecución del host de Azure Functions que
func runusa. - Bundles: artefactos precompilados de paquetes de extensiones para que los desencadenadores y enlaces funcionen sin configuración adicional (necesarios para entornos que no son .NET).
-
Stack: herramientas del proyecto específicas del lenguaje (por ejemplo,
python,node,dotnet). -
Worker: el worker de lenguaje que usa el host en tiempo de ejecución (por ejemplo,
python-worker,node-worker). -
Plantillas: plantillas de función expuestas por
func new(por ejemplo,python-templates,node-templates).
Para obtener la lista completa de las cargas de trabajo disponibles y sus descripciones, consulte Cargas de trabajo disponibles en la referencia de la CLI.
Experiencia de primer uso
La primera vez que ejecute func init, func newo func run, la CLI comprueba si se instalan las cargas de trabajo necesarias para el escenario. Si no lo son, la CLI le pedirá que las instale. Aceptar el aviso instala el conjunto recomendado para el stack que has elegido. Puede rechazar el aviso e instalar las cargas de trabajo manualmente mediante func workload install, o ejecutar func setup para aprovisionar el conjunto estándar de forma no interactiva.
Actualizaciones de carga de trabajo
Ejecute func workload search periódicamente para comprobar si hay cargas de trabajo recién disponibles. Siga usando Core Tools (v4) para stacks no compatibles o cuando necesite funciones específicas de Core Tools de disponibilidad general.
Creación de un proyecto local
Para crear un nuevo proyecto de Functions, use el func init comando .
func init MyProjFolder --stack dotnet
func init MyProjFolder --stack node --language javascript
func init MyProjFolder --stack node --language typescript
func init MyProjFolder --stack python
func init MyProjFolder --stack go
La --stack opción especifica la pila de idioma que se va a usar. La carga de trabajo instalada para esa pila proporciona la estructura.
Crear una función
Para agregar una función desde una plantilla, use el func new comando .
func new --template "HTTP trigger" --name MyHttpTrigger
Ejecución local de funciones
Para iniciar el host de Functions y ejecutar el proyecto, use func run:
func run
func start se conserva como alias compatible con versiones anteriores. El host administra automáticamente Azurite (emulador de almacenamiento local) a menos que pase --no-azurite.
Scaffolding desde plantillas de inicio rápido
Para examinar y generar la estructura de aplicaciones de ejemplo completas (APIs HTTP, procesadores de cola, orquestaciones de Durable Functions), use func quickstart:
func quickstart --stack dotnet --resource http
func quickstart --stack node --resource http
func quickstart --stack python --resource http
func quickstart --stack go --resource http
Administración de cargas de trabajo
Use func workload para instalar, actualizar y quitar cargas de trabajo. Para ver la lista completa de subcomandos y opciones, consulte func workload en la referencia de la CLI.
Profiles
Los perfiles definen restricciones de versión para el host, los paquetes de extensiones y los procesos de trabajo. Aplique un perfil en tiempo de ejecución mediante func run --profile <name>. Para ver la lista completa de subcomandos y opciones, consulte func profile en la referencia de la CLI.