# نصب لانگ‌ هورن در کوبرنتیز - پیوند: https://negarnovin.com/docs/how-to-install-longhorn-on-kubernetes/ - منتشرشده: 2025-11-05T14:41:37+00:00 - نویسنده: نگارنوین # نحوه نصب لانگ هورن روی کوبرنتیز یاد بگیرید که Longhorn را روی Kubernetes نصب کنید تا فضای ذخیره سازی بلوکی مقیاس پذیر و با دسترسی بالا به همراه مدیریت رابط کاربری و ویژگی های پشتیبان گیری داشته باشید. ## مقدمه لانگ هورن یک سیستم ذخیره سازی بلوکی توزیع شده ی سبک و متن باز برای کوبرنتیز است که ذخیره سازی پایدار را برای برنامه های دارای وضعیت در یک خوشه فراهم می کند. ولوم های لانگ هورن، ذخیره سازی بلوکی مقیاس پذیر و با دسترسی بالا را که به گره های کارگر شما متصل است، با پشتیبانی از حالت های دسترسی چندگانه در خوشه کوبرنتیز شما ارائه می دهند. در یک خوشه کوبرنتیز، لانگ هورن با اجزای اصلی زیر اجرا می شود: * **Longhorn UI**: یک رابط وب گرافیکی که می توانید برای مشاهده، ایجاد، مدیریت و پشتیبان گیری از ولوم های Longhorn در یک کلاستر Kubernetes از آن استفاده کنید. * **Longhorn Instance Manager**: روی هر گره در خوشه Kubernetes اجرا می شود و عملکردهایی مانند تکثیر، اسنپ شات، مدیریت نمونه، تشخیص خرابی گره و زمان بندی را فعال می کند. * **Longhorn Engine**: جزء صفحه داده که داده ها را در کنترلر ذخیره سازی اختصاصی روی هر دستگاه بلوکی می خواند و می نویسد. هر دستگاه Longhorn دارای یک نمونه موتور مربوطه است که داده ها را تکثیر می کند و پشتیبان گیری یا اسنپ شات هایی را روی چندین گره ایجاد می کند. * **Longhorn CSI (Container Storage Interface) Driver**: Longhorn را به عنوان یک ارائه دهنده فضای ذخیره سازی در یک کلاستر Kubernetes فعال می کند و عملیات مربوط به حجم را به اقدامات Longhorn ترجمه می کند. از مقدار `driver.longhorn.io` که توسط منابعی مانند StorageClasses ارجاع داده می شود، برای مدیریت درخواست های حجم استفاده می کند. این مقاله نحوه استقرار Longhorn روی Kubernetes و ایجاد یک سیستم ذخیره سازی توزیع شده که در دسترس منابع متعدد مانند Pods در کلاستر شما باشد را توضیح می دهد. همچنین از Volumeهای Longhorn در Negarnovin Object Storage پشتیبان گیری خواهید کرد تا بازیابی داده ها را فعال کنید یا Volumeهای جدید بازیابی فاجعه ایجاد کنید. ## پیش نیاز ها قبل از اینکه شروع کنید: * یک کلاستر Negarnovin Kubernetes Engine با حداقل `3` گره و `4 vCPUs` در هر گره مستقر کنید. * Negarnovin Object Storage را مستقر کنید و یک bucket `longhorn` جدید برای ذخیره پشتیبان های volume خود ایجاد کنید. * یک سرور مجازی با سیستم عامل دبیان ایجاد کنید تا به عنوان ایستگاه کاری مدیریت خوشه استفاده شود. * با استفاده از SSH و به عنوان یک کاربر غیر ریشه با امتیازات sudo به سرور دسترسی پیدا کنید. * Kubectl را با پیکربندی VKE خود نصب و پیکربندی کنید تا به کلاستر روی سرور خود دسترسی داشته باشید. ## نصب لانگ هورن روی کوبرنتیز شما می توانید Longhorn را با استفاده از مدیر بسته Helm یا Kubectl روی کلاستر Kubernetes خود نصب کنید. برای نصب آخرین نسخه سازگار با اکثر نسخه های کلاستر Kubernetes، از Kubectl برای مشخص کردن شماره نسخه هدف و تغییر هرگونه اطلاعات پیکربندی در کلاستر خود استفاده کنید. مراحل زیر را برای نصب آخرین نسخه Longhorn با استفاده از Kubectl دنبال کنید و تمام منابع کلاستر موجود را تأیید کنید. 1. آخرین فایل انتشار Longhorn را با استفاده از `wget`دانلود کنید. 2. console 3. ``` $ wget https://github.com/longhorn/longhorn/releases/download/v1.6.1/longhorn.yaml ``` 4. دستور بالا نسخه `1.6.1`,لانگ هورن را دانلود می کند، برای تأیید آخرین نسخه جهت استقرار در کلاستر کوبرنتس خود، به [مخزن رسمی گیت هاب](https://github.com/longhorn/longhorn/) پروژه مراجعه کنید. 5. فایل ها را فهرست کنید و تأیید کنید که یک فایل `longhorn.yaml` جدید در دایرکتوری کاری شما موجود است. 6. console 7. ``` $ ls ``` 8. خروجی: 9. ``` longhorn.yaml ``` 10. با استفاده از آخرین فایل `longhorn.yaml` ، Longhorn را در کلاستر Kubernetes خود مستقر کنید. 11. console 12. ``` $ kubectl apply -f longhorn.yaml ``` 13. وقتی نصب موفقیت آمیز باشد، خروجی شما باید مانند تصویر زیر باشد. 14. ``` customresourcedefinition.apiextensions.k8s.io/systemrestores.longhorn.io created customresourcedefinition.apiextensions.k8s.io/volumes.longhorn.io created customresourcedefinition.apiextensions.k8s.io/volumeattachments.longhorn.io created clusterrole.rbac.authorization.k8s.io/longhorn-role created clusterrolebinding.rbac.authorization.k8s.io/longhorn-bind created clusterrolebinding.rbac.authorization.k8s.io/longhorn-support-bundle created service/longhorn-backend created service/longhorn-frontend created service/longhorn-conversion-webhook created service/longhorn-admission-webhook created service/longhorn-recovery-backend created service/longhorn-engine-manager created service/longhorn-replica-manager created daemonset.apps/longhorn-manager created deployment.apps/longhorn-driver-deployer created deployment.apps/longhorn-ui created ``` 15. تمام منابع Longhorn مستقر در فضای نام جدید `longhorn-system` را مشاهده کنید و تأیید کنید که آنها به درستی در خوشه شما اجرا می شوند. 16. console 17. ``` $ kubectl get all -n longhorn-system ``` 18. خروجی: 19. ``` NAME READY STATUS RESTARTS AGE pod/csi-attacher-57689cc84b-tlzpb 1/1 Running 0 73s pod/longhorn-csi-plugin-lp562 3/3 Running 1 (15s ago) 73s pod/longhorn-ui-655b65f7f9-lgllp 1/1 Running 0 98s NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/longhorn-admission-webhook ClusterIP 10.100.203.235 <none> 9502/TCP 103s service/longhorn-backend ClusterIP 10.110.4.220 <none> 9500/TCP 104s NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE daemonset.apps/engine-image-ei-5cefaf2b 3 3 3 3 3 <none> 84s daemonset.apps/longhorn-csi-plugin 3 3 3 3 3 <none> 74s daemonset.apps/longhorn-manager 3 3 3 3 3 <none> 100s NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/csi-attacher 3/3 3 3 74s deployment.apps/csi-provisioner 3/3 3 3 74s deployment.apps/csi-resizer 3/3 3 3 74s NAME DESIRED CURRENT READY AGE replicaset.apps/csi-attacher-57689cc84b 3 3 3 74s replicaset.apps/csi-provisioner-6c78dcb664 3 3 3 74s replicaset.apps/csi-resizer-7466f7b45f 3 3 3 74s ``` 20. آخرین بسته Longhorn NFS را نصب کنید تا ایجاد Volumeهای ReadWriteMany (RWX) در کلاستر شما امکان پذیر شود. 21. console 22. ``` $ kubectl apply -f https://raw.githubusercontent.com/longhorn/longhorn/v1.6.1/deploy/prerequisite/longhorn-nfs-installation.yaml ``` 23. تأیید کنید که غلاف های Longhorn NFS در کلاستر شما ایجاد و اجرا می شوند. 24. console 25. ``` $ kubectl get pods | grep longhorn-nfs-installation ``` 26. خروجی: 27. ``` longhorn-nfs-installation-2kd6d 1/1 Running 0 43s longhorn-nfs-installation-52kgg 1/1 Running 0 43s longhorn-nfs-installation-qsst9 1/1 Running 0 43s ``` ## ایجاد یک کلاس ذخیره سازی Longhorn Longhorn از کلاس ذخیره سازی پیش فرض `longhorn` برای استقرار ولوم ها در کلاستر Kubernetes شما استفاده می کند. بسته به حجم کاری کلاستر خود، یک کلاس ذخیره سازی جدید ایجاد کنید تا هنگام اعمال PVCهای جدید برای ارتباط با درایور Longhorn CSI و استقرار ولوم های جدید با استفاده از Longhorn manager از آن استفاده کنید. در بخش های بعدی، کلاس های ذخیره سازی جداگانه ای ایجاد کنید تا هنگام اتصال حالت های دسترسی مختلف به PVCها در کلاستر خود از آنها استفاده کنید. ## کلاس ذخیره سازی فقط خواندنی و نوشتنی (RWO) ادعاهای حجم پایدار (PVC) از حالت دسترسی ReadWriteOnly (RWO) برای نصب یک حجم با امتیازات خواندن و نوشتن روی یک پاد در یک زمان استفاده می کنند. RWO از اشتراک گذاری حجم پشتیبانی نمی کند و همه امتیازات خواندن و نوشتن را به یک پاد در یک زمان محدود می کند. این برای برنامه هایی که نیاز به سازگاری داده ها دارند، مانند پایگاه های داده ای که به طور مداوم داده ها را روی حجم های مشترک می نویسند، مناسب است. برای ایجاد یک RWO StorageClass جدید برای استفاده در خوشه خود، مراحل زیر را دنبال کنید. 1. با استفاده از یک ویرایشگر متن مانند Nano، یک فایل StorageClass جدید به نام `rwo- storageclass.yaml` ایجاد کنید. 2. console 3. ``` $ nano rwo-storageclass.yaml ``` 4. تنظیمات زیر را به فایل اضافه کنید. 5. yaml 6. ``` kind: StorageClass apiVersion: storage.k8s.io/v1 metadata: name: longhorn-prod provisioner: driver.longhorn.io allowVolumeExpansion: true parameters: numberOfReplicas: "3" staleReplicaTimeout: "2880" # 48 hours in minutes fromBackup: "" fsType: "ext4" reclaimPolicy: Retain ``` 7. فایل را ذخیره کنید و ببندید. 8. پیکربندی فوق یک StorageClass `longhorn-prod` قابل توسعه جدید با سیاست حفظ (` retain` policy) ایجاد می کند که یک فضای ذخیره سازی را حتی در صورت حذف PVC مرتبط، فعال نگه می دارد. در پیکربندی: 9. * `provisioner`: درایور تأمین کننده ی فضای ذخیره سازی پایدار (PV) را تنظیم می کند. مقدار `driver.longhorn.io` از موتور مورد نیاز Longhorn برای استقرار و مدیریت فضاها استفاده می کند در حالی که مقداری مانند `block.csi.negarnovin. com` فضاهای ذخیره سازی پایدار (PV) را با Negarnovin Block Storage مستقر می کند که با Longhorn manager سازگار نیستند. * `allowVolumeExpansion`: امکان تغییر ظرفیت درایوهای Longhorn را در یک کلاستر فراهم می کند. برای مثال، یک درایو `10 GB` می تواند بسته به نیاز شما تا `20 GB` یا بیشتر افزایش یابد. * `numberOfReplicas`: تعداد کپی های درایو Longhorn را برای استقرار و اتصال به گره های کلاستر شما تنظیم می کند. * `staleReplicaTimeout`: یک مقدار time-out ایجاد می کند تا وقتی زمان فعالیت مشخص شده منقضی شد، یک درایو Longhorn را به عنوان غیرفعال علامت گذاری کند. * `staleReplicaTimeout`: یک درایو Longhorn را از منبع پشتیبان شما مانند Negarnovin Object Storage بازیابی می کند. * `fsType`: فرمت سیستم فایل ولوم Longhorn را تنظیم می کند. * `reclaimPolicy`: اقدام مربوط به ولوم Longhorn را برای اعمال در هنگام حذف PVC یا PV مرتبط با کلاس مشخص می کند. ولوم های Longhorn از سیاست های حذف و حفظ پشتیبانی می کنند. 10. کلاس StorageClass را روی کلاستر خود اعمال کنید. 11. console 12. ``` $ kubectl apply -f rwo-storageclass.yaml ``` 13. تمام StorageClasses را در کلاستر خود مشاهده کنید و تأیید کنید که کلاس RWO جدید شما در دسترس است. 14. console 15. ``` $ kubectl get storageclass ``` 16. خروجی: 17. ``` NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE longhorn (default) driver.longhorn.io Delete Immediate true 35m longhorn-prod driver.longhorn.io Retain Immediate true 4s negarnovin-block-storage block.csi.negarnovin.com Delete Immediate true 46m ``` ### کلاس ذخیره سازی ReadWriteMany (RWX) ReadWriteMany (RWX) به چندین Pod اجازه می دهد تا به طور همزمان یک Volume را با امتیازات خواندن و نوشتن در کلاستر Kubernetes شما Mount کنند. این ابزار از اشتراک گذاری Volume پشتیبانی می کند و به Podها امکان دسترسی به داده های مشترک را می دهد که آن را برای اکثر برنامه های موجود در کلاستر شما مناسب می کند. مراحل زیر را برای ایجاد یک StorageClass جدید که می توانید با PVCهای ReadWriteMany (RWX) در کلاستر خود استفاده کنید، دنبال کنید. 1. یک فایل جدید StorageClass به نام `rwx-storageclass.yaml` ایجاد کنید. 2. console 3. ``` $ nano rwx-storageclass.yaml ``` 4. تنظیمات زیر را به فایل اضافه کنید. 5. yaml 6. ``` kind: StorageClass apiVersion: storage.k8s.io/v1 metadata: name: longhorn-rwx provisioner: driver.longhorn.io allowVolumeExpansion: true reclaimPolicy: Delete volumeBindingMode: Immediate parameters: numberOfReplicas: "3" staleReplicaTimeout: "2880" fromBackup: "" fsType: "ext4" nfsOptions: "vers=4.2,noresvport,softerr,timeo=600,retrans=5,rw,hard" reclaimPolicy: Retain ``` 7. فایل را ذخیره کنید و ببندید. 8. پیکربندی فوق یک کلاس ذخیره سازی جدید ReadWriteMany (RWX) `longhorn-rwx` ایجاد می کند که از Longhorn NFS برای نصب پادهای مدیریت اشتراکی و فعال کردن امتیازات خواندن و نوشتن همزمان برای چندین پاد در کلاستر شما استفاده می کند. `nfsOptions` تفاوت اصلی مشخصات است که گزینه های اضافی Longhorn NFS را هنگام ایجاد والیوم های ReadWriteMany (RWX) فعال می کند. 9. پیکربندی StorageClass را روی کلاستر Kubernetes خود اعمال کنید. 10. console 11. ``` $ kubectl apply -f rwx-storageclass.yaml ``` 12. کلاس StorageClasses را مشاهده کنید و تأیید کنید که کلاس RWX جدید در دسترس است. 13. console 14. ``` $ kubectl get storageclass ``` 15. خروجی: 16. ``` NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE longhorn (default) driver.longhorn.io Delete Immediate true 36m longhorn-prod driver.longhorn.io Retain Immediate true 46s longhorn-rwx driver.longhorn.io Retain Immediate true 9s negarnovin-block-storage block.csi.negarnovin.com Delete Immediate true 47m ``` ## ایجاد درخواست های حجمی مداوم (PVC) مدیر Longhorn به صورت پویا، هر زمان که درخواست های جدید برای حجم های پایدار (PVC) به StorageClass شما ارجاع دهند، حجم های جدید Longhorn را به عنوان حجم های پایدار( PV) ایجاد می کند. برای ایجاد PVCهای جدید با حالت دسترسی Read Write Once (RWO) یا Read Write Many (RWX) برای نصب به عنوان حجم های ذخیره سازی برای Podها در کلاستر خود، بخش های زیر را دنبال کنید. ## پی وی سی خواندنی و نوشتنی (RWO) 1. یک فایل پیکربندی منبع PVC جدید به نام `rwo-pvc.yaml` ایجاد کنید. 2. console 3. ``` $ nano rwo-pvc.yaml ``` 4. تنظیمات زیر را به فایل اضافه کنید. 5. yaml 6. ``` apiVersion: v1 kind: PersistentVolumeClaim metadata: name: test-rwo spec: accessModes: - ReadWriteOnce storageClassName: longhorn-prod resources: requests: storage: 10Gi ``` 7. فایل را ذخیره کنید و ببندید. 8. پیکربندی فوق یک PVC `test-rwo` جدید ایجاد می کند که به `longhorn-prod` StorageClass ارجاع می دهد تا یک Volume `10 GB` گیگابایتی Longhorn ایجاد کند، زمانی که PVC توسط یک Pod در کلاستر نصب شده باشد. 9. PVC را روی خوشه خود بمالید. 10. console 11. ``` $ kubectl apply -f rwo-pvc.yaml ``` 12. تمام PVC های خوشه را مشاهده کنید و تأیید کنید که منبع جدید با وضعیت `Bound` در دسترس است. 13. console 14. ``` $ kubectl get pvc ``` 15. خروجی: 16. ``` NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE test-rwo Bound pvc-4026f8d2-873c-429b-8068-208b26a75692 10Gi RWO longhorn-prod <unset> 4s ``` 17. بر اساس خروجی بالا، وضعیت `Bound` به این معنی است که درخواست ذخیره سازی PVC موفقیت آمیز بوده و یک پارتیشن Longhorn با نام `pvc-4026f8d2-873c-429b-8068-208b26a75692` با موفقیت ایجاد شده است. ستون **CAPACITY** شامل ظرفیت پارتیشن Longhorn است در حالی که **ACCESS MODES** شامل حالت دسترسی پشتیبانی شده توسط پارتیشن است. 18. تمام PV های موجود در کلاستر خود را مشاهده کنید و تأیید کنید که یک Volume جدید Longhorn در دسترس است. 19. console 20. ``` $ kubectl get pv ``` 21. خروجی: 22. ``` NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS VOLUMEATTRIBUTESCLASS REASON AGE pvc-4026f8d2-873c-429b-8068-208b26a75692 10Gi RWO Retain Bound default/test-rwo longhorn-prod <unset> 8s ``` 23. بر اساس خروجی فوق، یک ولوم جدید Longhorn با ظرفیت 10Gi و دسترسی RWO `pvc-4026f8d2- 873c-429b-8068-208b26a75692` در دسترس است. 24. شما یک PVC از نوع ReadWriteOnce در کلاستر خود ایجاد کرده و یک ولوم جدید Longhorn را آماده کرده اید. بر اساس پیکربندی، Podها در کلاستر شما می توانند PVC را به عنوان یک ولوم ذخیره سازی نصب کنند، اما فقط یک Pod می تواند همزمان داده ها را روی ولوم Longhorn نصب، خوانده و بنویسد. ## خواندن، نوشتن و تعداد زیاد (RWX) PVC 1. یک فایل منبع RWX PVC جدید به نام `rwx-pvc.yaml `ایجاد کنید. 2. console 3. ``` $ nano rwx-pvc.yaml ``` 4. تنظیمات زیر را به فایل اضافه کنید. 5. yaml 6. ``` apiVersion: v1 kind: PersistentVolumeClaim metadata: name: rwx-pvc spec: accessModes: - ReadWriteMany storageClassName: longhorn-rwx resources: requests: storage: 20Gi ``` 7. فایل را ذخیره کنید و ببندید. 8. پیکربندی فوق یک ReadWriteMany (RWX) PVC `rwx-pvc` ایجاد می کند که به `longhorn- rwx` StorageClass ارجاع می دهد تا یک ولوم جدید `20 GB` Longhorn را هنگام نصب PVC به عنوان ولوم ذخیره سازی توسط یک Pod فراهم کند. 9. منبع را به کلاستر خود اعمال کنید. 10. console 11. ``` $ kubectl apply -f rwx-pvc.yaml ``` 12. تمام PVC های موجود در کلاستر خود را مشاهده کنید و تأیید کنید که PVC جدید RWX با وضعیت `Bound`در دسترس است. 13. console 14. ``` $ kubectl get pvc ``` 15. خروجی: 16. ``` NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE rwx-pvc Bound pvc-509f254e-255d-4aee-bdc1-8c10c6cc49f5 20Gi RWX longhorn-rwx <unset> 7s test-rwo Bound pvc-4026f8d2-873c-429b-8068-208b26a75692 10Gi RWO longhorn-prod <unset> 3m10s ``` 17. تمام PV های موجود در کلاستر خود را مشاهده کنید و تأیید کنید که یک Volume جدید Longhorn در دسترس است. 18. console 19. ``` $ kubectl get pv ``` 20. خروجی: 21. ``` NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS VOLUMEATTRIBUTESCLASS REASON AGE pvc-4026f8d2-873c-429b-8068-208b26a75692 10Gi RWO Retain Bound default/test-rwo longhorn-prod <unset> 3m31s pvc-509f254e-255d-4aee-bdc1-8c10c6cc49f5 20Gi RWX Retain Bound default/rwx-pvc longhorn-rwx <unset> 28s ``` 22. شما یک PVC از نوع ReadWriteMany (RWX) در کلاستر خود ایجاد کرده اید. تمام Podهایی که PVC را به عنوان Storage Volume نصب می کنند، می توانند همزمان داده ها را در Longhorn Volume در کلاستر Kubernetes شما بخوانند و بنویسند. ## ادعاهای حجم پایدار (PVC) را آزمایش کنید برای آزمایش حالت های دسترسی ReadWriteOnce (RWO) و ReadWriteMany (RWX) خود، با نصب PVC های مربوطه به عنوان حجم های ذخیره سازی، Pod های نمونه برنامه را در خوشه خود مستقر کنید. بخش های زیر را دنبال کنید تا Pod های جدیدی ایجاد کنید که به PVC های شما ارجاع می دهند و تأیید کنید که حجم های جدید Longhorn در خوشه شما ایجاد می شوند. ### یک بار خواندن و نوشتن (RWO) برای ایجاد یک Nginx Pod جدید که فایل های برنامه وب را با استفاده از دایرکتوری `/ usr/nginx/` و با استفاده از ReadWriteOnce PVC شما به عنوان درایو ذخیره سازی می خواند و می نویسد، مراحل زیر را دنبال کنید. 1. یک فایل منبع Pod جدید `nginx-rwo-pod.yaml` ایجاد کنید. 2. console 3. ``` $ nano nginx-rwo-pod.yaml ``` 4. تنظیمات زیر را به فایل اضافه کنید. 5. yaml 6. ``` apiVersion: v1 kind: Pod metadata: name: nginx-webserver spec: containers: - name: rwo-container image: nginx:latest volumeMounts: - name: rwo-volume mountPath: /data volumes: - name: rwo-volume persistentVolumeClaim: claimName: test-rwo ``` 7. فایل را ذخیره کرده و ببندید. 8. پیکربندی فوق یک Pod جدید `nginx-webserver` ایجاد می کند که محتوا را از PVC یک بار خواندنی-نوشتنی که در دایرکتوری `/usr/share/nginx/html` درون کانتینر برنامه قرار دارد، ارائه می دهد. 9. منبع را در کلاستر Kubernetes خود اعمال کنید. 10. console 11. ``` $ kubectl apply -f nginx-rwo-pod.yaml ``` 12. تمام Pod های موجود در کلاستر خود را مشاهده کنید و تأیید کنید که یک Pod جدید ` nginx-webserver` در حال اجرا است. 13. console 14. ``` $ kubectl get pods ``` 15. خروجی: 16. ``` NAME READY STATUS RESTARTS AGE nginx-webserver 1/1 Running 0 41s ``` 17. با استفاده از Kubectl به محیط غلاف Nginx دسترسی پیدا کنید. 18. console 19. ``` $ kubectl exec -it nginx-webserver -- /bin/bash ``` 20. دستور `-- /bin/bash` پوسته Bash را در محیط pod با پشتیبانی از دستورات و ابزارهای رایج لینوکس فعال می کند. هنگامی که دستور فوق با موفقیت اجرا شود، محیط ترمینال شما باید به پوسته زیر تغییر کند.. 21. console 22. ``` root@nginx-webserver:/# ``` 23. یک پیکربندی HTML جدید بنویسید تا با استفاده از ابزار echo، محتوای پیش فرض فایل`/ usr/share/nginx/html/index.html` را جایگزین کند. 24. console 25. ``` $ echo "<html><body><h1> Hello World! Nginx Writes to the RWO Longhorn Volume </h1></body></html>" > /usr/share/nginx/html/index.html ``` 26. دسترسی به آدرس IP `127.0.0.1` در Nginx localhost را با استفاده از Curl آزمایش کنید. 27. console 28. ``` $ curl 127.0.0.1 ``` 29. تأیید کنید که محتوای صفحه وب `Hello World` سلام دنیا شما در خروجی مشابه تصویر زیر نمایش داده می شود. 30. html 31. ``` <html><body><h2> Hello World! Nginx Writes to the RWO Longhorn Volume </h2></body></html> ``` 32. بر اساس خروجی بالا، پاد `nginx-webserver` دسترسی خواندن و نوشتن به والیوم ReadWriteOnce Longhorn که با دایرکتوری `/usr/share/nginx/html` مانت شده است را دارد. با این حال، فقط یک پاد می تواند همزمان حافظه را بخواند یا بنویسد. 33. بر اساس پیکربندی حافظه، پادهای دیگر ممکن است بتوانند PVC را با امتیازات فقط خواندنی مانت کنند، اما نمی توانند همزمان با برنامه `nginx-webserver` فایل ها را بنویسند. 34. از محیط Nginx Pod خارج شوید. 35. console 36. ``` # exit ``` ### خواندن، نوشتن و تعداد زیاد (RWX) حالت دسترسی Read Write Many (RWX) برای برنامه های خوشه ای با رابط های ارتباطی front- end و back-end مناسب است. مراحل زیر را برای ایجاد Podهای جدید برنامه که همزمان داده ها را در یک volume ذخیره سازی PVC نصب شده ReadWriteMany می خوانند و می نویسند، دنبال کنید. 1. یک فایل پیکربندی Pod جدید به نام `log-backend.yaml` ایجاد کنید که داده ها را در یک دایرکتوری ذخیره سازی mount شده بنویسد. 2. console 3. ``` $ nano log-backend.yaml ``` 4. تنظیمات زیر را به فایل اضافه کنید. 5. yaml 6. ``` apiVersion: v1 kind: Pod metadata: name: log-writer spec: containers: - name: log-writer-container image: busybox:latest command: ["/bin/sh", "-c", "while true; do echo $(date) >> /var/log/app.log; sleep 1; done"] volumeMounts: - name: shared-storage mountPath: /var/log volumes: - name: shared-storage persistentVolumeClaim: claimName: rwx-pvc ``` 7. فایل را ذخیره کنید و ببندید. 8. پیکربندی فوق یک `log-writer` جدید برای Application pod ایجاد می کند که به طور مداوم تاریخ و زمان کلاستر Kubernetes را در یک فایل لاگ `longhorn-date.log` در دایرکتوری مشترک `/var/log/` می نویسد. Volume پی وی سی ReadWriteMany به عنوان یک Volume `shared-storage` با استفاده از دایرکتوری مشترک `/var/log` به عنوان مسیر mount قابل دسترسی برای تمام منابع متصل، Mount می شود. 9. یک فایل پیکربندی Pod دیگر به نام `log-frontend.yaml` ایجاد کنید تا داده ها را از دایرکتوری ذخیره سازی نصب شده بخواند. 10. console 11. ``` $ nano log-frontend.yaml ``` 12. تنظیمات زیر را به فایل اضافه کنید. 13. yaml 14. ``` apiVersion: v1 kind: Pod metadata: name: log-viewer spec: containers: - name: log-reader-container image: busybox:latest command: ["/bin/sh", "-c", "tail -f /var/log/app.log"] volumeMounts: - name: shared-storage mountPath: /var/log volumes: - name: shared-storage persistentVolumeClaim: claimName: rwx-pvc ``` 15. فایل را ذخیره کنید و ببندید. 16. پیکربندی فوق یک `log-viewer` Pod جدید ایجاد می کند که داده ها را از فایل `app. log` ایجاد شده توسط `logs-writer` backend Pod در دایرکتوری مشترک `/var/log/` می خواند. 17. یک فایل پیکربندی Pod جدید در backend به نام `updatelog-backend` ایجاد کنید که به طور مداوم داده ها را در فایل مشترک می نویسد. 18. console 19. ``` $ nano updatelog-backend.yaml ``` 20. تنظیمات زیر را به فایل اضافه کنید. 21. yaml 22. ``` apiVersion: v1 kind: Pod metadata: name: updatelog spec: containers: - name: log-writer-container image: busybox:latest command: ["/bin/sh", "-c", "while true; do echo Update from backend pod $(date) >> /var/log/app.log; sleep 1; done"] volumeMounts: - name: shared-storage mountPath: /var/log volumes: - name: shared-storage persistentVolumeClaim: claimName: rwx-pvc ``` 23. فایل را ذخیره کنید و ببندید. 24. پیکربندی فوق یک Pod `updatelog` جدید ایجاد می کند که به روزرسانی ها را در فایل مشترک `app.log` در دایرکتوری `/var/log/` می نویسد. Pod یک پیام جدید `Update from backend pod` و تاریخ کلاستر را به فایل لاگ اضافه می کند. 25. تنظیمات پاد را روی کلاستر خود اعمال کنید. 26. console 27. ``` $ kubectl apply -f log-backend.yaml $ kubectl apply -f log-frontend.yaml $ kubectl apply -f updatelog-backend.yaml ``` 28. تمام پادهای (Pods) موجود در کلاستر خود را مشاهده کنید و تأیید کنید که پادهای آزمایشی جدید در حال اجرا هستند. 29. console 30. ``` $ kubectl get pods ``` 31. خروجی: 32. ``` NAME READY STATUS RESTARTS AGE log-viewer 1/1 Running 1 (37s ago) 59s log-writer 1/1 Running 0 64s updatelog 1/1 Running 0 51s ``` 33. لاگ های پادِ `log-viewer` را مشاهده کنید و تأیید کنید که هر دو پادِ بک اند به طور فعال در حال نوشتن داده ها در فایل مشترک `/var/log/app.log` هستند. 34. console 35. ``` $ kubectl logs log-viewer ``` 36. خروجی: 37. ``` Update from backend pod Tue Apr 30 18:48:19 UTC 2024 Tue Apr 30 18:48:20 UTC 2024 Update from backend pod Tue Apr 30 18:48:20 UTC 2024 Tue Apr 30 18:48:21 UTC 2024 Update from backend pod Tue Apr 30 18:48:21 UTC 2024 Tue Apr 30 18:48:22 UTC 2024 Update from backend pod Tue Apr 30 18:48:22 UTC 2024 Tue Apr 30 18:48:23 UTC 2024 Update from backend pod Tue Apr 30 18:48:23 UTC 2024 Tue Apr 30 18:48:24 UTC 2024 Update from backend pod Tue Apr 30 18:48:24 UTC 2024 Tue Apr 30 18:48:25 UTC 2024 Update from backend pod Tue Apr 30 18:48:25 UTC 2024 Tue Apr 30 18:48:26 UTC 2024 Update from backend pod Tue Apr 30 18:48:26 UTC 2024 Tue Apr 30 18:48:27 UTC 2024 Update from backend pod Tue Apr 30 18:48:27 UTC 2024 Tue Apr 30 18:48:28 UTC 2024 Update from backend pod Tue Apr 30 18:48:28 UTC 2024 ``` 38. بر اساس خروجی فوق، Podهای backend `log-write` و `updatelog`به طور همزمان داده ها را در فایل مشترک `app.log` می نویسند در حالی که `log-view` به طور فعال داده ها را از فایل می خواند. در نتیجه، روش دسترسی ReadWriteMany به چندین Pod این امکان را می دهد که داده ها را به اشتراک بگذارند، فایل ها را بخوانند و همزمان در یک فضای ذخیره سازی بنویسند. ## پیکربندی Longhorn برای دسترسی خارجی رابط کاربری (UI) لانگ هورن یک برنامه وب گرافیکی است که به شما امکان می دهد وضعیت ولوم های لانگ هورن و تمام PVCهای نصب شده را رصد کنید. مراحل زیر را برای نصب یک کنترلر Ingress و دسترسی ایمن به رابط کاربری لانگ هورن در کلاستر Kubernetes خود با ارسال درخواست های خارجی به پورت رابط کاربری لانگ هورن دنبال کنید. 1. آخرین نسخه Nginx Ingress Controller را با استفاده از Kubectl روی کلاستر Kubernetes خود نصب کنید. 2. console 3. ``` $ kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.10.1/deploy/static/provider/cloud/deploy.yaml ``` 4. خروجی: 5. ``` namespace/ingress-nginx created serviceaccount/ingress-nginx created serviceaccount/ingress-nginx-admission created role.rbac.authorization.k8s.io/ingress-nginx created role.rbac.authorization.k8s.io/ingress-nginx-admission created clusterrole.rbac.authorization.k8s.io/ingress-nginx created clusterrole.rbac.authorization.k8s.io/ingress-nginx-admission created rolebinding.rbac.authorization.k8s.io/ingress-nginx created rolebinding.rbac.authorization.k8s.io/ingress-nginx-admission created clusterrolebinding.rbac.authorization.k8s.io/ingress-nginx created clusterrolebinding.rbac.authorization.k8s.io/ingress-nginx-admission created configmap/ingress-nginx-controller created service/ingress-nginx-controller created service/ingress-nginx-controller-admission created deployment.apps/ingress-nginx-controller created job.batch/ingress-nginx-admission-create created job.batch/ingress-nginx-admission-patch created ingressclass.networking.k8s.io/nginx created validatingwebhookconfiguration.admissionregistration.k8s.io/ingress-nginx-admission created ``` 6. تمام Pod های `ingress-nginx` Controller ایجاد شده را مشاهده کنید و تأیید کنید که Pod ingress-nginx به طور فعال در حال اجرا است. 7. console 8. ``` $ kubectl get pods --all-namespaces -l app.kubernetes.io/name=ingress-nginx ``` 9. خروجی: 10. ``` NAMESPACE NAME READY STATUS RESTARTS AGE ingress-nginx ingress-nginx-admission-create-n2gvf 0/1 Completed 0 98s ingress-nginx ingress-nginx-admission-patch-vqfhn 0/1 Completed 0 98s ingress-nginx ingress-nginx-controller-57b7568757-ctk5z 1/1 Running 0 99s ``` 11. حداقل `3` دقیقه صبر کنید تا `ingress-nginx` Controller یک Load Balancer را مستقر کند. سپس، تمام سرویس های موجود در فضای نام ingress-nginx را مشاهده کنید تا آدرس IP عمومی خارجی اختصاص داده شده به سرویس `LoadBalancer` خود را تأیید کنید. 12. console 13. ``` $ kubectl get services ingress-nginx-controller --namespace=ingress-nginx ``` 14. خروجی: 15. ``` NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE ingress-nginx-controller LoadBalancer 10.106.252.171 203.0.113.5 80:30886/TCP,443:32107/TCP 4m25s ``` 16. بر اساس خروجی بالا، IP متعادل کننده بار خارجی شما `203.0.113.5`است. به ثبت کننده دامنه خود دسترسی پیدا کنید و یک رکورد DNS **A** جدید تنظیم کنید که به آدرس IP خارجی اشاره کند تا همه درخواست ها را به خوشه Kubernetes شما ارسال کند. 17. یک فایل منبع جدید Ingress به نام `longhorn-ingress.yaml` ایجاد کنید. 18. console 19. ``` $ nano longhorn-ingress.yaml ``` 20. تنظیمات زیر را به فایل اضافه کنید. `longhorn.example.com` را با نام دامنه واقعی خود جایگزین کنید. 21. yaml 22. ``` apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: longhorn-production44 namespace: longhorn-system spec: ingressClassName: nginx rules: - host: negarnovin.ddns.net http: paths: - pathType: Prefix path: "/" backend: service: name: longhorn-frontend port: number: 80 ``` 23. فایل را ذخیره کنید و ببندید. 24. پیکربندی فوق یک منبع جدید Ingress به نام `longhorn-production` ایجاد می کند که رابط کاربری Longhorn را با استفاده از نام دامنه شما `longhorn.example.com` در معرض نمایش قرار می دهد و تمام درخواست های خارجی HTTP را به برنامه داخلی `longhorn- frontend` روی پورت `80`ارسال می کند. 25. پیکربندی Ingress را روی کلاستر خود اعمال کنید. 26. console 27. ``` $ kubectl apply -f longhorn-ingress ``` 28. تمام منابع Ingress را در فضای نام `longhorn-system` مشاهده کنید و تأیید کنید که پیکربندی Longhorn Ingress شما در دسترس است. 29. console 30. ``` $ kubectl get ingress ``` 31. خروجی: 32. ``` NAME CLASS HOSTS ADDRESS PORTS AGE longhorn-production nginx longhorn.example.com 203.0.113.5 80 2m20s ``` 33. شما Nginx Ingress Controller را نصب کرده اید و یک پیکربندی جدید Longhorn Ingress ایجاد کرده اید که تمام درخواست های خارجی را به برنامه داخلی `longhorn-frontend` ارسال می کند. در نتیجه، می توانید با استفاده از نام دامنه خود، به طور ایمن به رابط کاربری Longhorn دسترسی داشته باشید تا بتوانید Volumeها را در کلاستر Kubernetes خود ایجاد و مدیریت کنید. ## دسترسی به رابط کاربری Longhorn 1. با استفاده از یک مرورگر وب مانند فایرفاکس به نام دامنه Longhorn خود دسترسی پیدا کنید. 2. ``` http://longhorn.example.com ``` 3. حجم ها، گره ها و خلاصه فضای ذخیره سازی کلاستر Kubernetes خود را در داشبورد Longhorn تأیید کنید. علاوه بر این، ناحیه حجم ها شامل اطلاعاتی در مورد وضعیت تمام حجم های Longhorn موجود در کلاستر شما است. 4. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ c6631e4773610d59_compressed.webp) 5. برای دسترسی به **Volume** های Longhorn موجود در کلاستر Kubernetes خود، روی Volume در منوی ناوبری بالا کلیک کنید. 6. تأیید کنید که والیوم های ReadWriteOnce (RWO) و ReadWriteMany (RWX) شما در وضعیت سالمی در دسترس هستند. 7. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ bea353eac461a281_compressed.webp) 8. برای مشاهده اطلاعات بیشتر مانند تعداد کپی ها، جزئیات ولوم، اسنپ شات ها و پشتیبان ها، روی هر یک از ولوم های لانگ هورن کلیک کنید. 9. به لیست پارتیشن های Longhorn برگردید و روی **Create Volume** کلیک کنید تا یک پارتیشن Longhorn جدید با استفاده از رابط کاربری Longhorn ایجاد شود. 10. اطلاعات مربوط به ولوم مورد نظر خود را وارد کنید و روی منوی کشویی**Access Mode** کلیک کنید تا روش دسترسی به ولوم ReadWriteOnce یا ReadWriteMany را انتخاب کنید. 11. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ 6f3b64198462c6b4_compressed.webp) 12. برای اعمال ولوم جدید و تأیید اینکه در فهرست ولوم های Longhorn شما موجود است، روی** OK** کلیک کنید. 13. ولوم را انتخاب کنید و روی **Attach** کلیک کنید تا ولوم جدید Longhorn به هر یک از گره های کلاستر شما که فضای ذخیره سازی کافی دارد، اختصاص داده شود. 14. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ 532aa070ba25c81a_compressed.webp) 15. روی منوی کشویی **Node** کلیک کنید، گره کارگر هدف خود را انتخاب کنید و برای آماده سازی ولوم جدید با استفاده از فضای ذخیره سازی گره خود، روی **Attach** کلیک کنید. 16. تأیید کنید که وضعیت ولوم جدید Longhorn سالم است و فیلد **Attached To** شامل گره کلاستر انتخابی شما می شود. 17. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ 1234d1b64eca96c3_compressed.webp) 18. شما یک درایو Longhorn جدید در رابط کاربری Longhorn ایجاد کرده اید. می توانید یک PVC جدید ایجاد کنید که به نام درایو Longhorn جدید اشاره دارد تا درایو جدید را بسته به روش دسترسی آن، در کلاستر خود mount کنید. ## پشتیبان گیری از Volumeهای Longhorn در NegarNovin Object Storage پشتیبان گیری های Longhorn با ذخیره سازی S3 مانند Negarnovin Object Storage برای بازیابی و ایجاد Disaster Recovery Volumes (DR volume) در صورت خرابی گره ها در کلاستر شما سازگار است. مراحل زیر را برای اعمال پیکربندی های جدید Negarnovin Object Storage در کلاستر خود دنبال کنید و Longhorn را برای پشتیبان گیری از Volumeها در باکت مقصد خود تنظیم کنید. * به نمونه Negarnovin Object Storage خود دسترسی پیدا کنید و **Hostname**, **Secret Key** و **Access Key** را برای استفاده در خوشه خود کپی کنید. 1. یک فایل منبع مخفی جدید `negarobj-secret.yaml` ایجاد کنید تا اعتبارنامه های NegarNovin Object Storage خود را در آن ذخیره کنید. 2. console 3. ``` $ nano negarnovinobj-secret.yaml ``` 4. پیکربندی های زیر را به فایل اضافه کنید. `examplekey`, `examplesecret` و `ewr1. negarnovin.com` را با اعتبارنامه های واقعی Negarnovin Object Storage خود جایگزین کنید. 5. yaml 6. ``` apiVersion: v1 kind: Secret metadata: name: longhorn-negarnovin-backups namespace: longhorn-system type: Opaque stringData: AWS_ACCESS_KEY_ID: examplekey AWS_ENDPOINTS: https://ewr1.negarnovin.com AWS_SECRET_ACCESS_KEY: examplesecret ``` 7. فایل را ذخیره کنید و ببندید. 8. پیکربندی فوق یک فایل جدید به نام `longhorn-negar-backups` با نام Secret ایجاد می کند که شامل اطلاعات دسترسی Negarnovin Object Storage شما در فضای نام `longhorn- system` است. Longhorn هنگام ایجاد پشتیبان گیری، بسته به باکت هدف در پیکربندی شما، به این فایل مخفی ارجاع می دهد. 9. پیکربندی را روی کلاستر Kubernetes خود اعمال کنید. 10. console 11. ``` $ kubectl apply -f negarobj-secret.yaml ``` 12. تمام اسرار موجود در فضای نام `longhorn-system` را مشاهده کنید و تأیید کنید که منبع جدید Negarnovin Object Storage شما در دسترس است. 13. console 14. ``` $ kubectl get secrets -n longhorn-system ``` 15. خروجی: 16. ``` NAME TYPE DATA AGE longhorn-negarnovin-backups Opaque 3 35s ``` 17. در مرورگر وب خود به رابط کاربری Longhorn دسترسی پیدا کنید. 18. روی منوی کشویی تنظیمات (**Setting** ) در منوی ناوبری اصلی کلیک کنید و از لیست گزینه ها، عمومی (**General** ) را انتخاب کنید. 19. به بخش **Back Up** بروید **Backup Target **و با استفاده از آدرس اینترنتی `s3://`، نام مخزن و آدرس اینترنتی مخزن NegarNovin Object Storage، محل پشتیبان گیری را روی مخزن NegarNovin Object Storage خود تنظیم کنید. 20. ``` s3://example-bucket@ewr1.negarnovin.com.com/ ``` 21. نام منبع NegarNovin Object Storage Secret خود را `longhorn-negarnovin-backups` در فیلد`Backup Target Credential Secret` وارد کنید. 22. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ 02e982ceb772bae1_compressed.webp) 23. نصب لانگ هورن در کوبرنتیز 24. برای ذخیره تغییرات و اعمال پیکربندی جدید پشتیبان گیری Longhorn، Enter را فشار دهید. 25. برای دسترسی به ولوم های Longhorn خود، در منوی ناوبری اصلی روی **Volume** کلیک کنید. 26. یک حجم هدف برای پشتیبان گیری انتخاب کنید. برای مثال، `test-volume`. 27. برای وارد کردن جزئیات پشتیبان جدید، روی **Create Backup** در منوی ناوبری بالا کلیک کنید. 28. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ a7a19f452db4687c_compressed.webp) 29. روی **Add Labels for Backup** کلیک کنید و جزئیات برچسب پشتیبان مورد نظر خود را وارد کنید. به عنوان مثال، `longhorn-backup` و `latest-backup` به ترتیب به عنوان کلید و مقدار برچسب. 30. بسته به حجم درایو خود، منتظر بمانید تا فرآیند پشتیبان گیری کامل شود و برای دسترسی به تمام **Backup** موجود، در منوی اصلی روی پشتیبان گیری کلیک کنید. 31. تأیید کنید که نسخه پشتیبان جدید Longhorn شما در لیست موجود است. 32. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ 41a71e9755fb2090_compressed.webp) 33. به مخزن ذخیره سازی negarnovin خود دسترسی پیدا کنید و تأیید کنید که یک دایرکتوری` backupstore` جدید توسط Longhorn با اشیاء پشتیبان گیری حجمی شما ایجاد شده است. 34. ![نصب لانگ‌ هورن در کوبرنتیز](https://negarnovin.com/wp-content/uploads/2025/11/ f161cca1c394ace8_compressed.webp) 35. شما از پارتیشن Longhorn خود در Negarnovin Object Storage نسخه پشتیبان تهیه کرده اید، می توانید یک پارتیشن بازیابی فاجعه جدید ایجاد کنید یا از داده های بازیابی برای بازگرداندن هرگونه تغییر خوشه ای استفاده کنید. برای خودکارسازی پشتیبان گیری از پارتیشن Longhorn خود یا ایجاد پشتیبان گیری دستی برای پشتیبان گیری مداوم از داده های پارتیشن در باکت مقصد، به **Recurring Job** در منوی ناوبری اصلی رابط کاربری Longhorn بروید. ## نتیجه گیری شما Longhorn را با استفاده از یک کلاستر Negarnovin Kubernetes Engine (VKE) روی Kubernetes مستقر کرده اید. شما Volume Longhorn را ایجاد کرده اید و چندین PVC را با حالت های دسترسی ReadWriteOnce و ReadWriteMany برای استفاده با برنامه های کلاستر خود که PVCها را به عنوان Volumeهای ذخیره سازی Mount می کنند، تنظیم کرده اید. علاوه بر این، شما با استفاده از رابط کاربری Longhorn، پشتیبان های Longhorn را برای ذخیره خارجی داده های Volume جهت بازیابی در صورت خرابی کلاستر ایجاد کرده اید. برای اطلاعات بیشتر و گزینه های پیکربندی، به [مستندات Longhorn](https://longhorn.io/docs/) مراجعه کنید. 