Configurando o Artifactory

Configure o gerenciador de repositório do Artifactory para armazenar artefatos de construção em seu repositório do Artifactory (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 Artifactory.
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 em uma 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 Artifactory.
Digite a URL do repositório Artifactory que você deseja abrir ao clicar no cartão do Artifactory.
Selecione o tipo de repositório ao qual deseja se conectar.
Se estiver usando um registro npm do Artifactory, 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 do repositório de liberação do Artifactory, que é seu registro privado no servidor Artifactory.

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 Artifactory que pode acessar seu registro privado e um cache do registro global npm.
Se estiver usando um repositório Maven do Artifactory, 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 Artifactory, que é seu repositório de liberação privada no servidor Artifactory.

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

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 Artifactory que pode acessar seu repositório privado e um cache do repositório central Maven.
Clique em Criar integração.
Na placa Ferramentas de terceiros, clique na integração de ferramenta Artifactory para o repositório Artifactory com o qual você deseja trabalhar. O website do Artifactory é 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 Artifactory 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 Artifactory em seu pipeline.
Opcional: se você estiver usando uma cadeia de ferramentas no IBM Cloud Public e desejar construir seu app usando o Artifactory 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 Artifactory em seu pipeline.

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

Antes de configurar uma tarefa de construção npm em seu pipeline, deve-se ter um pipeline de trabalho que possa usar o repositório SCM de construção como entrada. Deve-se também configurar o Artifactory para sua cadeia de ferramentas. Para obter instruções para configurar o Artifactory, veja a seção Artifactory.

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 Construção NPM.

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

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

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 de ferramenta Artifactory.

e. Se a sua tarefa de construção publicar no registro do Artifactory 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 de a tarefa publicar no registro do Artifactory. A tarefa 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 Artifactory para se conectar ao registro npm.

Configurando uma tarefa de construção Maven do Artifactory 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 Artifactory deverá ser configurado para sua cadeia de ferramentas. Para obter instruções para configurar o Artifactory, veja a seção Artifactory.

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 Construção Maven.

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

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

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 em um registro de captura instantânea.
```
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 de ferramenta Artifactory.
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 Artifactory para se conectar ao repositório Maven.

Configuração Artifactory usando a API

A integração da ferramenta Artifactory suporta os seguintes parâmetros de configuração que você pode usar com a API 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 artifactory.

Parâmetros de integração da ferramentaArtifactory
Parâmetro	Uso	Tipo	Argumento de Terraform	Descrição
Dashboard_url	opcional, atualizável	Sequência	Dashboard_url	A URL do painel do servidor Artifactory para esta integração de ferramenta. Na UI gráfica, o navegador vai para este painel quando você clica na placa de integração da ferramenta Artifactory.
mirror_url	opcional, atualizável	Sequência	mirror_url	A URL do seu repo virtual Artifactory 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 Artifactory.
reposity_name	opcional, atualizável	Sequência	reposity_name	O nome do seu repo Artifactory onde estão localizadas as imagens do seu Docker.
reposity_url	opcional, atualizável	Sequência	reposity_url	A URL do seu repo Artifactory onde estão localizados suas imagens Docker.
snapshot_url	opcional, atualizável	Sequência	snapshot_url	A URL do seu repo instantâneo Artifactory.
token	opcional, atualizável	Senha	token	O token de acesso para seu repositório Artifactory. Você pode usar uma referência secreta de cadeia de ferramentas para este parâmetro. Para obter mais informações sobre referências secretas da cadeia de ferramentas, 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 Artifactory.
user_id	opcional, atualizável	Sequência	user_id	O ID do usuário ou endereço de e-mail para o seu repo Artifactory.