Integração do controle de código-fonte

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

    • Permita que os desenvolvedores de aplicações se integrem a um repositório Git Source Control. Salve e gerencie várias versões de uma aplicação de uma instância de não produção.

    Vincular uma aplicação ao controle de código-fonte permite que todos os desenvolvedores de aplicações em uma instância de não produção:
    • Importe aplicações de um repositório Git.
    • Extraia e aplique mudanças remotas de um repositório Git.
    • Confirme todas as mudanças locais na instância em um repositório Git.
    • Crie marcadores para vincular permanentemente a uma determinada versão de uma aplicação.
    • Crie ramificações para manter várias versões de uma aplicação simultaneamente.

    Requisitos de integração

    Para vincular uma aplicação ao controle de código-fonte:
    • O usuário deve ter a função de administrador.
    • A instância de não produção deve ter acesso à rede para o repositório Git.
    • Cada aplicação deve estar em seu próprio repositório Git.
    • As credenciais do usuário do repositório devem conceder acesso de leitura e gravação.
    Nota:
    Todos os desenvolvedores de aplicações na instância compartilham um único conjunto de credenciais por repositório.

    Opções disponíveis em ServiceNow Studio

    Depois de vincular uma aplicação ao controle de código-fonte, os desenvolvedores de aplicações podem usar ServiceNow Studio para gerenciar o repositório. De Studio, os desenvolvedores podem:
    • Edite as credenciais do repositório de aplicações.
    • Confirme todas as mudanças locais na instância.
    • Aplique mudanças remotas do repositório.
    • Crie uma ramificação.
    • Alternar ramificações.
    • Importe uma aplicação de um repositório remoto.

    Não é recomendável usar o controle de código-fonte para gerenciar aplicações em uma instância de produção. Implantar na produção pode levar a consequências não intencionais. Consulte Dicas de implantação de produção. Em vez disso, você pode gerenciar aplicações em uma instância de produção usando o repositório de aplicações, um conjunto de atualizações ou o ServiceNow Store. Para obter mais informações sobre como gerenciar aplicações em uma instância de produção, consulte Compartilhamento de aplicações.

    Opções disponíveis em um repositório Git

    A plataforma ServiceNow oferece suporte limitado para modificar arquivos de aplicações vinculados fora de uma instância. No Git, os desenvolvedores podem:
    • Mova arquivos de aplicações para uma estrutura de diretórios Git diferente.
    • Edite arquivos de aplicações fora de ServiceNow Studio.

    O sistema gera um arquivo de texto de propriedades chamado sn_source_control.properties no nível raiz do repositório. Para mover arquivos de aplicações para uma estrutura de diretórios Git diferente, os desenvolvedores de aplicações podem definir o parâmetro path para especificar o caminho da subpasta que contém seus arquivos de aplicações. Por exemplo, se você moveu sua aplicação para a subpasta src/app, defina o path como path=src/app.

    O sistema gera um arquivo checksum.txt no repositório Git para determinar se algum arquivo de aplicação foi alterado fora de Studio. Quando o valor da soma de verificação do arquivo corresponde ao valor da soma de verificação atual, a integração ignora o processo de validação e limpeza. Quando os valores da soma de verificação não coincidem, a integração valida e limpa os arquivos da aplicação como parte da operação de controle de código-fonte. O processo de higienização:
    • Cria entradas de log de atualização para cada ação de limpeza realizada.
    • Remove pastas e arquivos sem suporte do repositório.
    • Anula todas as operações de controle de código-fonte quando um arquivo de aplicação do sistema falha na validação do esquema XML. Por exemplo, se um registro de dicionário de banco de dados falhar na validação do esquema XML, o sistema anulará todas as operações.
    • Ignora a operação de controle de código-fonte atual quando um arquivo de aplicação que não é do sistema falha na validação do esquema XML.

    A integração do controle de código-fonte limpa somente o conteúdo no caminho da aplicação listado no arquivo sn_source_control.properties. O conteúdo do repositório fora do caminho da aplicação é ignorado.

    Suporte para MID Server

    Use um MID Server existente para se conectar a um repositório de controle de código-fonte. Vincular ou importar uma aplicação por meio de um MID Server permite o acesso a repositórios atrás de um firewall.

    Configurar MID server para integração de controle de código-fonte

    Configure um MID server para Source Control Integration para habilitar a comunicação e o movimento de dados entre uma instância ServiceNow e aplicações externas, fontes de dados e serviços.

    • Adicione a extensão "bundle" às propriedades de glide.attachement.extensions.
    • Se os MID Servers precisarem passar por um proxy para acessar o repositório git remoto, faça o seguinte:
      • Adicione a seguinte linha ao arquivo agent\conf\wrapper-override.conf :
      • wrapper.java.additionial.3=-Dhttps.proxyHost=<proxyHost>
      • wrapper.java.additionial.4=-Dhttps.proxyPort=<proxyPort>
      • Reiniciar o MID
      • Adicione uma nova entrada em "MID Security Policy":
      • Nome:<proxy host name>
      • Marque somente "Ativo"

    Remover ruído de confirmações do controle de código-fonte

    Ignore o descarregamento em arquivos XML de campos de atualização ruidosos para qualquer registro de metadados no controle de código-fonte.