افزونه VS Code
افزونه اختصاصی پارسپک برای Visual Studio Code، محیط توسعهی محلی شما را مستقیما به زیرساخت PaaS متصل میکند. با استفاده از این ابزار، بدون نیاز به درگیری با مخازن Git یا آپلود دستی فایل، میتوانید سورسکد اپلیکیشنهای خود را در محیط VS Code دانلود و ویرایش کرده و تغییرات را با یک کلیک روی سرور مستقر (Deploy) کنید.
فرایند راهاندازی و استفاده از این ابزار شامل چهار گام زیر است:
گام اول: دریافت و نصب افزونه
ابتدا باید فایل افزونه را از پنل کاربری دریافت کرده و روی ویرایشگر کد خود نصب کنید.
- در پنل مدیریت PaaS، از منوی سمت راست وارد بخش «VS Code Wizard» شوید.
- با کلیک روی گزینهی «دانلود افزونه»، فایل اکستنشن با فرمت .vsix را روی سیستم خود ذخیره کنید.
- نرمافزار VS Code را باز کرده و از منوی سایدبار سمت چپ، تب Extensions را انتخاب کنید.
- در بالای پنل، روی آیکون سهنقطه (…) کلیک کرده و گزینهی …Install from VSIX را انتخاب کنید.
- فایلی که در مرحلهی اول دانلود کرده بودید را آدرسدهی کنید تا افزونه نصب شود. با نمایش پیام موفقیتآمیز بودن نصب در گوشه پایین تصویر، این گام به پایان میرسد.
گام دوم: احراز هویت (تولید و ثبت API Key)
برای اینکه افزونهی نصبشده مجوز دسترسی به اپلیکیشنهای شما را داشته باشد، باید یک کلید امنیتی (API Key) تولید کنید.
- در پنل پارسپک، از منوی سمت راست وارد بخش «API Keys» (یا مرحله سوم از ویزارد) شوید.
- روی دکمهی «ایجاد API Key» کلیک کنید. یک نام دلخواه برای کلید وارد کرده و سطح دسترسی را حتماً روی read/write تنظیم کنید.
- پس از کلیک روی ایجاد، سیستم یک رشتهکد طولانی به شما نمایش میدهد. این کد را کپی کنید. (توجه: به دلایل امنیتی، این کلید فقط همین یک بار نمایش داده میشود).
- به محیط VS Code برگردید. از تب Extensions، روی آیکون چرخدنده کنار افزونهی پارسپک کلیک کرده و وارد بخش Extension Settings شوید.
- در فیلد API Key، کدی که از پنل کپی کردهاید را Paste کنید. نیازی به تغییر Base URL نیست. تغییرات بهصورت خودکار ذخیره میشوند.
گام سوم: دریافت و ویرایش کدها
با ثبت کلید، آیکون پارسپک به سایدبار نرمافزار شما اضافه میشود. با کلیک روی آن، لیست تمامی پروژهها و اپلیکیشنهای فعال خود را مشاهده خواهید کرد.
- برای دسترسی به کدهای یک برنامه، در پنل افزونه روی نام آن اپلیکیشن کلیک راست کرده و گزینهی Download Application Service را انتخاب کنید.
- یک پوشهی خالی در سیستم خود برای ذخیره فایلها مشخص کنید.
- پس از اتمام دانلود، سورسکد اپلیکیشن شما بهطور کامل در بخش Explorer نرمافزار باز میشود و میتوانید فایلها را آزادانه ویرایش کنید.
قابلیتهای مدیریتی جانبی: از طریق همان منوی کلیک راست روی نام اپلیکیشن، به ابزارهای مدیریتی سریع مانند روشن/خاموش کردن (Power Off)، ریاستارت (Restart)، تغییر مقیاس (Scale Up) و حذف اپلیکیشن (Delete) نیز دسترسی مستقیم دارید.
گام چهارم: استقرار مستقیم تغییرات (Deploy)
پس از اینکه کدهای خود را در VS Code ویرایش و ذخیره کردید، اعمال تغییرات روی سرور به سادگی و بدون خروج از محیط توسعه انجام میشود:
- مجددا در پنل افزونه پارسپک (در سایدبار)، روی نام اپلیکیشن خود کلیک راست کنید.
- گزینهی Deploy To Parspack را انتخاب کنید.
- در پنجره باز شده، عملیات را تایید کنید. سورسکد جدید شما بستهبندی شده و مستقیما به سرور ارسال میشود.
میتوانید روند پیشرفت استقرار را از طریق لاگهای نرمافزار VS Code و یا با مراجعه به بخش اعلانات (زنگوله) در پنل وب پارسپک پیگیری کنید. پس از پایان فرایند، اپلیکیشن شما با کدهای جدید در دسترس خواهد بود.