ניהול מאגרי סוכנים

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

כל הנציגים חייבים להיות חלק ממאגר נציגים.

במדריך הזה מוסבר איך משתמשים במאגרי סוכנים.

לפני שמתחילים

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

אתם יכולים לראות את ההרשאות הנוכחיות שלכם.

כדי להשתמש בפקודות gcloud, צריך להתקין את כלי שורת הפקודה של Google Cloud.

יצירת מאגר סוכנים

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

כדי ליצור מאגר סוכנים:

מסוף Google Cloud

  1. נכנסים לדף Agent pools במסוף Google Cloud .

    כניסה לדף Agent pools

    מוצג הדף מאגרי סוכנים עם רשימה של מאגרי הסוכנים הקיימים.

  2. לוחצים על יצירת מאגר נוסף.

  3. נותנים שם למאגר, ואפשר גם להוסיף תיאור.

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

  5. לוחצים על יצירה.

API ל-REST

שימוש ב-projects.agentPools.create:

POST https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools?agent_pool_id=AGENT_POOL_ID

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

  • ‫PROJECT_ID: מזהה הפרויקט שבו אתם יוצרים את מאגר הסוכנים.
  • ‫AGENT_POOL_ID: המזהה של מאגר הסוכנים שאתם יוצרים.

אם מאגר סוכנים נתקע במצב Creating למשך יותר מ-30 דקות, מומלץ למחוק את מאגר הסוכנים וליצור אותו מחדש.

ביטול ההרשאות הנדרשות של Storage Transfer Service מפרויקט בזמן שמאגר סוכנים נמצא במצב Creating מוביל להתנהגות שגויה של השירות.

‫CLI של gcloud

כדי ליצור מאגר סוכנים באמצעות הכלי gcloud של שורת הפקודה, מריצים את הפקודה gcloud transfer agent-pools create.

gcloud transfer agent-pools create AGENT_POOL

אלה האפשרויות הזמינות:

  • ‫AGENT_POOL הוא מזהה ייחודי וקבוע של מאגר המשאבים.

  • ‫--no-async חוסם משימות אחרות במסוף עד ליצירת המאגר. אם לא מציינים את האפשרות הזו, יצירת המאגר תתבצע באופן אסינכרוני.

  • ‫--bandwidth-limit מגדיר כמה מרוחב הפס שלכם ב-MB/s יהיה זמין לסוכנים בבריכה הזו. מגבלת רוחב פס חלה על כל הסוכנים במאגר, ויכולה לעזור למנוע שיבוש של עומס העבודה של ההעברה במאגר, בפעולות אחרות שמשתמשות ברוחב הפס שלכם. לדוגמה, מזינים '50' כדי להגדיר מגבלת רוחב פס של 50MB/s. אם לא מציינים את הדגל הזה, הסוכנים במאגר הזה ישתמשו בכל רוחב הפס שזמין להם.

  • ‫--display-name הוא שם שאפשר לשנות כדי לעזור לכם לזהות את המאגר הזה. אפשר לכלול פרטים שלא מתאימים לשם המלא הייחודי של המשאב במאגר.

הקצאת סוכנים למאגר

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

אם לא מציינים מאגר סוכנים, הסוכן מוקצה למאגר transfer_service_default.

כדי ליצור סוכן ולהקצות אותו למאגר:

מסוף Google Cloud

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

  2. לוחצים על התקנת נציג. יופיע מדריך להתקנת הסוכן.

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

‫CLI של gcloud

כדי להשתמש בכלי שורת הפקודה gcloud כדי ליצור סוכן ולהקצות אותו למאגר, מריצים את הפקודה gcloud transfer agents install. הסוכן צריך להיות מותקן במכונה עם גישת root למערכת הקבצים.

gcloud transfer agents install --pool=AGENT_POOL

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

export AWS_ACCESS_KEY_ID=ID
export AWS_SECRET_ACCESS_KEY=SECRET
gcloud transfer agents install --pool=AGENT_POOL

פרטים נוספים זמינים במאמר בנושא ניהול סוכני העברה.

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

מידע נוסף על ניהול סוכנים זמין במאמר בנושא ניהול סוכני העברה.

הקצאת מאגר סוכנים למשרה

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

עדכון מאגר סוכנים

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

כדי לעדכן מאגר סוכנים:

מסוף Google Cloud

נכנסים לדף Agent pools במסוף Google Cloud .

כניסה לדף Agent pools

אפשר לערוך את הפריטים הבאים:

  • השם המוצג של מאגר הנציגים: לוחצים על Edit לצד השם הנוכחי של Agent pool.

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

API ל-REST

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

לדוגמה, כדי לעדכן את הערך displayName ל-my-transfer, צריך לספק את אנונימיזציית השדה "displayName,my-transfer".

דוגמה לבקשת תיקון לעדכון השם לתצוגה:

PATCH https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL:"displayName,NEW_DISPLAY_NAME"

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

  • ‫PROJECT_ID: מזהה הפרויקט שבו אתם מעדכנים את מאגר הסוכנים.
  • ‫AGENT_POOL: שם מאגר הסוכנים שרוצים לעדכן.
  • ‫NEW_DISPLAY_NAME: השם המוצג החדש של מאגר הסוכנים.

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

PATCH https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL:"bandwidthLimit,NEW_LIMIT"

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

  • ‫PROJECT_ID: מזהה הפרויקט שבו אתם מעדכנים את מאגר הסוכנים.
  • ‫AGENT_POOL: המזהה של מאגר הסוכנים שאתם מעדכנים.
  • ‫NEW_LIMIT: מגבלת רוחב הפס החדשה של מאגר הסוכנים הזה.

‫CLI של gcloud

כדי להשתמש בכלי gcloud משורת הפקודה כדי לעדכן מאגר סוכנים, מריצים את הפקודה gcloud transfer agent-pools update.

gcloud transfer agent-pools update AGENT_POOL \
  [--bandwidth-limit=NEW_BANDWIDTH_LIMIT] [--clear-bandwidth-limit] \
  [--clear-display-name] [--display-name=NEW_DISPLAY_NAME]

חובה לציין את הארגומנט הבא:

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

אפשר לציין את הדגלים הבאים עם הפקודה הזו:

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

  • אפשר לעדכן את --display-name או למחוק אותו באמצעות הדגל --clear-display-name.

מחיקת מאגר נציגים

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

כדי למחוק מאגר סוכנים:

מסוף Google Cloud

  1. נכנסים לדף Agent pools במסוף Google Cloud .

    כניסה לדף Agent pools

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

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

API ל-REST

משתמשים ב-projects.agentPools.delete:

DELETE https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL

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

  • ‫PROJECT_ID: מזהה הפרויקט שממנו אתם מוחקים את מאגר הסוכנים.
  • ‫AGENT_POOL: שם מאגר הסוכנים.

‫CLI של gcloud

כדי להשתמש בכלי gcloud משורת הפקודה כדי למחוק מאגר סוכנים, מריצים את הפקודה gcloud transfer agent-pools delete.

gcloud transfer agent-pools delete AGENT_POOL

חובה לציין את הארגומנט הבא:

  • ‫AGENT_POOL הוא המזהה הייחודי והקבוע של מאגר המשאבים הזה.

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

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

קבלת מאגר סוכנים

כדי לקבל מאגר סוכנים:

מסוף Google Cloud

נכנסים לדף Agent pools במסוף Google Cloud .

כניסה לדף Agent pools

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

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

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

בדף המידע של מאגר נציגים אפשר לבצע את הפעולות הבאות:

  • התקנת סוכן: מוצגות הוראות להתקנת סוכני העברה.
  • עצירת סוכן: בוחרים סוכן בטבלה ולוחצים על עצירת הסוכן.
  • הצגת רשימה של משימות העברה: לוחצים על Transfer Jobs כדי להציג את משימות ההעברה שאליהן מחוברים סוכני ההעברה במאגר הזה.

API ל-REST

משתמשים ב-projects.agentPools.get:

GET https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL

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

  • ‫PROJECT_ID: מזהה הפרויקט שאתם מקבלים עבורו מאגר סוכנים.
  • ‫AGENT_POOL: מאגר הסוכנים שיש לאחזר.

‫CLI של gcloud

כדי להשתמש בכלי שורת הפקודה gcloud כדי לאחזר מאגר סוכנים, מריצים את הפקודה gcloud transfer agent-pools describe.

gcloud transfer agent-pools describe AGENT_POOL

חובה לציין את הארגומנט הבא:

  • ‫AGENT_POOL הוא המזהה הייחודי והקבוע של מאגר המשאבים הזה.

הצגת רשימה של מאגרי סוכנים

כדי להציג את רשימת מאגרי הסוכנים:

מסוף Google Cloud

נכנסים לדף Agent pools במסוף Google Cloud .

כניסה לדף Agent pools

כל מאגרי הנציגים מוצגים.

API ל-REST

משתמשים ב-projects.agentPools.list:

GET https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools

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

  • ‫PROJECT_ID: מזהה הפרויקט שרוצים להציג בו את רשימת מאגרי הסוכנים.

‫CLI של gcloud

כדי להשתמש בכלי gcloud של שורת הפקודה כדי להציג רשימה של מאגרי סוכנים, מריצים את הפקודה gcloud transfer agent-pools list.

gcloud transfer agent-pools list \
  [--limit=LIMIT] \
  [--names=[NAMES,...]] \
  [--page-size=PAGE_SIZE]

אפשר לציין את הדגלים הבאים עם הפקודה הזו:

  • ‫--limit מגדיר את המספר המקסימלי של מאגרי סוכנים שיוחזרו.

  • ‫--names מציין את השמות של מאגרי הסוכנים שרוצים להציג. אם יש כמה שמות, צריך להפריד ביניהם בפסיקים. לדוגמה, --names=foo,bar. אם לא מציינים את בריכת הסוכנים, מוצגות כל בריכות הסוכנים בפרויקט הנוכחי.

  • ‫--page-size מגדיר את התנהגות האצווה של הפקודה הזו. כברירת מחדל, הפקודה list מחלקת את התגובות לקבוצות של 256 פריטים, ומביאה באופן אוטומטי את הקבוצה הבאה עד שכל הפריטים מופיעים או עד שמגיעים ל-limit.

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

name: projects/my-project-123/agentPools/my-first-pool
state: CREATED
---
bandwidthLimit:
  limitMbps: '120'
displayName: Source A to destination Z.
name: projects/my-project-123/agentPools/a2z-pool
state: CREATED