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 ferramentas de linha de comando disponibilizadas como func.exe para o Azure Functions:
| Ferramentas principais do Azure Functions | CLI do Azure Functions | |
|---|---|---|
| func.exe version | v4 | v5 |
| 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 dele 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 CLI do Azure Functions é distribuída como uma instalação básica pequena, além das cargas de trabalho que você adiciona para as pilhas com as 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 básica, 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), a carga de trabalho da pilha e a 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 workers de linguagem, 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. - Pacotes: artefatos de pacote de extensões pré-compilados para que gatilhos e vinculações funcionem prontamente (necessário para pilhas 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 no 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.
Tela de apresentaçã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 Ferramentas do Core (v4) para pilhas sem suporte ou quando precisar de recursos específicos da disponibilidade geral (GA) das Ferramentas do Core.
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 o scaffolding.
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.
Scaffolding a partir de modelos de início rápido
Para navegar e estruturar aplicativos de exemplo completos (APIs HTTP, workers 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.