Całość, a nie pierwsza połowa.
Każdy przewodnik bierze jedną pustą instancję i zamienia ją w usługę, na którą możesz skierować prawdziwy ruch. Polecenia wykonujesz od góry do dołu w kolejności, w jakiej są wydrukowane, placeholdery są oznaczone, a ostatnia sekcja to zawsze test. Żaden przewodnik tutaj nie kończy się słowami „a potem skonfiguruj resztę według uznania”.
Przewodnik to nie wpis w bazie wiedzy
Oba formaty istnieją, ponieważ każdy jest zły w zadaniu drugiego. Połącz je, a dostaniesz ten rodzaj dokumentacji, który wyjaśnia, co robi każda flaga, ale nigdy nie mówi, których flag potrzebujesz.
Baza wiedzy odpowiada na pytanie w minutę. Przewodnik kosztuje cię popołudnie i zostawia działający serwer na końcu.
Wpis w bazie wiedzy zaczyna się od czegoś, co już masz, i czegoś, co jest z tym nie tak: montowanie, które nie wraca po restarcie, certyfikat, który odnowił się, ale nie przeładował, konsola ratunkowa, z której nie możesz uzyskać wiersza poleceń. Jest krótki, ponieważ kontekst już masz w głowie. Przychodzisz z problemem i wychodzisz z odpowiedzią.
Przewodnik zaczyna się od zera. Zapłaciłeś fakturę, masz dane dostępowe roota, a maszyna jest niekonfigurowanym obrazem w mieście, które wybrałeś z własnych powodów. Na końcu masz serwer pocztowy przechodzący testy uwierzytelniania albo hiperwizor z zagnieżdżonymi gośćmi, albo dwa terabajty w innym kraju niż było to tego ranka. Kontekst buduje się w miarę czytania, dlatego te artykuły mają kilka tysięcy słów, a nie dwieście.
Pisanie ich w ten sposób to więcej pracy, ale pozwala wyłapać więcej błędów. Każdy przewodnik na tej stronie został uruchomiony od początku do końca na świeżo wdrożonej instancji przed publikacją, a następnie ponownie, gdy projekt nadrzędny wydał coś, co go psuło. Data na górze każdego wpisu to data ostatniego uruchomienia, a nie data, kiedy ktoś go przejrzał.
Jedna kompletna rzecz
To nie przegląd sześciu opcji i wzruszenie ramion. Każdy przewodnik wybiera jedno podejście, wyjaśnia dlaczego i to buduje. Realne alternatywy mają jedno zdanie i link, a przewodnik idzie dalej.
Polecenia wykonywane w kolejności
Skopiuj je w podanej kolejności na świeży obraz, a zadziałają. Jeśli krok dziewiąty wymaga pakietu zainstalowanego w kroku drugim, to krok drugi go instaluje. Nic nie zależy od stanu, którego nie miano kazać Ci stworzyć.
Nazwana maszyna
Każda budowa podaje, dla jakiej maszyny została napisana i co się stanie, jeśli użyjesz czegoś mniejszego. Optymalizacja Postgresa zakładająca 64 GB ECC to bezużyteczna rada dla pudła z 16 GB, więc mówimy to na górze.
Nudna część środkowa
Właściciele plików, wzmacnianie jednostek systemd, reguły firewalla, rotacja logów. To część, którą pomija większość poradników, i część, która decyduje o tym, czy usługa będzie działać w marcu.
Test na końcu
Każdy przewodnik kończy się poleceniami, których wynik jednoznacznie mówi, czy budowa się udała. Nie „powinieneś teraz zobaczyć stronę logowania”. Coś z kodem wyjścia lub nagłówkiem, który możesz odczytać.
“Jeśli ostatnia linia strony to „a następnie skonfiguruj firewall”, to nie jest przewodnik, tylko lista zakupów.”
Jak podążać za jednym bez marnowania wieczoru
Są napisane dla ludzi, którzy czytają całą stronę, zanim coś wpiszą. Ten nawyk jest wart mniej więcej godziny na każdą budowę.
Zakładamy świeży obraz Debian 13 i powłokę roota, chyba że przewodnik mówi inaczej. Wszystko inne jest podane w dwóch pierwszych akapitach.
- 01
Wdróż coś nowego
Przebudowa przewodnika na maszynie, która już uruchamia trzy usługi, to sposób na odkrycie, która z nich po cichu zajmowała port 8080. Świeża instancja jest mniej niż minutę stąd, a potem możesz ją zniszczyć.
- 02
Przeczytaj go w całości
W szczególności kroki DNS. Połowa budów tutaj wymaga, aby rekord rozprzestrzenił się, zanim późniejsze polecenie będzie mogło się powieść, a najtańsze miejsce, aby się tego nauczyć, to pierwsze czytanie, a nie krok jedenasty.
- 03
Podmień placeholdery
Wszystko w kształcie example.com, 2001:db8: lub <nawiasy ostre> należy do Ciebie. Zakresy dokumentacyjne są używane celowo, aby błąd kopiowania-wklejania zawiódł głośno, zamiast po cichu sięgnąć do czyjejś sieci.
- 04
Zrób snapshot przed nieodwracalną częścią
Repartycjonowanie, aktualizacje dystrybucji, wszystko, co zawiera słowo „wyczyść”. Pakiet snapshotów daje pięć slotów i przywracanie trwające sekundy, co jest tańsze niż powtarzanie kroków od pierwszego do dziewiątego.
- 05
Uruchom weryfikację
To ostatnia sekcja każdego przewodnika i istnieje, bo „wyglądało, że się uruchamia” to nie to samo co „działa”. Dwie minuty sprawdzania są lepsze niż dowiedzenie się od użytkownika.
Nic na tej stronie nie potokuje zdalnego skryptu do powłoki. Tam, gdzie projekt nadrzędny tylko tak dostarcza instalator, przewodnik pokazuje, jak go pobrać, przeczytać i uruchomić jako plik — powinieneś wiedzieć, co trafiło na Twoją maszynę, i my też powinniśmy.
Jaką maszynę chce każda budowa
Większość z nich działa bez problemu na najmniejszej instancji Ryzen. Cztery nie, a wybranie złej linii dla tych czterech marnuje popołudnie, zanim dotrzesz do ciekawej części.
Tam, gdzie przewodnik podaje plan, jest to plan, na którym go przetestowano. Zmniejszenie jest zwykle w porządku i zostało odnotowane tam, gdzie nie jest. Zwiększenie nie zmienia niczego poza liczbami, które wpisujesz w pliki konfiguracyjne, a przewodniki, które dbają o tę arytmetykę, pokazują tę arytmetykę.
| Budowa | Linia | Dlaczego ta |
|---|---|---|
| WireGuard, przekaźnik Tor, Matrix, monitoring | Ryzen R-4 | Jednowątkowy, ograniczony siecią, maleńki zestaw roboczy. Więcej rdzeni niczego nie zmienia. |
| Serwer pocztowy, runner CI, Nextcloud | Ryzen R-8 | Etapy budowania i antyspam lubią szybkie rdzenie. Budowanie obrazów to najcięższa rzecz tutaj. |
| Postgres | EPYC E-8 i wyżej | Strojenie w tym przewodniku zakłada 64 GB pamięci ECC i przypinanie NUMA. |
| Lokalna inferencja | GPU G-L40S | Czterdzieści osiem gigabajtów VRAM, przekazane bezpośrednio. Współdzielona karta to czyjaś kolejka. |
| Seedbox | Storage S-50 | Pięćdziesiąt terabajtów pamięci masowej za warstwą zapisu NVMe, na porcie wystarczająco grubym, aby to opróżnić. |
| Proxmox z zagnieżdżonymi gośćmi | Bare metal BM-E | Zagnieżdżona wirtualizacja wymaga fizycznej maszyny. Nie ma naszego hiperwizora na przeszkodzie. |
| Przenoszenie dwóch terabajtów między lokalizacjami | Dowolne dwie instancje | Napisane pod węzeł pamięci masowej i Ryzena, ale metoda jest taka sama przy każdym rozmiarze. |
Każdy przewodnik zakłada trasowany IPv6 /64, który jest dostarczany z każdą instancją. Dwa z nich proszą o /48, ponieważ rozdawanie podsieci per-klient z pojedynczego /64 oznacza proxy dla wykrywania sąsiadów, a proxy IPv6 to coś, co debugujesz zawodowo, a nie uruchamiasz.
Prywatność
03Infrastruktura
04Rozwój
02Sieć
02Pytania o przewodniki, a nie o kompilacje
W większości tak. Części, które są nasze, to kroki w panelu, trasowany prefiks i założenie dedykowanych rdzeni. Cała reszta to standardowy Debian i oprogramowanie z góry, więc polecenia przenoszą się czysto do dowolnego miejsca, które daje roota i nie sprzedaje CPU z naddatkiem.
Ponieważ pisanie dwunastu przewodników pięć razy to sposób, w jaki dokumentacja się starzeje. Debian 13 to nasz domyślny obraz, nazwy pakietów są stabilne przez lata, a przetłumaczenie kroku na AlmaLinux lub Alpine to zamiana menedżera pakietów, a nie przepisanie. Pełna lista obrazów znajduje się na stronie systemów operacyjnych.
Powiedz nam. Przewodniki są ponownie uruchamiane na czystym obrazie, gdy usłyszymy o awarii, a poprawiona wersja trafia w tym samym tygodniu z datą u góry. Ticket z poleceniem i błędem wystarczy; nie musisz tego dla nas diagnozować.
Wspieramy maszynę, sieć i pamięć masową pod spodem. Debugowanie plików map Postfix o trzeciej nad ranem nie jest na tej liście, a i tak bylibyśmy w tym zli. Zarządzane utwardzanie istnieje jako dodatek, jeśli chcesz, aby linia bazowa była utrzymywana przez kogoś innego.
Dla ośmiu z dwunastu tak, a R-4 to ten, na którym kilka powstało. Kompilacje Postgres, inferencji, seedboxa i Proxmox wymagają linii wymienionej w tabeli powyżej; reszta jest wygodna na czterech dedykowanych rdzeniach i 16 GB.
Wybierz miasto, wdróż, idź dalej.
Instancja, której potrzebujesz do większości z tego, kosztuje mniej niż kawa, którą wypijesz podczas jej budowania. Płać monetą, czekaj około czterdziestu siedmiu sekund i zacznij od kroku pierwszego.