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

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

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

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

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

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

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

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

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

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

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

מסוף Google Cloud

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

    כניסה לדף Agent pools

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

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

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

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

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

‫API בארכיטקטורת REST

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

POST https://storagetransfer./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 לשנייה. אם לא מציינים את הדגל הזה, הנציגים במאגר הזה ישתמשו בכל רוחב הפס שזמין להם.

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

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

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

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

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

מסוף Google Cloud

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

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

  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.

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

‫API בארכיטקטורת REST

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

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

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

PATCH https://storagetransfer./v1/projects/PROJECT_ID/agentPools/AGENT_POOL?updateMask=displayName
{
"displayName": "NEW_DISPLAY_NAME"
}

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

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

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

PATCH https://storagetransfer./v1/projects/PROJECT_ID/agentPools/AGENT_POOL?updateMask=bandwidthLimit
{
"bandwidthLimit": {
  "limitMbps": "NEW_LIMIT"
}
}

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

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

‫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./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 ולוחצים על הכרטיסייה Transfer jobs.

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

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

מסוף Google Cloud

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

כניסה לדף Agent pools

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

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

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

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

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

‫API בארכיטקטורת REST

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

GET https://storagetransfer./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./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