Ti trovi qui:
Esclusione dei metadati con il file .forceignore
Utilizzare il file .forceignore per escludere i file o i tipi di metadati che non si desidera confermare nel controllo sorgente o distribuire all'organizzazione di destinazione nella pipeline di rilascio. Questo file garantisce che DX Inspector e DevOps Center non inviino o estraggono file non necessari, ad esempio file di configurazione IDE, dati di test locali o profili specifici, dall'ambiente di sviluppo.
Versioni (Edition) richieste
| Disponibile nelle versioni: Lightning Experience nelle versioni Professional Edition (accesso API richiesto), Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition |
| Disponibile nelle versioni: Government Cloud Plus come interoperabile. L'attivazione di DevOps Center nelle organizzazioni Government Cloud Plus consente alle organizzazioni di inviare dati al di fuori del limite dell'autorizzazione. Per ulteriori dettagli, rivolgersi al responsabile account Salesforce. |
| Non disponibile in: Area operativa del'Unione Europea. L'area operativa dell'Unione Europea è un'offerta a pagamento speciale che offre un livello avanzato di impegni per la data residency. DevOps Center è supportato nelle organizzazioni dell'UE che non fanno parte dell'area operativa, in base ai termini e alle condizioni standard del prodotto. |
Durante il processo di conferma, DX Inspector legge il file .forceignore ed esclude i file e i metadati corrispondenti dall'archivio di controllo sorgente e dalla voce su cui lavorare. DevOps Center legge il file durante la promozione per identificare ed escludere i tipi di metadati e i file, impedendone la distribuzione.
Considerazioni sulla creazione del file .forceignore
- Se è stato utilizzato il modello per creare l'archivio, aggiornare il file .forceignore per i requisiti del progetto.
- Se si aggiunge il file .forceignore a un repository esistente, posizionarlo nella cartella principale della directory del progetto Salesforce DX.
- Sebbene sia possibile creare il file .forceignore in qualsiasi momento, si consiglia di crearlo quando si crea la pipeline in modo che sia pronto fin dall'inizio.
- Configurare il file nel branch principale associato all'ambiente di rilascio prima di attivare la pipeline. Questo passaggio copia i file in nuovi branch.
- Quando si crea la pipeline, se DevOps Center crea il repository e i branch, ogni branch della fase eredita il file .forceignore dal branch principale. Se si collega un repository esistente o si riutilizzano branch esistenti, aggiungere manualmente un file .forceignore se non è disponibile.
- I branch delle funzioni delle voci su cui lavorare utilizzano la versione del file del primo branch della fase della pipeline.
- Dopo aver attivato la pipeline, DevOps Center applica le regole sui file quando estrae o promuove le modifiche.
Esempio di sintassi .forceignore
La struttura del file .forceignore è simile alla struttura .gitignore. Ogni riga del file contiene uno schema corrispondente ai file che si desidera escludere, ad esempio file di configurazione LWC, file JSON o test.
Questo file di esempio contiene file e cartelle comuni che gli sviluppatori desiderano escludere al momento di un impegno o di una promozione. La sintassi è diversa per le operazioni di promozione (distribuzione) e di estrazione (recupero). Ad esempio, per escludere tutti i profili quando si promuovono le modifiche, utilizzare **/profiles/**. Per escludere tutti i profili quando si estraggono le modifiche, utilizzare *.profile. Vedere Come escludere l'origine durante la sincronizzazione.
# 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__/**Considerazioni sull'aggiornamento del file .forceignore
- Aggiornare il file .forceignore nel branch principale del repository delle opportunità in corso di realizzazione.
- Se sono presenti più opportunità in corso di realizzazione DevOps Center, aggiornare il file in ogni repository di opportunità in corso di realizzazione.
- Se la pipeline è già in uso, le modifiche non vengono applicate automaticamente alle filiali esistenti. Per applicarle ovunque, apportare la modifica in una voce su cui lavorare e promuovere quella voce. In questo modo, DevOps Center applica il file .forceignore aggiornato nei branch delle opportunità in corso di realizzazione durante la promozione.
