יצירה וניהול של פריסות

פריסת פרויקט ב-Apps Script היא גרסה של הסקריפט שזמין לשימוש כאפליקציית אינטרנט, כתוסף או כהפעלה של API. באמצעות יצירה וניהול של פריסות, אפשר לבצע איטרציה של הקוד, לעקוב אחרי השינויים ולשלוט בגרסת הקוד המדויקת שהמשתמשים יכולים לגשת אליה.

יש שני סוגים של פריסות:

• פריסות ראשיות, שמסונכרנות תמיד עם קוד הפרויקט הנוכחי.
• פריסות בגרסאות שמחוברות לגרסת פרויקט ספציפית.

פריסות ראשיות

פריסת ראש היא קוד הפרויקט הנוכחי. כשיוצרים פרויקט ב-Apps Script, יוצרים באופן אוטומטי פריסה ראשית (head) של הפרויקט.

פריסת הראש תמיד מסונכרנת עם הקוד האחרון שנשמר. לדוגמה, אם יוצרים פריסה עם גרסאות ואז משנים את הקוד, הפריסה הראשית משקפת את השינויים, אבל הפריסה של הגרסאות נשארת ללא שינוי.

שימוש בפריסות ראשיות לבדיקת קוד. אין להשתמש בפריסות ראשיות לשימוש ציבורי.

הערה: לכל פרויקט ב-Apps Script יש רק פריסה ראשית אחת. כדי להשתמש בפריסת כותרת, צריכה להיות לכם גישת קריאה לפחות לפרויקט הסקריפט.

פריסות שיש להן גרסאות

כשמשתמשים בפריסה עם גרסאות, אפשר לקבל גרסה ספציפית של קוד הפרויקט. כך המשתמשים יוכלו להמשיך להשתמש בגרסה פעילה בזמן שאתם מבצעים שינויים ושיפורים בקוד.

כשהאפליקציה שלכם מפורסמת לצריכה ציבורית, תמיד צריך להשתמש בפריסה עם גרסאות. יכולות להיות כמה פריסות פעילות עם גרסאות בו-זמנית.

חשוב: אי אפשר להעביר בעלות על פריסות של גרסאות. אם מעבירים את הבעלות על פרויקט סקריפט למישהו, הבעלים של הפריסות הקיימות עם הגרסאות בפרויקט לא משתנה. אם אדמין ימחק את החשבון של הבעלים של הפריסה, יכול להיות שיהיו שגיאות בסקריפטים של הפריסות שלו.

יצירת פריסה עם גרסאות

כדי לפרוס גרסה של תוסף ל-Google Workspace, תוסף Editor, אפליקציית Google Chat או ממשק API, צריך קודם לשנות את השיוך של פרויקט ב-Apps Script של Google Cloud מפרויקט ברירת המחדל לפרויקט רגיל.

כדי ליצור פריסה עם גרסאות:

1. פותחים את פרויקט Apps Script.
2. בפינה השמאלית העליונה, לוחצים על פריסה > פריסה חדשה.
3. ליד Select type, לוחצים על EnableDeploy types (הפעלת סוגי פריסה) .
4. בוחרים את סוג הפריסה שרוצים לפרוס. בוחרים באפשרות תוסף כדי להתקין את התוספים ל-Google Workspace, את התוספים ל-Editor ואת האפליקציות של Google Chat.

5. מזינים את פרטי הפריסה ולוחצים על פריסה.

   הערה: אפשר לשתף כל פריסה חדשה כספרייה. אם משתפים את הסקריפט כספרייה, תיאור הפריסה יהיה גלוי למשתמשים בספרייה.

הצגת גרסאות של פריסות

כדי לראות את הפריסות של פרויקט Apps Script, לוחצים למעלה על Deploy > ManageDeploys (ניהול הפריסות).

כדי לצפות בקוד של גרסה ספציפית, אפשר לעיין במאמר צפייה בגרסה קודמת.

עריכת פריסה עם גרסאות

אפשר לערוך פריסה שיש לה גרסאות כדי לשנות את התיאור או הגרסה שלה. כדי לערוך פריסה:

1. פותחים את פרויקט Apps Script.
2. לוחצים על Deploy (פריסה) > ניהול הפריסות.
3. בוחרים את הפריסה הפעילה שרוצים לשנות ולוחצים על סמל העריכה .

4. מבצעים את השינויים הרצויים ולוחצים על פריסה.

   כדי לערוך פריסה שהועברה לארכיון, צריך לפרוס אותה מחדש ולבצע את השלבים הקודמים.

   כשרוצים לפרוס שינוי בקוד הפרויקט, צריך ליצור גרסה חדשה ולערוך את הפריסה כדי להשתמש בה. כל המשתמשים שמשתמשים בפריסה הזו ישתמשו באופן אוטומטי בגרסה החדשה.

איתור מזהה פריסה

לכל פריסה משויך מזהה מחרוזת שנוצר באופן אוטומטי. כדי למצוא את המזהה הזה:

1. פותחים את פרויקט Apps Script.
2. בפינה השמאלית העליונה, לוחצים על פריסה > ניהול פריסות.

3. צריך לבחור פריסה פעילה כדי לאתר את המזהה שלה.

   מזהי פריסה מופיעים רק בפריסות פעילות.

בדיקת פריסה

אופן הבדיקה של הפריסה משתנה בהתאם לסוג האפליקציה שיוצרים.

תוסף ל-Google Workspace

במאמר בדיקת התוספים ל-Google Workspace מוסבר איך בודקים את הפריסה של תוספים ל-Google Workspace.

תוסף עריכה

כדי לבדוק פריסה של תוסף Editor, קראו את המאמר בדיקה של תוסף עריכה.

אפליקציית אינטרנט

כדי לבדוק את הפריסה של אפליקציית אינטרנט, ראו בדיקה של פריסה של אפליקציית אינטרנט.

באפליקציית Google Chat

כדי לבדוק את הפריסה של אפליקציית Chat, צריך קודם ליצור פריסה עם גרסאות של הסקריפט כדי שתהיה לו גישה למזהה הפריסה שלו.

אחרי שמקבלים את מזהה הפריסה, פועלים לפי השלבים להפעלה של Google Chat API. בקטע 'הרשאות' בדף ההגדרות, צריך לציין רק את כתובת האימייל. כדי להתקין ולבדוק את האפליקציה.

הפעלה דרך API

כדי לבדוק פריסה של הפעלה של API, קודם צריך ליצור פריסה עם גרסאות. אחרי שיוצרים את הפריסה:

1. בפינה השמאלית העליונה של פרויקט Apps Script, לוחצים על Deploy > Test Deployments (פריסה > בדיקת פריסות).
2. ליד 'Select type' (בחירת סוג), לוחצים על 'הפעלת סוגי פריסה' > API Executable.
3. צריך להעתיק את כתובת ה-URL ולהשתמש בה כדי לבדוק את פריסת ה-API להפעלה.

העברה לארכיון של פריסה עם גרסאות

אי אפשר למחוק פריסות עם גרסאות. במקום זאת, אפשר להעביר אותם לארכיון.

כדי להעביר לארכיון פריסה עם גרסאות:

1. פותחים את פרויקט Apps Script.
2. לוחצים על Deploy (פריסה) > ניהול הפריסות.
3. בוחרים את הפריסה שרוצים להעביר לארכיון ולוחצים על 'העברת הפריסה לארכיון' .

פריסה מחדש של פריסה שהועברה לארכיון

1. פותחים את פרויקט Apps Script.
2. בפינה השמאלית העליונה, לוחצים על פריסה > ניהול פריסות.
3. בצד שמאל, בקטע Archived, בוחרים את הפריסה שרוצים לפרוס מחדש ולוחצים על סמל העריכה > Deploy.