Configurando o Nexus

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ê tiver uma cadeia de ferramentas e estiver adicionando essa integração de ferramentas a ela, no console IBM Cloud, clique no ícone Menu > Automação da 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. Como alternativa, na página Visão Geral do seu app, no cartão Entrega contínua, clique em Visualizar a cadeia de ferramentas. Em seguida, clique em 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.

Configuração do Nexus usando a API

A integração da ferramenta Nexus suporta os seguintes parâmetros de configuração que você pode usar com o Toolchain HTTP API e SDKs quando você criar, reade update 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	server_url	A URL do painel do servidor Nexus para esta integração de ferramenta. Na UI gráfica, o navegador vai para este painel quando você clica no cartão de integração da ferramenta Nexus.
mirror_url	opcional, atualizável	Sequência	mirror_url	A URL do seu repo virtual Nexus onde você pode visualizar seus repos privados e um cache de repos públicos.
nome	necessário, atualizável	Sequência	nome	O nome dessa integração de ferramenta.
release_url	opcional, atualizável	Sequência	release_url	A URL do seu repo de liberação Nexus.
snapshot_url	opcional, atualizável	Sequência	snapshot_url	A URL de seu repo instantâneo Nexus instantâneo.
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.