מאגר סוכנים הוא אוסף של סוכנים שמשתמשים באותה הגדרה, עם גישה אחידה ורמת חשיפה אחידה למקור וליעד. מאגרי נציגים גם מאפשרים לשלוט במגבלות רוחב הפס של ההעברה.
כל הנציגים חייבים להיות שייכים למאגר נציגים.
במדריך הזה מוסבר איך להשתמש במאגרי סוכנים.
לפני שמתחילים
כדי לעבוד עם מאגרי סוכנים, צריכות להיות לכם ההרשאות המתאימות בפרויקט. למידע נוסף, קראו את המאמר בקרת גישה באמצעות IAM.
אתם יכולים לראות את ההרשאות הנוכחיות שלכם.
כדי להשתמש בפקודות של gcloud, צריך להתקין את כלי שורת הפקודה של Google Cloud.
יצירת מאגר של סוכנים
כדי ליצור מאגר של סוכנים:
מסוף Google Cloud
נכנסים לדף Agent pools במסוף Google Cloud .
מופיע הדף Agent pools, שבו מוצגת רשימה של מאגרי הסוכנים הקיימים.
לוחצים על יצירת מאגר נוסף.
נותנים שם למאגר, ואפשר גם להוסיף תיאור.
אתם יכולים להגדיר מגבלת רוחב פס שתחול על כל המאגר. רוחב הפס שצוין ב-MB/s יחולק בין כל הנציגים במאגר. מידע נוסף זמין במאמר ניהול רוחב הפס של הרשת.
לוחצים על יצירה.
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
בדף Agent pools, בוחרים את מאגר הסוכנים שאליו רוצים להקצות את הסוכנים.
לוחצים על התקנת הסוכן. מופיע המדריך להתקנת Agent.
פועלים לפי ההוראות ליצירת הסוכן במאגר הסוכנים הזה.
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 .
אפשר לערוך את הפריטים הבאים:
השם המוצג של מאגר הנציגים: לוחצים על 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
נכנסים לדף Agent pools במסוף Google Cloud .
לוחצים על מחיקה. קוראים את ההודעה בחלון הקופץ ולוחצים על מחיקה כדי לאשר.
אם לחצן המחיקה לא פעיל, צריך לעצור את כל הסוכנים והמשימות שמשויכים למאגר הזה.
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 .
בדף מוצגת רשימה של כל מאגרי הסוכנים שמשויכים לפרויקט, והמידע הבא על כל מאגר סוכנים:
- שם מאגר הנציגים
- סטטוס החיבור
- מספר הנציגים המחוברים
- מגבלת רוחב הפס, אם הוגדרה
- מספר משימות ההעברה המשויכות
- השם המוצג של מאגר הנציגים
כדי לראות מאגר ספציפי של סוכנים, לוחצים על 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 .
כל מאגרי הנציגים מוצגים.
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