Tutorial: Implantar no Azure Functions com Jenkins

O Azure Functions é um serviço de computação sem servidor. Usando o Azure Functions, você pode executar código sob demanda sem provisionar ou gerenciar infraestrutura. Este tutorial mostra como implantar uma função Java no Azure Functions usando o plug-in do Azure Functions.

Pré-requisitos

• Subscrição do Azure: se não tem uma subscrição do Azure, crie uma conta gratuita antes de começar.
• Servidor Jenkins: Se você não tiver um servidor Jenkins instalado, consulte o artigo Criar um servidor Jenkins no Azure.

Ver o código-fonte

O código-fonte usado para este tutorial está localizado no repositório GitHub do Visual Studio China.

Criar uma função Java

Para criar uma função em Java com o stack de execução em Java, use o portal do Azure ou a Azure CLI.

As etapas a seguir mostram como criar uma função Java usando a CLI do Azure:

1. Crie um grupo de recursos, substituindo o marcador <resource_group> pelo nome do seu grupo de recursos.

   az group create --name <resource_group> --location eastus
   

2. Crie uma conta de armazenamento do Azure, substituindo os marcadores de posição pelos valores apropriados.

   az storage account create --name <storage_account> --location eastus --resource-group <resource_group> --sku Standard_LRS    
   

3. Crie a aplicação de função de teste, substituindo os marcadores de posição pelos valores apropriados.

   az functionapp create --resource-group <resource_group> --runtime java --consumption-plan-location eastus --name <function_app> --storage-account <storage_account> --functions-version 2
   

Preparar o servidor Jenkins

As etapas a seguir explicam como preparar o servidor Jenkins:

1. Implante um servidor Jenkins no Azure. Se ainda não tiver uma instância do servidor Jenkins instalada, o artigo Criar um servidor Jenkins no Azure orienta-o ao longo do processo.

2. Entre na instância do Jenkins com SSH.

3. Na instância Jenkins, instale Az CLI, versão 2.0.67 ou superior.

4. Instale o maven usando o seguinte comando:

   sudo apt install -y maven
   

5. Na instância Jenkins, instale as Ferramentas Principais do Azure Functions emitindo os seguintes comandos em um prompt de terminal:

   curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
   sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg
   sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-$(lsb_release -cs)-prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list'
   cat /etc/apt/sources.list.d/dotnetdev.list
   sudo apt-get update
   sudo apt-get install azure-functions-core-tools-3
   

6. Jenkins precisa de um principal de serviço do Azure para autenticar e aceder aos recursos do Azure. Consulte Implantar no Serviço de Aplicativo do Azure para obter instruções passo a passo.

7. Certifique-se de que o plug-in de Credenciais está instalado.

   1. No menu, selecione Gerenciar Jenkins.

   2. Em Configuração do sistema, selecione Gerenciar plug-in.

   3. Selecione a guia Instalado.

   4. No campo de filtro , digite credentials.

   5. Verifique se o plug-in de Credenciais está instalado. Caso contrário, terá de instalá-lo a partir do separador Disponível .

   

8. No menu, selecione Gerenciar Jenkins.

9. Em Segurança, selecione Gerir Credenciais.

10. Em Credenciais, selecione (global).

11. No menu, selecione Adicionar credenciais.

12. Insira os seguintes valores para os seus principais serviços do Microsoft Azure:

    • Tipo: Selecione o valor: Nome de usuário com senha.
    • Nome de usuário: especifique a appId entidade de serviço criada.
    • Palavra-passe: especifique o password (segredo) do principal do serviço.
    • ID: especifique o identificador de credencial, como azuresp.

13. Selecione OK.

Fork o repositório GitHub de exemplo

1. Faça login no repositório GitHub para o aplicativo de amostra ímpar ou par.

2. No canto superior direito do GitHub, escolha Fork.

3. Siga as instruções para selecionar a sua conta do GitHub e concluir o fork.

Criar uma pipeline em Jenkins

Nesta seção, você cria o Jenkins Pipeline.

1. No dashboard do Jenkins, crie um "Pipeline".

2. Habilite Preparar um ambiente para a execução.

3. Na seção Pipeline->Definição, selecione Script de Pipeline do SCM.

4. Insira o URL e o caminho do script da bifurcação do GitHub ("doc/resources/jenkins/JenkinsFile") para usar no exemplo do JenkinsFile.

    node {
    withEnv(['AZURE_SUBSCRIPTION_ID=99999999-9999-9999-9999-999999999999',
            'AZURE_TENANT_ID=99999999-9999-9999-9999-999999999999']) {
        stage('Init') {
            cleanWs()
            checkout scm
        }
   
        stage('Build') {
            sh 'mvn clean package'
        }
   
        stage('Publish') {
            def RESOURCE_GROUP = '<resource_group>' 
            def FUNC_NAME = '<function_app>'
            // login Azure
            withCredentials([usernamePassword(credentialsId: 'azuresp', passwordVariable: 'AZURE_CLIENT_SECRET', usernameVariable: 'AZURE_CLIENT_ID')]) {
            sh '''
                az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
                az account set -s $AZURE_SUBSCRIPTION_ID
            '''
            }
            sh 'cd $PWD/target/azure-functions/odd-or-even-function-sample && zip -r ../../../archive.zip ./* && cd -'
            sh "az functionapp deployment source config-zip -g $RESOURCE_GROUP -n $FUNC_NAME --src archive.zip"
            sh 'az logout'
            }
        }
    }
   

Criar e implantar

Agora é hora de executar o trabalho de Jenkins.

1. Primeiro, obtenha a chave de autorização por meio das instruções no artigo Gatilhos e ligações HTTP do Azure Functions .

2. No navegador, insira o URL do aplicativo. Substitua os espaços reservados pelos valores apropriados e especifique um valor numérico para <input_number> como entrada para a função Java.

   https://<function_app>.azurewebsites.net/api/HttpTrigger-Java?code=<authorization_key>&number=<input_number>
   

3. Você verá resultados semelhantes ao seguinte exemplo de saída (onde um número ímpar - 365 - foi usado como teste):

   The number 365 is Odd.
   

Limpeza de recursos

Se você não vai continuar a usar este aplicativo, exclua os recursos que você criou com a seguinte etapa:

az group delete -y --no-wait -n <resource_group>

Próximos passos