Was macht Abhängigkeits-Upgrade-Planer?
Erstellen Sie einen Plan. Führen Sie kein Upgrade durch, bis der Benutzer den Plan genehmigt hat.
Vorgehen
- Erkennen Sie das Ökosystem aus dem Manifest:
package.json,requirements.txtoderpyproject.toml,go.mod,Cargo.toml,Gemfile,pom.xml. Wenn mehrere vorhanden sind, fragen Sie, welches geplant werden soll, oder planen Sie sie getrennt. - Lesen Sie die aktuellen Versionen aus dem Manifest und der Lockdatei (
package-lock.json,poetry.lock,go.sum,Cargo.lock,Gemfile.lock). - Finden Sie verfügbare Versionen mit dem eigenen Tool des Ökosystems und melden Sie die tatsächlich erhaltene Ausgabe:
- npm:
npm outdated - Python:
pip list --outdatedoderuv pip list --outdated - Go:
go list -u -m all - Rust:
cargo outdated - Ruby:
bundle outdatedWenn das Tool nicht verfügbar ist, sagen Sie dies und arbeiten Sie vom Manifest aus, wobei Sie Versionen als unverifiziert markieren.
- npm:
- Klassifizieren Sie jedes veraltete Paket:
- Patch / Minor – normalerweise sicher.
- Major – lesen Sie das Changelog oder die Versionshinweise auf Breaking Changes, bevor Sie es planen.
- Sicherheit – alles, was von
npm audit,pip-audit,govulncheck,cargo auditoderbundle auditgemeldet wird. Diese haben Vorrang.
- Ordnen Sie die Arbeit in Batches:
- Batch 0: Sicherheitsfixes, auch wenn es sich um Major-Versionen handelt.
- Batch 1: Patch- und Minor-Upgrades, gruppiert nach Bereich.
- Batch 2: Major-Upgrades ohne Abhängigkeit untereinander, einer pro Commit.
- Batch 3: Major-Upgrades, die zusammen verschoben werden müssen (z. B. ein Framework und seine Plugins).
- Geben Sie für jeden Batch an: die Pakete, die Von-/Nach-Versionen, die zutreffenden Breaking Changes, den Code oder die Konfiguration, die geändert werden müssen, und wie überprüft werden kann.
Ausgabevorlage
## Upgrade-Plan
Ökosystem: <npm / pip / go / cargo / ...>
Manifest: <Pfad>
### Batch 0 – Sicherheit
| Paket | Von | Nach | Grund | Breaking? |
| --- | --- | --- | --- | --- |
### Batch 1 – Patch und Minor
...
### Batch 2 – Major, unabhängig
...
### Batch 3 – Major, müssen zusammen verschoben werden
...
### Verifikation
Nach jedem Batch: <der genaue Befehl, der beweist, dass nichts zurückgegangen ist>
### Rollback
Pro Batch: <wie zurückgesetzt wird, z. B. git revert des Batch-Commits>
### Zurückgestellt
<Pakete, die absichtlich nicht aktualisiert wurden, und warum>
Regeln
- Bearbeiten Sie das Manifest während der Planung niemals. Geben Sie den Plan aus und stoppen Sie dann.
- Lesen Sie das tatsächliche Changelog für eine Major-Erhöhung, wenn eines verfügbar ist; gehen Sie nicht davon aus, dass eine Version Breaking Changes enthält, nur weil die Hauptnummer geändert wurde.
- Nennen Sie immer den Verifikationsbefehl. „Führen Sie die Tests aus“ ist kein Befehl;
npm testist es. - Geben Sie den Grund für die Zurückstellung an, wenn Sie ein Paket auslassen – z. B. eine Major-Version, deren Versionshinweise Sie nicht lesen konnten.
- Führen Sie keine Installations-, Upgrade- oder Audit-Befehle aus, die den Quellbaum verändern.
npm outdated,npm auditund ihre Äquivalente sind schreibgeschützt und in Ordnung.
Unterstützende Datei
references/upgrade-strategy.md erklärt Batch-Verarbeitung, Semver-Grenzfälle und den Umgang mit einem Paket, das zurückgehalten werden muss.