نصب ایجینت روی کلاستر برای اتصال به گیت لب
برای اتصال کلاستر کوبرنتیز به گیت لب نیاز به نصب یک ایجنت روی کلاستر خود دارید.
اما نصب ایجنت روی کلاستر چگونه انجام می‌شود؟ ما در این مقاله نگاهی به چگونگی نصب ایجنت روی کلاستر انداخته‌ایم، به راه‌های مختلف نصب آن اشاره کردیم و نکات تکمیلی درباره آن را ذکر کرده‌ایم. برای آشنایی بیشتر با این فرایند، ادامه این مقاله را از دست ندهید.
نصب ایجنت برای کوبرنتیز
ایجنت واسطی است که می‌تواند کلاستر کوبرنتیز شما را به گیت لب متصل کند؛ بنابراین برای اتصال کوبرنتیز به گیت لب باید ایجنت را روی کلاستر خود نصب کنید. کلاستر یکی از اصطلاحات رایج کوبرنتیز است.
پیش‌نیازها
قبل از نصب ایجنت روی کلاستر خود به موارد زیر نیاز دارید.
- باید یک کلاستر کوبرنتیز داشته باشید. اگر شما کلاستر نداشته باشید، می‌توانید یکی از آن‌ها را در یک سرویس تامین کننده خدمات ابری بسازید. برای مثال می‌توانید از موتور کوبرنتیز گوگل (GKE)، سرویس الاستیک کوبرنتیز آمازون (EKS) و اقیانوس دیجیتال (Digital Ocean) استفاده کنید.
- در نمونه‌هایی که گیت لب خودش مدیریت می‌شود یا اصطلاحا در حالت self-managed قرار دارد، یک ادمین گیت لب باید سرور ایجنت را راه‌اندازی کند. سپس این بخش به صورت پیش‌فرض رویwss://gitlab.example.com/-/kubernetes-agent/ قرار می‌گیرد. درcom ، سرویس ایجنت روی wss://kas.gitlab.com موجود می‌شود.
مراحل نصب
برای نصب یک ایجنت روی کلاستر باید مراحل زیر را طی کنید.
- یک فایل پیکربندی ایجنت بسازید.
- ایجنت را در گیت لب رجیستر یا ثبت نام کنید.
- ایجنت را روی کلاستر خود نصب کنید.
· ساخت یک فایل پیکربندی برای ایجنت
- برای تنظیمات مربوط به پیکربندی، ایجنت از یک فایل با فرمت YAML در پروژه گیت لب استفاده می‌کند. شما در شرایط زیر باید این فایل را بسازید:
- اگر از ورک فلوی گیت آپس استفاده می‌کنید.
- اگر از ورک فلوی CI/CD گیت لب استفاده می‌کنید و می‌خواهید یک پروژه متفاوت را برای استفاده از ایجنت احراز هویت کنید.
- در غیر این صورت ساخت این فایل برای شما غیرضروری خواهد بود. از طرفی برای ساخت یک فایل پیکربندی ایجنت باید مراحل زیر را طی کنید:
- یک اسم برای ایجنت خود انتخاب کنید. اسم ایجنت شما باید در راستای استاندارد لیبل دی‌ان‌اس RFC 1123 باشد. برای انتخاب اسم باید موارد زیر را نیز در نظر داشته باشید.
- اسم خاصی درباره پروژه باشد.
- حداکثر از ۶۳ کاراکتر تشکیل شده باشد.
- فقط از حروف کوچک انگلیسی و نماد – تشکیل شده باشد.
- با عدد یا حرف شروع شود.
- با عدد یا حرف تمام شود.
- در مخزن و در شاخه پیش فرض، این دایرکتوری را در روت ایجاد کنید:
gitlab/agents/<agent-name >
در دایرکتوری یک فایل به نام config.yaml بسازید. مطمئن شوید که این فایل به . aml ختم شود. سپس قسمت فایل را خالی نگه دارید تا بعدا آن را پیکربندی کنید.
· رجیستر یا ثبت نام ایجنت با گیت لب
مرحله بعدی همانطور که از اسم این بخش پیداست، مربوط به رجیستر ایجنت با گیت لب می‌شود. اگر از ورک فلوی CI/CD گیت لب استفاده می‌کنید، از فعال بودن آن اطمینان حاصل کنید.
- قبل از نصب ایجنت روی کلاستر، باید یک ایجنت را رجیستر کنید. برای رجیستر کردن ایجنت مراحل زیر پیش روی شما قرار دارند.
- در نوار بالایی، مسیر Main menu > Projects را انتخاب، و پروژه خود را در آن پیدا کنید. اگر شما یک فایل پیکربندی ایجنت دارید، حتما باید در مسیر این پروژه تعریف شود. کلاستر شما فایل‌هایی که باید در این پروژه باشند را آشکار یا اصطلاحا مانیفست می‌کند.
- از نوار سمت چپ، مسیر Infrastructure > Kubernetes clusters را انتخاب کنید.
- گزینه Connect a cluster (agent) را انتخاب کنید.
- اگر یک پیکربندی با ساختار CI/CD را می‌خواهید ایجاد کنید، یک اسم تایپ کنید.
- اگر یک فایل پیکربندی ایجنت دارید، آن را از لیست انتخاب کنید.
- گزینه Register an agent را انتخاب کنید.
- گیت لب توکن دسترسی به ایجنت را ایجاد می‌کند. شما برای نصب ایجنت روی کلاستر به این توکن نیاز خواهید داشت.
- دستور مدنظر را تحت متد نصبی پیشنهاد شده کپی کنید. زمانی که از متد خطی نصب برای نصب ایجنت روی کلاستر استفاده می‌کنید به آن نیاز خواهید داشت.
· نصب ایجنت روی کلاستر
برای اتصال کلاستر به گیت لب، ایجنت ثبت‌نام‌شده را در کلاستر خود نصب کنید. برای این کار می‌توانید:
- ایجنت را با استفاده از Helm نصب کنید.
- یا می‌توانید روش پیشرفته نصب را دنبال کنید.
اگر نمی‌دانید از کدام روش استفاده کنید، ما به شما نصب با Helm را پیشنهاد می‌کنیم.
§ نصب با استفاده از Helm
برای نصب ایجنت با استفاده از Helm ، باید مراحل زیر را دنبال کنید.
- Helm را نصب کنید.
- در سیستم خود یک ترمینال ایجاد کنید و به کلاستر خود متصل شوید.
- دستوری که کپی کردید را زمانی که ایجنت خود را در گیت لب رجیستر کردید، اجرا کنید.
§ روش پیشرفته نصب ایجنت
راه دیگر نصب ایجنت، استفاده از پکیج KPT گیت لب برای نصب ایجنت است. این روش انعطاف‌پذیری بالاتری را برای نصب ارائه می‌دهد اما برای کاربران حرفه‌ای‌تر مناسب است.
o پیکربندی ایجنت
برای پیکربندی ایجنت خود باید محتوایی را به فایل config.yaml خود اضافه کنید.
- جهت ورک فلوی گیت آپس، از طریق راهنمای موجود در این لینک می‌توانید محتوا را اضافه کنید.
برای ورک فلوی CI/CD گیت لب، ایجنت خود را برای داشتن دسترسی به پروژه‌ها احراز هویت کنید. سپس دستور kubectl را به فایل ci. aml-.gitlab اضافه کنید.
کلام آخر
در این مقاله نگاهی به نحوه نصب ایجنت روی کلاستر برای اتصال به کوبرنتیز انداختیم. همانطور که در مقاله خواندیم، این کار در نگاه اول کاری پیچیده به نظر می‌رسد، اما در صورت داشتن آشنایی با گیت لب و کوبرنتیز و استفاده از راهنمای این مقاله، به سادگی می‌توان این کار را انجام داد. امیدواریم از خواندن این مقاله نهایت استفاده را برده باشید.