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