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