מחיקת סיכום המסמך שנוצר על ידי AI גנרטיבי

Last reviewed 2023-07-21 UTC

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

אזהרה: האפליקציות של פתרונות התחלתיים כבר לא מתוחזקות. במקום זאת, כדאי להשתמש ב-Application Design Center, שמאפשר לתכנן ולפרוס אפליקציות ב- Google Cloud.

עלות

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

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

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

• המיקומים ב- Google Cloud שבהם המשאבים נפרסים.
• משך הזמן שבו נעשה שימוש במשאבים.

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

• כמות הנתונים שמאוחסנים ב-Cloud Storage.
• מספר הפעמים שהופעלה האפליקציה לסיכום המסמך.

קבלת הרשאות ה-IAM הנדרשות

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

נדרשת הרשאת IAM	תפקיד מוגדר מראש שכולל את ההרשאות הנדרשות
serviceusage.services.enable	אדמין של Service Usage (roles/serviceusage.serviceUsageAdmin)
iam.serviceAccounts.create	אדמין בחשבון שירות (roles/iam.serviceAccountAdmin)
resourcemanager.projects.setIamPolicy	אדמין IAM בפרויקט (roles/resourcemanager.projectIamAdmin)
config.deployments.create config.deployments.list	אדמין של Cloud Infrastructure Manager (roles/config.admin)

חשבון שירות שנוצר בשביל הפתרון

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

לראות את התפקידים שהוקצו לחשבון השירות

התפקידים האלה מפורטים כאן למקרה שאדמין של הפרויקט או הארגון שלכם ב-Google Cloud יזדקק למידע הזה.

• roles/clouddeploymentmanager.serviceAgent
• roles/cloudfunctions.serviceAgent
• roles/config.agent
• roles/documentai.editor
• roles/resourcemanager.projectIamAdmin
• roles/serviceusage.serviceUsageViewer

מחיקת הפריסה

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

מחיקה דרך המסוף

אם פרסתם את הפתרון דרך המסוף, השתמשו בתהליך הזה.

1. נכנסים לדף Solution deployments במסוף Google Cloud .

   מעבר אל פריסות של פתרונות

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

3. מאתרים את הפריסה שרוצים למחוק.

4. בשורה של הפריסה, לוחצים על Actions ובוחרים באפשרות Delete.

   יכול להיות שתצטרכו לגלול כדי לראות את האפשרות פעולות בשורה.

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

   בשדה Status מופיע הערך Deleting.

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

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

מחיקה באמצעות Terraform CLI

אם פרסתם את הפתרון באמצעות Terraform CLI, השתמשו בתהליך הזה.

1. ב-Cloud Shell, מוודאים שספריית העבודה הנוכחית היא $HOME/cloudshell_open/terraform-gen-ai-document-summarization/. אם לא, עוברים לספרייה הזו.

2. מסירים את המשאבים שהוקצו על ידי Terraform:

   terraform destroy
   

   ב-Terraform תוצג רשימה של המשאבים שיוסרו.

3. כשמופיעה בקשה לבצע את הפעולות, מזינים yes.

   ב-Terraform מוצגות הודעות על ההתקדמות. אחרי שכל המשאבים נמחקים, Terraform מציגה את ההודעה הבאה:

   Destroy complete!
   

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

כשכבר לא צריך את הפרויקט ב- Google Cloud ששימש לפתרון, אפשר למחוק אותו. מידע נוסף זמין במאמר אופציונלי: מחיקת הפרויקט.

אופציונלי: מחיקת הפרויקט

אם פרסתם את הפתרון בפרויקט חדש ב- Google Cloud ואתם לא צריכים יותר את הפרויקט, אתם יכולים למחוק אותו:

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

1. במסוף Google Cloud , נכנסים לדף Manage resources.

   כניסה לדף Manage resources

2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
3. בהודעה שמופיעה, מקלידים את מזהה הפרויקט ולוחצים על Shut down.

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

אופציונלי: מחיקת חשבון השירות

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

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

• אם פרסתם את הפתרון דרך מסוף Google Cloud , עוברים לדף Solution deployments. (אם כבר נמצאים בדף הזה, צריך לרענן את הדפדפן). ברקע מופעל תהליך למחיקת חשבון השירות. לא נדרשת פעולה נוספת.

• אם פרסתם את הפתרון באמצעות Terraform CLI, בצעו את השלבים הבאים:

  1. נכנסים לדף Service accounts במסוף Google Cloud .

     כניסה לדף Service accounts

  2. בוחרים את הפרויקט שבו השתמשתם לפתרון.

  3. בוחרים את חשבון השירות שרוצים למחוק.

     מזהה האימייל של חשבון השירות שנוצר עבור הפתרון הוא בפורמט הבא:

     goog-sc-DEPLOYMENT_NAME-NNN@PROJECT_ID.iam.gserviceaccount.com
     

     מזהה האימייל מכיל את הערכים הבאים:

     • ‫DEPLOYMENT_NAME: שם הפריסה.
     • ‫NNN: מספר אקראי בן 3 ספרות.
     • ‫PROJECT_ID: המזהה של הפרויקט שבו פרסתם את הפתרון.

  4. לוחצים על Delete.

פתרון בעיות

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

שגיאה במחיקת פריסה

במקרים מסוימים, ניסיונות למחוק פריסה עלולים להיכשל:

• אחרי פריסת פתרון דרך המסוף, אם משנים משאב כלשהו שהוקצה על ידי הפתרון, ואז מנסים למחוק את הפריסה, יכול להיות שהמחיקה תיכשל. בשדה סטטוס בדף פריסות של פתרונות מופיע הערך נכשל, ובלוג של Cloud Build מופיע הגורם לשגיאה.
• אחרי פריסת פתרון באמצעות Terraform CLI, אם משנים משאב כלשהו באמצעות ממשק שאינו Terraform (לדוגמה, המסוף), ואז מנסים למחוק את הפריסה, יכול להיות שהמחיקה תיכשל. ההודעות בפלט של הפקודה terraform destroy מציגות את הסיבה לשגיאה.

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

אם פריסה שמבוססת על המסוף לא נמחקת ואם אי אפשר לאבחן את השגיאה באמצעות יומן Cloud Build, אפשר למחוק את הפריסה באמצעות Terraform CLI, כמו שמתואר בקטע הבא.

מחיקת פריסה שמבוססת על המסוף באמצעות Terraform CLI

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

1. מזהים את האזור שבו מאוחסנים קוד ה-Terraform, היומנים ונתונים אחרים של הפריסה. יכול להיות שהאזור הזה יהיה שונה מהאזור שבחרתם כשפרסתם את הפתרון.

   1. נכנסים לדף Solution deployments במסוף Google Cloud .

      מעבר אל פריסות של פתרונות

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

   3. ברשימת הפריסות, מאתרים את השורה של הפריסה שרוצים למחוק.

   4. לוחצים על הצגת כל התוכן בשורה.

   5. בעמודה מיקום, שימו לב למיקום השני, כפי שמודגש בדוגמה הבאה:

      

2. במסוף Google Cloud , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

3. יוצרים משתני סביבה למזהה הפרויקט, לאזור ולשם של הפריסה שרוצים למחוק:

   export REGION="REGION"
   export PROJECT_ID="PROJECT_ID"
   export DEPLOYMENT_NAME="DEPLOYMENT_NAME"
   

   בפקודות האלה, מחליפים את מה שכתוב בשדות הבאים:

   • ‫REGION: המיקום שרשמתם קודם בהליך הזה.
   • ‫PROJECT_ID: מזהה הפרויקט שבו פרסתם את הפתרון.
   • ‫DEPLOYMENT_NAME: השם של הפריסה שרוצים למחוק.

4. מאתרים את המזהה של הגרסה האחרונה של הפריסה שרוצים למחוק:

   export REVISION_ID=$(curl \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
       | jq .latestRevision -r)
       echo $REVISION_ID
   

   הפלט אמור להיראות כך:

   projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME/revisions/r-0
   

5. מאתרים את המיקום ב-Cloud Storage של קובץ התצורה של Terraform לפריסה:

   export CONTENT_PATH=$(curl \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       "https://config.googleapis.com/v1alpha2/${REVISION_ID}" \
       | jq .applyResults.content -r)
       echo $CONTENT_PATH
   

   הדוגמה הבאה היא של הפלט שמתקבל מהפקודה הזו:

   gs://PROJECT_ID-REGION-blueprint-config/DEPLOYMENT_NAME/r-0/apply_results/content
   

6. מורידים את קובץ התצורה של Terraform מ-Cloud Storage אל Cloud Shell:

   gcloud storage cp $CONTENT_PATH $HOME --recursive
   cd $HOME/content/
   

   מחכים עד שההודעה Operation completed תוצג, כמו בדוגמה הבאה:

   Operation completed over 45 objects/268.5 KiB
   

7. מאתחלים את Terraform:

   terraform init
   

   מחכים עד שמופיעה ההודעה הבאה:

   Terraform has been successfully initialized!
   

8. מסירים את המשאבים שנפרסו:

   terraform destroy
   

   ב-Terraform תוצג רשימה של המשאבים שיוסרו.

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

9. כשמופיעה בקשה לבצע את הפעולות, מזינים yes.

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

   Destroy complete!
   

10. מוחקים את פריט המידע שנוצר בתהליך הפיתוח (Artifact) של הפריסה:

    curl -X DELETE \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}?force=true&delete_policy=abandon"
    

11. ממתינים כמה שניות ואז מוודאים שפריט הפריסה נמחק:

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
        | jq .error.message
    

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

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

    Resource 'projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME' was not found
    

המאמרים הבאים

• מידע נוסף על Application Design Center
• מידע נוסף על AI גנרטיבי ב-Vertex AI
• במאמר נקודת המבט של AI ו-ML ב-Well-Architected Framework מופיעה סקירה כללית של עקרונות והמלצות לארכיטקטורה שספציפיים לעומסי עבודה של AI ו-ML ב- Google Cloud.