Przejdź do głównej zawartości

Instalacja Speedwave

Speedwave działa na systemach macOS i Windows. Instalator zawiera wbudowane środowisko kontenerowe i maszynę wirtualną, więc nie musisz instalować Docker Desktop ani innych zewnętrznych narzędzi.

ZasóbWymagania minimalneZalecane
Pamięć RAM16 GiB32 GiB
Wolne miejsce na dysku10 GiB20 GiB

Speedwave uruchomi się także przy mniejszej ilości RAM niż 16 GiB, jednak praca może być wolniejsza. Na macOS aplikacja sprawdza dostępną pamięć przy starcie (wyświetli ostrzeżenie poniżej 16 GiB) i przydziela maszynie wirtualnej około połowy pamięci hosta, np. 8 GiB dla maszyny z 16 GiB RAM. Na Windowsie alokacją pamięci zarządza dynamicznie WSL2.

Oficjalne wydania są publikowane na stronie GitHub Releases. Wybierz instalator odpowiedni dla swojej architektury:

PlatformaArchitekturaPakiet instalacyjny
macOSApple SiliconSpeedwave_<wersja>_macOS_Apple_Silicon.dmg
macOSIntel (x86_64)Speedwave_<wersja>_macOS_Intel.dmg
Windows 10 i 1164-bitSpeedwave_<wersja>_x64-setup.exe (lub .msi dla instalacji masowych)

Pakiety instalacyjne są podpisane cyfrowo. Instrukcję weryfikacji sum kontrolnych i podpisów znajdziesz w sekcji Autentyczność pliku binarnego.

W przypadku systemu Windows wymagane jest włączenie wirtualizacji sprzętowej w BIOS/UEFI oraz uprawnienia administratora przy pierwszej instalacji (do konfiguracji WSL2).

  1. Otwórz pobrany plik .dmg i przeciągnij aplikację Speedwave do folderu Applications.
  2. Uruchom Speedwave z Launchpada lub Findera. System przeprowadzi standardową weryfikację podpisu.
  3. Kreator pierwszej konfiguracji automatycznie utworzy maszynę wirtualną Lima za pośrednictwem natywnego Apple Virtualization Framework.

Na komputerach z procesorami Apple Silicon Speedwave wykorzystuje emulację Rosetta do uruchamiania kontenerów x86 obok natywnych obrazów ARM64.

Kreator pierwszej konfiguracji prowadzi przez proces w sześciu krokach i zapisuje postęp w pliku ~/.speedwave/setup_state.json (dzięki czemu w razie przerwania można go wznowić od ostatniego etapu): weryfikacja środowiska, start maszyny wirtualnej, budowanie obrazów kontenerów, utworzenie pierwszego projektu, uruchomienie usług oraz dodanie polecenia CLI do zmiennej PATH. Szczegóły działania architektury znajdziesz w rozdziale Jak działa Speedwave.

Po zakończeniu konfiguracji sprawdź stan środowiska w terminalu:

Okno terminala
speedwave check

Prawidłowo skonfigurowane środowisko zwróci komunikat:

speedwave check OK -- all system checks passed

Polecenie speedwave check weryfikuje uprawnienia na hoście oraz konfigurację compose pod kątem reguł bezpieczeństwa. W razie problemów narzędzie wskaże kod niespełnionej reguły oraz podpowiedź, jak go rozwiązać. Opis wszystkich reguł zawiera rozdział Silnik SecurityCheck i reguły walidacji.