אפליקציות מובנות

תמונות ה-Docker של Antimatter מגיעות עם סט של אפליקציות (תוספים, בקונסולת המערכת). עמוד זה מפרט אותן, מציין אילו פעילות אחרי ההתקנה, ומכסה את ההגדרות שכל אחת מהן דורשת ממנהל.

האפליקציות המובנות

האפליקציות מופיעות כתוספים בקונסולת מערכת. הן נכללות בתמונה (ב/antimatter/prepackaged_plugins), חתומות עם מפתח החתימה של אפליקציות Antimatter, ולכן מותקנות ללא צורך בחיבור לאינטרנט.

ארכיון הגרסה והחבילות .deb ו-.rpm כוללות פחות אפליקציות: ראו אפליקציות בחבילות ובארכיון.

אפליקציות שפעילות כברירת מחדל מותקנות בכל הפעלה אם הן עדיין לא מותקנות, או מתעדכנות אם בתמונה יש גרסה חדשה יותר. אם מבטלים אחת מהן, היא נשארת כבוייה: ברירת המחדל חלה רק על אפליקציות שההגדרה עדיין לא מזכירה. אפליקציות שמחזיקות את מזהה Mattermost (סוכנים, שיחות, Kanban, Playbooks והאינטגרציות) הן בנייה עצמאית של Antimatter.

הפעלה, ביטול והגדרת אפליקציות

עבורו לקונסולת מערכת › תוספים › ניהול פלאגינים. תחת תוספים מותקנים, לכל אפליקציה יש הפעלה או השבתה, הגדרות והסרה, והיא מציגה את מצבה (רץ, לא רץ, נכשל בהתחלה…). לכל אפליקציה עם הגדרות יש גם דף משלה תחת קונסולת מערכת › תוספים.

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

docker compose exec antimatter amctl --local plugin marketplace install github
docker compose exec antimatter amctl --local plugin enable github

פקודות נוספות: amctl plugin list, amctl plugin disable <id>, amctl plugin delete <id>.

הפעלת אפליקציות דרך ההגדרה

האפליקציות הפעילות מוגדרות בהגדרה PluginSettings.PluginStates, שהיא מפה של מזהי אפליקציות. ניתן לשלב בה רשומות באמצעות amctl; כאשר הפעלת תוספים מוכנים מראש אוטומטית פעילה (ברירת המחדל), אפליקציה מצורפת שנוספה תותקן בהפעלה הבאה:

docker compose exec -T antimatter amctl --local config patch /dev/stdin <<'EOF'
{"PluginSettings": {"PluginStates": {"com.mattermost.plugin-todo": {"Enable": true}}}}
EOF
docker compose restart antimatter

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

הגדרות אפליקציה

ההגדרות של האפליקציה נשמרות תחת PluginSettings.Plugins.<app id>, עם מפתחות באותיות קטנות. ניתן לשנות אותן בדף System Console של האפליקציה, או באמצעות amctl config patch כמתואר בConfiguration. AM_PLUGINSETTINGS_PLUGINS מחליף את ההגדרות של כל האפליקציות בבת אחת ומנעול אותן, ולכן יש להימנע ממנו.

GIFs

אפליקציית GIFs מוסיפה לשדה בחירת האמוג'י לשונית ל-GIF ולמגנטים, המבוססת על שירות ה-GIF של Antimatter (gifs-server), שמדבר ב-API של Tenor. קובץ ה-compose של האתר מפעיל את השירות ומגדיר את האפליקציה באמצעות משתנים. ההגדרות שלה, בקונסולת מערכת › תוספים › GIF:

באפליקציה זו, המשתנים משמשים רק כברירת מחדל: ערך שנקבע ב-System Console גובר עליהם. אם תיבת בחירת GIF נשארת ריקה, יש לבדוק את כתובת השירות ומפתח API בדף זה.

כשאפליקציית GIFs מוגדרת, לשוניתה מחליפה את בוחר Giphy המובנה (קונסולת מערכת › אינטגרציות › GIF › הפעלת בוחר GIF, ServiceSettings.EnableGifPicker).

שירות GIF

השירות שומר את כל הנתונים בתיקיית הנתונים שלו (/data, נפח gifs): אינדקס חיפוש והמדיה. משתניו העיקריים:

כדי להוסיף GIFs משלך בכמויות, יבא אותם באמצעות manifest, מתוך תיקייה שהיא מורכבת לתוך קונטיינר חד-פעמי:

docker compose run --rm -v "$PWD/my-gifs:/import:ro" gifs import -manifest /import/manifest.json

כדי לייבא מחדש את המדבקות התחלתיות לאחר עדכון: docker compose run --rm gifs stickers. פורמט ה-manifest והפקודות האחרות מפורטים ב-README של gifs-server.

דוא"ל ולוח שנה

דוא"ל ולוח שנה מחברים כל אדם לתיבת הדוא"ל שלו (IMAP ו-SMTP) וללוח השנה שלו (CalDAV). המשתמשים מזינים את שרת הדוא"ל והסיסמה שלהם באפליקציה; הסיסמאות נשמרות במצופנות. אתה לא מגדיר עבורם שרתי דוא"ל או לוח שנה, אך אתה קובע לאיזה שרתים הם יכולים להתחבר:

כדי לאפשר לאנשים להתחבר לתיבות דוא"ל של Gmail או Microsoft 365 עם החשבון שלהם במקום סיסמה, צור OAuth client ומלא את השדות של Google או Microsoft באפליקציית הדוא"ל:

• Google: OAuth client של Web עם Gmail API וה-scope https://mail.google.com/.
• Microsoft: אפליקציית Entra ID עם הרשאות מופקדות IMAP.AccessAsUser.All, SMTP.Send, offline_access, openid, email ו-profile. ה-tenant הוא common כברירת מחדל.
• בשני המקרים, כתובת ה-redirect URI היא https://chat.example.com/plugins/com.antimatterchat.mail/oauth/callback (כתובת האתר שלך).

Kanban, פתקים, לוח לבן, סקרים ו-Playbooks

• Kanban (focalboard) נפתח בסרגל הצד לצד השיחה, בדומה ל-Playbooks. קישורים ישנים לעמודים /kanban/… ו-/boards/… פותחים את אותו לוח או כרטיס בקהילה. ההגדרה היחידה שלו, אפשרות לשתף לוחים ציבורית (EnablePublicSharedBoards, מושבתת), מאפשרת לעורכי לוחים לשתף לוח עם כל מי שיש לו את הקישור, ללא הצורך בהתחברות.
• לNotes ולPolls אין הגדרות.
• Whiteboard: מנהלי מערכת יכולים להעלות ספריות צורות (קבצי Excalidraw .excalidrawlib, עד 5 MB לכל קובץ) לכל שרת בדף ההגדרות שלו. מנהלי קהילה מנהלים את ספריות הקהילה שלהם.
• Playbooks נפתח בסרגל הצד. קישורים ישנים לעמודים /playbooks/… פותחים את אותה הרצה או Playbook בקהילה. יש לו כמה הגדרות, רובן תכונות ניסיוניות; ברירת המחדל מתאימה לרוב השרתים.
• Memes: מי יכול להוסיף תבניות ממים: כולם (ברירת המחדל), מנהלי מערכת, או אף אחד (תבניות מותאמות אישית מושבתות), שמונע תבניות חדשות בעוד שהתבניות שכבר נוספו נשארות בשימוש. אורחים לעולם לא מוסיפים תבניות. האדם שהוסיף תבנית ומנהלי מערכת יכולים למחוק אותה.
• לTodo אין הגדרות שרת.

GitHub, GitLab ו-Jira

אפליקציות אלו מקשרות את Antimatter לשירותי אחסון הקוד ולמעקב הבעיות שלך. כל אחת דורשת אפליקציית OAuth בצד השני ו-Webhook שמכוון חזרה אל Antimatter. הפעילו את האפליקציה, ואז הרצו את פקודת ההגדרה שלה בכל ערוץ, שהדרכה שלב אחר שלב: /github setup, /gitlab setup או /jira setup.

אפליקציות GitHub ו-GitLab יוצרות את סוד ה-Webhook ומפתח ההצפנה בהגדרה הראשונה. אפליקציית GitHub יכולה להיות מוגבלת לארגונים (GithubOrg) ואפליקציית GitLab לקבוצה (GitlabGroup); עבור GitHub Enterprise או GitLab עצמאי, הגדירו את כתובת הבסיס שלו.

מדידות

אפליקציית Metrics אוספת את מדדי הביצועים של השרת למסד נתונים זמני קטן בתוך Antimatter, כך שתוכלו להוריד אותם או לכלול אותם בחבילת תמיכה ללא הרצת Prometheus. בעת ההתחלה, היא מפעילה את נקודת המדדים של השרת (MetricsSettings.Enable). ראו Operations.

התקנת אפליקציות אחרות

Antimatter מריץ אפליקציות Mattermost (תוספים). שלושה דרכים להוסיף אחת:

• משוק תוספים מרוחק. הפעלת שוק תוספים מרוחק (PluginSettings.EnableRemoteMarketplace) מושבתת כברירת מחדל, וכתובת (URL) של שוק התוספים (PluginSettings.MarketplaceURL) ריקה: Antimatter אינו משתמש בשוק התוספים של Mattermost, ומתעלם מהכתובת שלו אם בהגדרה מ-Mattermost עדיין מופיעה. כדי להציג את האפליקציות של שרת שוק תוספים שאתם סומכים עליו, הפעילו את ההגדרה והגדירו את כתובתו. הגרסאות של שוק התוספים הזה לאפליקציות שAntimatter מספק (Calls, Playbooks, Kanban ואחרות) מוסתרות, כך שהן אינן יכולות להחליף את אלו של Antimatter: אפשרות להחליף פלאגיני Antimatter בגרסאות שוק (PluginSettings.AllowMarketplaceToReplaceAntimatterPlugins) מושבתת כברירת מחדל.
• על ידי העלאת חבילה (.tar.gz). העלאות כבויות כברירת מחדל ואין להן מתג בקונסולת המערכת: יש להגדיר AM_PLUGINSETTINGS_ENABLEUPLOADS=true, ואז להשתמש בהעלאת פלאגין בניהול הפלאגינים, או בפקודה amctl --local plugin add app.tar.gz.
• מכתובת: amctl plugin install-url <url>, גם כאשר העלאות מופעלות.

Antimatter בודק את חתימות האפליקציות מול המפתחות שהוא מאמין בהם: מפתח Antimatter, המפתח שבו Mattermost, Inc. חותמת את האפליקציות שמוציאה (כך שאפליקציית Mattermost שאתה מוריד בעצמך מותקנת), וכל מפתח שאתה מוסיף בPluginSettings.SignaturePublicKeyFiles. כאשר דרישה לחתימת תוסף (PluginSettings.RequirePluginSignature, כבוי כברירת מחדל) מופעל, אפליקציות ללא חתימה נדחות והעלאות נחסמות.

חלק מהאפליקציות שנועדו לגרסאות התשלום של Mattermost בודקות בעצמן עבור רישיון Mattermost ומסרבות להימשך; Antimatter אינו מתחזה לכזה עבורן.