Configurando o Artifactory

Continuous Delivery será descontinuado nas seguintes regiões em 10 de abril de 2026: eu-es e jp-osa. Essa descontinuação também se aplica a todos os recursos fornecidos no serviço, incluindo o Code Risk Analyzer e o DevOps Insights. Saiba mais

Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-mon, ca-tor, us-east. O Code Risk Analyzer e o DevOps Insights também serão descontinuados em todas as regiões nessa data. No entanto, se uma região não tiver uso ativo desses recursos, os recursos dessa região poderão ser descontinuados mais cedo e deixar de aceitar novas instâncias. Saiba mais

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 > Platform Automation > Toolchains. Na página Cadeias de ferramentas, clique em uma 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 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 de Artifactory usando a API

A integração de Artifactory ferramentas 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 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	O URL painel do Artifactory servidor para esta integração de ferramentas. Na interface gráfica do usuário, o navegador acessa este painel quando você clica no cartão de integração Artifactory de ferramentas.
url do espelho	opcional, atualizável	Sequência	url do espelho	O URL Artifactory repositório virtual 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 Artifactory do seu projeto.
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	O URL repositório Artifactory onde suas Docker imagens estão localizadas.
url_instantâneo	opcional, atualizável	Sequência	url_instantâneo	O URL repositório de Artifactory instantâneos do seu.
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.