Vincular uma aplicação ou personalização de aplicação ao controle de código-fonte

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura

    • Vincular uma aplicação ou personalização de aplicação ao controle de código-fonte permite que os desenvolvedores de aplicações gerenciem mudanças de um repositório Git.

    Antes de Iniciar

    • Função necessária: administrador
    • Saiba mais sobre como gerenciar personalizações de aplicações.
    • Crie um repositório Git dedicado para a aplicação. Para aumentar a segurança, habilite a autenticação multifator para o repositório Git.
    • Gere um token de acesso que a integração de controle de código-fonte possa usar em vez de uma senha e chave de autenticação multifator. Pesquise o token de acesso pessoal no GitHub ou GitLab.
    • Restrinja as permissões no token de acesso para permitir o acesso de leitura e gravação ao repositório Git.
    • Verifique se a instância de não produção tem acesso de rede ao repositório Git.
    • Certifique-se de que os usuários adicionem o endereço de e-mail aos respectivos registros da Tabela de usuários (ServiceNow sys_user) que usam em suas confirmações para o repositório Git.
    • Saiba mais: Migrar o histórico do conjunto de atualizações concluído para o Controle de código-fonte

    Por Que e Quando Desempenhar Esta Tarefa

    A integração de controle de código-fonte não é compatível com a vinculação a uma aplicação ou personalização em uma instância de produção. Em vez disso, instale aplicações em uma instância de produção a partir do repositório de aplicações, de um conjunto de atualizações ou do ServiceNow Store.

    Procedimento

    1. Abra a aplicação que você deseja vincular ao controle de código-fonte em Studio.
    2. Navegar até Controle de código-fonte > Vincular a controle de código-fonte.
      Studio exibe a caixa de diálogo Vincular ao controle de código-fonte.Caixa de diálogo Vincular ao controle de código-fonte
    3. Insira os detalhes da conexão para o repositório Git.
      Tabela 1. Detalhes da conexão do controle de código-fonte
      Campo Descrição
      Protocolo de rede Tipo de credencial HTTPS ou SSH que permite a troca de dados do canal seguro.
      URL A URL para o repositório Git onde você deseja salvar os arquivos de aplicações. Para o protocolo SSH, use o comando para gerar a chave privada ssh-keygen -t rsa -m PEM -b 4096 -C “email@address”.
      Nota:
      Se a URL do repositório Git para SSH fornecida pelo servidor Git não funcionar, verifique com o proprietário ou provedor do servidor Git a URL correta. Pode haver especificações adicionais, como prefixos de protocolo de esquema, números de porta e assim por diante, necessárias para que a URL do repositório Git funcione.
      Credenciais A credencial a ser usada com o protocolo selecionado. Consulte Introdução a credenciais para saber mais sobre como criar credenciais.
      Nota:
      Se você selecionar o protocolo de rede SSH, insira uma credencial válida do tipo de chave privada SSH. Se você selecionar o protocolo https, insira uma credencial válida do tipo Autenticação básica.
      Filial A ramificação do repositório para trabalhar na aplicação.
      Nome do MID Server O nome do MID Server existente para vincular.
      Nota:
      Use um MID Server separado para evitar conflitos com atividades Descoberta.

      Certifique-se de que o usuário do MID server possa criar arquivos na tabela sys_attachment e que a tabela possa aceitar arquivos do tipo "pacote".

      Vincular ou importar uma aplicação por meio de um MID Server permite o acesso a repositórios atrás de um firewall. Consulte os tópicos Usando o MID Server com controle de código-fonte e MID Server para saber mais
      E-mail padrão O endereço de e-mail do confirmador é definido pelo registro sys_user, se disponível. Mas se o campo de e-mail de registro sys_user de um confirmador estiver vazio, o sistema gerará um e-mail alternativo (username@instancename.service-now.com). Você também pode inserir um endereço de e-mail padrão e alterá-lo posteriormente. Para usar esse endereço de e-mail padrão em todos os casos, marque a caixa de seleção.
      Comentário de confirmação Uma descrição opcional do repositório ou aplicação.
      Nota:
      Todos os desenvolvedores de aplicações na instância compartilham um único conjunto de credenciais de repositório.
    4. Clique em Enviar.
      O sistema valida a conexão e as credenciais do usuário e exibe uma mensagem de sucesso.

      Todos os desenvolvedores de aplicações na instância podem usar o repositório Git vinculado para gerenciar mudanças.