הגדרת תוכנת ההתקנה ו-Docker
במאמר הזה מוסבר איך להגדיר סוכן, כולל איך להציג ולשנות את אפשרויות ההגדרה. בנוסף, מוסבר איך לקבוע את ההגדרות לשרת proxy לתקשורת בין הסוכן לבעל התוכן הדיגיטלי וגם לשילובים.
ניהול ההגדרות של הסוכן המרוחק
כדי לערוך שינויים בנציג, פועלים לפי השלבים הבאים:
- נכנסים למכונת הסוכן באמצעות SSH.
- עוברים לספרייה
/home/siemplify_agent/agent_source. אם אתם משתמשים ב-Docker, ודאו שאתם בתוך הקונטיינר. - מריצים את הפקודה הבאה כדי לראות את כל אפשרויות ההגדרה העיקריות של הכלי
cli:python agent_cli.py -h
מריצים את הפקודה
printenvכדי לבדוק את הערכים הנוכחיים של מערכי ההגדרות האישיות שבהם אתם משתמשים. כדי לשנות את הערך של אפשרות הגדרה ראשית אחת, משתמשים בפורמט
set_option:- משתמשים בפקודה
update_environmentכדי לשנות קבוצה רחבה יותר של הגדרות שמאוחסנות כמשתני סביבה:- מציגים את רשימת משתני הסביבה שאפשר לשנות:
- משנים את הערך של אחת מההגדרות האלה:
python agent_cli.py update_environment -h
python agent_cli.py update_environment VARIABLE_NAME VALUE
לדוגמה:
python agent_cli.py update_environment_status RETRANSMISSION_LOOP_INTERVAL_SECONDS 30
python agent_cli.py set_verify_ssl_slave false
משתני סביבה של Remote Agent
בטבלה הבאה מפורט מידע על משתני הסביבה שאפשר להגדיר באמצעות הפקודה python agent_cli.py update_environment:
| אפשרות | תיאור | ערכים |
|---|---|---|
TASK_TIMEOUT |
הגדרת הזמן הקצוב לתפוגה (בשניות) למשימות שהסוכן משך אבל לא ביצע. | זמן (בשניות) |
SERVER_API_ROOT |
כתובת השרת הראשית של Publisher API. מגדיר מאיפה הסוכן שולף משימות ולאן הוא מפרסם את התוצאות. אם מדיניות חומת האש שלכם לא מאפשרת רשומות של דומיינים עם תווים כלליים לחיפוש, אתם יכולים להשתמש בשם המארח הזה של Publisher, שספציפי לדייר, בכללי רשימת ההיתרים של התנועה היוצאת. מידע נוסף זמין במאמר דרישות הרשת וחומת האש. | כתובת ה-API |
SERVER_API_TOKEN |
אסימון האימות שמשמש לכל הבקשות שנשלחות אל בעל האפליקציה. | טוקן API של השרת (מחרוזת) |
VERIFY_SSL |
ההגדרה קובעת אם הסוכן חייב להתחבר ל-Publisher רק אם הוא מציג אישור SSL חתום. | ערך בוליאני (True או False) |
RETRANSMISSION_LOOP_INTERVAL_SECONDS |
מגדירה את משך ההשהיה (בשניות) בין הבדיקות כדי לוודא שהמוציא לאור קיבל את ה-CASE_ACK של חבילת המחבר. |
זמן (בשניות) |
RETRANSMISSION_SAVE_PERIOD_DAYS |
משך הזמן המקסימלי (בימים) שחבילת מחבר יכולה להישאר בתיקיית השידור החוזר לפני שהיא נמחקת, בהנחה שה-CASE_ACK לא התקבל. |
זמן (בימים) |
RETRANSMISSION_FOLDER_MAX_SIZE_MB |
הגודל המקסימלי (במגה-בייט) של תיקיית השידור החוזר, שאחריו הנציג מתחיל למחוק את חבילות המחברים הישנות ביותר כדי לא לחרוג מהגבול. | גודל (MB) |
VERIFY_SSL_SLAVE |
אם הערך הוא True, הסוכן דורש שלבעל התוכן הדיגיטלי המשני יהיה אישור SSL חתום לפני יצירת התקשורת. |
ערך בוליאני (True או False) |
PROXY_ADDRESS |
כתובת ה-IP של שרת ה-proxy שבו הסוכן משתמש כדי לתקשר עם ה-Publisher הראשי. | כתובת ה-IP של שרת ה-Proxy |
AGENT_KEY |
מפתח מוצפן שבו הסוכן משתמש כדי לפענח חבילות שנשלפו מהמוציא לאור, ולהצפין את התוצאות לפני שהן מתפרסמות בחזרה. | מפתח מוצפן של הנציג |
SERVER_API_ROOT_SLAVE |
כתובת שרת ה-API המשני של Publisher, שממנו הסוכן שולף משימות ואליו הוא מפרסם תוצאות. | כתובת ה-API |
PROXY_ADDRESS_SLAVE |
כתובת ה-IP של שרת ה-proxy שבו הסוכן משתמש כדי לתקשר עם בעל התוכן הדיגיטלי המשני. | כתובת ה-IP של שרת ה-Proxy |
DEPLOYMENT_TYPE |
מציין את שיטת ההתקנה שבה השתמשו בשביל הסוכן. | Docker או Installer (מחרוזת) |
הגדרת שרת proxy ל-Agent-Publisher
מגדירים שרת proxy שיטפל בכל התקשורת בין שירות Remote Agent לבין Publisher. ההגדרה הזו רלוונטית רק לערוץ התקשורת בין הסוכן ל-Publisher.
כדי להגדיר שרת proxy ל-Agent-Publisher:
- מריצים את הפקודה
update_environmentבמכונה של הסוכן כדי להגדיר שרת proxy בסוכן קיים שנפרס: - מורידים את החבילה ואז עורכים את הקובץ
.envכדי לכלול את כתובת ה-Proxy: - מוסיפים את כתובת ה-proxy כמשתנה סביבה (`-e`) לפקודת Docker לפני שמריצים את הפריסה:
python3 /opt/SiemplifyAgent/agent_cli.py update_environment PROXY_ADDRESS https://{proxy_host}
PROXY_ADDRESS=https://{proxy_host}
-e PROXY_ADDRESS=https://{proxy_host}.
הגדרת שרת proxy לשילוב
ההליך הזה מגדיר את הגדרות לשרת proxy לשילובים שפועלים ב-Remote Agent, ומוודא שתנועת השילוב מנותבת דרך שרת ה-proxy שצוין.
כדי להגדיר שרת proxy לשילוב, מוסיפים את המשתנים הנדרשים לסביבה של הנציג לפני שמריצים את הפקודה של Docker:
| משתנה | תיאור | דוגמה |
|---|---|---|
HTTP_PROXY |
כתובת שרת proxy לבקשות HTTP | https://{HTTP_PROXY} |
HTTPS_PROXY |
כתובת שרת ה-proxy לבקשות HTTPS | https://{HTTPS_PROXY} |
NO_PROXY |
רשימה מופרדת בפסיקים של שמות מארחים או כתובות IP שיעקפו את הניתוב של שרת ה-Proxy | https://{NO_PROXY} |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.