Add container workflow to README

This commit is contained in:
mpabi
2026-05-01 22:37:34 +02:00
parent afc96f7a8a
commit 40cfa61f4c
+62
View File
@@ -399,6 +399,68 @@ Dla użytkownika `u1` i zadania `task4_stack_strlen` branch będzie miał nazwę
u1T4a
```
## Kolejny krok: kontenery i debugowanie
Kontenery są potrzebne dopiero po pobraniu karty pracy, kiedy chcesz uruchomić
albo debugować konkretne zadanie. `rvctl` korzysta z narzędzia
`rv32i-hazard3-student-env`, które trafia do workspace pod:
```text
~/dev/workspace/rv/tools/rv32i-hazard3-student-env
```
Najpierw sprawdź dostępne profile i pobierz albo odśwież repo środowiska:
```bash
./rvctl env list
./rvctl env sync
```
Po synchronizacji workspace ma dodatkowe narzędzie pod `tools`:
```text
~/dev/workspace/rv
├── meta
│ └── workspace-info
├── tools
│ ├── rv-launcher
│ └── rv32i-hazard3-student-env
├── tokens
│ └── tokens.json
└── series
└── inf
└── lab-rv32i-strlen-bss-data-stack
```
Środowisko ma dwa profile:
- `rv32i` - Hazard3/RISC-V, `gdb-multiarch`, `nvim` i `tmux`,
- `host` - natywne uruchamianie i debugowanie C przez `clang` albo `gcc`,
`gdb`, `nvim` i `tmux`.
Zbuduj potrzebne obrazy:
```bash
./rvctl env build rv32i
./rvctl env build host
```
Dla pobranej karty `inf bss` możesz uruchomić debugowanie w obu profilach:
```bash
./rvctl debug rv32i 4
./rvctl debug host 4
```
Profil `host` ma też szybkie uruchomienie bez sesji debuggera:
```bash
./rvctl run host 4
```
Szczegóły komend, warianty `--dry-run`, `--instance`, `--editor` i ograniczenia
profili są w `doc/containers.md`.
## Dokumentacja
- `doc/rvctl.md` - techniczna dokumentacja CLI: wszystkie komendy, argumenty