در این آموزش مراحل ساخت برنامه‌های آماده در بازارچه‌ی ابری هم‌روش آورده شده‌است و همچنین با برخی ویژگی‌های این برنامه‌ها پس از ساخت آن‌ها آشنا خواهید شد.

ساخت سرویس

برای ساخت هر برنامه در کنسول هم‌روش ابتدا به «صفحه‌ی اکسپلور» بروید و سپس برنامه‌ی مورد نظر را انتخاب کنید.

در این صفحه می‌توانید اطلاعات مورد نیاز خود را به‌دست آورید و با ویژگی‌ها و راهنمایی‌های خاص هر برنامه آشنا شوید. برای ساخت روی دکمه‌ی «راه‌اندازی» کلیک کنید.

در ادامه نام سرویس، منطقه‌ی موردنظر برای ساخت و همچنین ورژن موردنظر و پلن دلخواه خود را انتخاب کنید. سپس با کلیک روی «راه‌اندازی»، سرویس شما ساخته می‌شود. پس از راه‌اندازی، دامنه‌ای پیش‌فرض در اختیارتان قرار می‌گیرد که سرویس شما از طریق آن در دسترس است. با این‌حال در ادامه می‌توانید از طریق تب مربوطه، دامنه‌ی شخصی خود را جایگزین کنید. البته برای برنامه‌هایی که از چند دامنه به‌صورت همزمان پشتیبانی می‌کنند، می‌توانید دامنه‌های مدنظرتان را اضافه کرده و آن‌ها را مدیریت کنید.

همچنین هر زمان که نیاز به منابع بیشتر را احساس کنید، از طریق تب مربوط به پلن‌ها می‌توانید پلن خود را ارتقاء دهید. توجه کنید که امکان تغییر پلن به پلن پایین‌تر به دلیل ویژگی‌های زیرساختی وجود ندارد.

به‌روزرسانی

هنگامی که امکان به‌روزرسانی به نسخه‌های جدیدتر موجود باشد، می‌توانید از طریق تب مربوطه به لیست نسخه‌ها دسترسی داشته باشید.

کافی است نسخه‌ی مورد نظر را انتخاب کنید، سپس با کلیک روی دکمه‌ی «به‌روزرسانی» فرآیند آپدیت سرویس شروع می شود. توجه کنید که این فرآیند به‌دلیل بکاپ‌گیری در ابتدای امر، ممکن است تا چندین دقیقه به طول بینجامد. همچنین می‌توانید تا ۲ روز پس از اعمال به‌روزرسانی در صورت نیاز آخرین به‌روزرسانی خود را بازگردانی کنید و به وضعیت قبل از آپدیت بازگردید. علاوه‌بر این، تایم‌لاین به‌روز‌رسانی‌های انجام‌شده از طریق همین تب در دسترس است.

فیلدهای موردنیاز

برخی از برنامه‌ها نیاز به اطلاعاتی همچون نام کاربری یا گذرواژه‌ی ورود دارند تا کاربر بتواند به آن‌ها دسترسی داشته باشد. این فیلدها هنگام ساخت سرویس تنظیم می‌شوند و البته فیلدهای حساس مانند رمز عبور، به‌صورت تصادفی تنظیم می‌شوند و از طریق تب اطلاعات عمومی سرویس قابل‌دسترسی هستند.

در این تب، می‌توانید به‌راحتی مقدار آن‌ها را کپی کنید یا از طریق «...» در کنار دکمه‌ی «مشاهده سرویس»، لیست کامل آن‌ها را مشاهده کنید.

قابلیت‌های دیگر

در این بخش به معرفی امکاناتی می‌پردازیم که در برنامه‌های آماده‌ی مختلف، در صورت نیاز برای کاربران قرار داده شده‌اند و دسترسی ایجاد تغییرات مورد نیاز کاربر در سرویس را مهیا می‌کنند.

ترمینال

تب ترمینال، امکان دسترسی به کانتینر اصلی سرویس را به کاربر می‌دهد. با این ویژگی می‌توانید به‌سادگی و بدون نیاز به ابزارهای خارجی، برای پایش، عیب‌یابی و مدیریت سرویس خود به صورت لحظه‌ای دستورات را اجرا و محیط کانتینر را بررسی کنید.

Environment Variables

این ویژگی به کاربران اجازه می‌دهد، متغیرهای مورد نیاز را برای سرویس خود تنظیم کنند. نکته‌ی قابل‌توجه این است که متغیرهای اصلی و مورد نیاز برنامه برای ستاپ اولیه از ابتدا تنظیم شده‌اند و احتیاجی به تغییر یا تنظیم مجدد آن‌ها توسط کاربر نیست.

شما می‌توانید از طریق تب تنظیمات و بخش Environment Variables، متغیرهای دیگری که نیاز دارید را تنظیم و مدیریت کنید. برای افزودن متغیر، کافی ‌است روی دکمه‌ی «افزودن متغیر» کلیک کنید و کلید و مقدار مدنظرتان را وارد و تأیید کنید. همچنین می‌توانید لیست متغیرهای تنظیم‌شده‌تان را در این بخش ببینید و در صورت لزوم هر متغیر را ویرایش یا حذف کنید. لازم است پس از اعمال تغییرات خود در این بخش، با زدن دکمه‌ی «اعمال تغییرات» آن‌ها را ذخیره کنید.

کانفیگ‌ها

این ویژگی به کاربران اجازه می‌دهد که فایل‌های پیکربندی (Configuration) لازم را برای سرویس خود تنظیم کنند و معادل کانفیگ‌مپ در کوبرنتیز است. این فایل‌ها معمولاً فقط‌خواندنی (read-only) هستند و بازنویسی‌ای توسط برنامه روی آن‌ها انجام نمی‌شود. فایل‌هایی که به‌عنوان کانفیگ اضافه می‌کنید، در آدرس مشخصی از کانتینر شما قرار می‌گیرند و با هر بار ری‌استارت شدن پاد، مقدارشان دست‌نخورده باقی می‌ماند. کانفیگ‌هایی که برای ستاپ اولیه‌ی برنامه لازم هستند، از ابتدا با مقادیر پیش‌فرض قرار داده شده‌اند و کاربر دسترسی ویرایش آن‌ها را دارد. همچنین امکان افزودن کانفیگ‌های بیشتر نیز وجود دارد.

برای مدیریت کانفیگ‌ها به تب تنظیمات و بخش «کانفیگ‌ها» بروید. برای افزودن کانفیگ کافی است روی دکمه‌ی «تنظیم کانفیگ» کلیک کنید و فیلدهای مربوطه را تکمیل کنید. همچنین می‌توانید هر کانفیگ خود را ویرایش یا حذف کنید. دقت کنید که mountPath و subPath کانفیگ‌های پیش‌فرض که از ابتدا روی سرویس شما تنظیم شده‌اند، قابل‌ویرایش نیستند و فقط می‌توانید محتوای data را در صورت نیاز برای آن‌ها تغییر دهید. در نهایت نیز لازم است پس از اعمال تغییرات خود در این بخش، با زدن دکمه‌ی «اعمال تغییرات» آن‌ها را ذخیره کنید.

شما به دو شیوه می‌توانید کانفیگ‌مپ موردنظرتان را اضافه کنید که در ادامه به آن‌ها می‌پردازیم.

اضافه کردن پوشه

در این حالت می‌توانید یک یا چند فایل را در یک پوشه قرار دهید. کافی است پس از انتخاب یک نام برای کانفیگ‌مپ، مقدار mountPath را برابر با محل پوشه وارد کنید و مقدار subPath را خالی بگذارید. حالا به‌ازای هر کلید و مقدار موجود در data، یک فایل با همان نام و محتوا در پوشه‌ی مورد نظر ایجاد می‌شود.

test.txt: hello world

my.conf: |-
  first line;
  second line {
    listen 80;
  }

دقت کنید که data باید به‌صورت یک فایل yaml باشد. به‌طور مثال، اگر مقدار mountPath را برابر با /etc/conf قرار دهید، این فایل data منجر به ساخت دو فایل test.txt و my.conf با محتواهای مشخص‌شده، در /etc/confمی‌شود.

اضافه کردن فایل

در این حالت می‌توانید یک فایل مشخص را در یک پوشه قرار دهید. کافی است پس از انتخاب یک نام برای کانفیگ‌مپ، مقدار mountPath را برابر با آدرس فایل و همچنین subPath را برابر با کلید مدنظر از data وارد کنید تا فایلی با آدرس mountPath و محتوای معادل subPath ایجاد شود.

config: |-
  first line;
  second line {
    listen 80;
  }

دقت کنید که data باید به‌صورت یک فایل yaml باشد. به‌طور مثال، اگر مقدار mountPath را برابر با /etc/conf/default.conf و subPath را برابر با config قرار دهید، این فایل data منجر به ساخت فایل default.conf با محتوای مشخص‌شده به‌ازای کلید config، در /etc/conf می‌شود.