SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Patutkah Guna k3s pada VPS Tunggal? Ini Panduannya

Ketahui bila k3s sesuai untuk VPS anda. Kami bincangkan penggunaan RAM, konflik port 80 semasa pemasangan, serta perbandingan praktikal antara k3s dan Docker Compose.

Apakah k3s dan apa yang anda peroleh daripada satu nod

k3s ialah pengagihan Kubernetes penuh yang dibungkus sebagai satu binari, dan menjalankannya pada satu VPS memberikan anda API Kubernetes sebenar tanpa memerlukan control plane tiga mesin. Ia merupakan pengagihan Kubernetes yang disahkan, jadi manifest yang digunakan di sini boleh digunakan pada kluster terurus kemudian. Pemasangannya hanya memerlukan satu arahan dan mengambil masa kira-kira satu minit. Kos yang perlu dibayar ialah memori yang tidak lagi tersedia untuk aplikasi anda, serta set mod kegagalan yang tidak pernah berlaku dengan Docker Compose.

SUSE membina k3s untuk tapak edge dan pemasangan kecil, dan perbezaannya daripada Kubernetes huluan wujud untuk menjadikannya lebih kecil dan lebih mudah dijalankan. Datastore lalai ialah sqlite di sebalik shim yang dipanggil kine, bukannya etcd, jadi tiada kuorum etcd yang perlu diselenggara. containerd dibenamkan dalam binari tersebut dan bukannya dipasang secara berasingan. Binari yang sama juga menyertakan CoreDNS untuk DNS kluster, Traefik sebagai ingress controller, ServiceLB (juga dipanggil klipper-lb) supaya servis LoadBalancer berfungsi tanpa penyedia awan di belakangnya, local-path provisioner untuk persistent volumes, metrics-server, dan flannel untuk rangkaian pod. Setiap satu daripadanya bermula secara lalai. Nilai lalai tersebut meletakkan Traefik pada port 80 dan 443, jadi tentukan siapa yang akan menggunakan port tersebut sebelum memasang pada VPS yang sudah pun menjalankan servis lain.

Bilakah satu nod k3s berbaloi

Gunakan peraturan ini. Jalankan k3s apabila API Kubernetes adalah perkara yang anda mahukan: anda sedang mempelajari Kubernetes pada mesin yang anda kawal, atau perisian yang anda inginkan hanya menerbitkan Helm chart. Kemudahalihan manifest juga penting, kerana Deployment yang anda tulis di sini boleh dipindahkan ke kluster terurus tanpa sebarang perubahan. Jalankan Docker Compose apabila aplikasi adalah perkara yang anda mahukan. Compose memulakan bekas yang sama dengan bahagian yang jauh lebih sedikit, dan fail Compose pada VPS lebih mudah dibaca setahun kemudian berbanding direktori manifest.

Fahami dengan jelas perkara yang tidak diberikan oleh satu nod kepada anda.

  • Tiada ketersediaan tinggi (high availability). Apabila VPS but semula, setiap beban kerja terhenti. Kubernetes menjadualkan semula pod ke nod lain, dan tiada nod lain yang tersedia.
  • Tiada kemas kini bergulir (rolling update) yang mengekalkan perkhidmatan, melainkan aplikasi tersebut bertoleransi dengan dua replika pada satu mesin dan nod tersebut mempunyai ruang untuk kedua-duanya.
  • Storan yang terikat pada kotak tersebut, atas sebab yang diterangkan dalam bahagian local-path di bawah.
  • Control plane yang memakan sekitar satu gigabait RAM sama ada anda menggunakan apa-apa atau tidak.

Tiada satu pun daripada perkara tersebut menjadikan k3s pilihan yang buruk. Ia menjadikannya pilihan yang buruk atas sebab yang biasanya diberikan oleh orang ramai, iaitu kebolehpercayaan. Jika perkara yang anda sebenarnya mahukan ialah beberapa mesin supaya anda boleh membina kluster berbilang nod yang sebenar, keputusan itu perlu dibuat terlebih dahulu: Proxmox pada perkakasan sendiri berbanding VPS sewaan menentukan dari mana nod tersebut datang sebelum k3s menentukan perkara yang dijalankan di atasnya.

Kos RAM dan CPU k3s sebelum anda menggunakan sebarang aplikasi

Projek k3s menerbitkan angka yang diukur dan bukannya anggaran. Baca angka tersebut dengan teliti, kerana angka yang sering disebut orang bukanlah penggunaan k3s dalam keadaan melahu (idle).

CartaPublished k3s resource use, 95th percentile, Intel 8375C, k3s v1.26.5
Data di sebalik carta ini
[
  {
    "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
  }
]

Satu nod pelayan dalam ujian tersebut menggunakan 1,596 MB RAM pada persentil ke-95 dan kira-kira 6 peratus daripada satu teras. Itu adalah angka yang diterbitkan, bukan ukuran daripada panduan ini. Ujian tersebut menjalankan k3s v1.26.5 dengan semua komponen pakej diaktifkan berserta timbunan pemantauan Prometheus dan Grafana, jadi kluster tersebut sibuk dan bukannya kosong. Walau bagaimanapun, projek tersebut menyatakan bahawa angka itu hanya merangkumi datastore Kubernetes dan control plane, serta tidak termasuk keperluan khusus beban kerja (workload). Kontena anda sendiri adalah tambahan kepada penggunaan tersebut. Menukar sqlite kepada etcd terbenam meningkatkan penggunaan kepada 1,606 MB. Nod ejen, yang menjalankan kubelet dan containerd tanpa control plane, menggunakan 275 MB. Minimum yang didokumentasikan untuk sebuah pelayan ialah 2 teras dan 2 GB RAM, dan minimum itu merangkumi k3s serta komponen pakejnya sebelum beban kerja anda diambil kira.

Bacaan praktikalnya: pada VPS 2 GB, control plane dan alat tambah yang disertakan meninggalkan ruang yang sangat sedikit untuk anda. Di bawah tekanan memori, kubelet akan menyingkirkan pod, tetapi jika penggunaan memori meningkat dengan pantas, OOM killer kernel boleh bertindak sebelum kubelet mengesan tekanan tersebut. 4 GB adalah lantai yang selesa untuk satu nod dengan beberapa servis kecil. Ukur kotak anda sendiri dan jangan hanya mempercayai mana-mana angka yang diterbitkan, termasuk angka ini.

free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -A

Jalankan free -h sebelum anda memasang dan sekali lagi sebaik sahaja setiap pod dalam kube-system menunjukkan status Running. Perbezaannya ialah kos control plane pada perkakasan anda. k3s kubectl top node akan memaparkan error: Metrics API not available untuk satu atau dua minit pertama selepas pemasangan, kerana metrics-server belum lagi mengumpul sebarang data. Itu bukan satu ralat. Jika anda sedang menentukan saiz satu kotak untuk tujuan ini dan kerja lain pada masa yang sama, pengiraan dalam menentukan saiz RAM dan CPU untuk VPS terpakai di sini tanpa sebarang perubahan.

Memasang k3s dengan versi tetap, bukan versi terkini

Arahan permulaan pantas yang sering disalin oleh pengguna akan mengambil versi yang ditunjuk oleh saluran stabil pada hari arahan tersebut dijalankan. Pada mesin yang ingin dikekalkan, tetapkan versi secara khusus. k3s menerbitkan satu saluran bagi setiap versi minor Kubernetes, jadi INSTALL_K3S_CHANNEL=v1.36 akan mengikuti keluaran tampalan (patch releases) dalam v1.36 dan tidak akan melompat ke versi minor yang lain secara automatik. Setakat Oktober 2026, saluran stabil merujuk kepada v1.36.5+k3s1.

Tulis fail konfigurasi terlebih dahulu, kemudian lakukan pemasangan. k3s membaca /etc/rancher/k3s/config.yaml semasa ia bermula, jadi sebarang tetapan di dalamnya akan terpakai pada but pertama dan setiap but seterusnya.

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 -

Untuk menetapkan satu keluaran yang tepat dan bukannya saluran, gunakan INSTALL_K3S_VERSION=v1.36.5+k3s1. Tanda tambah adalah sebahagian daripada tag tersebut. Kemudian, pastikan ia telah berjalan dengan betul.

k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -A

kubectl get node sepatutnya menyenaraikan satu nod dengan STATUS Ready dalam masa kira-kira tiga puluh saat, dan setiap pod dalam kube-system sepatutnya mencapai status Running atau Completed. Nod yang terhenti pada status NotReady biasanya bermaksud runtime kontena tidak bermula, jadi baca sudo journalctl -u k3s -n 100 --no-pager. Pada imej VPS yang luar biasa, jalankan sudo k3s check-config sebelum anda menyahpepijat perkara lain: ia melaporkan ciri kernel yang hilang, yang merupakan jawapan yang jauh lebih pantas daripada membaca log.

Mengapa port 80 sudah digunakan, dan apa yang perlu dikorbankan untuk membaikinya

Ini adalah kegagalan yang sering dihadapi pengguna pada VPS yang sudah menjalankan sesuatu servis. Pemasangan berjaya, tetapi Traefik tidak mendapat alamat jika pod Kubernetes lain sudah menempah hostPort yang sama pada nod tersebut.

Mekanismenya: carta Traefik yang disertakan mencipta Service jenis LoadBalancer pada port 80 dan 443. ServiceLB menjawab permintaan tersebut dengan mencipta DaemonSet bagi pod kecil, yang dinamakan dengan awalan svclb-, yang menuntut nombor port tersebut sebagai hostPort pada setiap nod. hostPort menghalakan trafik daripada port nod ke pod melalui peraturan rangkaian. Penjadual (scheduler) menyemak host port yang diisytiharkan oleh pod Kubernetes, bukan soket yang dipegang oleh servis hos atau kontena Docker kendiri. Pod lain yang menempah hostPort yang sama akan menyekat penjadualan; nginx, Caddy, Apache atau kontena Docker kendiri yang mendengar pada port 80 tidak menyebabkan penolakan penjadualan tersebut secara langsung.

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 )'

Dengan tempahan hostPort yang bercanggah daripada pod Kubernetes lain, anda akan melihat pod svclb dalam status Pending dan servis tanpa alamat luaran:

svclb-traefik-8f2c1a-r6k9x   0/2   Pending   0   3m
traefik   LoadBalancer   10.43.62.11   <pending>   80:31480/TCP,443:30219/TCP

Menjalankan kubectl -n kube-system describe pod svclb-traefik-... menyatakan puncanya secara terus:

0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports.

ss -lntp memberitahu anda proses mana yang mendengar pada port tersebut; ia tidak menunjukkan tempahan hostPort yang disemak oleh penjadual. Terdapat lebih daripada satu jalan keluar, dan setiap satunya mempunyai kos tersendiri.

Berikan port tersebut kepada k3s. Alihkan sebarang tempahan hostPort yang bercanggah daripada pod Kubernetes lain, serta hentikan dan nyahdayakan pelayan web hos sedia ada supaya Traefik mengendalikan trafik masuk pada 80 dan 443. Ini adalah jawapan yang tepat apabila VPS tersebut akan menjadi mesin k3s sepenuhnya, dan semua yang anda hidangkan sebelum ini dipindahkan ke belakang Ingress.

Nyahdayakan ServiceLB dan kekalkan proksi sedia ada anda. Pasang dengan --disable=servicelb. Service jenis LoadBalancer masih memperuntukkan NodePort, jadi Traefik kekal boleh dicapai pada port tinggi seperti 31480, dan nginx atau Caddy anda melakukan proksi ke 127.0.0.1:31480. Apa yang anda korbankan ialah alamat luaran: servis tersebut akan melaporkan <pending> selama-lamanya, yang kelihatan seperti ralat sedangkan ia adalah pilihan yang anda buat.

Nyahdayakan Traefik dan halakan dengan proksi anda sendiri. Pasang dengan --disable=traefik. Anda kemudiannya tidak mempunyai ingress controller, jadi objek Ingress tidak melakukan apa-apa: ia kekal dalam API tanpa pengawal yang memantaunya. Ini boleh diterima apabila anda menghalakan trafik daripada proksi hos ke NodePorts, dan ia adalah pilihan yang jujur jika anda sudah tahu cara anda mahu HTTP dikendalikan. Jika anda belum membuat keputusan tentang apa yang sepatutnya berada di hadapan, selesaikan pilihan antara nginx, Caddy dan Traefik sebagai reverse proxy sebelum anda menyahdayakan apa-apa.

Kedua-dua flag tersebut perlu diletakkan pada pemasang, atau dalam fail konfigurasi:

tls-san:
  - k3s.example.com
disable:
  - traefik
  - servicelb

Menyunting fail tersebut selepas pemasangan dan menjalankan sudo systemctl restart k3s juga berkesan, kerana --disable melakukan lebih daripada sekadar melangkau komponen semasa pemasangan. Ia juga memadamkan komponen yang sudah digunakan, jadi perubahan tersebut berkuat kuasa pada kluster yang sedang berjalan.

Untuk mengekalkan Traefik tetapi menukar cara carta dikonfigurasikan, jangan sunting /var/lib/rancher/k3s/server/manifests/traefik.yaml. k3s menulis semula fail tersebut dengan tetapan lalai setiap kali ia dimulakan. Tambahkan fail berasingan dalam direktori yang sama sebaliknya, kerana apa-apa dalam /var/lib/rancher/k3s/server/manifests digunakan secara automatik semasa permulaan dan setiap kali ia berubah pada cakera.

apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
  name: traefik
  namespace: kube-system
spec:
  valuesContent: |-
    ports:
      web:
        forwardedHeaders:
          trustedIPs:
            - 10.0.0.0/8

Contoh tersebut menetapkan satu nilai carta Traefik, iaitu alamat proksi yang dipercayai. Mekanisme yang sama menetapkan sebarang nilai lain yang didedahkan oleh carta tersebut, termasuk portnya.

Storan kekal pada satu nod

k3s menyertakan StorageClass lalai yang dipanggil local-path, yang disokong oleh local-path provisioner daripada Rancher. PersistentVolumeClaim tanpa storageClassName akan menggunakan storan ini. Volume disimpan dalam /var/lib/rancher/k3s/storage, dengan satu subdirektori bagi setiap volume, pada cakera nod itu sendiri.

sudo k3s kubectl get storageclass
sudo k3s kubectl get pvc -A
sudo ls -l /var/lib/rancher/k3s/storage

Terdapat dua kesan daripada "pada cakera nod itu sendiri", dan kedua-duanya akan menjadi masalah pada masa hadapan.

StorageClass ini menggunakan volumeBindingMode: WaitForFirstConsumer, jadi PVC baharu akan kekal dalam status Pending sehingga pod benar-benar melakukan mount pada volume tersebut. kubectl describe pvc akan memaparkan:

waiting for first consumer to be created before binding

Ini adalah perkara biasa, jadi mencipta PVC secara berasingan dan menunggunya tidak akan mengubah status tersebut.

Setelah bound, volume tersebut membawa node affinity untuk nod yang menciptanya, yang mengikat setiap pod yang menggunakan claim tersebut kepada nod itu sepanjang hayat volume berkenaan. Pada satu nod, anda tidak akan menyedarinya. Jika anda menambah nod kedua kemudian, pod yang enggan berpindah akan kelihatan seperti pepijat penjadual (scheduler bug) sehingga anda menjalankan kubectl get pv -o yaml dan mendapati hostname tersebut berada dalam nodeAffinity.

Sandaran adalah tanggungjawab anda. Membina semula VPS akan memadamkan direktori tersebut, begitu juga dengan skrip nyahpasang di bawah. Lakukan sandaran bagi /var/lib/rancher/k3s/storage, serta direktori datastore sqlite /var/lib/rancher/k3s/server/db/ yang disalin semasa servis dihentikan kerana ia merupakan pangkalan data aktif, dan fail token pelayan di /var/lib/rancher/k3s/server/token. Token tersebut adalah wajib: dokumentasi k3s menyatakan bahawa anda mesti memulihkan fail itu, atau memberikan nilainya kepada --token, apabila memulihkan datastore daripada sandaran. Alternatifnya adalah dengan menganggap kluster sebagai boleh dibuang (disposable) dan menyimpan setiap manifest dalam git.

Ingress dan TLS

Dengan Traefik dibiarkan aktif, objek Ingress standard adalah semua yang anda perlukan.

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: 80

Sijil tidak akan muncul dengan sendirinya. Penyelesaian biasa ialah cert-manager, yang dipasang daripada manifes yang diterbitkan, ditambah satu ClusterIssuer. Versi v1.21.3, yang dikeluarkan pada 23 Oktober 2026, adalah versi semasa setakat Oktober 2026.

sudo k3s kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.21.3/cert-manager.yaml
apiVersion: 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: traefik

Cabaran HTTP-01 bermaksud pelayan ACME (automatic certificate management environment) bersambung ke http://hello.example.com/.well-known/acme-challenge/... daripada internet awam. Oleh itu, rekod DNS hostname, sama ada rekod A atau rekod AAAA jika VPS boleh dicapai melalui IPv6, mestilah sudah menghala ke VPS tersebut, dan port 80 mestilah boleh mencapai Traefik. Let’s Encrypt akan mencuba alamat IPv6 terlebih dahulu apabila kedua-duanya wujud, tetapi akan beralih ke IPv4 jika sambungan IPv6 awal tamat masa. Ralat lain, termasuk respons cabaran yang salah, tidak akan mencetuskan peralihan tersebut, dan permintaan yang dialihkan tidak akan dicuba semula. Betulkan atau buang rekod AAAA yang lapuk. Jika anda menyahdayakan ServiceLB dan meletakkan proksi anda sendiri di hadapan, proksi tersebut juga perlu memajukan laluan cabaran, atau cert-manager akan terhenti dengan status ini pada objek Challenge:

Waiting for HTTP-01 challenge propagation: wrong status code '404', expected '200'

Pantau pengeluaran sijil dengan sudo k3s kubectl describe certificate hello-tls dan sudo k3s kubectl get order,challenge -A.

Fail kubeconfig, dan sebab API server kekal peribadi

k3s menulis kelayakan admin ke /etc/rancher/k3s/k3s.yaml. Fail ini dimiliki oleh root dan ditulis dengan mod 600 secara lalai. Ia mengandungi sijil klien dengan hak cluster-admin, jadi sesiapa yang boleh membacanya memiliki kluster tersebut.

sudo k3s kubectl get node
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get node

kubectl yang dipasang secara berasingan tidak mengetahui tentang fail k3s tersebut. Tanpa KUBECONFIG ditetapkan, ia membaca ~/.kube/config, dan jika fail itu tidak wujud, ia gagal dengan The connection to the server localhost:8080 was refused - did you specify the right host or port? kerana tiada kluster yang dikonfigurasikan. Tetapkan KUBECONFIG, salin fail tersebut ke ~/.kube/config seperti yang ditunjukkan di bawah, atau gunakan sudo k3s kubectl, yang membaca fail yang betul secara automatik.

Anda akan melihat --write-kubeconfig-mode 644 disyorkan supaya pengguna biasa boleh menjalankan kubectl. Fahami tindakan tersebut: ia menjadikan kelayakan cluster-admin boleh dibaca oleh setiap akaun tempatan pada mesin tersebut. Pada kotak admin tunggal, ini mungkin pertukaran yang boleh diterima. Pada kotak yang dikongsi, ia tidak selamat. Menyalin fail tersebut sebaliknya memberikan akses kepada seorang pengguna tanpa mendedahkannya kepada semua:

mkdir -p ~/.kube
sudo install -o $USER -g $USER -m 600 /etc/rancher/k3s/k3s.yaml ~/.kube/config

Baris server: dalam fail tersebut membaca https://127.0.0.1:6443. Untuk menggunakan kubectl dari komputer riba anda, jangan buka 6443 kepada internet. API Kubernetes awam adalah sasaran tetap, dan API yang terdedah adalah punca kluster kecil akhirnya digunakan untuk melombong mata wang kripto bagi pihak lain. Lakukan tunneling melalui SSH dan biarkan alamat dalam fail tersebut seperti asal:

ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get node

Jika anda mesti mencapai API melalui alamat rangkaian peribadi, pasang dengan tls-san yang menyenaraikan nama atau alamat tersebut, kemudian edit baris server: pada fail yang disalin untuk dipadankan. Tanpa entri SAN (subject alternative name), kubectl akan menolak sambungan tersebut:

x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10

Port masuk yang didokumenkan untuk kluster ialah TCP 6443 untuk API, UDP 8472 untuk flannel VXLAN antara nod, dan TCP 10250 untuk metrik kubelet. Pada nod tunggal, tiada satu pun daripada port ini perlu dibuka kepada internet.

containerd bukan Docker

k3s menjalankan containerd terbenamnya sendiri, dan ia tidak berkongsi storan imej dengan Docker. Imej yang baru anda bina dengan docker build tidak dapat dilihat oleh k3s, jadi pod gagal dengan ErrImagePull walaupun docker images menyenaraikannya. Import imej tersebut secara eksplisit:

docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl images

Kemudian, elakkan tag :latest pada container tersebut, kerana :latest secara lalai menetapkan imagePullPolicy kepada Always dan kubelet akan tetap pergi ke registry. Sebarang tag lain secara lalai menetapkan IfNotPresent, yang menggunakan imej yang telah anda import. Menjalankan kedua-duanya pada satu VPS boleh dilakukan, dan adalah berguna untuk mengetahui bahawa pemasangan Docker biasa pada VPS dan k3s masing-masing menyimpan storan imej sendiri serta peraturan iptables sendiri pada mesin yang sama.

Cara membuang k3s

Pemasang menulis skrip penyahpasangan. Tiada fungsi pembuangan separa atau buat asal (undo).

sudo /usr/local/bin/k3s-uninstall.sh

Skrip ini menghentikan dan membuang servis, memadam storan data, memadam data volum berterusan, membuang konfigurasi nod, serta membuang alatan yang ditambah oleh pemasang. Pada nod ejen, skrip tersebut adalah k3s-agent-uninstall.sh sebaliknya. Salin apa-apa sahaja di bawah /var/lib/rancher/k3s/storage keluar dari pelayan terlebih dahulu, kerana direktori tersebut akan turut dipadamkan. Selepas itu, pastikan tiada apa-apa yang masih memegang port atau antara muka dengan ip link show dan sudo ss -lntp. Antara muka cni0 atau flannel.1 yang tertinggal akan dibersihkan pada but semula seterusnya.

Memutuskan bahawa satu nod Kubernetes adalah lebih kompleks daripada yang diperlukan untuk tugasan tersebut adalah hasil yang biasa dan bukannya satu kegagalan. Memindahkan beban kerja tersebut kembali ke Compose biasanya mengambil masa satu petang sahaja.

Mod kegagalan dan rentetan yang akan anda lihat

Node NotReady, atau k3s memulakan semula dalam gelung. Baca sudo journalctl -u k3s -n 200 --no-pager dahulu. Pada VPS kecil, punca biasa ialah kernel out-of-memory killer yang menamatkan proses tersebut, yang muncul dalam dmesg sebagai baris yang menamakan k3s-server. Keperluan minimum 2 GB yang didokumentasikan adalah had sebenar.

Pod tersangkut dalam status Pending. kubectl describe pod menamakannya setiap kali. Insufficient memory atau Insufficient cpu bermaksud nod tidak mempunyai ruang lagi. didn't have free ports bermaksud pod Kubernetes lain menempah hostPort yang bercanggah. waiting for first consumer pada PVC bermaksud WaitForFirstConsumer sedang menjalankan tugasnya.

ImagePullBackOff. Nod tidak dapat menarik imej tersebut. Semak nama dan tag imej, akses serta kelayakan registry, atau sama ada anda membina imej dengan Docker tetapi tidak mengimportnya ke dalam containerd.

Traefik menjawab, aplikasi tidak. Badan respons 404 page not found datang daripada Traefik sendiri dan bermaksud permintaan telah sampai tetapi tiada router yang sepadan. Semak bahawa Ingress host sepadan dengan nama yang anda taip, dan ingressClassName adalah traefik.

DNS kluster gagal sedangkan hos dapat menyelesaikannya dengan baik. Semak CoreDNS dengan sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns. Mesej seperti plugin/loop: Loop ... detected for zone "." menghalang CoreDNS daripada bermula. Ia berlaku kerana CoreDNS sedang memajukan permintaan kepada resolver yang memajukan semula kepadanya, iaitu perkara yang dilakukan oleh alamat loopback dalam /etc/resolv.conf. Halakan k3s kepada fail upstream sebenar dengan --resolv-conf /run/systemd/resolve/resolv.conf.

FAQ

Adakah berbaloi menjalankan k3s pada satu VPS tunggal?

Ia berbaloi apabila anda memerlukan API Kubernetes: untuk mempelajarinya pada mesin yang anda kawal, memastikan deployment mudah alih sebagai manifest, menjalankan perisian yang hanya menerbitkan Helm chart, atau membina sesuatu yang akan anda pindahkan ke kluster terurus kemudian. Ia tidak berbaloi jika anda hanya mahu menjalankan kontena, kerana Docker Compose melakukan perkara tersebut dengan penyelenggaraan yang jauh lebih rendah dan menjimatkan kira-kira satu gigabait RAM. Satu nod tidak memberikan anda ketersediaan tinggi (high availability), jadi kebolehpercayaan bukanlah sebab untuk memilihnya.

Mengapa servis LoadBalancer k3s saya kekal dalam status Pending?

ServiceLB mencipta svclb- pod yang menuntut port servis tersebut sebagai hostPort pada nod, jadi ia hanya dijadualkan di tempat port tersebut bebas. Jika pod Kubernetes lain sudah menempah hostPort yang sama, pod tersebut kekal dalam status Pending dan servis tidak akan menerima alamat luaran. Proksi hos atau kontena Docker kendiri yang mendengar pada port 80 tidak menyebabkan penolakan penjadualan ini secara sendirinya. kubectl -n kube-system describe pod svclb-... melaporkan 0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports. Alihkan tempahan hostPort pod yang bercanggah itu, atau nyahdayakan ServiceLB dengan --disable=servicelb dan buat proksi ke NodePort yang masih diperuntukkan oleh servis tersebut.

Berapakah jumlah RAM yang diperlukan oleh k3s pada sebuah VPS?

Minimum yang didokumentasikan untuk nod pelayan ialah 2 teras dan 2 GB, dan itu merangkumi k3s serta komponen pakejnya sebelum beban kerja anda. Profiling projek itu sendiri mengukur control plane dan datastore bagi nod pelayan pada 1,596 MB semasa timbunan pemantauan dijalankan di atasnya, dan angka itu tidak termasuk memori beban kerja itu sendiri. Oleh itu, anggap 2 GB sebagai lantai dan 4 GB sebagai saiz pertama di mana satu nod boleh beroperasi dengan selesa. Ukur kotak anda sendiri dengan free -h yang diambil sebelum pemasangan dan sekali lagi selepas setiap pod dalam kube-system membaca Running.

Bolehkah saya menjalankan Docker dan k3s pada VPS yang sama?

Ya, dan ia kekal berasingan. k3s menggunakan containerd terbenamnya sendiri, jadi imej yang dibina dengan docker build tidak dapat dilihat olehnya sehingga anda menjalankan docker save myapp:0.1 | sudo k3s ctr images import -. Setiap satunya juga menulis peraturan iptables dan rangkaian bridge masing-masing. Pantau jumlah memori, kerana Docker, k3s dan kontena anda semuanya berkongsi RAM kotak tersebut.

Bagaimanakah cara untuk membuang k3s sepenuhnya?

Jalankan sudo /usr/local/bin/k3s-uninstall.sh pada nod pelayan, atau sudo /usr/local/bin/k3s-agent-uninstall.sh pada ejen. Ia menghentikan servis, memadam datastore, memadam data persistent volume di bawah /var/lib/rancher/k3s/storage, dan membuang alatan yang dibundelkan. Salin sebarang data yang anda ingin simpan keluar dari kotak tersebut terlebih dahulu, kerana tiada cara untuk membatalkan tindakan ini. Antara muka rangkaian cni0 atau flannel.1 yang tertinggal akan hilang pada but semula seterusnya.

Adakah artikel ini berguna?

#kubernetes#k3s#docker-compose#ingress#sizing