استقرار پروژه Apps Script نسخه ای از اسکریپت است که برای استفاده به عنوان یک برنامه وب، افزونه یا API قابل اجرا در دسترس است. با ایجاد و مدیریت استقرارها، می توانید کد خود را تکرار کنید، تغییرات خود را پیگیری کنید و نسخه کد دقیقی را که کاربران به آن دسترسی دارند را کنترل کنید.
دو نوع استقرار وجود دارد:
- گسترش‌های سر ، که همیشه با کد پروژه فعلی همگام‌سازی می‌شوند.
- استقرارهای نسخه شده ، که به یک نسخه پروژه خاص متصل هستند.
استقرارهای سر
یک هد استقرار کد فعلی پروژه است. هنگامی که یک پروژه Apps Script ایجاد می کنید، به طور خودکار یک head Deployment برای آن پروژه ایجاد می کنید.
استقرار هد همیشه با آخرین کدهای ذخیره شده همگام است. به عنوان مثال، اگر یک استقرار نسخه شده ایجاد کنید و سپس کد خود را تغییر دهید، استقرار هد آن تغییرات را منعکس می کند، در حالی که استقرار نسخه دست نخورده باقی می ماند.
از استقرار هد برای آزمایش کد استفاده کنید. از استقرار هد برای استفاده عمومی استفاده نکنید.
استقرارهای نسخه شده
یک استقرار نسخه شده، نسخه خاصی از کد پروژه را در دسترس قرار می دهد. این به کاربران شما امکان می‌دهد تا زمانی که شما تغییرات و بهبودهایی در کد ایجاد می‌کنید، از یک نسخه کاربردی استفاده کنند.
هنگامی که برنامه شما برای مصرف عمومی منتشر می شود، همیشه از یک استقرار نسخه شده استفاده کنید. شما می توانید چندین استقرار نسخه فعال را در یک زمان داشته باشید.
مهم : شما نمی توانید مالکیت استقرارهای نسخه شده را منتقل کنید. اگر مالکیت یک پروژه اسکریپت را به شخصی منتقل کنید، مالک نسخه‌های موجود در پروژه تغییر نمی‌کند. اگر یک سرپرست حساب مالک استقرار را حذف کند، ممکن است با خطاهای اسکریپت برای استقرار آنها مواجه شوید.
یک استقرار نسخه شده ایجاد کنید
برای استقرار نسخه‌ای از افزونه Google Workspace، افزونه ویرایشگر، برنامه Google Chat یا یک API قابل اجرایی، ابتدا باید ارتباط پروژه Google Cloud در Apps Script خود را از پروژه پیش‌فرض به یک پروژه استاندارد تغییر دهید .
برای ایجاد یک استقرار نسخه شده، این مراحل را دنبال کنید:
- پروژه Apps Script را باز کنید.
- در بالا سمت چپ، روی Deploy > Deployment جدید کلیک کنید.
- در کنار انتخاب نوع، روی فعال کردن انواع استقرار کلیک کنید.
- نوع استقرار مورد نظر برای استقرار را انتخاب کنید. برای برنامه‌های Google Workspace، افزونه‌های ویرایشگر، و Google Chat، Add-on را انتخاب کنید.
اطلاعات مربوط به استقرار خود را وارد کنید و روی Deploy کلیک کنید.
مشاهده استقرارهای نسخه شده
برای مشاهده استقرارهای پروژه Apps Script، در بالا، روی Deploy > Manage Deployments کلیک کنید.
برای مشاهده کد یک نسخه خاص، به مشاهده نسخه قبلی مراجعه کنید.
یک استقرار نسخه شده را ویرایش کنید
می توانید یک استقرار نسخه شده را ویرایش کنید تا توضیحات یا نسخه آن را تغییر دهید. برای ویرایش یک استقرار، مراحل زیر را دنبال کنید:
- پروژه Apps Script را باز کنید.
- روی Deploy > Manage Deployments کلیک کنید.
- استقرار فعالی را که می خواهید تغییر دهید انتخاب کنید و روی ویرایش کلیک کنید.
تغییرات خود را انجام دهید و روی Deploy کلیک کنید.
اگر می خواهید یک استقرار بایگانی شده را ویرایش کنید، باید آن را مجدداً گسترش دهید، سپس مراحل قبل را دنبال کنید.
هنگامی که می خواهید تغییری در کد پروژه اعمال کنید، یک نسخه جدید ایجاد کنید و استقرار را برای استفاده از آن ویرایش کنید. نسخه جدید به طور خودکار توسط هر کاربری که از آن استقرار استفاده می کند استفاده می شود.
شناسه استقرار را پیدا کنید
هر استقرار یک شناسه رشته مرتبط به طور خودکار برای آن ایجاد می شود. برای پیدا کردن این شناسه مراحل زیر را دنبال کنید:
- پروژه Apps Script را باز کنید.
- در بالا سمت چپ، روی Deploy > Manage Deployments کلیک کنید.
یک استقرار فعال را برای پیدا کردن شناسه آن انتخاب کنید.
شناسه‌های استقرار فقط در استقرارهای فعال ظاهر می‌شوند.
یک استقرار را آزمایش کنید
نحوه آزمایش استقرار به نوع برنامه ای که می سازید بستگی دارد.
افزونه Google Workspace
برای آزمایش استقرار افزونه Google Workspace، به آزمایش افزونه‌های Google Workspace مراجعه کنید.
افزودنی ویرایشگر
برای آزمایش استقرار افزونه ویرایشگر، به تست افزونه ویرایشگر مراجعه کنید.
برنامه وب
برای آزمایش استقرار برنامه وب، به آزمایش استقرار برنامه وب مراجعه کنید.
برنامه چت گوگل
برای آزمایش استقرار یک برنامه Chat، ابتدا باید یک استقرار نسخه‌ای از اسکریپت ایجاد کنید تا به شناسه استقرار آن دسترسی داشته باشید.
پس از دریافت شناسه استقرار، مراحل را برای فعال کردن Google Chat API دنبال کنید. در صفحه پیکربندی در بخش «مجوزها»، فقط آدرس ایمیل خود را مشخص کنید تا بتوانید برنامه خود را نصب و آزمایش کنید.
API قابل اجرا
برای آزمایش یک استقرار اجرایی API، ابتدا باید یک استقرار نسخه شده ایجاد کنید . پس از ایجاد استقرار، مراحل زیر را دنبال کنید:
- در سمت راست بالای پروژه Apps Script، روی Deploy > Test Deployments کلیک کنید.
- در کنار «انتخاب نوع»، روی فعال کردن انواع استقرار کلیک کنید
> API اجرایی - URL را برای آزمایش استقرار API Executable خود کپی کرده و از آن استفاده کنید.
یک استقرار نسخه شده را بایگانی کنید
شما نمی توانید استقرارهای نسخه شده را حذف کنید. در عوض، می توانید آنها را بایگانی کنید.
برای بایگانی یک استقرار نسخه شده:
- پروژه Apps Script را باز کنید.
- روی Deploy > Manage Deployments کلیک کنید.
- استقرار مورد نظر برای بایگانی را انتخاب کنید و روی Archive Deployment کلیک کنید.
یک استقرار بایگانی شده را مجدداً مستقر کنید
- پروژه Apps Script را باز کنید.
- در بالا سمت چپ، روی Deploy > Manage Deployments کلیک کنید.
- در سمت چپ زیر بایگانی شده ، استقراری را که می خواهید مجدداً مستقر کنید انتخاب کنید و روی ویرایش > استقرار کلیک کنید.