Fähigkeit: Kit bauen und veröffentlichen
Zweck
Baue ein Bottlerocket Kit (core-kit oder kernel-kit) und veröffentliche es in einem lokalen OCI-Registry für Entwicklungs- und Testzwecke. Dies ermöglicht es dir, Kit-Änderungen in Varianten-Builds zu testen, ohne sie in Produktionsregistries zu veröffentlichen.
Wann verwenden
- Änderungen an Kit-Paketen vornehmen und in Varianten testen
- Iterative Entwicklung an Kits
- Bevor ein Varianten-Image gebaut wird, das von Kit-Änderungen abhängt
Voraussetzungen
- Docker installiert und ausgeführt
- Arbeiten innerhalb eines Grove-Verzeichnisses
- Kit-Repository geklont im Verzeichnis
kits/
Vorgehen
1. Sicherstellen, dass das lokale Registry läuft
brdev registry start
2. Für lokales Registry konfigurieren
cd kits/<kit-name>
brdev twoliter use-local-publish
Dies erstellt Infra.toml, das auf das lokale Registry für die Veröffentlichung verweist.
3. Das Kit bauen
make build
Für eine bestimmte Architektur:
make build ARCH=x86_64
# oder
make build ARCH=aarch64
4. In lokales Registry veröffentlichen
make publish VENDOR=local
Dies veröffentlicht das Kit auf localhost:5000 mit dem Vendor-Präfix "local".
5. Veröffentlichung überprüfen
brdev registry list
Sollte dein Kit in der Repository-Liste anzeigen.
Validierung
Überprüfe, ob das Kit verfügbar ist:
brdev registry list
Sollte die veröffentlichten Versions-Tags zurückgeben.
Häufige Probleme
Registry läuft nicht:
Fehler: Verbindung abgelehnt
Lösung: Führe brdev registry start aus
Infra.toml nicht konfiguriert:
Fehler: Vendor 'local' nicht gefunden
Lösung: Führe brdev twoliter use-local-publish aus, um die Konfiguration zu erstellen
Docker Zugriff verweigert: Lösung: Stelle sicher, dass der Benutzer in der Docker-Gruppe ist und der Docker-Daemon läuft
Nächste Schritte
Nach der Veröffentlichung eines Kits:
- Aktualisiere die
Twoliter.tomlder Variante, um auf die neue Kit-Version zu verweisen - Führe
make updateim Varianten-Repository aus - Baue die Variante mit
cargo make