Branch PreDeploy Fix verwenden

PreDeploy Fix erkennt und behebt fehlende Abhängigkeiten proaktiv vor der Bereitstellung.

Übersicht

Der PreDeploy-Fix ist ein Validierungsprozess, der Ihren Branch vor der Bereitstellung auf potenzielle Probleme untersucht, wie zum Beispiel:

• API-Versionsunterschiede

• Fehlende Komponenten

• Defekte Verweise

• Nicht erfüllte Abhängigkeiten

Wenn Probleme erkannt werden, werden sie mit Optionen zur Behebung aufgeführt. Dieser Prozess hilft, Bereitstellungsfehler zu vermeiden durch:

• Überprüfen und Aktualisieren von API-Versionen der Komponenten

• Abrufen fehlender Metadaten

• Entfernen oder Aktualisieren von Verweisen auf problematische Komponenten

Durch die Abarbeitung dieser Aspekte wird Ihre Bereitstellung sauberer und weniger fehleranfällig.

Best Practices

• Führen Sie immer einen PreDeploy-Fix aus, bevor Validieren oder Bereitstellen um die Wahrscheinlichkeit von Fehlern zu verringern.

• Für fehlende Abhängigkeiten verwenden Sie Abrufen wenn möglich, um sicherzustellen, dass alle Abhängigkeiten korrekt enthalten sind. Verwenden Sie Entfernen nur, wenn Sie sicher sind, dass der Verweis veraltet oder nicht erforderlich ist.

• Geben Sie klare und beschreibende Commit-Nachrichten. Diese werden zur späteren Nachverfolgung im Reiter "Commits" angezeigt.

• Führen Sie den PreDeploy-Fix nach dem Beheben von Problemen erneut aus, bis die Listen leer sind.

• Verwenden Sie Filter (Status, Typ, Datumsbereich) in Aktivitäten um Ihre PreDeploy-Fix-Jobs schnell zu verfolgen.

• Überprüfen Sie die Protokolle, wann immer ein Job mit Ausnahme oder Aktion erforderlich endet, um zu verstehen, was behoben werden muss.

Branch PreDeploy-Fix ausführen

1

Branch auswählen und PreDeploy-Fix ausführen

1. Klicken Sie Code aus dem linken Seitenmenü.

2. Wählen Sie einen Branch aus der Liste.

   
3. Klicken Sie auf den Drei vertikale Punkte ⋮ Dropdown-Menü neben "Bereitstellen".

4. Klicken Sie PreDeploy-Fix.

   

2

Verbindung auswählen

1. Klicken Sie Auswählen für die Salesforce-Org-Verbindung, für die der PreDeploy-Fix ausgeführt werden soll.

2. Klicken Sie Ausführen.

   
3. Nachdem der PreDeploy-Fix-Job gestartet wurde, wird er auf der Aktivitäten Tab.

   

PreDeploy-Fix-Ergebnisse

1

Ergebnisse anzeigen

1. Klicken Sie auf den Aktivitäten Tab.

2. Überprüfen Sie, dass der PreDeploy-Fix-Suche Job-Status Abgeschlossen.

3. Klicken Sie auf den PreDeploy-Fix-Suche ist.

   

Um einen PreDeploy-Fix-Job zu finden, können Sie auf das Alle Typen Dropdown-Filtermenü klicken und PreDeploy-Fix-Sucheauswählen. Dadurch werden die Jobs gefiltert, sodass nur PreDeploy-Fix-Jobs angezeigt werden.

2

API-Versionsfehler

Wenn der PreDeploy-Fix API-Versionsfehler erkennt, erscheinen diese in der API-Versionsfehler Tabelle. Diese Tabelle zeigt jede Komponente mit einem API-Versionsfehler. Rechts von jeder Komponente befinden sich zwei API-Versionen: die Komponenten-API-Version und die Organisations-API-Version. Die Komponenten-API-Version ist die Version, die die Komponente im Branch verwendet, und die Organisations-API-Version ist die Version, die in der Salesforce-Org verwendet wird, die als Verbindung für diesen PreDeploy-Fix dient.

Siehe den Branch PreDeploy Fix verwenden Abschnitt unten, um zu erfahren, wie diese Fehler behoben werden.

1. Klicken Sie auf den API-Versionsfehler Tab.

   

3

Fehlende Abhängigkeiten

Wenn der PreDeploy-Fix fehlende Abhängigkeiten identifiziert, werden diese in der Fehlende Komponenten Tabelle angezeigt. Diese Tabelle zeigt jede fehlende Metadatenabhängigkeit zusammen mit der Komponente, die darauf verweist. Um fehlende Komponenten zu beheben, können Sie aus zwei Optionen wählen und diese für jede Komponente nach Bedarf anwenden.

• Abrufen: Diese Option ruft die fehlende Komponente ab und committet sie in den Branch.

• Entfernen: Diese Option entfernt den Verweis auf die fehlende Komponente und sollte nur verwendet werden, wenn bestätigt ist, dass das Bereitstellen ohne die Komponente im Branch sicher ist.

Siehe den Branch PreDeploy Fix verwenden Abschnitt unten, um zu erfahren, wie diese Fehler behoben werden.

1. Klicken Sie auf den Fehlende Abhängigkeiten Tab.

   

Wenn die Fehlende Abhängigkeiten Registerkarte nicht sichtbar ist, bedeutet dies, dass es keine fehlenden Abhängigkeiten gibt.

4

Job-Protokolle anzeigen

Sie können die PreDeploy-Fix-Jobprotokolle anzeigen, um Probleme bei der Jobverarbeitung zu prüfen und um zu verifizieren, mit welcher Salesforce-Org der Job ausgeführt wurde.

1. Klicken Sie Protokolle ansehen.

   
2. Sehen Sie den Job-Status und das Protokoll ein.

   

5

PreDeploy-Fix erneut ausführen

Sobald Sie alle API-Versionsfehler behoben und fehlende Abhängigkeiten gelöst haben, führen Sie den PreDeploy-Fix-Job erneut aus, um sicherzustellen, dass keine Probleme mehr bestehen. Die folgenden Screenshots zeigen einen PreDeploy-Fix-Job, der ohne das Finden von Problemen abgeschlossen wurde.

Sowohl die API-Versionsfehler und die Fehlende Komponenten Tabellen zeigen Keine Komponenten.

Beheben von API-Versionsfehlern

Wenn die PreDeploy-Fix hat API-Versionsfehler gefunden, Sie können diese beheben, indem Sie auf die korrekte Version aktualisieren.

1

Versionen aktualisieren

1. Klicken Sie Versionen aktualisieren.

   
2. Klicken Sie Hinzufügen für jede Komponente, um die API-Version zu aktualisieren.

3. Klicken Sie Aktualisieren.

   
4. Geben Sie eine Commit-Nachricht für die Änderungen am Branch ein.

5. Klicken Sie Beheben.

   
6. Nachdem der API-Aktualisierungs-Job gestartet wurde, wird er auf der Aktivitäten Registerkarte als PreDeploy-Fix-Aktualisierung ist.

   

2

Ergebnisse anzeigen

1. Klicken Sie auf den PreDeploy-Fix-Aktualisierung ist.

   
2. Sehen Sie den Job-Status und das Protokoll ein.

   

Beheben fehlender Abhängigkeiten

1

Fehlende Komponenten abrufen

Die ausgewählten Metadaten werden in Ihren Branch abgerufen und als Commit hinzugefügt.

Wenn Sie Abhängigkeitskomponenten bereits entfernt haben, wählen Sie diese nicht zum Abrufen aus. Wenn Sie unsicher sind, können Sie den PreDeploy-Fix-Job erneut ausführen.

1. Klicken Sie Abrufen.

   
2. Klicken Sie Hinzufügen für jede Abhängigkeitskomponente zum Abrufen.

3. Klicken Sie Abrufen.

   
4. Geben Sie eine Commit-Nachricht für die Änderungen am Branch ein.

5. Klicken Sie auf den Verbindung Dropdown-Menü.

6. Wählen Sie die Salesforce-Org aus, aus der die abhängigen Komponenten abgerufen werden sollen.

   
7. Klicken Sie Ausführen.

   
8. Nachdem der Job zum Abrufen fehlender Abhängigkeiten gestartet wurde, wird er auf der Aktivitäten Registerkarte als PreDeploy-Fix-Aktualisierung ist.

   

2

Fehlende Komponenten entfernen

Die Verweise auf diese Komponenten werden aus Ihrem Branch entfernt, wodurch Bereitstellungsfehler verhindert werden.

Wenn Sie Abhängigkeitskomponenten bereits abgerufen haben, wählen Sie diese nicht zum Entfernen aus. Wenn Sie unsicher sind, können Sie den PreDeploy-Fix-Job erneut ausführen.

1. Klicken Sie Entfernen.

   
2. Klicken Sie Hinzufügen für jede Abhängigkeitskomponente zum Abrufen.

3. Klicken Sie Entfernen.

   
4. Geben Sie eine Commit-Nachricht für die Änderungen am Branch ein.

5. Klicken Sie Ausführen.

   
6. Nachdem der Job zum Entfernen fehlender Abhängigkeiten gestartet wurde, wird er auf der Aktivitäten Registerkarte als PreDeploy-Fix Entfernen ist.

   

3

Ergebnisse anzeigen

1. Klicken Sie auf den PreDeploy-Fix Abrufen Job zum Abrufen von Komponenten oder PreDeploy-Fix Entfernen Job zum Entfernen von Komponenten.

   
2. Sehen Sie den Job-Status und das Protokoll ein.