Add container workflow to README
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user