NVIDIA Container Toolkit w ZimaOS: obecna konfiguracja GPU

W obecnej wersji ZimaOS nie wykonuj instrukcji dla Ubuntu, które instalują NVIDIA Container Toolkit za pomocą apt na hoście. ZimaOS ma własną integrację sterowników/środowiska wykonawczego NVIDIA, a aktualna dokumentacja aplikacji Docker pokazuje, że kontenery GPU korzystają z runtime: nvidia oraz NVIDIA_VISIBLE_DEVICES.

Użytkownik źródłowy z 2025 roku miał standardowy serwer x86 z kartą GTX 1050 i słusznie zauważył, że ZimaOS nie ma typowego menedżera pakietów Debiana. Uruchomienie Toolkit wewnątrz kontenera Alpine również nie rozwiąże problemu środowiska wykonawczego na hoście - środowisko wykonawcze NVIDIA musi być dostępne na poziomie hosta Dockera.

Najpierw sprawdź sterownik GPU na hoście

nvidia-smi
lspci -nnk | grep -A3 -Ei 'vga|3d|display'

Jeśli nvidia-smi nie może nawiązać komunikacji z GPU, konfiguracja Dockera nie jest pierwszym problemem.

Sprawdź, czy Docker ma już środowisko wykonawcze NVIDIA

docker info | grep -i nvidia
ps aux | grep '[d]ockerd'

Obecna wersja ZimaOS często uruchamia Dockera z dostępnym środowiskiem wykonawczym NVIDIA, nawet w systemach, w których nie jest ono aktywnie używane.

Korzystaj z modelu środowiska wykonawczego ZimaOS

Aktualny przewodnik ZimaOS dotyczący środowiska wykonawczego NVIDIA dla Dockera pokazuje:

services:
  my-gpu-app:
    image: your/image
    runtime: nvidia
    ipc: host
    environment:
      NVIDIA_VISIBLE_DEVICES: all

Dlaczego instalacja Toolkit w innym kontenerze nie działa

NVIDIA Container Toolkit integruje się z Dockerem/containerd na hoście. Własny przewodnik instalacji NVIDIA Container Toolkit firmy NVIDIA używa polecenia nvidia-ctk runtime configure, aby zmodyfikować konfigurację Dockera na hoście i ponownie uruchomić Dockera.

Nie kopiuj instrukcji apt do ZimaOS

Przewodnik instalacji NVIDIA zakłada użycie obsługiwanych dystrybucji opartych na Debianie/RPM z menedżerami pakietów na hoście. Obecna wersja ZimaOS nie jest utrzymywana w ten sposób, więc instrukcje dotyczące pakietów na hoście mogą kolidować z obrazem systemu appliance i modelem aktualizacji.

Testowanie dostępu do GPU w kontenerze

Gdy sterownik hosta i runtime działają poprawnie, użyj sprawdzonego kontenera z obsługą GPU lub docelowej aplikacji, aby potwierdzić, że urządzenie jest faktycznie widoczne wewnątrz kontenera.

GTX 1050 ma ograniczenia zależne od obciążenia

GTX 1050 może wystarczyć do niektórych zadań transkodowania NVENC/NVDEC, ale obciążenia AI, takie jak aktualne zadania uczenia maszynowego Immich, mogą mieć bardziej rygorystyczne wymagania dotyczące CUDA, VRAM, modelu i frameworka. To, że „Docker widzi GPU”, nie gwarantuje obsługi przez każdą aplikację.

Utwórz kopię zapasową konfiguracji aplikacji przed zmianą ustawień runtime’u

Nie zastępuj ręcznie plików usługi Dockera ani konfiguracji runtime’u, chyba że możesz je przywrócić. Błędna konfiguracja runtime’u hosta może zatrzymać wszystkie aplikacje Dockera, nie tylko kontener GPU.

Aktualny przewodnik po kontenerach GPU zawiera dokładniejsze omówienie obecnych i dawnych granic oprogramowania.

Sprawdź runtime w docelowej aplikacji

Hostowe nvidia-smi potwierdza tylko, że sterownik hosta ZimaOS wykrywa kartę. Otwórz powłokę w faktycznie skonfigurowanym do obsługi GPU kontenerze i sprawdź tam urządzenie/runtime; w przeciwnym razie aplikacja może po cichu przejść na CPU, mimo że GPU na hoście działa poprawnie.

Rozdziel transkodowanie od zgodności z AI

Obsługa NVENC/NVDEC, możliwości obliczeniowe CUDA, VRAM i frameworki specyficzne dla aplikacji to różne ograniczenia. Karta, która radzi sobie z transkodowaniem w Plex/Jellyfin, może być zbyt stara lub mieć za mało pamięci, by obsłużyć aktualny model ML.

FAQ

Czy na ZimaOS należy zainstalować nvidia-container-toolkit przez apt?

Nie. Skorzystaj z obecnej ścieżki runtime’u NVIDIA w ZimaOS, zamiast traktować host jak Ubuntu.

Czy mogę zainstalować toolkit wewnątrz Dockera Alpine?

Nie. Integracja runtime’u musi być dostępna na hoście Dockera.

Skąd mam wiedzieć, czy Docker widzi kartę NVIDIA?

Sprawdź docker info, polecenie demona Dockera/runtime, a następnie zweryfikuj dostęp do GPU w docelowym kontenerze.

Czy hostowe nvidia-smi potwierdza, że Immich ML będzie działać?

Nie. Potwierdza widoczność karty dla sterownika hosta; kontener i aplikacja nadal wymagają zgodnej obsługi CUDA/VRAM/runtime’u.