Configurando o Nexus

DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. O serviço Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-tor, us-east. O Code Risk Analyzer também será descontinuado em todas as regiões nessa data. Se uma região não apresentar uso ativo desses recursos, os recursos nessa região poderão ser descontinuados mais cedo e deixar de aceitar novas instâncias. Saiba mais

Configure o Gerenciador de Repositório do Nexus para armazenar artefatos de construção em seu repositório do Nexus (repositório).

Se você estiver configurando essa integração de ferramenta durante a criação da cadeia de ferramentas, na seção Integrações configuráveis, clique em Nexus.
Se você já possui uma cadeia de ferramentas e deseja adicionar essa integração de ferramenta a ela, no console do IBM Cloud, clique no ícone de menu ( ) > Automação de Plataforma > Cadeias de Ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas para abrir a sua página de Visão geral.

a. Clique em Incluir ferramenta.

b. Na seção Integrações de ferramentas, clique em Nexus.
Digite um nome para essa instância da integração de ferramenta Nexus.
Digite a URL do repositório Nexus que você deseja abrir ao clicar no cartão do Nexus de sua cadeia de ferramentas.
Selecione o tipo de repositório ao qual deseja se conectar.
Se tiver selecionado registro npm, siga estas etapas:

a. Digite o endereço de e-mail que está associado ao seu registro.

b. Digite o token de autenticação que está associado ao seu registro.

c. Digite a URL para seu repositório de liberação Nexus, que é seu registro privado no servidor Nexus.

d. Digite a URL para o registro de Espelho ou Público que você usa para combinar múltiplos registros npm públicos e privados. Por exemplo, essa URL pode ser a URL do registro virtual no servidor Nexus que pode acessar seu registro privado e um cache do registro global npm.
Se você tiver selecionado repositório Maven, siga estas etapas:

a. Digite o ID do usuário que está associado ao seu repositório.

b. Digite a senha que está associada ao seu repositório.

c. Digite a URL para seu repositório de liberação do Nexus, que é seu repositório de liberação privada no servidor Nexus.

d. Digite a URL para seu repositório de captura instantânea do Nexus, que é seu repositório de captura instantânea privada no servidor Nexus.

e. Digite a URL para o repositório de Espelho ou Público que você usa para combinar múltiplos repositórios Maven públicos e privados. Por exemplo, essa URL pode ser a URL do repositório virtual no servidor Nexus que pode acessar seu repositório privado e um cache do repositório central Maven.
Clique em Criar integração.
Na página Visão Geral da sua cadeia de ferramentas, na placa Ferramentas de terceiros, clique no repositório Nexus com o qual deseja trabalhar. O website do Nexus é aberto, no qual é possível visualizar os conteúdos do repositório.
Opcional: se você estiver usando uma cadeia de ferramentas no IBM Cloud Public e desejar construir seu app usando o Nexus com npm, configure seu pipeline para incluir uma tarefa de construção npm. Para obter instruções para configurar a tarefa de construção, veja a seção Configurando uma tarefa de construção npm do Nexus em seu pipeline.
Opcional: se você estiver usando uma cadeia de ferramentas no IBM Cloud Public e desejar construir seu app usando o Nexus com Maven, configure seu pipeline para incluir uma tarefa de construção Maven. Para obter instruções para configurar a tarefa de construção, veja a seção Configurando uma tarefa de construção Maven do Nexus em seu pipeline.

Configurando uma tarefa de construção npm do Nexus em seu pipeline

Antes de configurar uma tarefa de construção npm em seu pipeline, será necessário um pipeline funcional que possa usar seu repositório SCM de construção como entrada e o Nexus deverá ser configurado para sua cadeia de ferramentas. Para obter instruções para configurar o Nexus, veja a seção Nexus.

Configure o Delivery Pipeline para incluir uma tarefa de construção npm:

Crie um estágio e configure a entrada para o repositório SCM apropriado.
No estágio, inclua uma tarefa de construção.
Configure a tarefa de construção:

build

a. Para o tipo de construtor, selecione npm (Artifactory ou Nexus).

b. Se você configurou múltiplas instâncias da integração de ferramenta Nexus, insira o nome da integração de ferramenta Nexus para a qual deseja configurar a tarefa de construção npm.

c. Para o tipo de integração de ferramenta, selecione Nexus.

d. Para o comando de construção, insira os comandos para construir seu módulo npm ou publicá-lo em seu registro. Este exemplo mostra os comandos para construir o módulo ou publicá-lo.
```
npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"
```
É possível localizar a URL e as credenciais do usuário que você usou para se conectar ao seu registro nas definições de configuração para a integração da ferramenta do Nexus.

e. Se a sua tarefa de construção publicar no registro do Nexus e o formato de sua versão do módulo do nó for x.y.z-SNAPSHOT.w, marque a caixa de seleção Incrementar versão do módulo de captura instantânea. A tarefa de construção atualiza automaticamente a versão do módulo antes da publicação no registro do Nexus. A tarefa de construção seleciona a versão mais alta do módulo do registro npm e o arquivo local package.json e incrementa a versão do módulo usando semver. A tarefa de construção não entrega as mudanças para o repositório SCM.
Clique em Salvar. Sempre que o pipeline for executado, essa tarefa de construção usará as informações de configuração da integração de ferramenta Nexus para se conectar ao registro npm.

Configurando uma tarefa de construção Maven do Nexus em seu pipeline

Antes de configurar uma tarefa de construção Maven em seu pipeline, será necessário um pipeline funcional que possa usar seu repositório SCM de construção como entrada e o Nexus deverá ser configurado para sua cadeia de ferramentas. Para obter instruções para configurar o Nexus, veja a seção Nexus.

Configure o Delivery Pipeline para incluir uma tarefa de construção Maven:

Crie um estágio e configure a entrada para o repositório SCM apropriado.
No estágio, inclua uma tarefa de construção.
Configure a tarefa de construção:

de compilação do

a. Para o tipo de construtor, selecione Maven (Artifactory, Nexus, SonarQube).

b. Se você configurou múltiplas instâncias da integração de ferramenta Nexus, insira o nome da integração de ferramenta Nexus para a qual deseja configurar a tarefa de construção Maven.

c. Para o tipo de integração de ferramenta, selecione Nexus.

d. Para o comando de construção, insira os comandos para construir seu módulo Maven ou publicá-lo em seu registro de captura instantânea. Este exemplo mostra os comandos para construir o módulo ou publicá-lo.
```
mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy
```
É possível localizar a URL e as credenciais do usuário que você usou para se conectar ao seu registro nas definições de configuração para a integração da ferramenta do Nexus.
Clique em Salvar. Sempre que o pipeline for executado, essa tarefa de construção usará as informações de configuração da integração de ferramenta Nexus para se conectar ao repositório Maven.

Configurando o Nexus por meio da API

A integração da ferramenta Nexus suporta os seguintes parâmetros de configuração que você pode usar com a API e os SDKs HTTP da Toolchain ao criar, ler e atualizar integrações de ferramentas.

Você deve especificar a propriedade tool_type_id no corpo da solicitação com o valor nexus.

Parâmetros de integração da ferramenta Nexus
Parâmetro	Uso	Tipo	Argumento de Terraform	Descrição
Dashboard_url	opcional, atualizável	Sequência	url_do_servidor	O URL painel do servidor Nexus para esta integração de ferramentas. Na UI gráfica, o navegador vai para este painel quando você clica no cartão de integração da ferramenta Nexus.
url do espelho	opcional, atualizável	Sequência	url do espelho	O repositório virtual URL Nexus, onde você pode visualizar seus repositórios privados e um cache dos repositórios públicos.
nome	necessário, atualizável	Sequência	nome	O nome dessa integração de ferramenta.
url_de_lançamento	opcional, atualizável	Sequência	url_de_lançamento	O repositório de URL lançamento do seu Nexus.
url_instantâneo	opcional, atualizável	Sequência	url_instantâneo	O URL repositório de instantâneos do seu Nexus.
token	opcional, atualizável	Senha	token	A senha ou token para autenticar com o repo Nexus. Você pode usar uma referência secreta de cadeia de ferramentas para este parâmetro. Para obter mais informações sobre referências secretas, consulte Protegendo seus dados sensíveis em Continuous Delivery.
tipo	necessário, atualizável	Sequência	tipo	O tipo de repo para a sua integração de ferramenta Nexus.
user_id	opcional, atualizável	Sequência	user_id	O ID do usuário ou endereço de e-mail para autenticar com o seu repo Nexus.