--- sourceDocument: Criar ou modificar aplicações do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Criar ou modificar aplicações do Xanadu ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- # Integração do controle de código-fonte # Integração do controle de código-fonte {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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. {#c_SourceControlIntegration__ul_f23_qsk_p5} ## Requisitos de integração {#c_SourceControlIntegration__section_bgq_czg_kjb} 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. {#c_SourceControlIntegration__ul_spw_bhl_p5} 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 {#c_SourceControlIntegration__section_k2d_kyg_kjb} 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. A partir 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. {#c_SourceControlIntegration__ul_u55_hl4_q5} 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 [Dicas de implantação de produção](https://servicenow-prod.fluidtopics.net/yaUMWnp0~wnxE6DJEwPgCA "Ao desenvolver personalizações para aplicações na plataforma ServiceNow, você as implanta por meio do repositório de aplicações em uma instância de produção. Este tópico examina e fornece avisos para as compensações entre a instalação de uma aplicação do repositório de aplicações versus o repositório Git com controle de código-fonte."). 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](https://servicenow-prod.fluidtopics.net/SI1FmczsPyO6VfbepDoKeg "Os administradores podem compartilhar aplicações que estão concluídas e prontas para uso em outras instâncias."). ## Opções disponíveis de um repositório Git {#c_SourceControlIntegration__section_spn_nyg_kjb} 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. {#c_SourceControlIntegration__ul_gtn_34f_kjb} 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 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 de aplicações 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 limpeza realizada. * Remove pastas e arquivos incompatíveis do repositório. * Anula todas as operações de controle de código-fonte quando um arquivo de aplicações 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ções que não é do sistema falha na validação do esquema XML. {#c_SourceControlIntegration__ul_sqt_z4f_kjb} 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 ao MID Server {#c_SourceControlIntegration__section_ew2_4y1_njb} Use um MID Server existente para se conectar a um repositório de controle de código-fonte. [Vincular](https://servicenow-prod.fluidtopics.net/3NV_JO4~6xKRjRaX0vFkyA "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.") ou [importar](https://servicenow-prod.fluidtopics.net/Gn28hLRnuiK6FTJXIv6fYw "Importe uma aplicação ou personalização de aplicação de um repositório de controle de código-fonte para continuar a desenvolvê-la nesta instância.") 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 {#c_SourceControlIntegration__section_rft_qbh_4tb} Configure um MID Server para Integração de controle de código-fonte para habilitar a comunicação e a movimentação de dados entre uma instância ServiceNow e aplicações, fontes de dados e serviços externos. * Adicione a extensão "pacote" às propriedades glide.attachment.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=\ * wrapper.java.additionial.4=-Dhttps.proxyPort=\ * Reiniciar o MID * Adicione uma nova entrada em "Política de segurança do MID": * Nome:\ * Marque somente "Ativo" {#c_SourceControlIntegration__ul_z4l_2ch_4tb} {#c_SourceControlIntegration__ul_cfh_5bh_4tb} ## Remover ruído de confirmações do controle de código-fonte {#c_SourceControlIntegration__section_oky_ssg_4tb} Ignore o descarregamento em arquivos XML de campos de atualização com ruído para qualquer registro de metadados no controle de código-fonte. * **[Dicas de implantação de produção](https://servicenow-prod.fluidtopics.net/yaUMWnp0~wnxE6DJEwPgCA)** Ao desenvolver personalizações para aplicações na plataforma ServiceNow®, você as implanta por meio do repositório de aplicações em uma instância de produção. Este tópico examina e fornece avisos para as compensações entre a instalação de uma aplicação do repositório de aplicações versus o repositório Git com controle de código-fonte. * **[Operações de controle de código-fonte disponíveis](https://servicenow-prod.fluidtopics.net/S1~r0J0~y0D80cbUGRHrvw)** A integração de controle de código-fonte oferece suporte principalmente a operações de Studio, mas também pode oferecer suporte a algumas operações diretamente do repositório GIT. * **[Importar aplicação ou personalização de aplicação do controle de código-fonte](https://servicenow-prod.fluidtopics.net/Gn28hLRnuiK6FTJXIv6fYw)** Importe uma aplicação ou personalização de aplicação de um repositório de controle de código-fonte para continuar a desenvolvê-la nesta instância. * **[Vincular uma aplicação ou personalização de aplicação ao controle de código-fonte](https://servicenow-prod.fluidtopics.net/3NV_JO4~6xKRjRaX0vFkyA)** 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. * **[Migrar o histórico do conjunto de atualizações concluído para o Controle de código-fonte](https://servicenow-prod.fluidtopics.net/idlUpjwgvhb4h0O7FpvnLQ)** Ao vincular ao Controle de código-fonte, este recurso permite que os desenvolvedores de aplicações tenham a opção de migrar as informações em conjuntos de atualizações concluídos para o histórico do Controle de código-fonte. * **[Editar uma configuração de repositório Git](https://servicenow-prod.fluidtopics.net/dHmrur26jYJQquZNW3xLgA)** Você pode editar um repositório Git para mudar a seleção do protocolo de rede, credenciais ou outras entradas de campo. * **[Aplicar mudanças remotas](https://servicenow-prod.fluidtopics.net/g0tKVDwTQWaLOZ8utQBEjQ)** Os desenvolvedores de aplicações podem extrair mudanças de um repositório GIT vinculado para aplicar mudanças remotas à instância local. * **[Confirmar mudanças](https://servicenow-prod.fluidtopics.net/N_wBCrbMqms0ChPYxf4I1g)** Os desenvolvedores de aplicações podem confirmar suas mudanças na instância para o repositório Git vinculado. Você pode selecionar algumas mudanças para confirmar ou confirmar todas as mudanças na instância de uma vez. * **[Mudanças locais no estoque](https://servicenow-prod.fluidtopics.net/cn2MesHfivTTWWMfrCr~4w)** Os desenvolvedores de aplicações podem remover e salvar mudanças localmente para aplicá-las posteriormente. * **[Alternar ramificação](https://servicenow-prod.fluidtopics.net/gIjpzNJYse9iIa0RcQqgsw)** Os desenvolvedores de aplicações podem alternar para uma ramificação de repositório diferente para trabalhar em outra versão da aplicação. * **[Criar ramificação](https://servicenow-prod.fluidtopics.net/3RkiYnWUwXFFt8fW2UQqLQ)** Os desenvolvedores de aplicações podem criar uma ramificação para trabalhar em uma nova versão de uma aplicação existente. * **[Definir ramificação padrão](https://servicenow-prod.fluidtopics.net/hMERhdc6zogrFXOkaTAL2A)** Defina uma ramificação padrão quando quiser usar uma ramificação diferente de principal para novas mudanças ou para o repositório de desenvolvimento principal. * **[Gerenciar estoques](https://servicenow-prod.fluidtopics.net/UYjaCPIh7NS8GwGw86x3hQ)** Os desenvolvedores de aplicações podem aplicar ou excluir mudanças armazenadas de Studio. * **[Resolver conflitos](https://servicenow-prod.fluidtopics.net/6~JkstkNmp2J73L9f69JWg)** Os desenvolvedores de aplicações podem escolher qual versão do arquivo de aplicações usar ao aplicar mudanças remotas ou armazenadas. * **[Exibir histórico de confirmações](https://servicenow-prod.fluidtopics.net/3m2YoWtcLMSMw793caYTBw)** Os desenvolvedores de aplicações podem exibir o histórico de confirmações de aplicações vinculadas a um repositório de controle de código-fonte. * **[Mover arquivos de aplicações em um repositório GIT](https://servicenow-prod.fluidtopics.net/un6Urj1nTuyunYt9Aa3fUQ)** Mova arquivos de aplicações vinculados ao controle de código-fonte para qualquer pasta do repositório. Permita que os desenvolvedores de aplicações armazenem conteúdo de suporte, como testes automatizados, no mesmo repositório das aplicações às quais eles oferecem suporte. * **[Prevenção de colisão](https://servicenow-prod.fluidtopics.net/bAiYkIqV46ERPdJs9rmkCA)** Evite modificar um arquivo de aplicações em diferentes conjuntos de atualizações para garantir uma experiência perfeita durante o processo de confirmação. * **[Carregamento delta](https://servicenow-prod.fluidtopics.net/5UGZ9Ag0zZaSdShyvAYc8A)** "Carregamento delta" é uma maneira otimizada de carregar uma aplicação de um repositório Git. * **[Remover ruído das confirmações do controle de código-fonte](https://servicenow-prod.fluidtopics.net/maiDAheGn7L3jdqipTlyBA)** Como desenvolvedor de controle de código-fonte, você pode mesclar as ramificações Git sem obter ruído dos campos que são atualizados automaticamente pelo sistema.