title: “Self-host Failproof AI Cloud” description: “פרוס את מישור הבקרה של Failproof AI על קלסטר Kubernetes המנוהל על ידי הלקוח.” icon: “cloud-cog”
Self-hosting הוא פריסה בחבילת Enterprise. צור קשר עם Failproof AI כדי לקבל רישיון enterprise.
דרישות מוקדמות
- Kubernetes 1.27 ומעלה עם גישת cluster-admin
kubectlעם תמיכה ב-Kustomize- Helm 3
- גישה לתמונות פרטיות
ghcr.io/agenteye-enterprise - שני שמות DNS: אחד לדאשבורד ואחד ל-ingest
- אחסון קבוע עבור PostgreSQL ו-ClickHouse
- cert-manager ו-Traefik, או תשתית ingress ותעודות שוות ערך המותאמות לשכבת ה-overlay שלך
- SMTP לכניסה OTP בייצור וכן להודעות
רצף הפריסה
1
הכן את הקלסטר
התקן את cert-manager וויקומי ingress הציבורי/דאשבורד, אמת את מאזני העומס שלהם, ואז צור את ה-namespace, אישורי pull של תמונה, אישורי מסד נתונים, מפתח bootstrap של admin, וסודות אימות/SMTP.
2
הגדר דומיינים ציבוריים
הגדר את
INGEST_DOMAIN ו-DASHBOARD_DOMAIN בקובץ הסביבה של הדומיין שנוצר של ה-overlay וצור רשומות DNS המצביעות על מאזני העומס התואמים.3
החל וחשב overlay של פלטפורמה אחת
השתמש ב-overlay של customer/EKS או GCP. בדוק את פלט Kustomize המעורבב, החלה אותו, ואשר שכל עומס העבודה והתעודות מגיעים למצב הרצוי לפני הרישום של מכונות.
4
Bootstrap גישה וניצול
התחבר כ-admin המוגן, צור מפתח מכונה בהיקף ארגון, ושלח סשן בדיקה קטן דרך נקודת ה-ingest הציבורית.
שירותים נדרשים ואופציונליים
קיבולת audit והחזקת כישלון
הפעל audits על הפריסה audit-agent ייעודית כאשר זמינה. כל audit-agent pod מקבל חקירה אחת כברירת מחדל; קנה מידה של throughput עם replicas ולא הגברה של concurrency לכל pod ללא הגדלה גם של זיכרון. השרת יכול להפיץserver replicas × AUDIT_WORKERS audits בו-זמנית, כך שקיבולת dispatcher צריכה להיות גדולה מספיק למלא את fleet ה-audit-agent.
כאשר כל audit-agent slot עסוק, audit מחכה וחוזר על עצמו עד לרבע מהקדנס שלו, בגובה מרבי של שש שעות. אם לא משבצת זמינה, ההרצה מסתיימת ללא ממצאים ושולחת דוא״ל כישלון. כישלונות חוזרים על החזיקו בקריאה לרעיוני audit-agent נוספים או לעוגנים שעבור במרווח יותר רחב. כישלונות חוזרים על החזיקו בקריאה “shutting down” מציינים pods לא יציבים או looping rollout במקום קיבולת לא מספקת.
הודעות כישלון דורשות ערוץ דוא״ל מופעל ו-SMTP. הם משתמשים בנמענים של ה-audit, ואז חוזרים ל-alerts.email_default_recipients כאשר ל-audit אין ערוץ דוא״ל.
אמת את הפריסה
- Dashboard
- CLI
- פתח את דומיין הדאשבורד שהוגדר, השלם את זרימת ה-OTP של admin, ואשר את שם הארגון ו-slug.
- עבור ל-Administration → Keys וצור מפתח מכונה בהיקף צר.
- שלח סשן בדיקה, ואז אשר אותו ב-Observe → Events וב-Observe → Sessions.
- בדוק ערוץ alert ובעת ההגדרה, הערכה ידנית ו-audit.
אימות ודוא״ל
הדאשבורד משתמש בדוא״ל וקודים חד-פעמיים. ללא SMTP, פריסות פיתוח רישומות קודי OTP לפלט שרת. כאשרSMTP_HOST מוגדר, שם משתמש, סיסמה ושולח נדרשים כקבוצה או השרת מסרב להתחיל.
SMTP_TLS הוא בוליאני. התעבורה המוצפנת הנתמכת היא STARTTLS, בדרך כלל על יציאה 587; SMTPS מרומז על יציאה 465 אינו נתמך על ידי תעבורת השרת הנוכחית.
הגדר את כתובת ה-URL של הדאשבורד הציבוריים בצורה נכונה מכיוון שדוא״ל OTP, alert, incident ו-audit משתמשים בו עבור קישורים עמוקים. חברות ארגון שולטות מי עשוי להבקש קוד; כל ארגון יכול להגביל עוד יותר את כניסות החברים שלו בתוך Administration → Settings.
דרישות מולטי-טנאנט
לפני יצירת ארגון שני, הגדר סודי derivation ClickHouse חזק ויציב של ארגון והשאר אותו זהה בכל server replicas. סיבוב זה ללא הגירה מתואמת יכול להיתום משתמשי ClickHouse ספציפיים לארגון. שמור את ה-listener של admin-instance פנימי. קונסול operator שסופק הוא opt-in ותוכנן עבורkubectl port-forward, לא public ingress. הפעלה שלו דורשת את המפתח API החזק שלו, תיבת דוא״ל super-admin, והחזקת second-factor SMTP.
Break-glass organization CLI
agenteye-orgctl משלנו בתוך תמונת השרת ומדברת ישירות ל-PostgreSQL ו-ClickHouse. הוא נשאר זמין כאשר השרת הציבורי או קונסול operator לא בריא.
org purge בלתי הפיך וודורש למחוק את הארגון תחילה. חברים מוגנים לא יכולים להיות מוסרים או מוצנעים דרך דף Users רגיל של הארגון עד שמפעיל ביטל בפירוש את הגנתם.
רשימת בדיקת מוכנות ייצור
- Ingest ודוא״ל דאשבורד מתפרחים לנתיבי ingress בעלי כוונה שונים.
- TLS תקף; השתמש ב-mutual TLS על ingest כאשר הפריסה שלך דורשת זאת.
- PostgreSQL וקלעים של ClickHouse צפויים לקיבולת.
- גיבויים כוללים שני datastores וכן הנוהל restore שבדוק.
- בדיקות בריאות alert על ingest silence, כישלונות עומס, תוקף תעודה, לחץ אחסון וגיבויים ישנים.
- יומנים מובנים נאספים ללא הדפסה דו-פעמית של צינור יומן קלסטר קיים.
- Evaluator, audit ו-alert worker concurrency לא שוונה ללא ראיות queue שנמדדו.
- שחרור יישום מוצמד וטיוטת rollback מתועדים לפני שדרוג.