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 mudanças em App Engine Studio (AES) de um repositório Git.

Antes de Iniciar

• Saiba mais sobre Gerenciar personalizações para 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 senha de autenticação multifator ao criar um registro de credencial. 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.
• Função necessária: administrador

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 App Engine Studio.

Procedimento

1. Navegar até Todos > App Engine > App Engine Studio.
2. Na página Meus apps, abra sua aplicação.
3. Selecionar Controle de código-fonte > Vincular a controle de origem.
   App Engine Studio exibe a caixa de diálogo Vincular ao controle de código-fonte.

   

4. 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 HTTP ou SSH que permite a troca de dados de 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.
   Filial	A ramificação do repositório para trabalhar na aplicação. Nota: Esta ramificação é usada para confirmações. A ramificação padrão será definida como "principal" se ainda não estiver definida no repositório remoto. Se não houver ramificação padrão no repositório git remoto, a instância criará uma nova ramificação padrão com o nome "principal". Isso é configurado usando a propriedade do sistema glide.source_control.git_default_branch.
   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 uma aplicação por meio de um MID Server permite o acesso a repositórios atrás de um firewall. Para obter mais informações, consulte MID Server.
   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 ([e-mail]). 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.
   Credenciais	A credencial a ser usada com o protocolo selecionado. Consulte Getting started with credentials 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.
   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.
5. Selecione Vincular ao controle de código-fonte.
   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.

Tópicos relacionados

• MID Server
• Introdução às credenciais