Como Instalar o Nexus Repository Manager no Ubuntu 22.04

O Nexus é um dos gerenciadores de repositórios mais populares no mundo DevOps. Ele permite que você armazene e recupere artefatos de construção e também fornece recursos para enviar e puxar artefatos via ferramentas de integração CI e IDE, como Visual Studio e Jenkins.

Existem duas versões do gerenciador de repositórios Nexus: a versão comercial e a versão de código aberto. Ele suporta muitos formatos, como PyPi, Docker, Yum, APT, Helm, npm, Go, R e muitos mais.

Usar o Nexus como um repositório permite que seus desenvolvedores obtenham e gerenciem pacotes no gerenciador de repositórios centralizado, o que também dá à equipe de desenvolvedores uma única fonte de verdade para cada pacote.

Neste tutorial, explicaremos como instalar o Nexus Repository Manager em um servidor Ubuntu 22.04. Este tutorial também inclui a instalação de alguns pacotes, como Java OpenJDK e o servidor web Nginx, que será usado como um proxy reverso.

Pré-requisitos

Antes de começar, você precisará dos seguintes requisitos:

• Um servidor Ubuntu 22.04.
• Um usuário não-root com sudo/administrador habilitado.
• Um nome de domínio apontado para o endereço IP do seu servidor Ubuntu (para produção).

Instalando o Java OpenJDK 8

O Nexus Repository Manager requer Java OpenJDK e JRE v8. O repositório padrão do Ubuntu fornece várias versões do Java, então agora você instalará o Java OpenJDK e JRE v8 do repositório do Ubuntu.

Antes de instalar qualquer pacote, execute o comando apt abaixo para atualizar e refrescar o índice de pacotes do seu repositório.

sudo apt update

Agora, instale o Java OpenJDK 8 via o comando apt abaixo. Digite Y quando solicitado para confirmar a instalação e pressione ENTER para prosseguir.

sudo apt install openjdk-8-jdk

Uma vez que o Java esteja instalado, verifique a versão do Java no seu sistema usando o seguinte comando.

java -version

Você verá a saída na captura de tela a seguir:

Configurando o Sistema

Para instalar o Nexus, você precisará criar um novo usuário Linux dedicado com um shell válido e também precisará configurar o número máximo de arquivos abertos para os limites duros e suaves para ‘65536‘.

Execute o seguinte comando para criar um novo usuário dedicado para o Nexus com o nome ‘nexus‘.

sudo useradd -d /opt/nexus -s /bin/bash nexus  
sudo passwd nexus

Em seguida, defina o ulimit para ‘65536‘ usando o comando abaixo. Isso afetará temporariamente o sistema no sistema atual. Para torná-lo permanente, você pode criar um novo arquivo de configuração que você fará na próxima etapa.

ulimit -n 65536

Para configurar o ulimit permanentemente, crie um novo arquivo de configuração ‘/etc/security/limits.d/nexus.conf‘ usando o editor nano.

sudo nano /etc/security/limits.d/nexus.conf

Adicione a seguinte configuração ao arquivo. Neste exemplo, você está configurando o ulimit para o usuário específico ‘nexus‘ com o valor ‘65536‘.

nexus - nofile 65536

Salve o arquivo e saia do editor quando terminar.

Com todos os requisitos básicos em vigor e configurados, você está pronto para instalar o Nexus Repository Manager no seu sistema Ubuntu.

Instalando o Nexus Repository Manager

O Nexus Repository Manager pode ser instalado via o pacote de distribuição que você pode baixar da página oficial de downloads da Sonatype. No momento da redação deste texto, a versão mais recente do Nexus é a v3.41.1. Agora, você fará o download do pacote de distribuição do Nexus Repository Manager e configurará a instalação do Nexus.

Baixe o pacote do Nexus Repository Manager via o comando wget como abaixo. Se o processo de download for concluído, você verá o arquivo ‘nexus-3.41.1-01-unix.tar.gz’ no seu diretório de trabalho atual.

wget https://download.sonatype.com/nexus/3/nexus-3.41.1-01-unix.tar.gz

Agora extraia o arquivo ‘nexus-3.41.1-01-unix.tar.gz‘ via o comando tar abaixo. E você deve obter dois diretórios, ‘nexus-3.41.1-01‘ e ‘sonatype-work‘.

O diretório ‘nexus-3.41.1-01‘ é o diretório principal para o pacote Nexus, e o diretório ‘sonatype-work’ é o diretório de trabalho principal para o Nexus.

tar xzf nexus-3.41.1-01-unix.tar.gz

Em seguida, mova os diretórios extraídos para ‘/opt’ usando o seguinte comando. O diretório do pacote Nexus será ‘/opt/nexus’ e o diretório de trabalho do Nexus será ‘/opt/sonatype-work‘.

mv nexus-3.41.1-01 /opt/nexus  
mv sonatype-work /opt/

Por último, mude a propriedade de ambos os diretórios para o usuário e grupo ‘nexus’ via o comando chown abaixo.

chown -R nexus:nexus /opt/nexus /opt/sonatype-work

Em seguida, você configurará sua instalação do Nexus editando alguns dos arquivos de configuração do Nexus.

Abra o arquivo ‘/opt/nexus/bin/nexus.rc’ usando o editor nano.

sudo nano /opt/nexus/bin/nexus.rc

Descomente a opção ‘run_as_user‘ e mude o valor para ‘nexus’. Com esta configuração, você estará executando o aplicativo Nexus como o usuário do sistema ‘nexus‘.

run_as_user="nexus"

Salve o arquivo e saia do editor quando terminar.

Em seguida, abra o arquivo de configuração ‘/etc/nexus/bin/nexus.vmoptions’ usando o editor nano para configurar a memória máxima do heap para o Nexus.

sudo nano /etc/nexus/bin/nexus.vmoptions

Altere a memória máxima do heap padrão para sua instalação do Nexus nas seguintes opções. Você pode alterar o tamanho para ‘1024m‘ com base na memória que você tem no seu servidor.

-Xms1024m  
-Xmx1024m  
-XX:MaxDirectMemorySize=1024m

Salve o arquivo e saia do editor quando terminar.

Agora, edite o arquivo de configuração ‘/opt/sonatype-work/nexus3/etc/nexus.properties‘ usando o editor nano.

sudo nano /opt/sonatype-work/nexus3/etc/nexus.properties

Descomente a opção ‘application-host’ e mude o valor para ‘127.0.0.1‘. Isso significa que você estará executando o Nexus no localhost ou no endereço IP ‘127.0.0.1‘.

application-host=127.0.0.1

Salve o arquivo e saia do editor.

Agora você tem o Nexus Repository Manager baixado e configurado. Em seguida, você configurará um arquivo de serviço systemd para o Nexus.

Executando o Nexus como Serviço SystemD

Em uma instalação padrão, o Nexus Repository Manager pode ser executado manualmente via o comando binário ‘nexus’ que está disponível no diretório ‘/opt/nexus/bin’. Mas, para facilitar o gerenciamento do Nexus, você configurará um arquivo de serviço systemd para o Nexus.

Executar o Nexus com o arquivo de serviço systemd permite que você gerencie o processo do Nexus via o comando systemctl.

Agora, crie um novo arquivo de serviço ‘/etc/systemd/system/nexus.service‘ usando o editor nano.

sudo nano /etc/systemd/system/nexus.service

Adicione a seguinte configuração ao arquivo.

[Unit]  
Description=nexus service  
After=network.target  
  
[Service]  
Type=forking  
LimitNOFILE=65536  
ExecStart=/opt/nexus/bin/nexus start  
ExecStop=/opt/nexus/bin/nexus stop  
User=nexus  
Restart=on-abort  
  
[Install]  
WantedBy=multi-user.target

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o seguinte comando para recarregar o gerenciador systemd e aplicar um novo arquivo de serviço para o Nexus.

sudo systemctl daemon-reload

Inicie e habilite o ‘nexus.service‘ via o comando systemctl abaixo. O Nexus Repository Manager agora será iniciado no endereço IP local 127.0.0.1 com a porta padrão ‘8081’. Além disso, o ‘nexus.service‘ será executado automaticamente na inicialização do sistema.

sudo systemctl start nexus.service  
sudo systemctl enable nexus.service

Por último, execute o seguinte comando para verificar o ‘nexus.service’ e garantir que o serviço está em execução.

sudo systemctl status nexus.service

Com o Nexus em execução como um serviço systemd, você pode agora configurar um proxy reverso para o Nexus.

Executando o Nexus com Proxy Reverso

O Nexus Repository Manager agora está em execução no endereço IP local ‘127.0.0.1’ com a porta padrão ‘8081’. Para torná-lo acessível de fora da rede, você usará o proxy reverso Nginx que estará em execução nas portas padrão HTTP/HTTPS.

Execute o seguinte comando apt para instalar o servidor web Nginx no seu sistema Ubuntu. Quando solicitado a confirmar a instalação, digite Y e pressione ENTER para prosseguir.

sudo apt install nginx

Uma vez que o Nginx esteja instalado, execute o seguinte comando systemctl para verificar e confirmar o serviço nginx. Você deve ver que o serviço nginx está habilitado e será executado automaticamente na inicialização do sistema. E o status do serviço nginx está em execução.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Em seguida, crie uma nova configuração de bloco de servidor ‘/etc/nginx/sites-available/nexus‘ usando o editor nano.

sudo nano /etc/nginx/sites-available/nexus

Adicione a seguinte configuração do Nginx ao arquivo e certifique-se de alterar o nome do domínio.

upstream nexus3 {  
  server 127.0.0.1:8081;  
}  
  
server {  
    listen 80;  
    server_name nexus.howtoforge.local;  
  
    location / {  
        proxy_pass http://nexus3/;  
        proxy_http_version 1.1;  
        proxy_set_header Upgrade $http_upgrade;  
        proxy_set_header Connection "upgrade";  
        proxy_set_header Host $http_host;  
  
        proxy_set_header X-Real-IP $remote_addr;  
        proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;  
        proxy_set_header X-Forward-Proto http;  
        proxy_set_header X-Nginx-Proxy true;  
  
        proxy_redirect off;  
    }  
}

Salve o arquivo e saia do editor.

Em seguida, execute o seguinte comando para ativar a configuração do bloco de servidor para o Nexus criando um symlink do arquivo de configuração para o diretório ‘sites-enabled‘. Depois, verifique a configuração do Nginx para garantir que o Nginx está configurado corretamente.

sudo ln -s /etc/nginx/sites-available/nexus /etc/nginx/sites-enabled/  
sudo nginx -t

Se sua configuração do Nginx estiver configurada corretamente, você deve receber a mensagem de saída como “teste bem-sucedido”.

Por último, execute o seguinte comando para reiniciar o serviço Nginx e aplicar a nova configuração do bloco de servidor para o Nexus.

sudo systemctl restart nginx

Agora você configurou o servidor web Nginx como um proxy reverso para o Nexus Repository Manager na sua máquina Ubuntu. Você pode agora acessar sua instalação do Nexus através do seu nome de domínio.

Instalação do Nexus Repository Manager

Neste ponto, o Nexus Repository Manager está em execução sob o proxy reverso Nginx. E está acessível através do nome de domínio da sua instalação.

Abra o navegador web e visite o nome de domínio da sua instalação do Nexus (ou seja: http://nexus.howtoforge.local). E você deve ver a página padrão do Nexus conforme abaixo.

Clique no botão “Entrar“ para fazer login no painel de administração do Nexus.

A senha padrão do administrador para o Nexus está armazenada no arquivo ‘/opt/sonatype-work/nexus3/admin.properties‘ com o nome de usuário padrão admin.

Volte ao seu terminal e execute o seguinte comando para obter a senha padrão para login no Nexus. Em seguida, copie a senha padrão para o Nexus.

cat /opt/sonatype-work/nexus3/admin.properties

Em seguida, insira o usuário admin e cole a senha para o Nexus. Depois, clique em “Entrar“.

Agora você verá o assistente de configuração do Nexus Repository Manager. Clique em “Próximo“ para prosseguir.

Insira a nova senha forte para sua instalação do Nexus e repita. Em seguida, clique em “Próximo“ novamente.

Para a configuração de “Acesso Anônimo”. Selecione a opção “Desabilitar acesso anônimo“ e clique em “Próximo“.

Agora clique em “Concluir“ para completar a configuração do Nexus.

Após a configuração do Nexus ser concluída, você verá agora o painel de administração do Nexus. Na captura de tela abaixo, você pode ver o Nexus Repository Manager.

Por último, verifique sua instalação do Nexus através do botão de verificação de status na parte superior. Agora, certifique-se de que todos os status do sistema estão verificados como verdes, o que significa que a instalação e configuração do Nexus foram bem-sucedidas.

Conclusão

Neste tutorial, você configurou o Nexus Repository Manager em um servidor Ubuntu 22.04. Você também configurou o servidor web Nginx como um proxy reverso para o Nexus. Agora você pode adicionar repositórios dos seus projetos ao gerenciador de repositórios Nexus e centralizar a fonte dos seus projetos para que você possa facilmente construir e distribuir suas aplicações para os desenvolvedores.

Se você estiver interessado em executar o Nexus em produção, pode configurar a segurança do seu Nexus com SSL/TLS via Letsencrypt.