Configurar um repositório Git remoto na Control Room

Configure um repositório Git remoto na Control Room de modo que você possa versionar todos os bots e suas dependências e armazená-las no repositório Git. Além do repositório local de Automation 360 na Control Room, o Git remoto fornece um backup para os bots e suas dependências.

Pré-requisitos

  • Para configurar um repositório Git remoto na Control Room, garante que você tenha a função AAE_Admin.
  • Conforme sua região, configure seu firewall de rede para adicionar endereços IP de gateway NAT de saída à lista permitida.

    Endereços de IP Control Room para integrações externas

Quando estiver configurando um repositório Git remoto, tenha em mente as seguintes considerações:
  • O repositório Git deve ser configurado para ter acesso de gravação somente à Control Room e não a qualquer outro cliente Git.
  • Não é possível fazer upload de arquivos com mais de 100 MB para o repositório Git.
  • Certifique-se de fazer a integração com um repositório Git vazio.
  • Você não deve fazer o checkin de nenhum arquivo manualmente no repositório Git de nenhum outro usuário, produto ou aplicativo.
  • Quando você fizer a integração com o Git, o repositório não deve conter o arquivo ReadMe.md.
  • Certifique-se de que seu repositório Git seja privado (interno). Por razões de segurança, o Automation 360 não pode se conectar a um repositório Git público, pois todos os bots e arquivos são geralmente acessíveis em um repositório Git público.

Procedimento

  1. Na Control Room, navegue até Administração > Configurações > Integração de repositório Git remoto.
  2. Clique em Editar.
  3. Escolha um dos seguintes métodos de autenticação e execute as etapas correspondentes para configurar sua configuração Git:
    Método de autenticaçãoPassos
    Autenticação HTTPS
    1. Digite o caminho do repositório HTTPS, incluindo o nome de usuário no seguinte formato:

      https://<username>@bitbucket.org/companyname/product.git

      Nota: Use o host do Git que você quer que obtenha o endereço do repositório Git.
    2. Insira o nome do branch.

      As mudanças são empurradas para o branch selecionado. Por padrão, o branch principal é selecionado.

      Você pode utilizar caracteres minúsculos para nomes de ramificações, mas eles não devem exceder 250 caracteres. Não incluir caracteres de controle ASCII, tais como espaços, tils ou dois pontos em nomes de ramificações. É possível usar hífen para separar as palavras. Para obter mais informações sobre os nomes da ramificação, consulte Create a new Git branch.

    3. Digite sua senha de repositório Git ou um token de Git gerado.
      Nota:
      • O token deve ter, no máximo, 75 caracteres.
      • Você deve inserir a senha gerada para a conexão do repositório. É recomendável usar tokens, pois eles são mais seguros do que as senhas.
      • Para o GitHub, use apenas os tokens de acesso pessoal (clássico). Os tokens de acesso pessoal (refinados) não funcionam no GitHub.
      • Para BitButcket, você deve usar apenas as senhas do aplicativo.
    4. Digite novamente a senha ou o símbolo Git para confirmar.
    Autenticação SSH
    1. Insira o caminho do repositório SSH no seguinte formato:

      https://git@bitbucket.org:companyname/product.git

      Nota: Use o host do Git que você quer que obtenha o endereço do repositório Git.
    2. Insira o nome do branch.

      As mudanças são empurradas para o branch selecionado. Por padrão, o branch principal é selecionado.

      Você pode utilizar caracteres minúsculos para nomes de ramificações, mas eles não devem exceder 250 caracteres. Não incluir caracteres de controle ASCII, tais como espaços, tils ou dois pontos em nomes de ramificações. É possível usar hífen para separar as palavras. Para obter mais informações sobre os nomes da ramificação, consulte Create a new Git branch.

    3. Digite sua chave privada de autenticação SSH.

      Você deve criar o par de chaves privadas e públicas usando o algoritmo RSA.

      Nota: Certifique-se de que a chave privada inserida na Control Room contenha a seguinte string: -----BEGIN RSA PRIVATE KEY----- AND -----END RSA PRIVATE KEY-----

      Você deve gerar a chave pública e inseri-la em seu servidor Git.

      Consulte os seguintes tópicos das etapas para saber como gerar a chave pública dependendo do seu servidor:
    4. Opcional: Digite a senha.
  4. Opcional: Selecione a caixa de seleção Conectar-se a Git via proxy.
    1. Digite o nome do host de proxy ou endereço IP.
    2. Insira o número da porta.
    3. Opcional: Selecione a caixa de seleção de autenticação e digite o nome de usuário e a senha.
  5. Clique em Conectar e Salvar.
    A Control Room conecta-se ao repositório remoto Git, e a seguinte mensagem é exibida: Configurações de integração de Git salvas com sucesso. Você também pode verificar o registro de auditoria onde o status de Ajustar configurações do git é exibido como bem sucedido.
Nota:
  • A operação de check-in pode levar mais tempo se houver muitos arquivos bot na pasta Git no espaço de trabalho público. Isto porque um aumento do tamanho do repositório leva a uma desaceleração dos compromissos do git. Como melhor prática, recomendamos que você elimine os arquivos bot que não são utilizados no espaço de trabalho público.
  • Se o repositório do Git tiver arquivos de bloqueio como index.lock ou master.lock, exclua-os, pois eles podem impedir as operações de check-in e check-out.

Você pode se conectar ao mesmo repositório Git com um nome de usuário diferente na Control Room. Para obter mais informações, consulte How to change the remote Git repository username in the control room (A-People login required).

Veja o vídeo a seguir para uma visão geral de Git: