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

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

Antes de Iniciar

• Função necessária: administrador
• Saiba mais sobre como Gerenciar personalizações da aplicação.
• 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 acesso de autenticação multifator. Pesquise o token de acesso pessoal no GitHub ou no 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 à rede para o 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 eles usam em suas confirmações no 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 oferece suporte à 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 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.
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	O URL para o repositório Git onde você deseja salvar os arquivos da aplicação. 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ários para o URL do repositório Git funcionar.
   Credencial	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 chave privada SSH. Se você selecionar o protocolo https, insira uma credencial válida do tipo credenciais de 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 Descoberta atividades. Certifique-se de que o usuário do MID Server possa criar arquivos para a 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 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 do registro sys_user de um confirmador estiver vazio, o sistema gerará um e-mail alternativo ([e-mail]). Você também pode inserir um endereço de e-mail padrão e alterá-lo mais tarde. Para usar esse endereço de e-mail padrão em todos os casos, marque a caixa de seleção.
   Confirmar Comentário	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.

• Uso do MID Server com controle de código-fonte
  O ServiceNow® MID Server permite a comunicação e a movimentação de dados entre uma instância ServiceNow e aplicações externas, fontes de dados e serviços.

Tópicos relacionados

• Introdução às credenciais