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 de Funções do 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, você usa Visual Studio Code para criar um projeto local de Funções do Azure em PowerShell. Mais adiante neste artigo, irá publicar o seu código de função no Azure.

  1. Escolha o ícone Azure na barra de Atividades. Em seguida, na área do Espaço de Trabalho (local), selecione o + botão, escolha Criar Função no dropdown. Quando solicitado, escolha Criar novo projeto.

    Screenshot de criar uma nova janela do projeto.

  2. Escolha a localização do diretório para o seu espaço de trabalho do projeto e escolha Select. Deve criar uma nova pasta ou escolher uma pasta vazia para o espaço de trabalho do projeto. Não escolha uma pasta de projeto que já faça parte de um espaço de trabalho.

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

    Prompt Seleção
    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.
    Fornecer um nome de função Escreva HttpExample.
    Nível de autorização Escolha Anonymous, o que permite que qualquer pessoa chame o ponto de final da sua função. Para saber mais sobre o nível de autorização, consulte as chaves de Autorização.
    Selecione como gostaria de abrir o seu projeto Selecione Add to workspace.

    Utilizando esta informação, o Visual Studio Code gera um projeto Funções do Azure 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

O Visual Studio Code integra-se com Funções do Azure ferramentas Core para permitir que execute este projeto no seu computador de desenvolvimento local antes de publicar para o Azure.

  1. Para iniciar a função localmente, prima F5 ou o ícone Executar e Debug na barra de atividade do lado esquerdo. O painel Terminal apresenta a saída das Ferramentas Centrais. 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.

    Screenshot da função local saída do Código VS.

    Se tiver problemas em funcionamento no Windows, certifique-se de que o terminal padrão do Código do Estúdio Visual não está definido para WSL Bash.

  2. Com as Ferramentas Core ainda em funcionamento no Terminal, escolha o ícone Azure na barra de atividade. Na área do Espaço de Trabalho, expandirfunções deprojeto> local. Clique à direita (Windows) ou Ctrl - clique (macOS) na nova função e escolha Executar Função Agora....

    Execute a função agora a partir do Código do Estúdio Visual

  3. No corpo de pedido de enterro vê o valor do corpo da mensagem de pedido de { "name": "Azure" }. Prima Entrar 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 do Estúdio Visual. As informações sobre a execução da função são mostradas no painel terminal .

  5. Com o painel terminal focado, 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. Em seguida, na área de Recursos , escolha Iniciar súm em Azure....

    Screenshot da insusitada para a janela Azure dentro do Código VS.

    Se já fez o contrato e pode ver as subscrições existentes, vá para a secção seguinte. Se ainda não tiver uma conta Azure, escolha a Conta Criar e Azure.... Os alunos podem escolher a Conta Criar e Azul para Estudantes....

  2. Quando solicitado no navegador, escolha a sua conta Azure e inscreva-se usando as suas credenciais de conta Azure. Se criar uma nova conta, pode iniciar sessão após a criação da sua conta.

  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.

Crie a app de função em Azure

Nesta secção, cria uma app de função e recursos relacionados na sua subscrição Azure.

  1. Escolha o ícone Azure na barra de Atividades. Em seguida, na área recursos , selecione o + ícone e escolha a App Criar Função na opção Azure .

    Crie um recurso na sua subscrição Azure

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

    Prompt Seleção
    Selecione subscrição Escolha a subscrição a utilizar. Não verá este pedido quando tiver apenas uma subscrição visível no âmbito dos Recursos.
    Introduza um nome globalmente único para a aplicação de função Digite um nome que seja válido num caminho URL. O nome que digita é validado para se certificar de que é único em Funções do Azure.
    Selecione uma pilha de tempo de execução Escolha a versão linguística em que tem vindo a correr localmente.
    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 sendo criados em Azure no painel Azure: Activity Log .

    Registo da criação de recursos Azure

  3. Quando a criação estiver concluída, os seguintes recursos Azure são criados na sua subscrição. Os recursos são nomeados com base 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.
    • 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.
    • Um plano Serviço de Aplicações, que define o anfitrião subjacente para a sua aplicação de função.
    • Uma instância de Insights de Aplicação ligada à aplicação de função, que rastreia o uso das suas funções na aplicação.

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

    Dica

    Por padrã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 .

Implementar o projeto no Azure

Importante

A implementação para uma aplicação de função existente substitui sempre o conteúdo dessa app em Azure.

  1. Escolha o ícone Azure na barra de Atividade, em seguida, na área do Espaço de Trabalho, selecione a pasta do projeto e selecione o botão Implementar...

    Implementar projeto a partir do espaço de trabalho visual Studio Code

  2. Selecione Implementar para a Aplicação de Função..., escolher a aplicação de função que acabou de criar e selecione Implementar.

  3. Após a implementação concluída, selecione Ver Saída 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.

    Screenshot da janela 'Saída's View.

Executar a função em Azure

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

    Screenshot da função de execução em Azure a partir do Código do Estúdio Visual.

  2. No corpo de pedido de enterro vê o valor do corpo da mensagem de pedido de { "name": "Azure" }. Prima Entrar 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 os 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: Open in portal.

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

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

    Screenshot de selecionar o grupo de recursos para eliminar a partir da página da aplicação de funções.

  4. Na página do grupo de Recursos , reveja a lista de recursos incluídos e verifique se são eles 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 obter mais informações sobre os custos das funções, consulte os custos do plano de consumo estimado.

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 do Azure.