Implementação contínua para Funções do AzureContinuous deployment for Azure Functions

Você pode usar Azure Functions para implantar o código continuamente usando a integração de controle do código-fonte.You can use Azure Functions to deploy your code continuously by using source control integration. A integração de controle do código-fonte habilita um fluxo de trabalho no qual uma atualização de código dispara a implantação no Azure.Source control integration enables a workflow in which a code update triggers deployment to Azure. Se você for novo no Azure Functions, comece analisando o Azure Functions visão geral.If you're new to Azure Functions, get started by reviewing the Azure Functions overview.

A implantação contínua é uma boa opção para projetos em que você integra contribuições múltiplas e frequentes.Continuous deployment is a good option for projects where you integrate multiple and frequent contributions. Ao usar a implantação contínua, você mantém uma única fonte de verdade para seu código, o que permite que as equipes colaborem facilmente.When you use continuous deployment, you maintain a single source of truth for your code, which allows teams to easily collaborate. Você pode configurar a implantação contínua no Azure Functions dos seguintes locais de código-fonte:You can configure continuous deployment in Azure Functions from the following source code locations:

A unidade de implantação para funções no Azure é o aplicativo de funções.The unit of deployment for functions in Azure is the function app. Todas as funções em um aplicativo de funções são implantadas ao mesmo tempo.All functions in a function app are deployed at the same time. Depois de habilitar a implantação contínua, o acesso ao código de função no portal do Azure é configurado como somente leitura porque a fonte de verdade está definida como em outro lugar.After you enable continuous deployment, access to function code in the Azure portal is configured as read-only because the source of truth is set to be elsewhere.

Requisitos para implantação contínuaRequirements for continuous deployment

Para que a implantação contínua seja realizada com sucesso, sua estrutura de diretório deve ser compatível com a estrutura de pasta básica que Azure Functions espera.For continuous deployment to succeed, your directory structure must be compatible with the basic folder structure that Azure Functions expects.

O código para todas as funções num aplicativo de função específica está localizado numa pasta de projeto de raiz que contém um ficheiro de configuração de anfitrião e as subpastas de um ou mais.The code for all the functions in a specific function app is located in a root project folder that contains a host configuration file and one or more subfolders. Cada subpasta contém o código para uma função separada.Each subfolder contains the code for a separate function. A estrutura de pastas é mostrada na seguinte representação:The folder structure is shown in the following representation:

FunctionApp
 | - host.json
 | - Myfirstfunction
 | | - function.json
 | | - ...  
 | - mysecondfunction
 | | - function.json
 | | - ...  
 | - SharedCode
 | - bin

Na versão 2.x do runtime das funções, todas as funções na aplicação de função têm de partilhar a mesma pilha de idioma.In version 2.x of the Functions runtime, all functions in the function app must share the same language stack.

O Host. JSON ficheiro contém configurações específicas do tempo de execução e está na pasta raiz da aplicação de função.The host.json file contains runtime-specific configurations and is in the root folder of the function app. R bin pasta contém pacotes e outros ficheiros de biblioteca que requer que a aplicação de funções.A bin folder contains packages and other library files that the function app requires. Consulte os requisitos de idioma específico para um projeto de aplicação de função:See the language-specific requirements for a function app project:

Configurar a implantação contínuaSet up continuous deployment

Para configurar a implantação contínua para um aplicativo de funções existente, conclua estas etapas.To configure continuous deployment for an existing function app, complete these steps. As etapas demonstram a integração com um repositório GitHub, mas etapas semelhantes se aplicam para Azure Repos ou outros repositórios de código-fonte.The steps demonstrate integration with a GitHub repository, but similar steps apply for Azure Repos or other source code repositories.

  1. Em seu aplicativo de funções no portal do Azure, selecionecentro de implantaçãode recursos > de plataforma.In your function app in the Azure portal, select Platform features > Deployment Center.

    Abrir o centro de implantação

  2. Na central de implantação, selecione GitHube, em seguida, selecione autorizar.In Deployment Center, select GitHub, and then select Authorize. Se você já tiver autorizado o GitHub, selecione continuar.If you've already authorized GitHub, select Continue.

    Centro de implantação de serviço Azure App

  3. No GitHub, selecione o botão autorizar AzureAppService .In GitHub, select the Authorize AzureAppService button.

    Autorizar serviço Azure App

    Na central de implantação no portal do Azure, selecione continuar.In Deployment Center in the Azure portal, select Continue.

  4. Selecione um dos seguintes provedores de compilação:Select one of the following build providers:

    • Serviço de compilação do serviço de aplicativo: Melhor quando você não precisa de uma compilação ou se precisa de uma compilação genérica.App Service build service: Best when you don't need a build or if you need a generic build.
    • Azure pipelines (versão prévia) : Melhor quando você precisa de mais controle sobre a compilação.Azure Pipelines (Preview): Best when you need more control over the build. Este provedor está em visualização no momento.This provider currently is in preview.

    Selecionar um provedor de compilação

  5. Configure informações específicas para a opção de controle do código-fonte que você especificou.Configure information specific to the source control option you specified. Para o GitHub, você deve inserir ou selecionar valores para organização, repositórioe ramificação.For GitHub, you must enter or select values for Organization, Repository, and Branch. Os valores se baseiam no local do seu código.The values are based on the location of your code. Em seguida, selecione continuar.Then, select Continue.

    Configurar o GitHub

  6. Examine todos os detalhes e, em seguida, selecione concluir para concluir a configuração da implantação.Review all details, and then select Finish to complete your deployment configuration.

    Resumo

Quando o processo for concluído, todo o código da origem especificada será implantado em seu aplicativo.When the process is finished, all code from the specified source is deployed to your app. Nesse ponto, as alterações na origem da implantação disparam uma implantação dessas alterações em seu aplicativo de funções no Azure.At that point, changes in the deployment source trigger a deployment of those changes to your function app in Azure.

Cenários de implementaçãoDeployment scenarios

Mover funções existentes para implantação contínuaMove existing functions to continuous deployment

Se você já escreveu funções no portal do Azure e deseja baixar o conteúdo do seu aplicativo antes de alternar para a implantação contínua, vá para a guia visão geral do seu aplicativo de funções.If you've already written functions in the Azure portal and you want to download the contents of your app before you switch to continuous deployment, go to the Overview tab of your function app. Selecione o botão baixar conteúdo do aplicativo .Select the Download app content button.

Transferir conteúdo da aplicação

Nota

Depois de configurar a integração contínua, você não poderá mais editar seus arquivos de origem no portal do functions.After you configure continuous integration, you can no longer edit your source files in the Functions portal.

Passos seguintesNext steps