Como baixar e instalar Jenkins on Windows

Jenkins pode ser instalado em qualquer um dos dois Windows ou plataformas Unix, mas este guia se concentra no Windows Instalação apenas. O Windows O instalador MSI registra Jenkins como um Windows serviço e seleciona um de 64 bits Java O instalador oferece um ambiente de execução otimizado, tornando-se a maneira mais rápida de obter um servidor de automação funcional. Antes de abrir o instalador, confirme se sua máquina atende aos requisitos listados na próxima seção.

Jenkins Pré-requisitos e requisitos do sistema

Jenkins É leve em repouso, mas cresce rapidamente à medida que o histórico de compilações, espaços de trabalho e plugins se acumulam. Dimensionar a máquina corretamente desde o início evita uma migração problemática posteriormente.

Requisitos de hardware:

Requisitos de Software:

• Jenkins corre em Java, portanto, um suportado Java Kit de desenvolvimento (JDK) ou Java O ambiente de execução JRE (JRE) deve estar presente. Jenkins Os lançamentos exigem Java 21 ou posterior; Java Os modelos 8, 11 e 17 não são mais suportados pela linha de Suporte de Longo Prazo mais recente.
• É necessário um navegador web moderno para acessar o Jenkins painel de controle.
• Uma conta com direitos administrativos no Windows É necessário um computador para registrar o Jenkins serviço.

Confirme a instalação. Java Verifique a versão do JDK no Prompt de Comando antes de continuar. Se o comando falhar ou retornar uma versão inferior a 21, instale primeiro um JDK compatível.

:: Check the Java version available on the machine
java -version

:: Expected output resembles the following
openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)

Tipos de lançamento

Jenkins Publica duas linhas de lançamento, e a escolha afeta a frequência com que você atualiza.

Este guia utiliza a versão LTS, embora o processo de instalação seja idêntico para a versão semanal. Com os pré-requisitos instalados, o download pode ser iniciado.

Como baixar Jenkins?

Siga os passos abaixo para obter o Windows instalador e concluir uma instalação bem-sucedida:

Passo 1) Acesse https://www.jenkins.io/download/ e selecione a plataforma. No nosso caso, Windows.

Passo 2) Acesse a pasta onde o arquivo foi baixado em seu computador e descompacte o pacote. Double-clique no arquivo descompactado jenkins.msi arquivo. Jenkins Também é possível executar a partir de um arquivo WAR (Web Application Archive), mas esse método não é recomendado. Windows Porque ignora o registro do serviço, que é feito pelo instalador.

Observação: Windows O SmartScreen pode informar que impediu a inicialização de um aplicativo não reconhecido. Selecione Mais informações, Em seguida Correr de qualquer maneira, para dar continuidade ao assinado Jenkins instalador.

Passo 3) De acordo com o relatório Jenkins Na tela de configuração, clique em Seguinte.

Passo 4) Escolha o local onde o Jenkins A instância deve ser instalada. O local padrão nos instaladores de 64 bits atuais é C: \ Arquivos de Programas \JenkinsObserve este caminho, pois a senha inicial do administrador está armazenada nele. Clique. Seguinte.

Passo 5) O instalador solicitará então as credenciais de login do serviço e o número da porta. Forneça uma conta local ou de domínio dedicada e clique em "Avançar". Credenciais de testeEm seguida, defina a porta e clique. Porta de teste. Porta 8080 é o padrão. Executando Jenkins O uso de uma conta de serviço nomeada é mais seguro do que a opção LocalSystem, que concede Jenkins Acesso total à máquina.

Passo 6) Confirme o Java No diretório inicial detectado pelo instalador, revise as opções de configuração personalizadas e clique em Instale botão. Assim que a instalação estiver concluída, clique Acabamento.

Passo 7) Durante o processo de instalação, um painel informativo pode aparecer para avisar que é necessário reiniciar o computador ao final da instalação. Clique em OK botão quando o painel de informações aparecer.

Os arquivos já estão no disco e o serviço está registrado. A próxima etapa desbloqueia a interface web.

Como desbloquear Jenkins?

Depois de completar o Jenkins Durante a fase de instalação, o controlador fica bloqueado até que você forneça uma senha gerada automaticamente. Os passos abaixo explicam como desbloqueá-lo. Jenkins aplicação:

Passo 1) Após a conclusão do processo de instalação, uma aba do navegador será aberta e solicitará a senha inicial de administrador. Para acessar JenkinsAcesse o seguinte caminho no seu navegador web.
http://localhost:8080

Se o endereço acima carregar, a instalação foi bem-sucedida e o serviço está em execução.

Passo 2) A senha inicial do administrador é armazenada em Jenkins Caminho de instalação que você definiu na Etapa 4 da instalação. Para o local padrão. C: \ Arquivos de Programas \Jenkins, um arquivo chamado inicialAdminPassword é encontrado em C: \ Arquivos de Programas \Jenkins\segredosSe um caminho personalizado foi selecionado, verifique esse local. O mesmo valor também é gravado no jenkins.err.log arquivo no Jenkins diretório inicial.

Passo 3) Abra o arquivo destacado e copie o conteúdo do inicialAdminPassword arquivo.

Passo 4) Cole a senha no Senha de administrador campo Desbloquear Jenkins abra a página no seu navegador e clique em Continuar botão.

Com o controlador desbloqueado, o assistente de configuração passa para os plugins e a primeira conta de usuário.

Personalizar Jenkins

Você também pode personalizar seu Jenkins ambiente usando os passos indicados abaixo:

Passo 1) Clique na Instale os plugins sugeridos botão para que Jenkins Recupera e instala os plugins essenciais.

Jenkins Inicia o download e a instalação de todos os plugins necessários para criar novos Jenkins empregos.

Observação: Você pode escolher a opção Selecione os plugins que deseja instalar. e selecione apenas os plugins que desejar. Plugins podem ser adicionados ou removidos posteriormente. Gerenciar Jenkins > PluginsPortanto, essa escolha não é permanente.

Passo 2) Após a instalação de todos os plugins sugeridos, o Criar o primeiro usuário administrador O painel será exibido. Preencha todos os campos com os detalhes da conta desejados e clique em Salvar e terminar botão.

Passo 3) Jenkins finalmente pede o URL onde a instância será acessada. Deixe o valor padrão para evitar confusão posteriormente. Se outro aplicativo já estiver usando a porta 8080, forneça uma porta diferente aqui e clique em Salvar e Continuar botão.

Parabéns! Um novo Jenkins O servidor já está instalado. Clique em Comece a usar Jenkins botão.

O Jenkins A instância está pronta e funcionando, aguardando seu primeiro trabalho. Jenkins tutorial para iniciantes Explica como criar esse emprego.

Como verificar o Jenkins Instalação e gerenciamento do serviço

Um painel de controle que carrega apenas uma vez não é prova de uma instalação íntegra. Isso ocorre porque o instalador MSI registra Jenkins como um Windows O serviço deve sobreviver a uma reinicialização e reiniciar corretamente sob demanda. Execute as verificações abaixo imediatamente após o fechamento do assistente de configuração.

1. Confirme se o serviço existe. Imprensa Win + R, Tipo services.msce pressione Enter. Localize a entrada chamada Jenkins e confirme se o status é Corrida e o tipo de inicialização é Automático.
2. Verifique a conta em uso. Abra as propriedades do Jenkins serviço e revisão do Log On guia. Uma conta de serviço dedicada é preferível ao LocalSystem para qualquer coisa além de experimentação local.
3. Verifique a porta de escuta. Execute netstat -ano | findstr :8080 a partir do Prompt de Comando. Uma entrada LISTENING confirma que Jenkins detém o porto.
4. Leia o banner da versão. Entrar em http://localhost:8080 e leia o número da versão no canto inferior direito do painel. Compare-o com a versão que você baixou.
5. Reinicie uma vez. Reiniciar Windows E acesse o painel de controle novamente sem iniciar nada manualmente. Se a página carregar, o serviço é realmente automático.

O serviço também pode ser controlado a partir de um Prompt de Comando com privilégios elevados, o que é mais rápido do que o console gráfico e funciona bem dentro de scripts de implantação:

:: Stop, start, and query the Jenkins Windows service
net stop "Jenkins"
net start "Jenkins"
sc query "Jenkins"

:: Install Jenkins silently on a fleet of machines
msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^
  INSTALLDIR="D:\Jenkins" ^
  PORT=8080 ^
  /L*v "C:\logs\jenkins-install.txt"

💡 Dica: O instalador silencioso aceita INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME e SERVICE_PASSWORD como substituições de propriedades. Qualquer valor que você não especificar usar será usado como padrão e, no modo silencioso, o serviço será executado como LocalSystem, a menos que uma conta de serviço seja fornecida.

Caso alguma dessas verificações falhe, as causas geralmente são previsíveis, como mostra a próxima seção.

comum Jenkins Erros de instalação em Windows e como corrigi-los

A maioria falhou Windows instalações trace voltamos a um pequeno conjunto de causas: uma causa sem fundamento. Java tempo de execução, uma porta ocupada ou uma conta de serviço sem permissão para fazer login como serviço. Cada um desses problemas produz um sintoma distinto, portanto, a solução geralmente é rápida após a leitura atenta da mensagem.

• Credenciais de login de serviço inválidas: O instalador rejeita a conta durante o processo. Credenciais de teste passo. Abrir secpol.msc, expandir Políticas locais > Atribuição de direitos de usuário, aberto Faça logon como um serviçoAdicione a conta e, em seguida, tente novamente o teste de credenciais.
• A porta 8080 já está em uso: O Porta de teste O botão fica vermelho porque outro aplicativo, geralmente um Tomcat local ou um servidor de desenvolvimento, já está utilizando a porta. Escolha uma porta livre, como a 8081, ou encerre o processo conflitante identificado por netstat -ano.
• Sem suporte ou ausente Java: O instalador não pode preencher previamente o Java diretório inicial, ou o serviço inicia e para imediatamente. Instale um JDK 21 ou posterior de 64 bits e, em seguida, indique o diretório inicial para o instalador.
• O SmartScreen bloqueia o instalador: Windows Relata um aplicativo não reconhecido. Selecione Mais informações, Em seguida Correr de qualquer maneira, após confirmar que o arquivo provinha da fonte oficial Jenkins página de download.
• Arquivo initialAdminPassword não encontrado: Foi escolhido um diretório de instalação personalizado. Veja dentro do secrets pasta desse diretório, ou leia a senha de jenkins.err.log no Jenkins diretório inicial.

Uma vez Jenkins Se o sistema estiver funcionando de forma confiável, o próximo passo natural é conectá-lo a um repositório de código-fonte e a um pipeline de compilação. Os tutoriais em Jenkins Integração com GitHub e pipeline de CI/CD Explique como a integração contínua é implementada em torno dessa instalação.

Perguntas Frequentes