Criar um servidor Jenkins em uma VM Linux do Azure no portal do AzureCreate a Jenkins server on an Azure Linux VM from the Azure portal

Este guia de início rápido mostra como instalar o Jenkins em uma VM Linux Ubuntu com as ferramentas e os plug-ins configurados para funcionar com o Azure.This quickstart shows how to install Jenkins on an Ubuntu Linux VM with the tools and plug-ins configured to work with Azure. Ao concluir, você terá um servidor Jenkins em execução no Azure criando um aplicativo Java de exemplo do GitHub.When you're finished, you have a Jenkins server running in Azure building a sample Java app from GitHub.

Pré-requisitosPrerequisites

  • Uma assinatura do AzureAn Azure subscription
  • Acesso a SSH na linha de comando do computador (como o shell Bash ou o PuTTY)Access to SSH on your computer's command line (such as the Bash shell or PuTTY)

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Criar a VM Jenkins do modelo de soluçãoCreate the Jenkins VM from the solution template

Jenkins dá suporte a um modelo onde o servidor Jenkins delega trabalho para um ou mais agentes para permitir que uma única instalação Jenkins hospede um número grande de projetos ou para fornecer ambientes diferentes, necessários para compilações ou testes.Jenkins supports a model where the Jenkins server delegates work to one or more agents to allow a single Jenkins installation to host a large number of projects or to provide different environments needed for builds or tests. As etapas nesta seção o orientam durante a instalação e configuração de um servidor Jenkins no Azure.The steps in this section guide you through installing and configuring a Jenkins server on Azure.

  1. No navegador, abra a imagem do Azure Marketplace para Jenkins.In your browser, open the Azure Marketplace image for Jenkins.

  2. Selecione OBTENHA AGORA.Select GET IT NOW.

    Selecione OBTENHA AGORA para iniciar o processo de instalação para a imagem do Jenkins Marketplace.

  3. Depois de consultar as informações de termos e detalhes de preços, selecione Continuar.After reviewing the pricing details and terms information, select Continue.

    Informações de termos e preços da imagem do Jenkins Marketplace.

  4. Selecione Criar para configurar o servidor de Jenkins no portal do Azure.Select Create to configure the Jenkins server in the Azure portal.

    Instale a imagem do Jenkins Marketplace.

  5. Na guia Noções Básicas, especifique os seguintes valores:In the Basics tab, specify the following values:

    • Nome - Digite Jenkins.Name - Enter Jenkins.

    • Nome de usuário - Insira o nome de usuário a ser usado ao entrar na máquina virtual que está executando Jenkins.User name - Enter the user name to use when signing in to the virtual machine on which Jenkins is running. O nome de usuário deve atender aos requisitos específicos.The user name must meet specific requirements.

    • Tipo de autenticação - Selecione Chave pública SSH.Authentication type - Select SSH public key.

    • Chave pública SSH - Copie e cole uma chave pública RSA no formato de linha única (iniciando com ssh-rsa) ou no formato PEM de multilinhas.SSH public key - Copy and paste an RSA public key in single-line format (starting with ssh-rsa) or multi-line PEM format. É possível gerar chaves SSH usando ssh-keygen no Linux e macOS ou PuTTYGen no Windows.You can generate SSH keys using ssh-keygen on Linux and macOS, or PuTTYGen on Windows. Para obter mais informações sobre chaves SSH e Azure, consulte o artigo Como usar chaves SSH com o Windows no Azure.For more information about SSH keys and Azure, see the article, How to Use SSH keys with Windows on Azure.

    • Assinatura - Selecione a assinatura do Azure que você deseja para instalar o Jenkins.Subscription - Select the Azure subscription into which you want to install Jenkins.

    • Grupo de recursos - Selecione Criar novo e digite um nome para o grupo de recursos que serve como um contêiner lógico para a coleção de recursos que compõem sua instalação Jenkins.Resource group - Select Create new, and enter a name for the resource group that serves as a logical container for the collection of resources that make up your Jenkins installation.

    • Local - Selecione Leste dos EUA.Location - Select East US.

      Insira informações de grupo de recursos e autenticação para Jenkins na guia Básico.

  6. Selecione OK para prosseguir para a guia Configurações Adicionais.Select OK to proceed to the Additional Settings tab.

  7. Na guia Configurações Adicionais, especifique os seguintes valores:In the Additional Settings tab, specify the following values:

    • Tamanho - Selecione a opção de tamanho apropriado para sua máquina virtual de Jenkins.Size - Select the appropriate sizing option for your Jenkins virtual machine.

    • Tipo de disco de máquina virtual - Especifique HDD (unidade de disco rígido) ou SSD (unidade de estado sólido) para indicar qual tipo de disco de armazenamento é permitido para as máquinas virtuais Jenkins.VM disk type - Specify either HDD (hard-disk drive) or SSD (solid-state drive) to indicate which storage disk type is allowed for the Jenkins virtual machine.

    • Rede virtual - (opcional) Selecione Rede virtual para modificar as configurações padrão.Virtual network - (Optional) Select Virtual network to modify the default settings.

    • Sub-redes - Selecione Sub-redes, verifique as informações e selecione OK.Subnets - Select Subnets, verify the information, and select OK.

    • Endereço IP público - O nome do endereço IP padrão é o nome de Jenkins que você especificou na página anterior com um sufixo de - IP.Public IP address - The IP address name defaults to the Jenkins name you specified in the previous page with a suffix of -IP. Você pode selecionar a opção para alterar esse padrão.You can select the option to change that default.

    • Rótulo de nome de domínio - Especifique o valor para a URL totalmente qualificada para a máquina virtual Jenkins.Domain name label - Specify the value for the fully qualified URL to the Jenkins virtual machine.

    • Tipo de versão Jenkins - Selecione o tipo de versão desejada entre as opções: LTS, Weekly build ou Azure Verified.Jenkins release type - Select the desired release type from the options: LTS, Weekly build, or Azure Verified. As opções LTS e Weekly build são explicadas no artigo Linha de versão Jenkins LTS.The LTS and Weekly build options are explained in the article, Jenkins LTS Release Line. A opção Azure Verified refere-se a uma versão Jenkins LTS que foi verificada para executar no Azure.The Azure Verified option refers to a Jenkins LTS version that has been verified to run on Azure.

    • Tipo de JDK – JDK a ser instalado.JDK Type - JDK to be installed. O padrão são builds certificados do OpenJDK testados por Zulu.Default is Zulu tested, certified builds of OpenJDK.

      Insira as configurações de máquina virtual para Jenkins na guia Configurações.

  8. Selecione OK para prosseguir para a guia Configurações de Integração.Select OK to proceed to the Integration Settings tab.

  9. Na guia Configurações de Integração, especifique os valores a seguir:In the Integration Settings tab, specify the following values:

    • Entidade de Serviço - A entidade de serviço é adicionada ao Jenkins como uma credencial para autenticação com o Azure.Service Principal - The service principal is added into Jenkins as a credential for authentication with Azure. Auto significa que a entidade será criada pela MSI (Identidade de Serviço Gerenciada).Auto means that the principal will be created by MSI (Managed Service Identity). Manual significa que a entidade deve ser criada por você.Manual means that the principal should be created by you.
      • ID do Aplicativo e Segredo - Se você selecionar a opção Manual para a opção Entidade de Serviço, será necessário especificar Application ID e Secret para a entidade de serviço.Application ID and Secret - If you select the Manual option for the Service Principal option, you'll need to specify the Application ID and Secret for your service principal. Ao criar uma entidade de serviço, observe que a função padrão é Colaborador, que é suficiente para trabalhar com recursos do Azure.When creating a service principal, note that the default role is Contributor, which is sufficient for working with Azure resources.
    • Habilitar agentes de nuvem - Especifica o modelo de nuvem padrão para os agentes em que ACI faz referência à Instância do Contêiner do Azure e VM refere-se às máquinas virtuais.Enable Cloud Agents - Specify the default cloud template for agents where ACI refers to Azure Container Instance, and VM refers to virtual machines. Também é possível especificar No se não desejar habilitar um agente de nuvem.You can also specify No if you don't wish to enable a cloud agent.
  10. Selecione OK para prosseguir para a guia Resumo.Select OK to proceed to the Summary tab.

  11. Quando a guia Resumo aparece, as informações inseridas são validadas.When the Summary tab displays, the information entered is validated. Depois de ver a mensagem Validação aprovada (na parte superior da guia), selecione OK.Once you see the Validation passed message (at the top of the tab), select OK.

    Na guia Resumo exibe e valida as opções selecionadas.

  12. Quando a guia Criar aparecer, selecione Criar para criar a máquina virtual Jenkins.When the Create tab displays, select Create to create the Jenkins virtual machine. Quando o servidor estiver pronto, uma notificação aparecerá no portal do Azure.When your server is ready, a notification displays in the Azure portal.

    Notificação de que Jenkins está pronto.

Conectar-se ao JenkinsConnect to Jenkins

Navegue até sua máquina virtual (por exemplo, http://jenkins2517454.eastus.cloudapp.azure.com/) no navegador da web.Navigate to your virtual machine (for example, http://jenkins2517454.eastus.cloudapp.azure.com/) in your web browser. O console do Jenkins não pode ser acessado por meio de HTTP não segura e, portanto, instruções são fornecidas na página para acessar o console do Jenkins com segurança do seu computador usando um túnel SSH.The Jenkins console is inaccessible through unsecured HTTP so instructions are provided on the page to access the Jenkins console securely from your computer using an SSH tunnel.

Desbloquear Jenkins

Configure o túnel usando o comando ssh na página a partir da linha de comando, substituindo username pelo nome do usuário administrador da máquina virtual escolhido anteriormente durante a configuração da máquina virtual no modelo de solução.Set up the tunnel using the ssh command on the page from the command line, replacing username with the name of the virtual machine admin user chosen earlier when setting up the virtual machine from the solution template.

ssh -L 127.0.0.1:8080:localhost:8080 jenkinsadmin@jenkins2517454.eastus.cloudapp.azure.com

Depois de iniciar o túnel, navegue para http://localhost:8080/ no computador local.After you have started the tunnel, navigate to http://localhost:8080/ on your local machine.

Obtenha a senha inicial executando o comando abaixo na linha de comando, enquanto estiver conectado à VM Jenkins por meio do SSH.Get the initial password by running the following command in the command line while connected through SSH to the Jenkins VM.

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

Desbloqueie o painel Jenkins pela primeira vez usando essa senha inicial.Unlock the Jenkins dashboard for the first time using this initial password.

Desbloquear Jenkins

Selecione Instalar plug-ins sugeridos na próxima página e crie um usuário administrador do Jenkins usado para acessar o painel do Jenkins.Select Install suggested plugins on the next page and then create a Jenkins admin user used to access the Jenkins dashboard.

O Jenkins está pronto!

O servidor Jenkins agora está pronto para compilar código.The Jenkins server is now ready to build code.

Criar seu primeiro trabalhoCreate your first job

Selecione Criar novos trabalhos no console do Jenkins, nomeie-o mySampleApp e selecione projeto Freestyle. Em seguida, selecione OK.Select Create new jobs from the Jenkins console, then name it mySampleApp and select Freestyle project, then select OK.

Criar um novo trabalho

Selecione a guia Gerenciamento de código-fonte, habilite o Gite digite a seguinte URL no campo URL do Repositório:https://github.com/spring-guides/gs-spring-boot.gitSelect the Source Code Management tab, enable Git, and enter the following URL in Repository URL field: https://github.com/spring-guides/gs-spring-boot.git

Definir o repositório Git

Selecione a guia Build e selecione Adicionar etapa de compilação, Invocar script Gradle.Select the Build tab, then select Add build step, Invoke Gradle script. Selecione Usar Wrapper Gradle, digite complete na localização do Wrapper e build como Tarefas.Select Use Gradle Wrapper, then enter complete in Wrapper location and build for Tasks.

Use o wrapper Gradle para compilar

Selecione Avançado e insira complete no campo Script de Compilação da Raiz.Select Advanced and then enter complete in the Root Build script field. Clique em Salvar.Select Save.

Definir as configurações avançadas na etapa de compilação do wrapper Gradle

Compilar o códigoBuild the code

Selecione Criar agora para compilar o código e empacotar o aplicativo de exemplo.Select Build Now to compile the code and package the sample app. Quando a compilação for concluída, selecione o link Workspace para o projeto.When your build completes, select the Workspace link for the project.

Navegue até o workspace para obter o arquivo JAR da compilação

Navegue até complete/build/libs e verifique se o gs-spring-boot-0.1.0.jar está disponível a fim de verificar se a compilação foi bem-sucedida.Navigate to complete/build/libs and ensure the gs-spring-boot-0.1.0.jar is there to verify that your build was successful. O servidor Jenkins agora está pronto para criar seus próprios projetos no Azure.Your Jenkins server is now ready to build your own projects in Azure.

Solução de problemas do modelo de solução do JenkinsTroubleshooting the Jenkins solution template

Caso encontre bugs com o modelo de solução do Jenkins, registre um problema no repositório GitHub do Jenkins.If you encounter any bugs with the Jenkins solution template, file an issue in the Jenkins GitHub repo.

Próximas etapasNext Steps