Legado - Integração de controle de origem

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Permita que os desenvolvedores de aplicações se integrem a um repositório de Controle de código-fonte Git. Salve e gerencie várias versões de uma aplicação a partir de uma instância que não seja de produção.

    Importante:
    Começando com Xanaduversão, o. legadoversão de ServiceNow Studioestá sendo preparado para descontinuação futura. Ele ficará oculto e não será mais ativado em novas instâncias, mas continuará sendo compatível. Para obter detalhes sobre o processo de descontinuação, consulte Processo de descontinuação [KB0867184] artigo na Base de conhecimento do Now Support.

    Tente criar e editar apps na versão atual de ServiceNow Studioem vez disso. Para obter mais informações, consulte ServiceNow Studio.

    Vincular uma aplicação ao controle de origem 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 origem:
    • O usuário deve ter a função de administrador.
    • A instância de não produção deve ter acesso de rede ao 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 Studiopara 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. A implantação na produção pode levar a consequências não intencionais, consulte Legado - 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

    . ServiceNowa plataforma oferece suporte limitado para modificar arquivos de aplicações vinculadas fora de uma instância. No Git, os desenvolvedores podem:
    • Mover arquivos da aplicação para uma estrutura de diretório Git diferente.
    • Edite arquivos da aplicação 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ório Git diferente, os desenvolvedores de aplicações podem definir o. pathparâmetro para especificar o caminho da subpasta que contém os arquivos da aplicação. Por exemplo, se você moveu sua aplicação para src/app subpasta, defina o. pathpara caminho: src/app .

    O sistema gera um checksum.txt Arquivo no repositório Git para determinar se algum arquivo de aplicação foi alterado fora de Studio. Quando o valor de soma de verificação do arquivo corresponde ao valor de soma de verificação atual, a integração ignora o processo de validação e limpeza. Quando os valores de soma de verificação não correspondem, 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 sanitização:
    • Cria entradas de log de upgrade para cada ação de higienização realizada.
    • Remove pastas e arquivos incompatíveis do repositório.
    • Anula todas as operações de Controle de origem quando um arquivo de aplicação do sistema falha na validação de esquema XML. Por exemplo, se um registro de dicionário de banco de dados falhar na validação do esquema XML, o sistema cancelará todas as operações.
    • Ignora a operação de Controle de código-fonte atual quando um arquivo de aplicação que não seja do sistema falha na validação de esquema XML.

    A integração do Controle de origem limpa somente o conteúdo no caminho da aplicação listado no sn_source_control.properties arquivo. O conteúdo do repositório fora do caminho da aplicação é ignorado.

    Suporte ao MID Server

    Use um MID Server existente para se conectar a um repositório de controle de origem. Vinculando ou importando Uma aplicação por meio de um MID Server permite o acesso a repositórios protegidos por um firewall.

    Configure o MID Server para integração de controle de origem

    Configure um MID Server para Integração de controle de origem para habilitar a comunicação e a movimentação de dados entre um ServiceNowinstâncias e aplicações externas, fontes de dados e serviços.

    • Adicione a extensão "pacote" a. extensões.anexo.glide propriedades.
    • Se os MID Servers precisarem passar por um proxy para acessar o repositório remoto do git, faça o seguinte:
      • Adicione a seguinte linha a. wrapper-override.conf arquivo:
      • Wrapper.java.additionial.3 - -Dhttps.proxyHost=<proxyHost>
      • Wrapper.java.additionial.4 - -Dhttps.proxyPort=<proxyPort>
      • Reinicie o MID
      • Adicione uma nova entrada na "Política de segurança DO MID":
      • Nome: Nome do host do proxy
      • Marque "Ativo" somente

    Remover confirmações de controle de origem

    Ignorar o descarregamento em arquivos XML de campos de atualização ruidosos para qualquer registro de metadados no controle de origem.