Ein GitHub-Repository verbinden

Subaya-Projekte sind Git-gestützt. Ihre Entwurfsquellen, Testbenches und generierten Artefakte leben in einem GitHub-Repository, das Subaya über eine GitHub-App-Installation liest und beschreibt. Sie können entweder ein frisches Repository mit einem Starter-Gerüst erstellen oder ein bereits vorhandenes Repository verbinden.

Die GitHub-App installieren

Das Verbinden eines Repositorys erfordert, dass die Subaya-GitHub-App im besitzenden Konto oder in der besitzenden Organisation installiert ist. Installieren Sie sie über die Konsole und notieren Sie sich dann die Installations-ID — jeder repo-Befehl benötigt sie.

Variante A — ein neues Repository mit Gerüst erstellen

Dies erstellt ein neues GitHub-Repository und pusht ein typspezifisches Starter-Gerüst (Verzeichnislayout, eine Beispiel-Testbench und eine .subaya/config.toml):

suya repo create \
  --installation <installation-id> \
  --name blinky          # defaults to the project slug

--project leitet sich standardmäßig aus dem in .subaya/config.toml festgehaltenen Projekt ab; geben Sie es explizit an, wenn Sie sich außerhalb des Projektverzeichnisses befinden.

Variante B — ein vorhandenes Repository verbinden

Sie haben bereits ein Repository? Verbinden Sie es stattdessen:

suya repo connect \
  --installation <installation-id> \
  --owner my-org \
  --repo my-existing-repo

Die Verbindung prüfen

suya repo status

Dies zeigt das verbundene Repository und den Konfigurationszustand des Projekts. Sobald verbunden, werden generierte Artefakte — zum Beispiel eine STM32-.ioc aus suya arch ioc commit — direkt zurück in das Repository committet.

Nächste Schritte

• Ihr Projekt planen — Entwurfs- und Plandokumente sowie einen Arbeitselement-Baum erzeugen.
• Workspaces & Projekte — der vollständige Mandantenfähigkeits-Leitfaden.