עברה ל-`agenteye-collector`

העברה היא לא הרסנית: היא לא גורמת לשום זמן שבות ולא לאובדן נתונים, והיא משחררת את השם הקצר agenteye ל-AgentEye CLI כך שדמון המאספן ו-CLI יכולים להתקיים באותה מכונה. קובץ המאספן קיבל שינוי שם מ-agenteye ל-agenteye-collector. השם הקצר agenteye שייך כעת ל-AgentEye CLI, כלי נפרד לשאילתות על הפעלות, אירועים והערכות מהטרמינל שלך. המדריך הזה מובילך דרך עברה של התקנה קיימת של מאספן.

מה השתנה

	לפני	אחרי
פקודה / קובץ בינארי	`agenteye`	`agenteye-collector`
נתיב התקנה ברירת מחדל	`/usr/local/bin/agenteye`	`/usr/local/bin/agenteye-collector`
תת-פקודות	`start`, `flush`, `health`, `update`	`start`, `flush`, `health`
עדכון עצמי (`agenteye update`)	מובנה	הוסר: הורד את הקובץ הבינארי החדש או שלוף את התמונה החדשה
סקריפט התקנה (`install.sh`)	מסופק	הוסר: הורד את הקובץ הבינארי ישירות (ראה התקנה של מאספן)
`AGENTEYE_TOKEN`	נדרש להורדה וגם לבדיקות עדכון בחזקה	נדרש רק להורדה של קבצים בינאריים/תמונות

התצורה לא השתנתה: אותו ~/.agenteye/config.json, אותם משתני סביבה AGENTEYE_URL / AGENTEYE_KEY / AGENTEYE_HOME / TLS, ואותה ספול ~/.agenteye/events/. לא נדרש שום שינוי בתצורה.

אם אתה מריץ את הקובץ הבינארי שחויה שמו תחת השם הישן agenteye, הוא עדיין עובד אך מדפיס הודעת התיחסות אל שורה אחת ל-stderr שמזכירה לך להחליף ל-agenteye-collector.

לפני שתתחיל

ההתקנה הקיימת שלך של agenteye ממשיכה לרוץ; שום דבר לא נשבר ברגע שאתה משדרג. בצע עברה בתחשבנות, ואחר כך הסר את הקובץ הבינארי הישן בסוף.
עקוב אחר הסדר הזה כדי להימנע מזמן שבות:
1. התקן את הקובץ הבינארי החדש agenteye-collector (או שלוף את התמונה החדשה).
2. עדכן את הגדרת השירות / בדיקת הבריאות / סקריפטים שלך כדי לקרוא ל-agenteye-collector.
3. טען מחדש והפעל מחדש את השירות; אשר שהוא בריא.
4. רק אז הסר את קובץ הבינארי הישן /usr/local/bin/agenteye.

1. התקן את הקובץ הבינארי החדש

הורד את התוצר עבור הפלטפורמה שלך (agenteye-collector-linux-x86_64, agenteye-collector-darwin-arm64, וכו’; ראה התקנה של מאספן → אפשרות A לרשימה המלאה) מהרלease collector/v<version> האחרון והנח אותו ב-/usr/local/bin/agenteye-collector. משתמשי Docker: docker pull ghcr.io/agenteye-enterprise/collector:beta-latest (או תג :v<version> משוכלל, שהוא מועדף; :latest קיים רק לרלישים יציבים). אשר:

agenteye-collector --version

2. עדכן את הפריסה שלך

systemd (Linux)

ערוך /etc/systemd/system/agenteye-collector.service כך ש-ExecStart יצביע על הקובץ הבינארי החדש:

[Service]
ExecStart=/usr/local/bin/agenteye-collector start

לאחר מכן טען מחדש והפעל מחדש:

sudo systemctl daemon-reload
sudo systemctl restart agenteye-collector
sudo systemctl status agenteye-collector

launchd (macOS)

שינוי שם ברנד: אם ה-plist הקיים שלך נמצא בנתיב הישן ~/Library/LaunchAgents/host.exosphere.agenteye-collector.plist, שנה שם של קובץ ל-ai.befailproof.agenteye-collector.plist וגם שנה את ערך <key>Label</key> בתוך הקובץ למזהה החדש לפני טעינה מחדש.

ב-~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist, שנה את ערך ProgramArguments הראשון מ-/usr/local/bin/agenteye ל-/usr/local/bin/agenteye-collector, ואז טען:

launchctl unload ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist
launchctl load   ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist

supervisord

בחסימת התוכנית supervisord שלך, הגדר את command לקובץ הבינארי החדש:

[program:agenteye-collector]
command=/usr/local/bin/agenteye-collector start

לאחר מכן supervisorctl reread && supervisorctl update.

Docker / Kubernetes

שלוף את התמונה החדשה (ghcr.io/agenteye-enterprise/collector:beta-latest או תג :v<version> משוכלל, שהוא מועדף; :latest קיים רק לרלישים יציבים). נקודת הכניסה של התמונה כבר agenteye-collector, אז אותה פקודת docker run עם תת-הפקודה start ממשיכה לעבוד ללא שינוי. חשוב: עדכן בדיקות בריאות. אם אתה משתמש בבדיקת Kubernetes liveness/readiness (או כל docker exec) שמריצה את הקובץ הבינארי לפי שם, שנה את הפקודה ל-agenteye-collector:

livenessProbe:
  exec:
    command: ["agenteye-collector", "health"]

התמונה החדשה לא משלחת כינוי agenteye, אז בדיקה שעדיין קוראת ל-agenteye תכשל. עדכן את הבדיקה באותו rollout כמו התמונה החדשה.

Cron / סקריפטים ידניים

החלף כל בקרו של agenteye start|flush|health בפקודה המתאימה של agenteye-collector start|flush|health. מחק כל עבודות cron של agenteye update; תת-פקודה זו כבר לא קיימת (ראה שדרוגים מעכשיו והלאה).

3. הסר את הקובץ הבינארי הישן (בסוף)

ברגע שהשירות רץ על agenteye-collector ודיווח בריא:

sudo rm /usr/local/bin/agenteye

זה חשוב במיוחד אם אתה גם משתמש ב-AgentEye CLI, שמתקין את הפקודה agenteye שלו; השארת קובץ המאספן הישן ב-/usr/local/bin/agenteye תעשה את שם agenteye דו-משמעי ב-PATH שלך.

שדרוגים מעכשיו והלאה

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

קובץ בינארי: הורד את התוצר החדש עבור הפלטפורמה שלך (לדוגמה agenteye-collector-linux-x86_64; ראה התקנה של מאספן → אפשרות A לרשימה המלאה), החלף את /usr/local/bin/agenteye-collector, והפעל מחדש את השירות.
Docker: docker pull ghcr.io/agenteye-enterprise/collector:beta-latest (או תג :v<version> משוכלל, שהוא מועדף; :latest קיים רק לרלישים יציבים) ובנה מחדש את הקונטיינר.

AGENTEYE_TOKEN עדיין נדרש להורדה מאחסן ה-releases הפרטי, אך דמון ריצה כבר לא צריך אותו.

אשר

agenteye-collector --version    # קובץ בינארי חדש ב-PATH
agenteye-collector health       # exit 0 = בריא
agenteye-collector flush        # העברת כל אירועים בתור וצא בנקיות

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

חזרה לאחור

העברה היא לא הרסנית. אם אתה צריך להחזור לאחור, הצביע את הגדרת השירות שלך חזרה לקובץ הבינארי הישן /usr/local/bin/agenteye (כל עוד לא הסרת אותו עדיין) והפעל מחדש. ספול האירועים והתצורה משותפים ולא מושפעים.

פתרון בעיות

סימפטום	סיבה	תיקייה
`warning: the collector binary is now agenteye-collector …` בכל הרצה	אתה משדר את הקובץ הבינארי תחת השם הישן `agenteye`	קרא ל-`agenteye-collector` במקום זאת; עדכן קבצי שירות וסקריפטים.
systemd נכשל: `.../agenteye: No such file or directory`	הסרת את הקובץ הבינארי הישן לפני עדכון `ExecStart`	הגדר `ExecStart=/usr/local/bin/agenteye-collector start`, ואז `sudo systemctl daemon-reload`.
Pod של Kubernetes נכנס ללולאות קריסה אחרי שדרוג התמונה	בדיקת liveness עדיין מריצה `agenteye`	שנה את פקודת הבדיקה ל-`["agenteye-collector", "health"]`.
`agenteye: command not found`, אבל `agenteye-collector` עובד	סקריפטים/כינויים עדיין מתייחסים לשם הישן	עדכן אותם ל-`agenteye-collector`.
הרצת `agenteye` מתחילה את ה-CLI, לא את המאספן	אתה בעל AgentEye CLI מותקן; הוא בעלי `agenteye`	השתמש ב-`agenteye-collector` עבור דמון והסר כל קובץ בינארי מאספן ישן שנותר ב-`/usr/local/bin/agenteye`.

​מה השתנה

​לפני שתתחיל

​1. התקן את הקובץ הבינארי החדש

​2. עדכן את הפריסה שלך

​systemd (Linux)

​launchd (macOS)

​supervisord

​Docker / Kubernetes

​Cron / סקריפטים ידניים

​3. הסר את הקובץ הבינארי הישן (בסוף)

​שדרוגים מעכשיו והלאה

​אשר

​חזרה לאחור

​פתרון בעיות