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

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

סיכום הפקודות

sudo docker run [--ulimit memlock=64000000 -d --rm -v host-directory:container-directory]
--env environment-variable=variable-value
gcr.io/cloud-ingest/tsop-agent:latest
{--help | --version | --project-id=project-id}
[--agent-pool=pool-name --agent-id-prefix=id-prefix
--creds-file=credential-file --enable-mount-directory
--hostname=hostname
--kerberos-disable-pa-fx-fast
--log-dir=logs-directory
--max-physical-mem=maximum-memory]

אפשרויות Docker

--ulimit memlock=64000000
נעילת הזיכרון המשותף למאגר משותף של Docker, כדי שהוא תמיד יהיה בזיכרון ויהיה אפשר לגשת אליו מכמה סשנים.
-d

הפקודה הזו מפעילה את הקונטיינר של Docker במצב מנותק או ברקע. כך תוכלו להמשיך להנפיק פקודות מהטרמינל של Linux.

מידע נוסף זמין במאמר Detached -d.

--rm

מוחק את הקונטיינר ואת מערכת הקבצים של הקונטיינר כשיוצאים מ-Docker.

מידע נוסף זמין בקטע הסרת המשאבים (--rm).

-v host-directory:container-directory

מציין אמצעי אחסון אחד או יותר למיפוי מהמארח למאגר. כשמשתמשים ב--v, הערכים של host-directory ו-container-directory צריכים להיות זהים, אחרת Storage Transfer Service לא יצליח לאתר את הקבצים להעברה.

מידע נוסף זמין במאמר VOLUME (מערכות קבצים משותפות).

--env environment-variable=variable-value

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

אפשרויות של סוכן

--agent-id-prefix=id-prefix

קידומת אופציונלית שמתווספת למזהה הסוכן כדי לעזור לזהות את הסוכן או את המכונה שלו במסוף Google Cloud . כשמשתמשים בקידומת, מזהה הנציג מופיע בפורמט prefix + hostname + Docker container ID.

--agent-pool=pool-name

מאגר הסוכנים שאליו רוצים להוסיף את הסוכן. אם לא מציינים מאגר, הנציג מצטרף למאגר transfer_service_default.

--creds-file=credential-file

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

--enable-mount-directory

ההגדרה הזו מציינת לסוכן שכל מערכת הקבצים של המארח מותקנת ב-/transfer_root במאגר. צריך להשתמש בו רק יחד עם -v /:/transfer_root, במקום -v volume mounts של Docker. הסוכן מוסיף את /transfer_root בתחילת הנתיבים של המקור, היעד, היומן ופרטי הכניסה, והערך /transfer_root לא מופיע ביומני ההעברה או בדוגמאות של השגיאות.

--help

הצגת עזרה קצרה לגבי השימוש.

--hostname=hostname

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

--kerberos-disable-pa-fx-fast

ההגדרה מונעת מהסוכנים להשתמש במשא ומתן FAST עם Kerberos להעברות HDFS. צריך להשתמש בדגל הזה אם המרכז להקצאת מפתחות (KDC) של Kerberos לא תומך במשא ומתן של FAST.

--log-dir=logs-directory

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

--max-physical-mem=maximum-memory

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

ערך של max-physical-mem הגדרת הזיכרון המקסימלי
6g ‫6 גיבי-בייט
6gb ‫6 גיבי-בייט
6GiB ‫6 גיבי-בייט
--project-id=project-id

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

--version

הגרסה הנוכחית של הנציג.