Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A interface de linha de comandos (CLI) do Funções do Azure é a próxima versão principal (v5) do ambiente de execução e do conjunto de ferramentas de desenvolvimento local do Funções do Azure. Esta versão do func.exe inclui uma arquitetura baseada em cargas de trabalho, pelo que só transfere o que necessita para a plataforma em que desenvolve.
Importante
A CLI do Funções do Azure (v5) está atualmente em pré-visualização. Esta versão de pré-visualização ainda não suporta Java e PowerShell. Para trabalhar com linguagens atualmente não suportadas, continue a usar Funções do Azure Core Tools v4.
Existem duas versões do func.exe usadas para o desenvolvimento de Funções do Azure local:
| v4 | v5 | |
|---|---|---|
| Nome da API | Ferramentas principais do Funções do Azure | Funções do Azure CLI |
| Nível de apoio | Disponibilidade geral (GA) | Preview |
| Área de instalação | Binário completo que inclui todos os comandos e capacidades para todas as línguas nativas. | Instalação base pequena, além de cargas de trabalho por língua e outras funcionalidades que adicionas conforme necessário. O host é enviado como carga de trabalho própria, por isso recebes a versão mais recente do host sem teres de voltar a descarregar a CLI. |
| Utilizar quando... | Precisas de suporte total de GA para todos os fluxos de trabalho de desenvolvimento. | Quer uma experiência leve, baseada em cargas de trabalho, com novas funcionalidades como modelos de início rápido e perfis que mantenham o seu ambiente local sincronizado com a configuração do seu plano de alojamento Azure. |
Para a referência de comandos, veja Funções do Azure CLI reference.
Os exemplos estão atualmente indisponíveis devido à falta de suporte para a stack de línguas.
Instalar a CLI do Funções do Azure
A interface de linha de comandos (CLI) do Funções do Azure é disponibilizada como uma instalação base pequena, à qual se acrescentam cargas de trabalho para as stacks em que desenvolve. A Microsoft publica pacotes de instalação para Windows, macOS e Linux. Após a instalação, o binário func está no seu PATH.
Note
Enquanto a CLI do Funções do Azure estiver em fase de pré-visualização, instale a compilação de pré-visualização mais recente a partir da página de lançamentos do Funções do Azure Core Tools. A orientação final de instalação é publicada juntamente com a versão de disponibilidade geral.
Verifique a instalação:
func --version
Depois de instalar a CLI de base, instale os componentes necessários para a sua stack. A forma mais rápida é utilizar func setup, que instala o host, o processo de linguagem, os conjuntos de extensões (quando necessário), a carga de trabalho da stack e a carga de trabalho dos modelos num único passo.
Por exemplo:
func setup --features dotnet
func setup --features node
func setup --features python
func setup --features go
Também pode instalar cargas de trabalho individualmente usando func workload install. De qualquer forma, na primeira vez que executas func init, func new, ou func run sem as cargas de trabalho necessárias instaladas, o CLI pede-te para as instalar.
Workloads
A CLI Funções do Azure utiliza um modelo carga de trabalho. A instalação base func é pequena e independente da linguagem. Instala cargas de trabalho conforme necessário para obter ferramentas específicas da pilha, o anfitrião do Functions, processos de trabalho da linguagem, pacotes de extensões e modelos.
As cargas de trabalho enquadram-se nestas categorias:
-
Host: O tempo de execução do Funções do Azure host que o
func runutiliza. - Pacotes: pacotes de extensões pré-compilados para que os accionadores e as associações funcionem de imediato (necessários para plataformas que não sejam .NET).
-
Stack: Ferramentas de projeto específicas da linguagem (por exemplo,
python,node,dotnet). -
Worker: O worker da linguagem que o host utiliza em tempo de execução (por exemplo,
python-worker,node-worker). -
Templates: Templates de funções surgidos por
func new(por exemplo,python-templates,node-templates).
Para a lista completa de cargas de trabalho disponíveis e as suas descrições, veja Cargas de trabalho disponíveis na referência de CLI.
Experiência de estreia
Na primeira vez que executa func init, func new, ou func run, a CLI verifica se as cargas de trabalho necessárias para o seu cenário estão instaladas. Se não estiverem, o CLI pede-te para os instalar. Ao aceitar o pedido, instala o conjunto recomendado para a stack que escolheu. Pode recusar o prompt e instalar as cargas de trabalho manualmente usando func workload install, ou 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 as novas cargas de trabalho disponíveis. Continue a usar o Core Tools (v4) para stacks não suportados ou quando precisar de funcionalidades específicas de GA do Core Tools.
Criar um projeto local
Para criar um novo projeto de Funções, 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 --stack opção especifica que pilha de idiomas utilizar. A carga de trabalho instalada para essa pilha fornece o andaime.
Criar uma função
Para adicionar uma função a partir de um modelo, use o func new comando.
func new --template "HTTP trigger" --name MyHttpTrigger
Executar funções localmente
Para iniciar o anfitrião Functions e executar o seu projeto, utilize func run:
func run
func start é preservado como um pseudónimo retrocompatível. O host gere automaticamente o Azurite (emulador de armazenamento local), a menos que passe --no-azurite.
Andaime a partir de modelos de início rápido
Para procurar e gerar aplicações de exemplo completas (APIs HTTP, processadores de filas, orquestrações do 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
Uso func workload para instalar, atualizar e remover cargas de trabalho. Para a lista completa de subcomandos e opções, veja func workload na referência da CLI.
Profiles
Os perfis codificam restrições de versão para o host, pacotes de extensão e trabalhadores. Aplique um perfil em tempo de execução usando func run --profile <name>. Para a lista completa de subcomandos e opções, veja func profile na referência da CLI.