Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A interface de linha de comando (CLI) do Azure Functions é a próxima versão principal (v5) do ambiente de execução e das ferramentas de desenvolvimento local do Azure Functions. Esta versão do func.exe apresenta uma arquitetura baseada em carga de trabalho, portanto, você só baixa o que precisa para a pilha na qual desenvolve.
Importante
A CLI do Azure Functions (v5) está atualmente em versão prévia. Esta versão prévia ainda não suporta Java e PowerShell. Para trabalhar com linguagens atualmente não suportadas, continue usando o Azure Functions Core Tools v4.
Há duas versões de func.exe usadas para desenvolvimento de Azure Functions local:
| v4 | v5 | |
|---|---|---|
| Nome da API | Ferramentas principais do Azure Functions | Azure Functions CLI |
| Nível de suporte | Disponibilidade geral (GA) | Preview |
| Espaço de instalação | Binário completo que inclui todos os comandos e funcionalidades para todos os idiomas nativos. | Instalação base pequena, mais cargas de trabalho por idioma e outros recursos que você adiciona conforme necessário. O host é distribuído como uma carga de trabalho independente, para que você obtenha a versão mais recente do host sem precisar baixar novamente a CLI. |
| Usar quando... | Você precisa de suporte total de GA para todos os fluxos de trabalho de desenvolvimento. | Você deseja uma experiência leve e baseada em carga de trabalho com novos recursos, como modelos de início rápido e perfis que mantêm seu ambiente local em sincronia com sua configuração de plano de hospedagem Azure. |
Para obter a referência de comandos, consulte referência da CLI do Azure Functions.
Atualmente, os exemplos não estão disponíveis devido à falta de suporte ao conjunto de idiomas.
Instalar a CLI do Azure Functions
A interface de linha de comando (CLI) do Azure Functions é distribuída como uma instalação básica pequena, além das workloads que você adiciona para os stacks com os quais desenvolve. Microsoft publica pacotes do instalador para Windows, macOS e Linux. Após a instalação, o binário func estará no seu PATH.
Note
Enquanto a CLI do Azure Functions estiver em versão prévia, instale a versão prévia mais recente da página de versões do Azure Functions Core Tools. As diretrizes de instalação final são publicadas com a versão de disponibilidade geral.
Verifique a instalação:
func --version
Depois de instalar a CLI base, instale as cargas de trabalho para sua pilha. A maneira mais rápida é func setup, que instala o host, o worker de linguagem, os pacotes de extensão (quando necessário), o workload da stack e o workload de modelos em uma etapa.
Por exemplo:
func setup --features dotnet
func setup --features node
func setup --features python
func setup --features go
Você também pode instalar cargas de trabalho individualmente usando func workload install. De qualquer forma, na primeira vez que você executar func init, func newou func run sem as cargas de trabalho necessárias instaladas, a CLI solicitará que você as instale.
Workloads
A CLI do Azure Functions usa um modelo de workload. A instalação base func é pequena e independente de idioma. Você instala cargas de trabalho sob demanda para obter ferramentas específicas da pilha, o host do Functions, os trabalhos de idioma, os pacotes de extensão e os modelos.
As cargas de trabalho se enquadram nessas categorias:
-
Host: o runtime de host do Azure Functions que
func runusa. - Bundles: artefatos de pacote de extensões pré-compilados para que gatilhos e vinculações funcionem prontamente (necessário para ambientes que não sejam .NET).
-
Stack: ferramentas de projeto específicas da linguagem (por exemplo,
python,node,dotnet). -
Worker: o worker de linguagem que o host usa em tempo de execução (por exemplo,
python-worker,node-worker). -
Modelos: modelos para funções exibidos por
func new(por exemplo,python-templates,node-templates).
Para obter a lista completa de cargas de trabalho disponíveis e suas descrições, consulte as cargas de trabalho disponíveis na referência da CLI.
Experiência de primeira execução
Na primeira vez em que você executa func init, func newou func run, a CLI verifica se as cargas de trabalho necessárias para seu cenário estão instaladas. Se não estiverem, a CLI solicitará que você os instale. Ao aceitar a solicitação, o conjunto recomendado para a stack escolhida é instalado. Você pode recusar o prompt e instalar cargas de trabalho manualmente usando func workload installou executar func setup para provisionar o conjunto padrão de forma não interativa.
Atualizações de carga de trabalho
Execute func workload search periodicamente para verificar se há cargas de trabalho recém-disponíveis. Continue usando Core Tools (v4) para stacks sem suporte ou quando precisar de recursos específicos da disponibilidade geral (GA) do Core Tools.
Criar um projeto local
Para criar um novo projeto do Functions, use o 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
A opção --stack especifica qual pilha de linguagens usar. A carga de trabalho instalada para essa pilha fornece a estrutura básica.
Criar uma função
Para adicionar uma função de um modelo, use o func new comando.
func new --template "HTTP trigger" --name MyHttpTrigger
Executar funções localmente
Para iniciar o host do Functions e executar seu projeto, use func run:
func run
func start é preservado como um alias compatível com versões anteriores. O host gerencia automaticamente o Azurite (emulador de armazenamento local), a menos que você forneça --no-azurite.
Gerar estrutura a partir de modelos de início rápido
Para navegar e estruturar aplicativos de exemplo completos (APIs HTTP, trabalhos de fila, orquestrações 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
Gerenciar cargas de trabalho
Use func workload para instalar, atualizar e remover cargas de trabalho. Para obter a lista completa de subcomandos e opções, consulte func workload na referência da CLI.
Profiles
Os perfis codificam restrições de versão para o host, os pacotes de extensão e os trabalhos. Aplicar um perfil em runtime usando func run --profile <name>. Para obter a lista completa de subcomandos e opções, consulte func profile na referência da CLI.