Compartilhar via


Introdução: Instalar o Jenkins em uma VM Linux do Azure

Este artigo mostra como instalar o Jenkins em uma VM do Ubuntu Linux com as ferramentas e os plug-ins configurados para funcionar com o Azure.

Neste artigo, você aprenderá a:

  • Criar um arquivo de instalação que baixe e instale o Jenkins
  • Criar um grupos de recursos
  • Criar uma máquina virtual com o arquivo de instalação
  • Abrir a porta 8080 para acessar o Jenkins na máquina virtual
  • Conectar-se à máquina virtual via SSH
  • Configurar um trabalho de exemplo do Jenkins com base em um aplicativo Java de exemplo no GitHub
  • Criar o trabalho de exemplo do Jenkins

1. Configurar seu ambiente

  • Assinatura do Azure: caso você não tenha uma assinatura do Azure, crie uma conta gratuita antes de começar.

2. Abrir o Cloud Shell

  1. Se você já tem uma sessão do Cloud Shell aberta, pode pular para a próxima seção.

  2. Navegue para o portal do Azure

  3. Se necessário, faça logon em sua assinatura do Azure e altere o diretório do Azure.

  4. Abra o Azure Cloud Shell.

    Open Cloud Shell from the top menu in the Azure portal.

  5. Se você ainda não usou o Cloud Shell, defina as configurações de ambiente e armazenamento.

  6. Selecione o ambiente de linha de comando.

    Select the CLI you want to use in Cloud Shell.

3. Criar uma máquina virtual

  1. Crie um diretório de teste chamado jenkins-get-started.

  2. Mude para o diretório de teste.

  3. Crie um arquivo chamado cloud-init-jenkins.txt.

  4. Cole o seguinte código no novo arquivo:

    #cloud-config
    package_upgrade: true
    runcmd:
      - sudo apt install openjdk-11-jre -y
      - curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
      -  echo 'deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/' | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
      - sudo apt-get update && sudo apt-get install jenkins -y
      - sudo service jenkins restart
    
    
    
  5. Execute az group create para criar um grupo de recursos.

    az group create --name jenkins-get-started-rg --location eastus
    
  6. Execute az vm create para criar uma máquina virtual.

    az vm create \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm \
    --image UbuntuLTS \
    --admin-username "azureuser" \
    --generate-ssh-keys \
    --public-ip-sku Standard \
    --custom-data cloud-init-jenkins.txt
    
  7. Execute az vm list para confirmar a criação (e o estado) da nova máquina virtual.

    az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"
    
  8. Conforme o Jenkins for executado na porta 8080, execute az vm open para abrir a porta 8080 na nova máquina virtual.

    az vm open-port \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm  \
    --port 8080 --priority 1010
    

4. Configurar o Jenkins

  1. Execute az vm show para obter o endereço IP público para a máquina virtual de exemplo.

    az vm show \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm -d \
    --query [publicIps] \
    --output tsv
    

    Pontos principais:

    • O parâmetro --query limita a saída para os endereços IP públicos para a máquina virtual.
  2. Usando o endereço IP recuperado na etapa anterior, conecte-se por SSH à máquina virtual. Você precisará confirmar a solicitação de conexão.

    ssh azureuser@<ip_address>
    

    Pontos principais:

    • Após a conexão bem-sucedida, o prompt do Cloud Shell inclui o nome de usuário e o nome da máquina virtual: azureuser@jenkins-get-started-vm.
  3. Verifique se o Jenkins está em execução obtendo o status do serviço Jenkins.

    service jenkins status
    

    Pontos principais:

    • Se você receber um erro indicando que o serviço não existe, talvez precise aguardar alguns minutos para que tudo seja instalado e inicializado.
  4. Obtenha a senha do Jenkins gerada automaticamente.

    sudo cat /var/lib/jenkins/secrets/initialAdminPassword
    
  5. Usando o endereço IP, abra a seguinte URL em um navegador: http://<ip_address>:8080

  6. Insira a senha que você recuperou anteriormente e selecione Continuar.

    Initial page to unlock Jenkins

  7. Escolha Selecionar plug-in para instalar.

    Select the option to install selected plug-ins

  8. Na caixa de diálogo de filtro na parte superior da página, insira github. Selecione o plug-in do GitHub e escolha Instalar.

    Install the GitHub plug-ins

  9. Insira as informações do primeiro usuário administrador e selecione Salvar e Continuar.

    Enter information for first admin user

  10. Na página Configuração da Instância, selecione Salvar e Concluir.

    Confirmation page for instance configuration

  11. Selecione Começar a usar o Jenkins.

    Jenkins is ready!

5. Criar seu primeiro trabalho

  1. Na home page do Jenkins, selecione Criar um trabalho.

    Jenkins console home page

  2. Insira um nome de trabalho de mySampleApp, selecione Projeto Freestyle e selecione OK.

    New job creation

  3. Selecione a guia Gerenciamento de Código-Fonte. Habilite o Git e insira a seguinte URL como o valor de URL do Repositório: https://github.com/spring-guides/gs-spring-boot.git. Em seguida, altere o especificador de branch para */main.

    Define the Git repo

  4. Selecione a guia Build e depois selecione Adicionar etapa de build

    Add a new build step

  5. No menu suspenso, selecione Invocar script Gradle.

    Select the Gradle script option

  6. Selecione Usar Wrapper Gradle, digite complete na localização do Wrapper e build como Tarefas.

    Gradle script options

  7. Selecione Avançado e insira complete no campo Script de Build Raiz.

    Advanced Gradle script options

  8. Role até a parte inferior da página e selecione Salvar.

6. Criar o aplicativo Java de exemplo

  1. Quando a home page do projeto for exibida, selecione Criar agora para compilar o código e empacotar o aplicativo de exemplo.

    Project home page

  2. Um gráfico abaixo do título Histórico de Build indica que o trabalho está sendo compilado.

    Job-build in progress

  3. Quando o build for concluído, selecione o link Workspace.

    Select the workspace link.

  4. Navegue até complete/build/libs para ver se o arquivo .jar foi criado com êxito.

    The target library verifies the build succeeded.

  5. O servidor Jenkins agora está pronto para criar seus próprios projetos no Azure.

Solução de problemas

Se você encontrar problemas ao configurar o Jenkins, veja a página de instalação do Jenkins para obter as instruções mais recentes e informações sobre problemas conhecidos.

Próximas etapas