Você está aqui:
Excluir metadados com o arquivo .forceignore
Use o arquivo .forceignore para excluir arquivos ou tipos de metadados que você não deseja confirmar no controle de origem ou implementar na organização de destino em seu pipeline de versão. Esse arquivo garante que o Inspetor DX e o DevOps Center não enviem ou extraam arquivos desnecessários, como arquivos de configuração do IDE, dados de teste locais ou perfis específicos, do ambiente de desenvolvimento.
Edições obrigatórias
| Disponível em: Lightning Experience nas edições Professional (exige acesso à API), Enterprise, Performance, Unlimited e Developer Editions |
| Disponível em: Government Cloud Plus como interoperável. Ativar o DevOps Center em organizações Government Cloud Plus permitirá o envio de dados fora dos limites de autorização. Entre em contato com seu executivo de conta do Salesforce para obter mais detalhes. |
| Não disponível em: Zona de operação da UE. A zona de operação da UE é uma oferta paga especial que proporciona um nível maior de compromisso de residência de dados. Há suporte para o DevOps Center em organizações na União Europeia que não fazem parte da zona de operação da UE, conforme os termos e condições padrão do produto. |
Durante o processo de confirmação, o Inspetor DX lê o arquivo .forceignore e exclui os arquivos e metadados correspondentes do repositório de controle de código-fonte e do item de trabalho. DevOps Center lê o arquivo durante a promoção para identificar e excluir os tipos de metadados e arquivos, impedindo sua implantação.
Considerações ao criar o arquivo .forceignore
- Se você usou nosso modelo para criar o repositório, atualize o arquivo .forceignore para seus requisitos de projeto.
- Se você estiver adicionando o arquivo .forceignore a um repositório existente, coloque-o na pasta raiz do diretório de projetos do Salesforce DX.
- Embora você possa criar o arquivo .forceignore a qualquer momento, recomendamos criá-lo ao criar seu pipeline para que esteja no lugar desde o início.
- Configure o arquivo na ramificação principal associada ao ambiente de versão antes de ativar o pipeline. Esta etapa copia os arquivos para novas ramificações.
- Quando você cria seu pipeline, se o DevOps Center cria o repositório e ramificações, cada ramificação de estágio herda o arquivo .forceignore da ramificação principal. Se você conectar um repositório existente ou reutilizar ramificações existentes, adicione um arquivo .forceignore manualmente se ele não estiver disponível.
- As ramificações de recurso do item de trabalho usam a versão do arquivo da primeira ramificação do estágio do pipeline.
- Depois de ativar o pipeline, o DevOps Center aplica as regras de arquivo ao capturar ou promover alterações.
Amostra da sintaxe .forceignore
A estrutura do arquivo .forceignore é semelhante à estrutura .gitignore. Cada linha no arquivo contém um padrão correspondente aos arquivos que você deseja excluir, como arquivos de configuração do LWC, arquivos JSON ou testes.
Esse arquivo de amostra contém arquivos e pastas comuns que os desenvolvedores querem excluir no momento de uma confirmação ou promoção. A sintaxe é diferente para as operações promocionar (implementar) e pull (recuperar). Por exemplo, para excluir todos os perfis ao promover alterações, use **/profiles/**. Para excluir todos os perfis ao capturar alterações, use *.profile. Consulte Como excluir origem ao sincronizar.
# List files or folders below to ignore them when deploying and retrieving changes
# Standard metadata
package.xml
# These metadata files are ignored when promoting (deploying)
**/appMenus/**
**/appSwitcher/**
**/fieldRestrictionRules/**
**/objectTranslations/**
**/profiles/**
**/profilePasswordPolicy/**
**/profileSessionSetting/**
**/settings/**
**/sharingRules/**
**/AuthProvider/**
# These metadata files are ignored when pulling (retrieving)
*.settings
*.appMenu
*.appSwitcher
*.rule
*.objectTranslation
*.profile
*.profilePasswordPolicy
*.profileSessionSetting
*.sharingRules
*.AuthProvider
# LWC configuration files
**/jsconfig.json
**/.eslintrc.json
# LWC Jest
**/__tests__/**Considerações ao atualizar o arquivo .forceignore
- Atualize o arquivo .forceignore na ramificação principal do repositório de pipeline.
- Se você tiver vários pipelines do DevOps Center, atualize o arquivo em cada repositório de pipeline.
- Se o pipeline já estiver em uso, as alterações não serão aplicadas às ramificações existentes automaticamente. Para aplicá-los em qualquer lugar, faça a alteração em um item de trabalho e promova esse item de trabalho. Dessa forma, o DevOps Center aplica o arquivo atualizado .forceignore em todas as ramificações do pipeline conforme você promove.
