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

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

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

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

פריסות Head

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

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

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

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

פריסות עם ניהול גרסאות

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

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

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

פריסות לעומת גרסאות

גרסה ופריסה הם שני מושגים שונים ב-Apps Script:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

איך מוצאים מזהה פריסה

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

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

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

בדיקת פריסה

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

תוסף ל-Google Workspace

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

תוסף עריכה

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

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

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

אפליקציית Google Chat

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

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

API Executable

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

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

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

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

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

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

מחיקת גרסה מהיסטוריית הפרויקט

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

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

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

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