Quickstart: Criar uma função PowerShell em Azure utilizando o Código do Estúdio Visual

Neste artigo, utiliza o Código do Estúdio Visual para criar uma função PowerShell que responde a pedidos HTTP. Depois de testar o código localmente, implemente-o para o ambiente sem servidor das Funções Azure.

Completar este quickstart incorre num pequeno custo de alguns usd ou menos na sua conta Azure.

Há também uma versão baseada em CLI deste artigo.

Configurar o ambiente

Antes de começar, certifique-se de que tem os seguintes requisitos em vigor:

Crie o seu projeto local

Nesta secção, utiliza o Código do Estúdio Visual para criar um projeto local de Funções Azure em PowerShell. Mais adiante neste artigo, irá publicar o seu código de função no Azure.

  1. Selecione o ícone do Azure na barra de Atividade e, em seguida, na área Azure: Funções, selecione o ícone Criar novo projeto....

    Selecione Criar um novo projeto

  2. Selecione uma localização do diretório para a área de trabalho do seu projeto e escolha Selecionar.

    Nota

    Estes passos foram concebidos para serem concluídos fora de um espaço de trabalho. Neste caso, não selecione uma pasta de projeto que faz parte de uma área de trabalho.

  3. Forneça as seguintes informações nos pedidos:

    • Selecione um idioma para o seu projeto de função: Selecione PowerShell.

    • Selecione um modelo para a primeira função do seu projeto: Selecione HTTP trigger.

    • Forneça um nome de função: Escreva HttpExample.

    • Nível de autorização: Anonymous Escolha, que permite a qualquer pessoa ligar para o ponto final da sua função. Para saber mais sobre o nível de autorização, consulte as teclas de Autorização.

    • Selecione como gostaria de abrir o seu projeto: Selecione Add to workspace.

  4. Utilizando esta informação, o Visual Studio Code gera um projeto Azure Functions com um gatilho HTTP. Pode ver os ficheiros de projeto locais no Explorer. Para saber mais sobre ficheiros que são criados, consulte os ficheiros do projeto Gerados.

Executar a função localmente

Visual Studio O Código integra-se com as ferramentas core do Azure Functions para permitir que execute este projeto no seu computador de desenvolvimento local antes de publicar para o Azure.

  1. Para ligar para a sua função, prima F5 para iniciar o projeto da aplicação de funções. São apresentados os resultados das Ferramentas de Núcleo no painel Terminal. A sua aplicação começa no painel Terminal. Pode ver o ponto final url da sua função desencadeada por HTTP a funcionar localmente.

    Função local saída do Código VS

    Se tiver problemas em executar Windows, certifique-se de que o terminal padrão para Visual Studio Código não está definido para WSL Bash.

  2. Com as Ferramentas Core em funcionamento, vá para a área Azure: Funções. Em Funções, expandir funções locais de Project > . Clique à direita (Windows) ou Ctrl - clique (macOS) na HttpExample função e escolha Executar Função Agora....

    Execute a função agora a partir do Código Visual Studio

  3. In Enter request body você vê o valor do corpo da mensagem de pedido de { "name": "Azure" } . Prima Insira para enviar esta mensagem de pedido para a sua função.

  4. Quando a função executa localmente e devolve uma resposta, uma notificação é levantada no Código Visual Studio. As informações sobre a execução da função são mostradas no painel terminal.

  5. Prima Ctrl + C para parar as Ferramentas Core e desligar o depurar.

Depois de verificar que a função funciona corretamente no seu computador local, é hora de usar o Código do Estúdio Visual para publicar o projeto diretamente para o Azure.

Iniciar sessão no Azure

Antes de poder publicar a aplicação, tem de iniciar sessão no Azure.

  1. Se ainda não se inscreveu, escolha o ícone Azure na barra de Atividades, então na área Azure: Funções, escolha Iniciar súmido para Azure.... Se ainda não tiver um, pode criar uma conta Azure gratuita. Os alunos podem criar uma conta Azure gratuita para os Estudantes.

    Inscreva-se no Azure dentro do Código VS

    Se já assinou, vá para a próxima secção.

  2. Quando solicitado no navegador, escolha a sua conta Azure e inscreva-se usando as suas credenciais de conta Azure.

  3. Depois de ter assinado com sucesso, pode fechar a nova janela do navegador. As subscrições que pertencem à sua conta Azure são apresentadas na barra Lateral.

Publicar o projeto no Azure

Nesta secção, cria uma aplicação de função e recursos relacionados na sua subscrição Azure e, em seguida, implementa o seu código.

Importante

A publicação de uma aplicação de funções existente substitui o conteúdo dessa aplicação no Azure.

  1. Escolha o ícone Azure na barra de Atividade, em seguida, na área Azure: Funções, escolha o botão Implementar para funcionar... botão.

    Publicar o projeto no Azure

  2. Forneça as seguintes informações nos pedidos:

    • Selecione pasta: Escolha uma pasta do seu espaço de trabalho ou navegue para uma que contenha a sua aplicação de função. Não verá isto se já tiver uma aplicação de função válida aberta.

    • Selecione subscrição: Escolha a subscrição para usar. Não verá isto se tiver apenas uma assinatura.

    • Selecione Aplicação de Funções no Azure: Selecione - Create new Function App. (Não escolha a Advanced opção, que não está abrangida por este artigo.)

    • Introduza um nome globalmente único para a aplicação de função: Escreva um nome que seja válido num caminho URL. O nome que digita é validado para se certificar de que é único em Funções Azure.

    • Selecione uma localização para novos recursos: Para um melhor desempenho, escolha uma região perto de si.

    A extensão mostra o estado dos recursos individuais à medida que estão a ser criados em Azure na área de notificação.

    Notificação da criação de recursos Azure

  3. Quando concluídos, os seguintes recursos Azure são criados na sua subscrição, utilizando nomes baseados no nome da aplicação da sua função:

    • Um grupo de recursos, que é um recipiente lógico para recursos relacionados.
    • Uma conta padrão de Armazenamento Azure,que mantém informações estatais e outras sobre os seus projetos.
    • Um plano de consumo, que define o anfitrião subjacente para a sua aplicação de função sem servidor.
    • Uma aplicação de função, que fornece o ambiente para a execução do seu código de função. Uma aplicação de função permite-lhe agrupar funções como uma unidade lógica para facilitar a gestão, implementação e partilha de recursos dentro do mesmo plano de hospedagem.
    • Uma instância de Insights de Aplicação ligada à aplicação de função, que rastreia o uso da sua função sem servidor.

    Depois de criar a aplicação de funções, é apresentada uma notificação e o pacote de implementação é aplicado.

    Dica

    Por predefinição, os recursos Azure exigidos pela sua aplicação de função são criados com base no nome da aplicação de função que fornece. Por padrão, também são criados no mesmo novo grupo de recursos com a aplicação de função. Se quiser personalizar os nomes destes recursos ou reutilizar os recursos existentes, tem de publicar o projeto com opções avançadas de criação.

  4. Selecione Ver Saída nesta notificação para ver os resultados da criação e implementação, incluindo os recursos Azure que criou. Se perder a notificação, selecione o ícone da campainha no canto inferior direito para vê-lo novamente.

    Criar notificação completa

Executar a função em Azure

  1. De volta ao Azure: Funções na barra lateral, expandir a sua subscrição, a sua nova aplicação de funções e funções. Clique à direita (Windows) ou Ctrl - clique (macOS) na HttpExample função e escolha Executar Função Agora....

    Executar função agora em Azure a partir do Código do Estúdio Visual

  2. In Enter request body você vê o valor do corpo da mensagem de pedido de { "name": "Azure" } . Prima Insira para enviar esta mensagem de pedido para a sua função.

  3. Quando a função executa em Azure e devolve uma resposta, uma notificação é levantada no Código do Estúdio Visual.

Limpar recursos

Quando continuar até ao próximo passo e adicionar uma fila de armazenamento Azure à sua função, terá de manter todos os seus recursos no lugar para se basear no que já fez.

Caso contrário, pode utilizar os seguintes passos para eliminar a aplicação de função e os seus recursos relacionados para evitar incorrer em custos adicionais.

  1. No Código do Estúdio Visual, prima F1 para abrir a paleta de comando. Na paleta de comando, procure e selecione Azure Functions: Open in portal .

  2. Escolha a sua aplicação de função e prima Enter. A página de aplicação de função abre no portal Azure.

  3. No separador Visão Geral, selecione o link nomeado ao lado do grupo De recursos.

    Selecione o grupo de recursos a eliminar na página da aplicação de função.

  4. Na página Grupo de recursos, reveja a lista dos recursos incluídos e certifique-se de que são aqueles que pretende eliminar.

  5. Selecione Eliminar grupo de recursos e siga as instruções.

    A eliminação pode demorar alguns minutos. Quando terminar, é apresentada uma notificação durante alguns segundos. Também pode selecionar o ícone de sino na parte superior da página para ver a notificação.

Para saber mais sobre os custos das funções, consulte os custos do plano de consumoestimado.

Passos seguintes

Utilizou o Código do Estúdio Visual para criar uma aplicação de função com uma função simples desencadeada por HTTP. No artigo seguinte, expande essa função ligando-se ao Azure Storage. Para saber mais sobre a ligação a outros serviços Azure, consulte adicionar ligações a uma função existente em Funções Azure.