راهنمای گام به گام برای توسعه دهنده با استفاده از Multipass و K3D
K3S یک توزیع سبک وزن Kubernetes است که برای محیط های محدود شده از منابع طراحی شده است و آن را برای توسعه محلی یا محاسبات لبه ایده آل می کند. با این حال ، ساختمان K3 از منبع در MACOS ساده نیست ، زیرا K3S برای کامپایل شدن به یک محیط لینوکس نیاز دارد. در این راهنما ، ما چگونه می توانیم K3 را از منبع با استفاده از Multipass Canonical بسازیم ، تصویر حاصل را به MAC خود منتقل کنیم و سپس با استفاده از آن اجرا کنیم k3dبشر
پیش نیازها:
قبل از شروع ، اطمینان حاصل کنید که Homebrew بر روی سیستم MACOS شما نصب شده است. می توانید تمام وابستگی های مورد نیاز را با استفاده از Homebrew نصب کنید.
multipass نصب کنید
Multipass یک روش سریع و آسان برای چرخش ماشین های مجازی سبک وزن لینوکس (VMS) در MACOS است. ما از آن برای ایجاد یک محیط لینوکس که در آن می توان K3s ساخته شد استفاده خواهیم کرد. آن را از طریق Homebrew نصب کنید:
brew install multipass
نصب را تأیید کنید: پس از اتمام نصب ، می توانید با بررسی نسخه آن را تأیید کنید
multipass version
بیشتر بدانید: برای اطلاعات بیشتر در مورد روش های نصب چندگانه و جایگزین ، به راهنمای نصب چند علیقی مراجعه کنید.
🔧 K3D را نصب کنید
K3D را نصب کنید ، یک بسته بندی سبک برای اجرای خوشه های K3S در Docker ، با استفاده از Homebrew:
brew install k3d
نصب را تأیید کنید: پس از اتمام نصب ، می توانید با بررسی نسخه آن را تأیید کنید
~ k3d version
k3d version v5.8.3
k3s version v1.31.5-k3s1 (default)
multiplass را راه اندازی کنید و محیط ساخت را تنظیم کنید
حال ، بیایید با استفاده از Multipass یک Linux VM ایجاد کنیم تا به عنوان محیط ساخت K3s خدمت کنیم.
یک نمونه چند منظوره را راه اندازی کنید: دستور زیر را اجرا کنید تا یک VM چند منظوره به نام K3SServer با 2 CPU ، 3 گیگابایت حافظه و 20 گیگابایت فضای دیسک ایجاد کنید.
multipass launch --name k3sServer --cpus 2 --memory 3G --disk 20G
به نمونه چندگانه وارد شوید: پس از اتمام VM ، با استفاده از آن وارد شوید:
multipass shell k3sServer
اکنون در داخل پوسته چند قطبی قرار خواهید گرفت و با فوریت مورد استقبال قرار می گیرید:
ubuntu@k3sServer:~$
ابزارهای مورد نیاز را در داخل VM نصب کنید:
برای ساخت K3S ، به داکر نیاز دارید و در داخل VM چند منظوره نصب کنید.
نصب Docker: دستورات زیر را برای نصب Docker اجرا کنید:
sudo apt update
sudo apt install docker.io
پیکربندی Docker (اختیاری): اگر با ایجاد Docker Build روبرو هستید ، اطمینان حاصل کنید که Daocer Daemon به درستی پیکربندی شده است. ممکن است لازم باشد پیکربندی DNS را به شرح زیر اضافه کنید:
~ cat /etc/docker/daemon.json
{
"dns": ["172.17.0.1", "8.8.8.8"]
}
نصب: Make Utility را نصب کنید:
sudo apt install make
🧪 کلون و ساخت K3s
اکنون که محیط آماده است ، بیایید با ساخت K3S اقدام کنیم.
کلون مخزن K3S: کلون مخزن رسمی K3S GitHub
git clone --depth 1 https://github.com/k3s-io/k3s.git
به مخزن بروید: به فهرست K3S بروید
cd k3s
محیط ساخت را آماده کنید: دستورات زیر را برای بارگیری وابستگی ها و تولید پرونده های مورد نیاز اجرا کنید. اگر می خواهید بررسی کنید که هر مرحله چه کاری انجام می دهد ، این دستورات را یک به یک اجرا کنید
sudo mkdir -p build/data && make download && make generate
ساخت K3s: سرانجام ، K3s را با دستور زیر بسازید (SKIP_VALIDATE = True Flag برخی از مراحل اعتبار سنجی را رد می کند و روند ساخت را سریعتر می کند.)
sudo SKIP_VALIDATE=true make
ساخت مستندات: دستورالعمل های ساخت در repo رسمی موجود است:
👉 https://github.com/k3s-io/k3s/blob/master/building.md
تصاویر داکر را تأیید کنید
پس از اتمام ساخت ، می توانید تصاویر Docker تولید شده را تأیید کنید.
لیست تصاویر داکر: به تصویر Rancher/K3S که تازه ساخته اید توجه داشته باشید
sudo docker images
REPOSITORY TAG IMAGE ID SIZE
rancher/k3s v1.33.0-k3s-c2efae3e-arm64 9ae40bc58195 227MB
k3s master 622b36d40a23 1.25GB
...
تصویر K3S (به عنوان مثال ، Rancher/K3S: V1.33.0-K3S-C2EFAE3E-ARM64) را برای مرحله بعدی شناسایی کنید.
🔁 انتقال تصویر به میزبان MACOS
برای استفاده از تصویر K3S ساخته شده در میزبان MacOS خود ، تصویر Docker را از نمونه چند منظوره به MAC منتقل کنید
تصویر Docker را ذخیره کنید: در داخل پوسته چند قطبی ، تصویر Docker K3s را به عنوان یک پرونده فشرده شده .tar.gz ذخیره کنید
sudo docker save rancher/k3s:v1.33.0-k3s-c2efae3e-arm64 | gzip > rk3s.tar.gz
از پوسته چند قطبی خارج شوید: از نمونه چندگانه خارج شوید یا کاربر می تواند از ترمینال دیگری برای مرحله بعدی استفاده کند
تصویر را به MACOS منتقل کنید: برای کپی کردن فایل TAR در میزبان MacOS خود از دستور انتقال Multipass استفاده کنید
multipass transfer k3sServer:rk3s.tar.gz ~/Downloads
تصویر را در Docker بارگذاری کنید: در میزبان MacOS خود ، تصویر را در Docker بارگذاری کنید
docker load -i ~/Downloads/rk3s.tar.gz
🌐 یک خوشه K3S با K3D ایجاد کنید
ایجاد خوشه: اکنون با استفاده از تصویر ساخته شده که تازه بارگذاری شده اید ، یک خوشه Kubernetes ایجاد کنید
k3d cluster create --image rancher/k3s:v1.33.0-k3s-c2efae3e-arm64
اگر به هر مشکلی رسیدید ، از پرچم های -verbose یا -trace استفاده کنید تا جزئیات بیشتری را در هنگام ایجاد خوشه کسب کنید.
تأیید خوشه:
~ k3d cluster list
NAME SERVERS AGENTS LOADBALANCER
k3s-default 1/1 0/0 true
غلافها را بررسی کنید:
~ kubectl get pods -A
NAMESPACE NAME READY STATUS RESTARTS AGE
kube-system coredns-697968c856-gbvc8 1/1 Running 0 25h
kube-system helm-install-traefik-crd-vlrvr 0/1 Completed 0 25h
kube-system helm-install-traefik-j5tm8 0/1 Completed 1 25h
kube-system local-path-provisioner-774c6665dc-pt44v 1/1 Running 0 25h
kube-system metrics-server-6f4c6675d5-6j47v 1/1 Running 0 25h
kube-system svclb-traefik-a74de106-kzddc 2/2 Running 0 25h
kube-system traefik-c98fdf6fb-gc2f5 1/1 Running 0 25h
✅ نتیجه گیری
شما به تازگی K3 را از منبع در یک لینوکس VM ساخته اید ، تصویر Docker Custom را به میزبان MacOS خود منتقل کرده اید و از آن برای چرخش یک خوشه Kubernetes از طریق K3D استفاده کرده اید. این تنظیم کنترل کامل بر روی نسخه و ساخت K3 هایی را که استفاده می کنید به شما می دهد – عالی برای آزمایش ویژگی های جدید ، اشکال زدایی یا کمک به بالادست.
With K3s now running in a Kubernetes cluster on your macOS host, you are ready to:
• Experiment with lightweight Kubernetes for development or testing environments.
• Deploy containerized workloads and explore Kubernetes features.
• Build further expertise with Kubernetes, multi-cloud setups, or edge computing.
اگر با هر مشکلی روبرو شدید ، به راهنمای رسمی ساخت K3S یا مستندات K3D مراجعه کنید.
