הגדרת תוכנת ההתקנה ו-Docker

נתמך ב:

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

ניהול ההגדרות של הסוכן המרוחק

כדי לערוך שינויים בנציג, פועלים לפי השלבים הבאים:

  1. נכנסים למכונת הסוכן באמצעות SSH.
  2. עוברים לספרייה /home/siemplify_agent/agent_source. אם אתם משתמשים ב-Docker, ודאו שאתם בתוך הקונטיינר.
  3. מריצים את הפקודה הבאה כדי לראות את כל אפשרויות ההגדרה העיקריות של הכלי cli:
    python agent_cli.py -h

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

  4. כדי לשנות את הערך של אפשרות הגדרה ראשית אחת, משתמשים בפורמט set_option:

  5. python agent_cli.py set_verify_ssl_slave false
  6. משתמשים בפקודה update_environment כדי לשנות קבוצה רחבה יותר של הגדרות שמאוחסנות כמשתני סביבה:
    1. מציגים את רשימת משתני הסביבה שאפשר לשנות:
    2. python agent_cli.py update_environment -h
    3. משנים את הערך של אחת מההגדרות האלה:
    4. python agent_cli.py update_environment VARIABLE_NAME VALUE

      לדוגמה:

      python agent_cli.py update_environment_status RETRANSMISSION_LOOP_INTERVAL_SECONDS  30

משתני סביבה של 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:

  1. מריצים את הפקודה update_environment במכונה של הסוכן כדי להגדיר שרת proxy בסוכן קיים שנפרס:
  2. python3 /opt/SiemplifyAgent/agent_cli.py update_environment PROXY_ADDRESS https://{proxy_host}
  3. מורידים את החבילה ואז עורכים את הקובץ .env כדי לכלול את כתובת ה-Proxy:
  4. PROXY_ADDRESS=https://{proxy_host}
  5. מוסיפים את כתובת ה-proxy כמשתנה סביבה (`-e`) לפקודת Docker לפני שמריצים את הפריסה:
  6. -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.