Fähigkeit: Testen lokaler Twoliter-Änderungen
Zweck
Twoliter aus lokalen Quellen erstellen und Kits so konfigurieren, dass sie die lokal erstellte Binärdatei zum Testen von Änderungen vor der Veröffentlichung verwenden.
Wann verwenden
- Änderungen am Twoliter-Quellcode vornehmen
- Twoliter-Modifikationen vor dem Erstellen eines PR testen
- Fehlverhalten von Twoliter debuggen
- Korrekturen an Twoliter validieren
Voraussetzungen
- Twoliter-Repository im Forest geklont
- Rust-Toolchain installiert
- Mindestens ein Kit-Repository zum Testen
Vorgehensweise
1. Änderungen am Twoliter-Quellcode vornehmen
Bearbeiten Sie Dateien in twoliter/twoliter/src/ oder twoliter/twoliter/embedded/.
2. Twoliter erstellen
cd twoliter
cargo build --release
Die Binärdatei befindet sich unter target/release/twoliter.
3. Änderungen testen
Überschreiben Sie TWOLITER_DIR, um auf Ihr lokales Build-Verzeichnis zu verweisen:
cd kits/bottlerocket-core-kit
make build TWOLITER_DIR=./twoliter/target/release
4. Iterieren
Nach weiteren Änderungen:
# Twoliter neu erstellen
cd ./twoliter
cargo build --release
# Erneut testen
cd kits/bottlerocket-core-kit
make build TWOLITER_DIR=./twoliter/target/release
Validierung
Überprüfen Sie, ob der lokale Twoliter verwendet wird, indem Sie den Pfad prüfen:
cd kits/bottlerocket-core-kit
make build TWOLITER_DIR=./twoliter/target/release 2>&1 | head -5
Sie sollten sehen, dass Ihr modifizierter Twoliter aufgerufen wird.
Häufige Probleme
Änderungen werden nicht übernommen:
- Stellen Sie sicher, dass Sie
cargo build --releasenach den Änderungen ausgeführt haben - Überprüfen Sie, ob der Pfad in
TWOLITER_DIRkorrekt ist - Prüfen Sie, ob die Binärdatei existiert:
ls -lh ./twoliter/target/release/twoliter
Build-Fehler in Twoliter:
- Führen Sie
cargo checkaus, um detaillierte Fehlermeldungen zu sehen - Führen Sie
cargo clippyaus, um häufige Probleme zu erkennen - Führen Sie
cargo testaus, um zu überprüfen, ob die Tests bestehen
Kit-Build schlägt mit lokalem Twoliter fehl:
- Überprüfen Sie die Twoliter-Ausgabe auf Fehlermeldungen
- Fügen Sie
--log-level debughinzu, indem Sie das Makefile vorübergehend ändern oder die Twoliter-Binärdatei direkt verwenden
Rückkehr zur veröffentlichten Version
Um zur veröffentlichten Version zurückzukehren, lassen Sie einfach die Überschreibung von TWOLITER_DIR weg:
cd kits/bottlerocket-core-kit
make build
Dadurch wird die Standard-tools/twoliter/twoliter aus der veröffentlichten Version verwendet.