Sistemas e repositórios
O código das automações fica nos repositórios git da empresa. No Proton, cada sistema (o que é automatizado: um portal, uma API, o SAP) aponta para o repositório com o código dele, e o repositório usa uma integração git para o Proton ler o código. Os três ficam em Configurações.
O caminho, do zero:
- Em Configurações > Integrações, cadastre a integração com o GitHub, o GitLab ou o Bitbucket, com o token. Ver Integrações.
- Em Configurações > Repositório Git, cadastre o repositório e a branch padrão.
- Em Configurações > Sistema, ligue o sistema ao repositório.
- Cadastre os componentes no sistema. No disparo, escolha a branch de cada sistema, e o runner baixa o código dela.
Repositório Git
Os cartões mostram o dono e o repositório, a plataforma, a integração, a branch padrão e o selo BDD quando o repositório tem automações em Gherkin. Os filtros separam por GitHub, GitLab e Bitbucket.
Adicionar abre Criar Repositório Git:
- Selecione a plataforma: só aparecem as que têm integração cadastrada.
- Em Integração, escolha a integração. O token vem dela.
- Em Geral, preencha o dono (Owner no GitHub, o workspace no Bitbucket, a URL no GitLab) e o Repositório.
- Use Buscar Branches (ou Validar Projeto, no GitLab) e escolha a Branch Padrão na lista. No GitHub, a busca já escolhe a branch padrão do repositório.
- Marque Esse repositório possui automações escritas em Gherkin se for o caso, e salve.
Sem nenhuma integração git, a janela avisa e leva para Cadastrar Integração.
Ao apagar um repositório, os sistemas ligados a ele ficam sem repositório.
Como o runner usa o repositório
Na execução, o runner recebe cada sistema dos componentes com o repositório e a branch escolhidos no disparo, pede ao
Proton o token da integração e baixa o código. O commit usado fica registrado como a versão do código da execução, no
detalhe da execução. O Proton só lê os repositórios: não grava no git
da empresa, a não ser a branch proton-bdd dos repositórios com BDD no GitHub.
Sistema
Os cartões mostram o nome, a plataforma e o repositório com a branch padrão, ou que o sistema está sem repositório. Os filtros Com repositório e Sem repositório separam os dois casos.
Adicionar abre Criar Sistema:
- Sistema: o nome, obrigatório, até 50 caracteres e único na organização.
- Repositório Git: Selecionar Repositório Git escolhe o repositório (o X desliga).
Vários sistemas podem usar o mesmo repositório. Trocar o repositório de um sistema muda de onde as próximas execuções baixam o código; confira a branch das recorrências que usam o sistema.
Um sistema com componentes ou recorrências não pode ser apagado: mova os componentes antes.
Análise de impacto
O ícone Análise de impacto do cartão mostra o que depende do sistema antes de uma mudança, nas abas Componentes, Processos, Automações e Grupos, com alertas para processos de criticidade alta ou crítica e datasets que já falharam na última execução. O que a regra de equipe esconde aparece só como uma contagem.
Configuração
Configurações > Configuração guarda pares de Parâmetro de Configuração e Valor da organização (até 50 caracteres cada, sem repetir o parâmetro), com quem gravou por último e quando. Clicar no parâmetro ou no valor copia.
Os valores ficam em texto aberto: não guarde senhas nem tokens aqui. Para os dados que a automação usa em cada ambiente, como endereços e usuários, use os Ambientes.
Permissões e celular
Sistema, Repositório Git, Configuração e Integrações têm permissões próprias (ver, criar, editar e apagar) na aba Configuração do perfil. Escolher o repositório de um sistema exige ver os repositórios.
As telas são feitas para o computador.