k3s na pojedynczym VPS: kiedy warto wdrożyć?
Analiza wdrozenia k3s na pojedynczym serwerze VPS. Sprawdz, ile RAM zajmuje klaster, jak uniknac konfliktu portu 80 podczas instalacji i kiedy Docker Compose jest lepszy.
Czym jest k3s i co zapewnia pojedynczy węzeł
k3s to pełna dystrybucja Kubernetes spakowana w jeden plik binarny. Uruchomienie jej na pojedynczym VPS zapewnia dostęp do rzeczywistego API Kubernetes bez konieczności utrzymywania płaszczyzny sterowania (control plane) na trzech maszynach. Jest to certyfikowana dystrybucja Kubernetes, więc manifest zastosowany tutaj zadziała również w zarządzanym klastrze w przyszłości. Instalacja wymaga jednego polecenia i trwa około minuty. Kosztem jest pamięć RAM niedostępna dla aplikacji oraz zestaw trybów awaryjnych, które nie występują w Docker Compose.
SUSE tworzy k3s z myślą o lokalizacjach brzegowych i małych instalacjach. Różnice względem standardowego Kubernetes wynikają z dążenia do zmniejszenia rozmiaru i uproszczenia uruchamiania. Domyślnym magazynem danych jest sqlite obsługiwany przez warstwę pośrednią kine, a nie etcd, dzięki czemu nie ma potrzeby utrzymywania kworum etcd. containerd jest wbudowany w plik binarny zamiast być instalowanym oddzielnie. Ten sam plik binarny dostarcza również CoreDNS dla DNS klastra, Traefik jako kontroler Ingress, ServiceLB (znany również jako klipper-lb), aby usługi typu LoadBalancer działały bez zewnętrznego dostawcy chmurowego, local-path provisioner dla wolumenów trwałych, metrics-server oraz flannel do obsługi sieci podów. Każdy z tych komponentów uruchamia się domyślnie. Te ustawienia domyślne zajmują porty 80 i 443 przez Traefik, dlatego należy ustalić sposób obsługi tych portów przed instalacją na VPS, który już świadczy inne usługi.
Kiedy warto stosować pojedynczy węzeł k3s
Stosuj k3s, gdy celem jest wykorzystanie Kubernetes API: uczysz się Kubernetes na własnym sprzęcie lub oprogramowanie, które chcesz uruchomić, jest dostępne wyłącznie jako Helm chart. Istotna jest również przenośność manifestów, ponieważ przygotowany tutaj Deployment można przenieść do zarządzanego klastra bez żadnych zmian. Wybierz Docker Compose, gdy celem są same aplikacje. Compose uruchamia te same kontenery przy znacznie mniejszej liczbie komponentów, a plik Compose na VPS jest łatwiejszy do odczytania po roku niż katalog pełen manifestów.
Należy jasno określić, czego pojedynczy węzeł nie zapewnia.
- Brak wysokiej dostępności (High Availability). Po restarcie VPS wszystkie zadania zostają zatrzymane. Kubernetes próbuje przenieść pod na inny węzeł, ale żaden inny węzeł nie istnieje.
- Brak aktualizacji typu rolling update, która utrzymuje ciągłość działania usługi, chyba że aplikacja toleruje dwie repliki na jednej maszynie, a węzeł posiada wystarczające zasoby dla obu.
- Pamięć masowa przypisana do konkretnej maszyny, z przyczyn opisanych w sekcji local-path poniżej.
- Control plane, który zajmuje około gigabajta pamięci RAM niezależnie od tego, czy wdrożono jakiekolwiek usługi.
Powyższe ograniczenia nie czynią k3s złym wyborem. Czynią go złym wyborem z powodów, dla których ludzie zazwyczaj go wybierają, czyli niezawodności. Jeśli faktycznym celem jest posiadanie kilku maszyn w celu budowy rzeczywistego klastra wielowęzłowego, decyzja ta jest priorytetowa: Proxmox na własnym sprzęcie kontra wynajęty VPS określa pochodzenie węzłów, zanim k3s określi, co będzie na nich uruchomione.
Zużycie pamięci RAM i procesora przez k3s przed wdrożeniem jakichkolwiek usług
Projekt k3s publikuje zmierzone wartości, a nie szacunki. Należy czytać je uważnie, ponieważ liczby przytaczane przez użytkowników nie dotyczą k3s w stanie spoczynku.
Dane, na których opiera się ten wykres
[
{
"label": "Server, sqlite datastore",
"ram_mb": "1,596",
"cpu_percent_of_one_core": 6
},
{
"label": "Server, embedded etcd",
"ram_mb": "1,606",
"cpu_percent_of_one_core": 6
},
{
"label": "Agent node only",
"ram_mb": "275",
"cpu_percent_of_one_core": 3
}
]Węzeł serwera w tym teście zużywał 1,596 MB pamięci RAM na 95. percentylu oraz około 6 procent jednego rdzenia. Są to opublikowane dane, a nie pomiary z tego przewodnika. Test uruchomiono na k3s w wersji v1.26.5 ze wszystkimi wbudowanymi komponentami oraz stosem monitoringu Prometheus i Grafana, więc klaster był obciążony, a nie pusty. Projekt zaznacza jednak, że liczby te obejmują jedynie datastore Kubernetes oraz płaszczyznę sterowania (control plane) i nie uwzględniają wymagań konkretnych obciążeń. Własne kontenery należy doliczyć osobno. Zamiana sqlite na wbudowany etcd zwiększyła zużycie do 1,606 MB. Węzeł typu agent, uruchamiający kubelet oraz containerd bez płaszczyzny sterowania, zużywał 275 MB. Dokumentowane minimum dla serwera to 2 rdzenie i 2 GB pamięci RAM; minimum to obejmuje k3s oraz wbudowane komponenty przed uruchomieniem własnych obciążeń.
Wnioski praktyczne: na VPS z 2 GB RAM płaszczyzna sterowania i dołączone dodatki pozostawiają bardzo niewiele zasobów. W warunkach presji pamięci kubelet eksmituje pody, jednak przy gwałtownym wzroście zużycia pamięci mechanizm OOM killer jądra systemu może zadziałać, zanim kubelet wykryje problem. 4 GB to bezpieczne minimum dla jednego węzła z kilkoma małymi usługami. Należy zmierzyć własną maszynę zamiast polegać na jakichkolwiek opublikowanych liczbach, w tym tych podanych tutaj.
free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -AUruchom free -h przed instalacją oraz ponownie, gdy każdy pod w kube-system osiągnie stan Running. Różnica stanowi koszt płaszczyzny sterowania na posiadanym sprzęcie. k3s kubectl top node zwraca error: Metrics API not available przez pierwsze minutę lub dwie po instalacji, ponieważ metrics-server nie pobrał jeszcze żadnych danych. Nie jest to błąd. Jeśli planujesz wykorzystać jedną maszynę jednocześnie do tego celu i do innych zadań, obliczenia zawarte w dobieraniu zasobów RAM i CPU dla VPS mają tutaj pełne zastosowanie.
Instalacja k3s przypięta do konkretnego wydania, a nie do najnowszej wersji
Szybka komenda instalacyjna, którą kopiuje większość użytkowników, pobiera wersję wskazywaną w danym dniu przez kanał stable. Na maszynie przeznaczonej do długotrwałej pracy należy przypiąć wersję. k3s publikuje kanał dla każdej wersji minor Kubernetes, więc INSTALL_K3S_CHANNEL=v1.36 śledzi wydania poprawkowe wewnątrz v1.36 i nigdy nie dokona automatycznej aktualizacji wersji minor. Według stanu na październik 2026 kanał stable wskazuje na v1.36.5+k3s1.
Najpierw utwórz plik konfiguracyjny, a następnie przeprowadź instalację. k3s odczytuje /etc/rancher/k3s/config.yaml podczas uruchamiania, więc wszelkie zawarte w nim ustawienia mają zastosowanie zarówno przy pierwszym starcie, jak i przy każdym kolejnym.
sudo mkdir -p /etc/rancher/k3s
sudo tee /etc/rancher/k3s/config.yaml >/dev/null <<'EOF'
tls-san:
- k3s.example.com
EOF
curl -sfL https://get.k3s.io | INSTALL_K3S_CHANNEL=v1.36 sh -Aby przypiąć konkretne wydanie zamiast kanału, użyj INSTALL_K3S_VERSION=v1.36.5+k3s1. Znak plus jest częścią tagu. Następnie sprawdź, czy usługa została uruchomiona.
k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -Akubectl get node powinno wyświetlić jeden węzeł ze statusem Ready w ciągu około trzydziestu sekund, a każdy pod w kube-system powinien osiągnąć stan Running lub Completed. Węzeł zablokowany w stanie NotReady zazwyczaj oznacza, że środowisko uruchomieniowe kontenerów nie wystartowało, więc należy sprawdzić sudo journalctl -u k3s -n 100 --no-pager. W przypadku nietypowego obrazu VPS, przed rozpoczęciem jakiejkolwiek diagnostyki uruchom sudo k3s check-config: narzędzie to zgłasza brakujące funkcje jądra, co pozwala uzyskać odpowiedź znacznie szybciej niż analiza logów.
Dlaczego port 80 jest już zajęty i z czego zrezygnować, aby to naprawić
Jest to błąd, który często występuje na serwerach VPS, na których już działa jakaś usługa. Instalacja kończy się powodzeniem, ale Traefik nie otrzymuje adresu, jeśli inny pod Kubernetes zarezerwował już ten sam hostPort na danym węźle.
Mechanizm: dołączony chart Traefik tworzy Service typu LoadBalancer na portach 80 i 443. ServiceLB odpowiada na to żądanie, tworząc DaemonSet małych podów o prefiksie svclb-, które zajmują te numery portów jako hostPort na każdym węźle. hostPort przekazuje ruch z portu węzła do poda za pomocą reguł sieciowych. Harmonogram sprawdza porty hosta zadeklarowane przez pody Kubernetes, a nie gniazda zajęte przez usługi hosta lub samodzielne kontenery Docker. Inny pod rezerwujący ten sam hostPort blokuje harmonogramowanie; nginx, Caddy, Apache lub samodzielny kontener Docker nasłuchujący na porcie 80 sam w sobie nie powoduje odrzucenia harmonogramowania.
sudo k3s kubectl -n kube-system get pods
sudo k3s kubectl -n kube-system get svc traefik
sudo ss -lntp '( sport = :80 or sport = :443 )'W przypadku konfliktu rezerwacji hostPort przez inny pod Kubernetes, pod svclb będzie w stanie Pending, a usługa nie będzie miała adresu zewnętrznego:
svclb-traefik-8f2c1a-r6k9x 0/2 Pending 0 3m
traefik LoadBalancer 10.43.62.11 <pending> 80:31480/TCP,443:30219/TCPUruchomienie kubectl -n kube-system describe pod svclb-traefik-... wskazuje bezpośrednio przyczynę:
0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports.ss -lntp pokazuje, który proces nasłuchuje na porcie; nie pokazuje jednak rezerwacji hostPort, które sprawdza harmonogram. Istnieje więcej niż jedno rozwiązanie, a każde z nich wiąże się z pewnym kosztem.
Przekaż porty do k3s. Usuń wszelkie konfliktujące rezerwacje hostPort z innych podów Kubernetes oraz zatrzymaj i wyłącz istniejący serwer WWW na hoście, aby Traefik obsługiwał ruch przychodzący na portach 80 i 443. Jest to właściwe rozwiązanie, gdy VPS ma pełnić wyłącznie rolę węzła k3s, a wszystkie dotychczasowe usługi zostaną przeniesione za Ingress.
Wyłącz ServiceLB i zachowaj istniejące proxy. Zainstaluj z użyciem --disable=servicelb. Usługa typu LoadBalancer nadal przydziela NodePort, więc Traefik pozostaje dostępny na wysokim porcie, takim jak 31480, a Twój nginx lub Caddy przekazuje ruch do 127.0.0.1:31480. Rezygnujesz w ten sposób z adresu zewnętrznego: usługa będzie stale zgłaszać <pending>, co wygląda jak błąd, mimo że jest to świadomy wybór.
Wyłącz Traefik i kieruj ruch własnym proxy. Zainstaluj z użyciem --disable=traefik. W takiej konfiguracji nie masz kontrolera Ingress, więc obiekty Ingress nie wykonują żadnych działań: pozostają w API bez kontrolera, który by je obsługiwał. Jest to dopuszczalne, gdy kierujesz ruch z proxy hosta do NodePorts, i jest to uczciwe rozwiązanie, jeśli wiesz, w jaki sposób chcesz obsługiwać ruch HTTP. Jeśli nie masz pewności, co powinno znajdować się na froncie, rozważ wybór między nginx, Caddy i Traefik jako reverse proxy przed dokonaniem jakichkolwiek zmian.
Obie flagi należy dodać podczas instalacji lub w pliku konfiguracyjnym:
tls-san:
- k3s.example.com
disable:
- traefik
- servicelbEdycja tego pliku po instalacji i uruchomienie sudo systemctl restart k3s również działa, ponieważ --disable nie tylko pomija komponent podczas instalacji. Usuwa on również komponent, który jest już wdrożony, więc zmiana zaczyna obowiązywać w działającym klastrze.
Aby zachować Traefik, ale zmienić sposób konfiguracji charta, nie edytuj /var/lib/rancher/k3s/server/manifests/traefik.yaml. k3s nadpisuje ten plik wartościami domyślnymi przy każdym starcie. Zamiast tego dodaj osobny plik w tym samym katalogu, ponieważ wszystko w /var/lib/rancher/k3s/server/manifests jest stosowane automatycznie przy starcie oraz za każdym razem, gdy plik zostanie zmieniony na dysku.
apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
name: traefik
namespace: kube-system
spec:
valuesContent: |-
ports:
web:
forwardedHeaders:
trustedIPs:
- 10.0.0.0/8Ten przykład ustawia jedną wartość charta Traefik: adresy zaufanych proxy. Ten sam mechanizm pozwala ustawić każdą inną wartość udostępnianą przez chart, w tym jego porty.
Trwała pamięć masowa na jednym węźle
k3s dostarcza domyślną klasę pamięci masowej (StorageClass) o nazwie local-path, obsługiwaną przez lokalny provisioner Rancher. Żądanie PersistentVolumeClaim bez określonej klasy storageClassName korzysta z niej automatycznie. Wolumeny znajdują się w /var/lib/rancher/k3s/storage, gdzie każdy z nich zajmuje osobny podkatalog na dysku lokalnym węzła.
sudo k3s kubectl get storageclass
sudo k3s kubectl get pvc -A
sudo ls -l /var/lib/rancher/k3s/storageZ faktu, że dane znajdują się na dysku lokalnym węzła, wynikają dwie konsekwencje, które stają się problematyczne dopiero w przyszłości.
Klasa pamięci masowej używa volumeBindingMode: WaitForFirstConsumer, więc nowe żądanie PVC pozostaje w stanie Pending, dopóki pod faktycznie go nie zamontuje. Polecenie kubectl describe pvc wyświetli:
waiting for first consumer to be created before bindingJest to zachowanie standardowe, więc samo utworzenie PVC i oczekiwanie na zmianę stanu nie przyniesie rezultatu.
Po powiązaniu wolumen zyskuje powinowactwo do węzła (node affinity), na którym został utworzony. Powoduje to przypisanie każdego poda korzystającego z tego żądania do danego węzła na cały okres istnienia wolumenu. Na pojedynczym węźle nie jest to odczuwalne. Po dodaniu drugiego węzła pod, który odmawia przeniesienia, może być błędnie interpretowany jako błąd harmonogramu, dopóki nie zostanie wykonane polecenie kubectl get pv -o yaml, które ujawni nazwę hosta w sekcji nodeAffinity.
Kopie zapasowe są obowiązkiem administratora. Przebudowa VPS niszczy ten katalog, podobnie jak poniższy skrypt deinstalacyjny. Należy zabezpieczyć /var/lib/rancher/k3s/storage, a także katalog bazy danych sqlite /var/lib/rancher/k3s/server/db/, kopiowany przy zatrzymanej usłudze, ponieważ jest to aktywna baza danych, oraz plik tokena serwera w /var/lib/rancher/k3s/server/token. Token jest niezbędny: dokumentacja k3s wskazuje, że podczas przywracania bazy danych z kopii zapasowej należy przywrócić ten plik lub przekazać jego wartość do --token. Alternatywnym podejściem jest traktowanie klastra jako zasobu tymczasowego i przechowywanie wszystkich manifestów w systemie git.
Ingress i TLS
Przy włączonym Traefik, wystarczy standardowy obiekt Ingress.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: hello
annotations:
cert-manager.io/cluster-issuer: letsencrypt
spec:
ingressClassName: traefik
tls:
- hosts:
- hello.example.com
secretName: hello-tls
rules:
- host: hello.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: hello
port:
number: 80Certyfikaty nie pojawiają się automatycznie. Standardowym rozwiązaniem jest cert-manager, instalowany z opublikowanego manifestu wraz z jednym ClusterIssuer. Wersja v1.21.3, wydana 23 października 2026, jest aktualna na październik 2026.
sudo k3s kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.21.3/cert-manager.yamlapiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
name: letsencrypt
spec:
acme:
email: you@example.com
server: https://acme-v02.api.letsencrypt.org/directory
privateKeySecretRef:
name: letsencrypt-account-key
solvers:
- http01:
ingress:
ingressClassName: traefikWyzwanie HTTP-01 oznacza, że serwer ACME (automatic certificate management environment) łączy się z http://hello.example.com/.well-known/acme-challenge/... z publicznego Internetu. Dlatego rekord DNS nazwy hosta, rekord A lub rekord AAAA, jeśli VPS jest dostępny przez IPv6, musi już wskazywać na VPS, a port 80 musi być skierowany na Traefik. Let’s Encrypt próbuje najpierw adresu IPv6, jeśli oba istnieją, ale przełącza się na IPv4, jeśli początkowe połączenie IPv6 przekroczy limit czasu. Inne błędy, w tym błędna odpowiedź na wyzwanie, nie wyzwalają tego mechanizmu, a przekierowane żądania nie są ponawiane. Należy naprawić lub usunąć nieaktualny rekord AAAA. Jeśli wyłączono ServiceLB i umieszczono własne proxy przed klastrem, proxy to musi również przekazywać ścieżkę wyzwania, w przeciwnym razie cert-manager zawiesi się na obiekcie Challenge z następującym komunikatem:
Waiting for HTTP-01 challenge propagation: wrong status code '404', expected '200'Monitoruj proces wydawania certyfikatów za pomocą sudo k3s kubectl describe certificate hello-tls oraz sudo k3s kubectl get order,challenge -A.
Plik kubeconfig i powody, dla których serwer API pozostaje prywatny
k3s zapisuje poświadczenia administratora w /etc/rancher/k3s/k3s.yaml. Plik ten jest własnością użytkownika root i domyślnie posiada uprawnienia 600. Zawiera certyfikat klienta z uprawnieniami cluster-admin, więc każdy, kto może go odczytać, przejmuje kontrolę nad klastrem.
sudo k3s kubectl get node
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get nodeOsobno zainstalowany kubectl nie posiada informacji o pliku k3s. Bez ustawionej zmiennej KUBECONFIG, narzędzie odczytuje ~/.kube/config, a jeśli plik ten nie istnieje, kończy działanie błędem The connection to the server localhost:8080 was refused - did you specify the right host or port?, ponieważ nie skonfigurowano żadnego klastra. Należy ustawić KUBECONFIG, skopiować plik do ~/.kube/config zgodnie z poniższym przykładem lub użyć sudo k3s kubectl, który automatycznie odczytuje właściwy plik.
Często zaleca się --write-kubeconfig-mode 644, aby zwykły użytkownik mógł uruchamiać kubectl. Należy zrozumieć skutki tego działania: sprawia ono, że poświadczenia cluster-admin stają się czytelne dla każdego lokalnego konta w systemie. Na maszynie z jednym administratorem może to być akceptowalny kompromis. Na współdzielonym serwerze nie jest. Skopiowanie pliku zapewnia dostęp jednemu użytkownikowi bez udostępniania go pozostałym:
mkdir -p ~/.kube
sudo install -o $USER -g $USER -m 600 /etc/rancher/k3s/k3s.yaml ~/.kube/configLinia server: w tym pliku zawiera https://127.0.0.1:6443. Aby używać kubectl z laptopa, nie należy otwierać portu 6443 na świat. Publiczny interfejs Kubernetes API jest stałym celem ataków, a jego wystawienie jest najczęstszą przyczyną przejmowania małych klastrów w celu kopania kryptowalut. Należy tunelować ruch przez SSH i pozostawić adres w pliku bez zmian:
ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get nodeJeśli dostęp do API musi odbywać się przez prywatny adres sieciowy, należy przeprowadzić instalację z flagą tls-san, podając tę nazwę lub adres, a następnie edytować linię server: w skopiowanym pliku, aby była zgodna. Bez wpisu SAN (subject alternative name) kubectl odrzuci połączenie:
x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10Udokumentowane porty przychodzące dla klastra to TCP 6443 dla API, UDP 8472 dla flannel VXLAN między węzłami oraz TCP 10250 dla metryk kubelet. W przypadku pojedynczego węzła żaden z nich nie musi być otwarty na Internet.
containerd to nie Docker
k3s uruchamia własny, wbudowany containerd i nie współdzieli magazynu obrazów z Dockerem. Obraz zbudowany za pomocą docker build jest niewidoczny dla k3s, dlatego pod kończy się błędem ErrImagePull, mimo że docker images wyświetla go na liście. Należy zaimportować go jawnie:
docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl imagesNastępnie należy unikać tagu :latest dla tego kontenera, ponieważ :latest domyślnie ustawia imagePullPolicy na Always i kubelet i tak łączy się z rejestrem. Każdy inny tag domyślnie ustawia IfNotPresent, co wykorzystuje obraz, który został zaimportowany. Uruchomienie obu rozwiązań na jednym VPS działa, przy czym warto pamiętać, że standardowa instalacja Dockera na VPS oraz k3s utrzymują własne magazyny obrazów i własne reguły iptables na tej samej maszynie.
Jak usunąć k3s
Instalator tworzy skrypt odinstalowujący. Nie istnieje możliwość częściowego usunięcia ani cofnięcia operacji.
sudo /usr/local/bin/k3s-uninstall.shSkrypt zatrzymuje i usuwa usługę, usuwa magazyn danych, usuwa dane wolumenów trwałych, usuwa konfigurację węzła oraz usuwa narzędzia dodane przez instalator. Na węźle typu agent skryptem jest k3s-agent-uninstall.sh. Przed uruchomieniem należy skopiować zawartość /var/lib/rancher/k3s/storage poza serwer, ponieważ ten katalog zostanie usunięty. Następnie należy sprawdzić, czy żadne procesy nie blokują portów ani interfejsów za pomocą ip link show oraz sudo ss -lntp. Pozostały interfejs cni0 lub flannel.1 zostanie usunięty przy następnym restarcie systemu.
Uznanie, że jeden węzeł Kubernetes to zbyt złożone rozwiązanie dla danego zadania, jest typowym wnioskiem, a nie porażką. Przeniesienie obciążeń z powrotem do Compose zazwyczaj zajmuje jedno popołudnie.
Tryby awarii i komunikaty błędów
Węzeł w stanie NotReady lub k3s w pętli restartów. Najpierw zapoznaj się z sudo journalctl -u k3s -n 200 --no-pager. Na małych instancjach VPS częstą przyczyną jest mechanizm kernel out-of-memory killer, który przerywa proces; w dmesg pojawia się wówczas wpis wskazujący na k3s-server. Dokumentowane minimum 2 GB pamięci RAM jest wartością bezwzględną.
Pod w stanie Pending. kubectl describe pod zawsze wskazuje przyczynę. Insufficient memory lub Insufficient cpu oznaczają brak wolnych zasobów na węźle. didn't have free ports oznacza, że inny pod Kubernetes rezerwuje konfliktowy hostPort. waiting for first consumer przy PVC oznacza, że mechanizm WaitForFirstConsumer działa zgodnie z założeniami.
ImagePullBackOff. Węzeł nie mógł pobrać obrazu. Sprawdź nazwę obrazu i tag, dostęp do rejestru oraz poświadczenia, lub upewnij się, czy obraz zbudowany za pomocą Docker został zaimportowany do containerd.
Traefik odpowiada, aplikacja nie. Treść odpowiedzi 404 page not found pochodzi bezpośrednio z Traefik i oznacza, że żądanie dotarło, ale nie dopasowano żadnego routera. Sprawdź, czy Ingress host zgadza się z wpisaną nazwą oraz czy ingressClassName ma wartość traefik.
DNS klastra nie działa, mimo że host rozwiązuje nazwy poprawnie. Sprawdź CoreDNS za pomocą sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns. Komunikat typu plugin/loop: Loop ... detected for zone "." uniemożliwia uruchomienie CoreDNS. Występuje on, gdy CoreDNS przekazuje zapytania do resolvera, który odsyła je z powrotem, co jest efektem użycia adresu pętli zwrotnej w /etc/resolv.conf. Skieruj k3s na rzeczywisty plik nadrzędny za pomocą --resolv-conf /run/systemd/resolve/resolv.conf.
FAQ
Czy warto uruchamiać k3s na pojedynczym VPS?
Warto, jeśli celem jest wykorzystanie API Kubernetes: nauka na kontrolowanej maszynie, utrzymywanie przenośności wdrożeń w formie manifestów, uruchamianie oprogramowania dostępnego wyłącznie jako Helm chart lub budowanie rozwiązań, które w przyszłości zostaną przeniesione do zarządzanego klastra. Nie warto, jeśli celem jest jedynie uruchamianie kontenerów, ponieważ Docker Compose wymaga znacznie mniej nakładów na utrzymanie i pozwala zaoszczędzić około gigabajta pamięci RAM. Pojedynczy węzeł nie zapewnia wysokiej dostępności, więc niezawodność nie jest powodem, dla którego należy go wybierać.
Dlaczego mój serwis typu LoadBalancer w k3s pozostaje w stanie Pending?
ServiceLB tworzy pody svclb-, które rezerwują porty serwisu jako hostPort na węźle, dlatego są one planowane tylko tam, gdzie te porty są wolne. Jeśli inny pod Kubernetes już zarezerwował ten sam hostPort, pod pozostaje w stanie Pending, a serwis nigdy nie otrzymuje adresu zewnętrznego. Proxy hosta lub samodzielny kontener Docker nasłuchujący na porcie 80 sam w sobie nie powoduje odrzucenia planowania. kubectl -n kube-system describe pod svclb-... raportuje 0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports. Należy usunąć rezerwację hostPort kolidującego poda lub wyłączyć ServiceLB za pomocą --disable=servicelb i przekierować ruch na NodePort, który serwis nadal przydziela.
Ile pamięci RAM potrzebuje k3s na VPS?
Dokumentowane minimum dla węzła typu server to 2 rdzenie i 2 GB RAM; obejmuje to k3s oraz jego wbudowane komponenty przed uruchomieniem własnych obciążeń. Profilowanie projektu wykazało, że płaszczyzna sterowania i magazyn danych węzła server zajmują 1,596 MB przy działającym stosie monitoringu. Wartość ta nie uwzględnia pamięci zużywanej przez same obciążenia, dlatego 2 GB należy traktować jako absolutne minimum, a 4 GB jako pierwszą wartość zapewniającą komfortową pracę na jednym węźle. Należy zmierzyć zużycie na własnej maszynie za pomocą free -h przed instalacją oraz ponownie po tym, jak każdy pod w kube-system uzyska stan Running.
Czy mogę uruchomić Docker i k3s na tym samym VPS?
Tak, działają one niezależnie. k3s korzysta z własnego wbudowanego containerd, więc obraz zbudowany za pomocą docker build nie jest dla niego widoczny, dopóki nie zostanie wykonane polecenie docker save myapp:0.1 | sudo k3s ctr images import -. Każde z tych rozwiązań tworzy również własne reguły iptables oraz własne sieci typu bridge. Należy monitorować całkowite zużycie pamięci, ponieważ Docker, k3s oraz kontenery współdzielą zasoby RAM maszyny.
Jak całkowicie usunąć k3s?
Należy uruchomić sudo /usr/local/bin/k3s-uninstall.sh na węźle typu server lub sudo /usr/local/bin/k3s-agent-uninstall.sh na agencie. Polecenie to zatrzymuje usługę, usuwa magazyn danych, usuwa dane wolumenów trwałych w lokalizacji /var/lib/rancher/k3s/storage oraz usuwa dołączone narzędzia. Przed wykonaniem operacji należy skopiować wszystkie istotne dane z maszyny, ponieważ proces jest nieodwracalny. Pozostałe interfejsy sieciowe cni0 lub flannel.1 znikną po kolejnym restarcie systemu.