> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-de/code/branch-aktionen/branch-predeploy-fix-verwenden.md).
# Branch PreDeploy Fix verwenden
PreDeploy Fix erkennt und behebt fehlende Abhängigkeiten proaktiv vor der Bereitstellung.
{% hint style="warning" %}
#### Geschrieben für die alte Benutzeroberfläche
Dieser Artikel wurde für die alte Benutzeroberfläche geschrieben. Die Anweisungen sind weiterhin verwendbar, aber die Screenshots sind veraltet. In einigen Fällen wurden die in den Anweisungen genannten Elemente verschoben oder geändert. Wenn Sie ein Element nicht finden können, siehe den [Wo ist es hin](/devops/devops-de/ubergang-zur-neuen-ui-ux/wo-ist-es-hin.md) Artikel.
{% endhint %}
##  Überblick
Der PreDeploy Fix ist ein Validierungsprozess, der Ihren Branch vor der Bereitstellung auf potenzielle Probleme überprüft, wie zum Beispiel:
* Nicht übereinstimmende API-Versionen
* Fehlende Komponenten
* Beschädigte Verweise
* Nicht erfüllte Abhängigkeiten
Wenn Probleme erkannt werden, werden sie mit Optionen zur Behebung aufgelistet. Dieser Prozess hilft, Bereitstellungsfehler zu verhindern, indem er:
* Überprüfen und Aktualisieren der API-Versionen von Komponenten
* Abrufen fehlender Metadaten
* Entfernen oder Aktualisieren von Verweisen auf problematische Komponenten
Indem Sie diese Aspekte beheben, wird Ihre Bereitstellung sauberer und weniger fehleranfällig.
{% hint style="info" %}
#### Best Practices
* Führen Sie immer einen PreDeploy Fix aus, bevor **Validieren** oder **Bereitstellen** um die Wahrscheinlichkeit von Fehlern zu verringern.
* Bei fehlenden 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 aussagekräftige **Commit-Nachrichten**ein. Diese werden zur späteren Nachverfolgung im Tab „Commits“ angezeigt.
* Führen Sie den PreDeploy Fix nach der Behebung der Probleme 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 immer, wenn ein Job endet mit **Ausnahme** oder **Aktion erforderlich** um zu verstehen, was behoben werden muss.
{% endhint %}
## Branch-PreDeploy-Fix ausführen
{% stepper %}
{% step %}
### Branch auswählen und PreDeploy Fix ausführen
1. Klicken Sie auf **Code** im linken Seitenleistenmenü.
2. Wählen Sie einen Branch aus der Liste aus.
3. Klicken Sie auf das **Drei vertikale Punkte ⋮** Dropdown-Menü neben „Bereitstellen“.
4. Klicken Sie auf **PreDeploy-Fix**.
{% endstep %}
{% step %}
### Verbindung auswählen
1. Klicken Sie auf **Wählen Sie** für die Salesforce-Org-Verbindung aus, für die der PreDeploy Fix ausgeführt werden soll.
2. Klicken Sie auf **Ausführen**.
3. Nachdem der PreDeploy-Fix-Job gestartet wurde, wird er auf dem **Aktivitäten** Tab angezeigt.
{% endstep %}
{% endstepper %}
## PreDeploy-Fix-Ergebnisse
{% stepper %}
{% step %}
### Ergebnisse anzeigen
1. Klicken Sie auf das **Aktivitäten** Tab angezeigt.
2. Prüfen Sie, ob der **Pre Deploy Fix Search** Jobstatus **Abgeschlossen**.
3. Klicken Sie auf das **Pre Deploy Fix Search** ist.
{% hint style="info" %}
Um einen PreDeploy-Fix-Job zu finden, können Sie auf das **Alle Typen** Dropdown-Filtermenü klicken und **Pre Deploy Fix Search**auswählen. Dadurch werden die Jobs gefiltert, sodass nur PreDeploy-Fix-Jobs angezeigt werden.
{% endhint %}
{% endstep %}
{% step %}
### API-Versionsfehler
Wenn der PreDeploy Fix API-Versionsfehler erkennt, werden sie in der **API-Versionsfehler** Tabelle angezeigt. Diese Tabelle zeigt jede Komponente mit einem API-Versionsfehler. Rechts neben jeder Komponente stehen 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 sie in der Salesforce-Org verwendet, die als Verbindung für diesen PreDeploy Fix genutzt wird.
{% hint style="info" %}
Siehe den [#fixing-api-version-errors](#fixing-api-version-errors "mention") Abschnitt unten, um zu erfahren, wie diese Fehler behoben werden können.
{% endhint %}
1. Klicken Sie auf das **API-Versionsfehler** Tab angezeigt.
{% endstep %}
{% step %}
### Fehlende Abhängigkeiten
Wenn der PreDeploy Fix fehlende Abhängigkeiten erkennt, werden sie 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 zwischen zwei Optionen wählen und diese je nach Bedarf auf jede Komponente anwenden.
* **Abrufen**: Diese Option ruft die fehlende Komponente ab und schreibt sie als Commit in den Branch.
* **Entfernen**: Diese Option entfernt den Verweis auf die fehlende Komponente und sollte nur verwendet werden, wenn bestätigt ist, dass die Bereitstellung ohne die Komponente im Branch sicher ist.
{% hint style="info" %}
Siehe den [#fixing-missing-dependencies](#fixing-missing-dependencies "mention") Abschnitt unten, um zu erfahren, wie diese Fehler behoben werden können.
{% endhint %}
1. Klicken Sie auf das **Fehlende Abhängigkeiten** Tab angezeigt.
{% hint style="info" %}
Wenn der **Fehlende Abhängigkeiten** Tab nicht sichtbar ist, bedeutet das, dass keine fehlenden Abhängigkeiten vorhanden sind.
{% endhint %}
{% endstep %}
{% step %}
### Job-Protokolle anzeigen
Sie können die Protokolle des PreDeploy-Fix-Jobs anzeigen, um etwaige Probleme bei der Jobverarbeitung zu prüfen und zu verifizieren, mit welcher Salesforce-Org der Job ausgeführt wurde.
1. Klicken Sie auf **Protokolle anzeigen**.
2. Zeigen Sie den Jobstatus und das Protokoll an.
{% endstep %}
{% step %}
### PreDeploy Fix erneut ausführen
Sobald Sie alle API-Versionsfehler behoben und fehlende Abhängigkeiten aufgelö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 gefundene Probleme abgeschlossen wurde.
{% hint style="info" %}
Beide **API-Versionsfehler** und die **Fehlende Abhängigkeiten** Tabellen zeigen **Keine Komponenten**.
{% endhint %}
{% endstep %}
{% endstepper %}
## API-Versionsfehler beheben
Wenn der **PreDeploy Fix** hat API-Versionsfehler gefunden, können Sie diese beheben, indem Sie auf die richtige Version aktualisieren.
{% stepper %}
{% step %}
### Versionen aktualisieren
1. Klicken Sie auf **Versionen aktualisieren**.
2. Klicken Sie auf **Hinzufügen** für jede Komponente, um die API-Version zu aktualisieren.
3. Klicken Sie auf **Aktualisieren**.
4. Geben Sie eine **Commit-Nachricht** für die Änderungen am Branch ein.
5. Klicken Sie auf **Beheben**.
6. Nachdem der API-Aktualisierungsjob gestartet wurde, wird er auf dem **Aktivitäten** Tab als ein **Pre Deploy Fix Update** ist.
{% endstep %}
{% step %}
### Ergebnisse anzeigen
1. Klicken Sie auf das **Pre Deploy Fix Update** ist.
2. Zeigen Sie den Jobstatus und das Protokoll an.
{% endstep %}
{% endstepper %}
## Fehlende Abhängigkeiten beheben
{% stepper %}
{% step %}
### Fehlende Komponenten abrufen
Die ausgewählten Metadaten werden in Ihren Branch abgerufen und als Commit hinzugefügt.
{% hint style="info" %}
Wenn Sie Abhängigkeitskomponenten bereits entfernt haben, wählen Sie sie nicht zum Abrufen aus. Wenn Sie unsicher sind, können Sie den PreDeploy-Fix-Job erneut ausführen.
{% endhint %}
1. Klicken Sie auf **Abrufen**.
2. Klicken Sie auf **Hinzufügen** für jede abzurufende Abhängigkeitskomponente.
3. Klicken Sie auf **Abrufen**.
4. Geben Sie eine **Commit-Nachricht** für die Änderungen am Branch ein.
5. Klicken Sie auf das **Verbindung** Dropdown-Menü.
6. Wählen Sie die Salesforce-Org aus, aus der die abhängigen Komponenten abgerufen werden sollen.
7. Klicken Sie auf **Ausführen**.
8. Nachdem der Job „Fehlende Abhängigkeiten abrufen“ gestartet wurde, wird er auf dem **Aktivitäten** Tab als ein **Pre Deploy Fix Update** ist.
{% endstep %}
{% step %}
### Fehlende Komponenten entfernen
Die Verweise auf diese Komponenten werden aus Ihrem Branch entfernt, wodurch Bereitstellungsfehler verhindert werden.
{% hint style="info" %}
Wenn Sie Abhängigkeitskomponenten bereits abgerufen haben, wählen Sie sie nicht zum Entfernen aus. Wenn Sie unsicher sind, können Sie den PreDeploy-Fix-Job erneut ausführen.
{% endhint %}
1. Klicken Sie auf **Entfernen**.
2. Klicken Sie auf **Hinzufügen** für jede abzurufende Abhängigkeitskomponente.
3. Klicken Sie auf **Entfernen**.
4. Geben Sie eine **Commit-Nachricht** für die Änderungen am Branch ein.
5. Klicken Sie auf **Ausführen**.
6. Nachdem der Job „Fehlende Abhängigkeiten entfernen“ gestartet wurde, wird er auf dem **Aktivitäten** Tab als ein **Pre Deploy Fix Remove** ist.
{% endstep %}
{% step %}
### Ergebnisse anzeigen
1. Klicken Sie auf das **Pre Deploy Fix Retrieve** Job zum Abrufen von Komponenten oder **Pre Deploy Fix Remove** Job zum Entfernen von Komponenten.
2. Zeigen Sie den Jobstatus und das Protokoll an.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.flosum.com/devops/devops-de/code/branch-aktionen/branch-predeploy-fix-verwenden.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
