Usted está aquí:
Excluir metadatos con el archivo .forceignore
Utilice el archivo .forceignore para excluir archivos o tipos de metadatos que no desea confirmar en el control de origen o implementar en la organización de destino en sus oportunidades en curso de versión. Este archivo se asegura de que DX Inspector y DevOps Center no distribuyen o extraen archivos innecesarios, como archivos de configuración de IDE, datos de prueba locales o perfiles específicos, del entorno de desarrollo.
Ediciones necesarias
| Disponible en: Lightning Experience en Professional (se requiere acceso de API), Enterprise, Performance, Unlimited y Developer Edition |
| Disponible en: Government Cloud Plus como interoperable. Activar Centro de DevOps en las organizaciones de Government Cloud Plus puede provocar el envío de datos fuera de los límites de la organización. Póngase en contacto con su ejecutivo de cuenta de Salesforce para obtener más detalles. |
| No disponible en: Zona de Operación de UE. La zona de Operación de la Unión Europea es una oferta de pago especial que proporciona un nivel mejorado de compromiso de residencia de datos. Centro de DevOps es compatible con organizaciones en la UE que no forman parte del OZ de la UE, según los términos y condiciones de productos estándar. |
Durante el proceso de confirmación, DX Inspector lee el archivo .forceignore y excluye los archivos y metadatos coincidentes del repositorio de control de origen y el elemento de trabajo. DevOps Center lee el archivo durante la promoción para identificar y excluir los tipos de metadatos y archivos, evitando su implementación.
Consideraciones al crear el archivo .forceignore
- Si utilizó nuestra plantilla para crear el repositorio, actualice el archivo .forceignore para sus requisitos de proyecto.
- Si está agregando el archivo .forceignore a un repositorio existente, coloque el archivo en la carpeta raíz de su directorio de proyectos de Salesforce DX.
- Aunque puede crear el archivo .forceignore en cualquier momento, recomendamos crearlo cuando cree su canalización de modo que esté en su lugar desde el principio.
- Configure el archivo en la bifurcación principal asociada con su entorno de versión antes de activar sus oportunidades en curso. Este paso copia los archivos en nuevas sucursales.
- Cuando crea su canalización, si DevOps Center crea el repositorio y las bifurcaciones, cada bifurcación de etapa hereda el archivo .forceignore de la bifurcación principal. Si conecta un repositorio existente o reutiliza sucursales existentes, agregue un archivo .forceignore manualmente si no está disponible.
- Las bifurcaciones de funciones de elementos de trabajo utilizan la versión de archivo de la primera bifurcación de etapa de canalización.
- Después de activar las oportunidades en curso, DevOps Center aplica las reglas de archivo al extraer o promocionar cambios.
Sintaxis .forceignore de muestra
La estructura del archivo .forceignore es similar a la estructura .gitignore. Cada línea del archivo contiene un patrón correspondiente a los archivos que desea excluir, como archivos de configuración LWC, archivos JSON o pruebas.
Este archivo de muestra contiene archivos y carpetas comunes que los desarrolladores desean excluir en el momento de una confirmación o promoción. La sintaxis es diferente para las operaciones de promoción (implementación) y extracción (recuperación). Por ejemplo, para excluir todos los perfiles al promocionar cambios, utilice **/profiles/**. Para excluir todos los perfiles al extraer cambios, utilice *.profile. Consulte Cómo excluir el origen al 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__/**Consideraciones al actualizar el archivo .forceignore
- Actualice el archivo .forceignore en la sucursal principal de su repositorio de oportunidades en curso.
- Si tiene múltiples oportunidades en curso de DevOps Center, actualice el archivo en cada repositorio de oportunidades en curso.
- Si las oportunidades en curso ya están en uso, los cambios no se aplican a las bifurcaciones existentes automáticamente. Para aplicarlos en todas partes, realice el cambio en un elemento de trabajo y promocione ese elemento de trabajo. De ese modo, DevOps Center aplica el archivo .forceignore actualizado en las bifurcaciones de oportunidades en curso a medida que promociona.
