استقرار پروژه اسکریپت Google Apps، نسخهای از اسکریپت شماست که برای استفاده به عنوان یک برنامه وب، افزونه Google Workspace یا API اجرایی در دسترس است. با ایجاد و مدیریت استقرارها، میتوانید روی کد خود تکرار کنید و کنترل کنید که کاربران به کدام نسخه اسکریپت دسترسی داشته باشند.
دو نوع استقرار وجود دارد:
- استقرارهای Head ، که همیشه با کد پروژه فعلی همگامسازی میشوند.
- استقرارهای نسخهبندیشده ، که به یک نسخه خاص از پروژه متصل میشوند.
استقرار سر
استقرار سر، کد پروژه فعلی است. وقتی یک پروژه Apps Script ایجاد میکنید، سیستم به طور خودکار یک استقرار سر برای آن پروژه ایجاد میکند.
استقرار اصلی همیشه با آخرین کد ذخیره شده همگامسازی میشود. برای مثال، اگر یک استقرار نسخهبندی شده ایجاد کنید و سپس کد خود را تغییر دهید، استقرار اصلی آن تغییرات را منعکس میکند در حالی که استقرار نسخهبندی شده دست نخورده باقی میماند.
از استقرارهای سر (head deployments) برای تست کد استفاده کنید. از استقرارهای سر برای استفاده عمومی استفاده نکنید.
برای هر پروژه اسکریپت برنامهها، فقط یک استقرار سر وجود دارد. برای استفاده از استقرار سر، باید حداقل دسترسی خواندن به پروژه اسکریپت را داشته باشید.
استقرارهای نسخهبندیشده
استقرار نسخهبندیشده، نسخه خاصی از کد پروژه را در دسترس قرار میدهد. این به کاربران اجازه میدهد تا در حالی که شما تغییرات و بهبودهایی را در کد ایجاد میکنید، به استفاده از نسخه فعال ادامه دهند.
وقتی برنامهای را برای استفاده عمومی منتشر میکنید، همیشه از یک استقرار نسخهبندیشده استفاده کنید. میتوانید چندین استقرار نسخهبندیشده فعال را بهطور همزمان داشته باشید.
مهم : شما نمیتوانید مالکیت نسخههای مختلف پیادهسازیها را منتقل کنید. اگر مالکیت یک پروژه اسکریپت را منتقل کنید، مالک پیادهسازیهای نسخهبندیشده موجود تغییر نمیکند. اگر مدیر حساب مالک پیادهسازی را حذف کند، پیادهسازیهای او ممکن است با خطاهای اسکریپت مواجه شوند.
استقرارها در مقابل نسخهها
نسخه و استقرار مفاهیم متمایزی در Apps Script هستند:
- نسخه : یک تصویر لحظهای ایستا از کد پروژه اسکریپت شما. پس از ایجاد، یک نسخه تغییرناپذیر است. نسخه را به عنوان یک "نقطه ذخیره" در تاریخچه توسعه خود در نظر بگیرید.
- استقرار (Deployment ): نسخهای که نسخه خاصی از اسکریپت شما را در دسترس کاربران قرار میدهد. استقرار دارای یک URL یا شناسه منحصر به فرد است.
وقتی میخواهید کدی را که توسط یک استقرار موجود (مانند یک برنامه وب) استفاده میشود، بهروزرسانی کنید، یک نسخه جدید ایجاد میکنید و سپس استقرار را ویرایش میکنید تا به آن نسخه جدید اشاره کند. این کار برنامه را برای همه کاربران بهروزرسانی میکند، در حالی که همان URL یا شناسه استقرار را حفظ میکند.
ایجاد یک استقرار نسخهبندیشده
برای استقرار نسخهای از یک افزونه، افزونه ویرایشگر، برنامه چت یا یک فایل اجرایی API، ابتدا باید ارتباط پروژه Google Cloud مربوط به Apps Script خود را از پروژه پیشفرض به یک پروژه استاندارد تغییر دهید .
برای ایجاد یک استقرار نسخهبندیشده:
- پروژه Apps Script را باز کنید.
- در بالا سمت راست، روی Deploy > New deployment کلیک کنید.
- در کنار انتخاب نوع، روی فعال کردن انواع استقرار کلیک کنید.
- نوع استقراری را که میخواهید مستقر کنید انتخاب کنید. برای افزونههای Google Workspace، افزونههای Editor و برنامههای Google Chat، افزونه را انتخاب کنید.
- اطلاعات مربوط به استقرار خود را وارد کنید و روی Deploy کلیک کنید.
هر استقرار جدید میتواند به عنوان یک کتابخانه به اشتراک گذاشته شود. اگر اسکریپت را به عنوان یک کتابخانه به اشتراک بگذارید، توضیحات استقرار برای کاربران کتابخانه قابل مشاهده است.
مشاهده نسخههای استقرار یافته
برای مشاهدهی استقرارهای یک پروژهی Apps Script، در بالا، روی Deploy > Manage deployments کلیک کنید.
برای مشاهده کد یک نسخه خاص، به مشاهده نسخه قبلی مراجعه کنید.
ویرایش یک استقرار نسخهبندیشده
شما میتوانید یک استقرار نسخهبندیشده را ویرایش کنید تا توضیحات یا نسخه آن را تغییر دهید. برای ویرایش یک استقرار:
- پروژه Apps Script را باز کنید.
- روی استقرار > مدیریت استقرارها کلیک کنید.
- استقرار فعال را انتخاب کنید و ویرایش کلیک کنید.
- تغییرات خود را اعمال کنید و روی «استقرار» کلیک کنید.
برای ویرایش یک استقرار بایگانیشده، آن را مجدداً مستقر کنید و سپس مراحل قبلی را دنبال کنید.
برای استقرار یک تغییر در کد پروژه، یک نسخه جدید ایجاد کنید و استقرار را برای استفاده از آن ویرایش کنید. این روش استاندارد برای بهروزرسانی برنامه شما بدون تغییر URL یا شناسه استقرار آن است. استقرار بهطور خودکار از نسخه جدید برای همه کاربران استفاده میکند.
پیدا کردن شناسه استقرار
هر استقرار دارای یک شناسه رشتهای مرتبط است. برای یافتن این شناسه:
- پروژه Apps Script را باز کنید.
- در بالا سمت راست، روی Deploy > Manage deployments کلیک کنید.
- یک استقرار فعال را برای یافتن شناسه آن انتخاب کنید.
شناسههای استقرار فقط در استقرارهای فعال ظاهر میشوند.
آزمایش یک استقرار
روش آزمایش استقرار به نوع برنامهای که میسازید بستگی دارد.
افزونهی گوگل ورک اسپیس
برای آزمایش استقرار افزونه، به بخش «آزمایش افزونهها» مراجعه کنید.
افزونه ویرایشگر
برای آزمایش پیادهسازی افزونهی ویرایشگر، به بخش «آزمایش افزونهی ویرایشگر» مراجعه کنید.
برنامه وب
برای آزمایش استقرار برنامه وب، به «آزمایش استقرار برنامه وب» مراجعه کنید.
برنامه گوگل چت
برای آزمایش استقرار برنامه چت، یک استقرار نسخهبندی شده از اسکریپت ایجاد کنید تا به شناسه استقرار آن دسترسی پیدا کنید.
پس از اینکه شناسه استقرار را داشتید، شناسه را در پیکربندی Chat API مشخص کنید و مراحل آزمایش ویژگیهای تعاملی را دنبال کنید.
API قابل اجرا
برای آزمایش یک استقرار اجرایی API، یک استقرار نسخهبندیشده ایجاد کنید . پس از ایجاد یک استقرار، این مراحل را دنبال کنید:
- در سمت راست بالای پروژه Apps Script، روی Deploy > Test deployments کلیک کنید.
- در کنار «انتخاب نوع»، کلیک کنید
> فایل اجرایی API . - آدرس اینترنتی (URL) را کپی کرده و برای آزمایش پیادهسازی اجرایی API خود استفاده کنید.
بایگانی یک استقرار نسخهبندیشده
شما نمیتوانید استقرارهای نسخهبندیشده را از رکورد استقرارهای خود حذف کنید. در عوض، میتوانید آنها را بایگانی کنید.
برای بایگانی کردن یک استقرار نسخهبندیشده:
- پروژه Apps Script را باز کنید.
- روی استقرار > مدیریت استقرارها کلیک کنید.
- استقرار را انتخاب کنید و استقرار بایگانی کلیک کنید.
حذف یک نسخه از تاریخچه پروژه
اگرچه نمیتوانید استقرارهای نسخهبندیشده را حذف کنید، میتوانید نسخههای اسکریپتی را که استفاده میکنند از تاریخچه پروژه خود حذف کنید. برای حذف یک نسخه، نباید توسط یک استقرار فعال در حال استفاده باشد.
برای حذف یک نسخه، به «حذف نسخهها» مراجعه کنید.
استقرار مجدد یک نسخه آرشیو شده
- پروژه Apps Script را باز کنید.
- در بالا سمت راست، روی Deploy > Manage deployments کلیک کنید.
- در قسمت بایگانیشده (Archived) ، استقرار (deploy) را انتخاب کنید و روی ویرایش (edit > استقرار (Deploy) کلیک کنید.