Instalacja Speedwave

Speedwave działa na macOS i Windows. Instaluje wszystko, czego potrzebuje do uruchamiania kontenerów, więc nie musisz sam wgrywać Docker Desktop, żadnego innego środowiska kontenerowego ani narzędzi do wirtualizacji. Linux nie jest obsługiwany jako platforma hosta.

Zanim zaczniesz

	Minimum	Zalecane
RAM	16 GiB	32 GiB
Wolne miejsce na dysku	10 GiB	20 GiB

Poniżej minimum Speedwave też się uruchomi, choć wydajność może na tym ucierpieć. Na macOS Speedwave przy starcie sprawdza ilość pamięci hosta i ostrzega cię, gdy jest jej mniej niż 16 GiB, a rozmiar swojej maszyny wirtualnej ustawia na mniej więcej połowę pamięci hosta, więc na Macu z 16 GiB RAM dostajesz maszynę wirtualną z 8 GiB. Na Windows nie ma wykrywania pamięci: Speedwave zawsze przyjmuje tam 16 GiB, dlatego to ostrzeżenie nigdy się nie pojawia, niezależnie od tego, ile pamięci masz naprawdę, a jej rozdziałem zajmuje się samo WSL2.

Pobieranie

Każde wydanie trafia na GitHub Releases. Wybierz pakiet instalacyjny dla swojego komputera spośród plików najnowszego wydania:

Platforma	Sprzęt	Pakiet instalacyjny
macOS	Apple Silicon	Speedwave_<wersja>_macOS_Apple_Silicon.dmg
macOS	Intel	Speedwave_<wersja>_macOS_Intel.dmg
Windows 10 i 11	64-bit	Speedwave_<wersja>_x64-setup.exe, a do wdrożenia przez dział IT .msi

Instalatory są podpisane; jeśli chcesz zweryfikować pobrany plik przed uruchomieniem, zajrzyj do autentyczności plików binarnych.

Na Windows potrzebna jest jeszcze wirtualizacja sprzętowa włączona w BIOS-ie lub UEFI (Windows uruchamia kontenery pod Hyper-V) oraz uprawnienia administratora przy pierwszej instalacji, żeby Speedwave mógł skonfigurować WSL2.

Instalacja

macOS

1. Otwórz pobrany plik .dmg i przeciągnij Speedwave do folderu Applications.
2. Uruchom Speedwave raz z Launchpada. macOS przy pierwszym uruchomieniu weryfikuje podpis aplikacji.
3. Kreator konfiguracji tworzy maszynę wirtualną Speedwave za pomocą wbudowanego mechanizmu wirtualizacji Apple, więc nie masz nic więcej do wgrywania.

Na Apple Silicon Speedwave korzysta z Rosetty, by uruchamiać obrazy kontenerów x86, dzięki czemu działają obrazy zbudowane pod obie architektury.

Windows

1. Uruchom pobrany instalator .exe.
2. Uruchom Speedwave z menu Start.
3. Jeśli brakuje WSL2, kreator konfiguracji zainstaluje go za ciebie. Zobaczysz okno z prośbą o uprawnienia Windows, a potem musisz zrestartować komputer i otworzyć Speedwave ponownie.
4. Kreator zakłada osobną dystrybucję WSL2 o nazwie Speedwave i uruchamia w niej środowisko kontenerowe.

Dystrybucja WSL2 o nazwie Speedwave jest oddzielona od innych dystrybucji Linuksa, które już masz, a Speedwave nie zmienia twojej domyślnej konfiguracji WSL.

Jeśli automatyczna konfiguracja WSL2 zawiedzie na komputerze zablokowanym przez politykę firmy, włącz ją ręcznie z PowerShella uruchomionego z podwyższonymi uprawnieniami, a potem otwórz Speedwave ponownie:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --update

Notatka

Windows 11 w wersji 22H2 (kompilacja 22621) lub nowszej jest potrzebny tylko wtedy, gdy pracujesz zza firmowego VPN-a i chcesz, żeby Speedwave sięgał z wnętrza kontenera do usług dostępnych przez VPN. Speedwave sprawdza numer kompilacji przy starcie i ostrzega, gdy jest niższy niż 22621 (jeśli numeru nie da się odczytać, sprawdzenie zostaje po cichu pominięte). Na starszych kompilacjach Speedwave nadal działa; niedostępny z poziomu kontenera pozostaje tylko ruch kierowany przez VPN.

Welcome to Speedwave.

first-run setup · ~2 minutes

✓check environmentdone

✓start virtual machinedone

3build imagesrunning

4create your first project

5start containers

6finalize

Co robi kreator

Kreator prowadzi cię przez sześć kroków i zapisuje postęp w ~/.speedwave/setup_state.json, więc przerwany przebieg wznawia się, zamiast zaczynać od nowa: sprawdzenie środowiska, uruchomienie maszyny wirtualnej, zbudowanie obrazów, utworzenie twojego pierwszego projektu, uruchomienie kontenerów oraz finalizacja (podpięcie CLI speedwave). Gdy kreator skończy, nie zostaje już nic do wgrania ani skonfigurowania dla żadnego projektu. Zajrzyj do jak działa Speedwave, by dowiedzieć się, co działa gdzie, a potem zacznij pierwszy projekt, żeby wziąć się do pracy.

Sprawdź, czy działa

Po instalacji otwórz terminal i uruchom:

speedwave check

Na sprawnym systemie zobaczysz:

speedwave check OK -- all system checks passed

speedwave check weryfikuje twój system i konfigurację kontenerów Speedwave pod kątem jego reguł bezpieczeństwa. Tylko raportuje: nie uruchamia kontenerów i niczego nie zmienia. Jeśli któraś reguła nie przejdzie, polecenie wypisze, która to reguła, wraz z podpowiedzią, a potem zakończy się błędem. Napraw problem i uruchom je ponownie. Zajrzyj do SecurityCheck i jego reguł, by dowiedzieć się, co obejmują te sprawdzenia.