Configurar seu Artifactory

Configurando seu repositório Artifactory para se conectar ao repositório de artefatos Agora da Deque

Siga estas etapas quando quiser se conectar ao repositório de artefatos Agora da Deque a partir de sua instância do Artifactory. Configurar este repositório remoto autenticado dentro do Artifactory permite que seus usuários acessem os componentes Axe DevTools através da sua própria rede de distribuição de software.

Pré-requisitos

Você deve ter credenciais de login do Agora e credenciais de administrador para sua instância do Artifactory para configurar esta conexão de repositório. A Deque recomenda usar uma conta de serviço do Agora para essas credenciais em vez de uma conta pessoal.

Usando uma Conta de Serviço

A Deque recomenda que você autentique esta conexão com uma conta de serviço Agora ao invés de usar seu próprio login Agora. Uma conta de serviço é uma conta Agora que pertence à sua equipe em vez de uma conta pessoal que pertence a apenas um membro da equipe.

Seu gerenciador de repositório — o servidor que hospeda o repositório remoto que você está configurando — armazena as credenciais da conta de serviço e as utiliza sempre que precisa acessar o Agora. Ele não faz o download dos pacotes antecipadamente. Na primeira vez que um dos seus desenvolvedores ou pipelines de build instala um pacote do Axe DevTools, o repositório remoto busca esse pacote do Agora e mantém uma cópia, e as instalações posteriores são servidas a partir da cópia. Seus desenvolvedores e sistemas automatizados sempre solicitam pacotes do seu gerenciador de repositório, de modo que eles nunca precisam de suas próprias contas Agora.

Uma conexão baseada no login de uma única pessoa depende de que ela mantenha o acesso ao Agora. Se essa pessoa sair da organização, ninguém poderá entrar em sua conta para recriar o Token de Identidade quando expirar, e as instalações falharão para todos. Uma conta de serviço não depende de apenas uma pessoa.

Cuidados com a Conta de Serviço

Trate o Token de Identidade da conta de serviço — a credencial semelhante a uma senha que o Agora emite para a conta — como uma credencial de infraestrutura compartilhada, e gerencie-o de acordo com as políticas de segurança e credenciais da sua organização. Armazene-o em um gerenciador de segredos ou no armazenamento de segredos do seu provedor de CI e faça referência a ele na configuração do seu gerenciador de repositório, em vez de comprometê-lo no controle de versão. Solicite à Deque que restrinja o escopo da conta de serviço apenas ao acesso de leitura necessário quando solicitá-la, e peça-nos para revogar e emitir novamente o token se ele puder ter sido exposto ou quando o dono da conta mudar.

Atribua um responsável pela conta dentro de sua organização. Os Tokens de Identidade expiram (geralmente após um ano), então o responsável pela conta deve recriar o token antes que ele expire. Quem quer que o recrie também deve atualizar o token armazenado que o seu gerenciador de repositório usa para se conectar ao Agora, pois seu gerenciador de repositório não pode baixar pacotes novos e atualizados até que o token armazenado seja atualizado.

Criando um Token de Identidade do Agora

Para começar, entre no Agora como a conta de serviço, para que o Token de Identidade pertença à conta de serviço em vez de a uma conta pessoal. Se você não estiver usando uma conta de serviço, entre como você mesmo. Clique no botão Bem-vindo no canto superior direito para abrir a página de perfil. Gere um Token de Identidade lá e copie-o.

Conectando-se ao Agora

1. Faça login no seu Gerenciador de Repositórios do Artifactory com suas credenciais de administrador.
2. Selecione Admin no menu de navegação à esquerda.
3. Selecione „Remote“ em „Repositories“ para exibir a página dos repositórios remotos.
4. Selecione „Create New“ no canto superior direito da página de Repositórios Remotos.
5. A página deve exibir uma lista de tipos de pacotes
6. Selecione o tipo de pacote (por exemplo, npm)
7. A página de criação do repositório deve exibir um formulário (veja o exemplo acima de um repositório npm).
   1. No campo Repository Key, digite o nome que você gostaria de usar para se referir ao repositório. A chave do repositório não deve conter espaços ou caracteres especiais, deve ser única, não pode começar com um número e é limitada a 58 caracteres.
   2. Insira a URL no registro Agora (consulte URLs do Registro Agora abaixo).
   3. Selecione os layouts apropriados (os padrões devem funcionar para cada tipo de repositório)
8. Clique no botão „Test“ para testar a conexão
9. Clique em „Save and Finish“
10. Se você quiser que os usuários usem este repositório por padrão, terá que incluí-lo em qualquer um de seus registros virtuais

URLs do Registro Agora

• npm: https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
• Maven: https://agora.dequecloud.com/artifactory/devtools-maven/
• NuGet: https://agora.dequecloud.com/artifactory/api/nuget/devtools-nuget/
• Gems: https://agora.dequecloud.com/artifactory/devtools-gems/
• Pip: https://agora.dequecloud.com/artifactory/api/pypi/devtools-python/simple/