Du er her:
Ekskluder metadata med .forceignore-filen
Bruk .forceignore-filen til å ekskludere filer eller metadatatyper som du ikke vil bekrefte til kildekontrollen eller distribuere til målorganisasjonen under utgivelse. Denne filen sørger for at DX Inspector og DevOps Center ikke overfører eller trekker ut unødvendige filer, som IDE-konfigurasjonsfiler, lokale testdata eller spesifikke profiler, fra utviklingsmiljøet.
Nødvendige utgaver
| Tilgjengelig i Lightning Experience i Professional (API-tilgang kreves), Enterprise, Performance, Ubegrenset og Developer Edition |
| Tilgjengelig i Government Cloud Plus som interoperabel. Aktivering av DevOps Center i Government Cloud Plus-organisasjoner kan sende data utenfor godkjenningsgrensen. Kontakt din Salesforce-kundeansvarlig for å få flere detaljer. |
| Ikke tilgjengelig i EU Operating Zone. EU-operasjonssone er et spesielt betalt tilbud som gir et forbedret nivå av dataoppbevaringsforpliktelse. DevOps Center er støttet i organisasjoner i EU som ikke er en del av EU OZ, i henhold til standard produktvilkår. |
Under bekreftelsesprosessen leser DX Inspector .forceignore-filen og utelukker samsvarende filer og metadata fra kildekontrolloppbevaringsstedet og arbeidselementet. DevOps Center leser filen under promoteringen for å identifisere og ekskludere metadatatypene og filene, og hindrer distribusjon.
Viktige punkter om opprettelse av .forceignore-filen
- Hvis du brukte malen vår til å opprette oppbevaringsstedet, oppdaterer du .forceignore-filen til prosjektkravene dine.
- Hvis du legger til .forceignore-filen i et eksisterende oppbevaringssted, plasserer du filen i rotmappen i Salesforce DX.
- Selv om du kan opprette .forceignore-filen når som helst, anbefaler vi å opprette den når du bygger pipelinen slik at den er på plass fra begynnelsen.
- Konfigurer filen i hovedforgreningen som er knyttet til utgivelsesmiljøet, før du aktiverer pipelinen. Dette trinnet kopierer filene til nye grener.
- Når du bygger pipelinen, hvis DevOps Center oppretter repositoriet og forgreningene, arver hver faseforgrening .forceignore-filen fra hovedforgreningen. Hvis du kobler til et eksisterende repositorium eller gjenbruker eksisterende grener, legger du til en .forceignore-fil manuelt hvis den ikke er tilgjengelig.
- Arbeidselementfunksjonsforgrener bruker filversjonen fra den første pipelinefaseforgreningen.
- Når du har aktivert pipelinen, bruker DevOps Center filreglene når du henter eller promoterer endringer.
Eksempel på .forceignore-syntaks
Strukturen til .forceignore-filen ligner på strukturen til .gitignore. Hver linje i filen inneholder et mønster som tilsvarer filene du vil ekskludere, som LWC-konfigurasjonsfiler, JSON-filer eller tester.
Denne eksempelfilen inneholder vanlige filer og mapper som utviklere ønsker å ekskludere på tidspunktet for en bekreftelse eller promotering. Syntaksen er forskjellig for promotere (distribuere) og hente (hente) operasjoner. Hvis du for eksempel vil ekskludere alle profiler når du promoterer endringer, bruker du **/profiles/**. Hvis du vil ekskludere alle profiler ved henting av endringer, bruker du *.profile. Se Hvordan ekskludere kilde ved synkronisering.
# 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__/**Viktige punkter om oppdatering av .forceignore-filen
- Oppdater .forceignore-filen i hovedforgreningen i pipelineoppbevaringsstedet.
- Hvis du har flere DevOps Center pipelines, oppdaterer du filen i hvert pipeline repositorium.
- Hvis pipelinen allerede er i bruk, gjelder ikke endringer automatisk for eksisterende grener. Hvis du vil bruke dem overalt, gjør du endringen i et arbeidselement og promoterer dette arbeidselementet. På den måten bruker DevOps Center den oppdaterte .forceignore-filen på tvers av pipelineforgreningene når du promoterer.
