Beépített alkalmazások

Az Antimatter Docker-képei egy csomag alkalmazással (a Rendszerkonzolban bővítményekkel) érkezik. Ez az oldal felsorolja őket, megadja, melyek vannak bekapcsolva a telepítés után, és leírja az adminisztrátor által szükséges beállításokat.

A beépített alkalmazások

Az alkalmazások a Rendszerkonzolban Bővítmények néven szerepelnek. A képen találhatók (a /antimatter/prepackaged_plugins könyvtárban), az Antimatter alkalmazás-aláíró kulcsával vannak aláírva, így internetkapcsolat nélkül is telepíthetők.

A kiadási archívum és a .deb és .rpm csomagok kevesebb alkalmazást tartalmaznak: lásd a Csomagokban és archívumban elérhető alkalmazások részt.

Az alapértelmezetten bekapcsolt alkalmazások minden indításkor telepítve maradnak, ha még nincsenek, vagy frissítve, ha a képben újabb verzió van. Ha valamelyiket kikapcsolja, az így is marad: az alapértelmezés csak azokra az alkalmazásokra vonatkozik, amelyeket a konfiguráció még nem említ. Azok az alkalmazások, amelyek megtartják a Mattermost-azonosítójukat (Ügynökök, Hívások, Kanban, Playbookok és az integrációk), az Antimatter saját kiadásai.

Alkalmazások engedélyezése, letiltása és beállítása

Menjen a Rendszerkonzol › Bővítmények › Bővítmény kezelés menüpontra. A Telepített bővítmények alatt minden appnál megjelenik a Bekapcsolás vagy Letiltás, a Beállítások és az Eltávolítás gomb, valamint az app állapota (Fut, Nem fut, Nem sikerült elindítani…). Minden app, amelynek vannak beállításai, saját oldalt is kap a Rendszerkonzol › Bővítmények menü alatt.

A csomagolt, alapértelmezés szerint kikapcsolt alkalmazások a képből saját másolatuk alapján telepíthetők: kattints a profilfényképedre az alkalmazássáv tetején, válaszd az App piac lehetőséget (a klasszikus felületen a termékménu alatt található), keresd meg az alkalmazást, kattints a Telepítés gombra, majd engedélyezd a Bővítménykezelésben. Parancssorból:

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

Egyéb parancsok: amctl plugin list, amctl plugin disable <id>, amctl plugin delete <id>.

Alkalmazások engedélyezése a konfigurációban

Az, hogy mely appok vannak bekapcsolva, a PluginSettings.PluginStates beállításban tárolódik, amely egy app azonosítókból álló tábla. Bejegyzéseket adhat hozzá amctl segítségével; ha az Automatikusan előre csomagolt bővítmények engedélyezése be van kapcsolva (ez az alapértelmezés), a következő indításkor települ a bekapcsolt csomagolt app:

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

Így telepíthető a Teendők is, amely nem érhető el a Piac párbeszédablakában. Az AM_PLUGINSETTINGS_PLUGINSTATES változó is működik, de az egész táblázatot felülírja: sorolja fel minden bekapcsolni kívánt alkalmazást.

Alkalmazás-beállítások

Az alkalmazás beállításai a PluginSettings.Plugins.<app id> alatt tárolódnak, kisbetűs kulcsokkal. Módosíthatók az alkalmazás Rendszerkonzol-oldalán, vagy a amctl config patch paranccsal, ahogy a Konfiguráció részben látható. A AM_PLUGINSETTINGS_PLUGINS egyszerre felülírja és zárolja minden alkalmazás beállításait, ezért kerülendő.

GIF-ek

A GIF-ek app GIF- és matricafüget ad az emoji-választóhoz, amelyet az Antimatter GIF-szolgáltatása (gifs-server) támaszt alá, és amely a Tenor API-t használja. A webhely compose fájlja futtatja a szolgáltatást, és változók segítségével konfigurálja az appot. Beállításai a Rendszerkonzol › Bővítmények › GIF-ek menü alatt találhatók:

Ez az alkalmazás esetén a változók csak visszafordulási értékek: a Rendszerkonzolban beállított érték felülírja őket. Ha a GIF-választó üres marad, ellenőrizze a szolgáltatás URL-jét és az API-kulcsot az adott oldalon.

Amíg a GIF-ek app be van állítva, a fülje helyettesíti a beépített Giphy választót (Rendszerkonzol › Integrációk › GIF › GIF választó engedélyezése, ServiceSettings.EnableGifPicker).

A GIF-szolgáltatás

A szolgáltatás minden adatot a saját adatkönyvtárában tárol (/data, a gifs kötet): keresőindexet és médiafájlokat. Fő változói:

Saját GIF-ek tömeges hozzáadásához importálja őket egy manifeszttel, egy egyszeri konténerbe beillesztett könyvtárból:

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

A kezdő matricák újrabemutatása frissítés után: docker compose run --rm gifs stickers. A manifesztum formátumát és a többi parancsot a gifs-server README tartalmazza.

E-mail és Naptár

Az E-mail és a Naptár mindenkit a saját leveles fiókjához (IMAP és SMTP) és a saját naptárához (CalDAV) kapcsol. Az emberek az alkalmazásban adják meg a szervert és a jelszót; a jelszavak titkosítva tárolódnak. Ön nem konfigurálja a levelező vagy naptár szervert számukra, de Ön dönti el, mihhez csatlakozhatnak:

Ha azt szeretné, hogy az emberek a Gmail vagy Microsoft 365 leveles fiókjaikhoz a fiókukkal, jelszó nélkül jelentkezzenek be, hozzon létre egy OAuth klienset, és tölje ki az E-mail alkalmazás Google vagy Microsoft mezőit:

• Google: egy Web OAuth kliens a Gmail API-val és a https://mail.google.com/ hatókörrel.
• Microsoft: egy Entra ID alkalmazás a delegált jogosultságokkal: IMAP.AccessAsUser.All, SMTP.Send, offline_access, openid, email és profile. A bérlő (tenant) alapértelmezetten a common.
• Mindkettőnél a visszairányító URI: https://chat.example.com/plugins/com.antimatterchat.mail/oauth/callback (az Ön webhelyének URL-je).

Kanban, Megjegyzések, Fehértábla, Szavazások és Playbookok

• A Kanban (focalboard) a beszélgetés mellett, a Playbookokhoz hasonlóan oldalsó panelben nyílik meg. A régebbi /kanban/… és /boards/… oldalakra mutató hivatkozások ugyanazt a táblát vagy kártyát nyitják meg egy közösségben. Egyetlen beállítása, a Közösen megosztott táblák engedélyezése (EnablePublicSharedBoards, alapértelmezés szerint kikapcsolva), lehetővé teszi, hogy a táblaszerkesztők bármelyik link birtokosával megosszák a táblát bejelentkezés nélkül.
• A Megjegyzések és a Szavazások nincsenek beállításokkal.
• Fehértábla: a rendszeradminisztrátorok a beállítások oldalon feltölthetnek alakzat-könyvtárakat (Excalidraw .excalidrawlib fájlok, mindegyik legfeljebb 5 MB) a teljes szerver számára. A közösségi adminisztrátorok a saját közösségük könyvtárait kezelik.
• A Playbookok oldalsó panelben nyílik meg. A régebbi /playbooks/… oldalakra mutató hivatkozások ugyanazt a futtatást vagy playbookt nyitják meg egy közösségben. Több beállítása van, többségük kísérleti funkció; az alapértelmezések a legtöbb szerverre alkalmasak.
• Memes: Ki adhat hozzá meme-sablonokat: Mindenki (alapértelmezés), Rendszeradminisztrátorok, vagy Senki (saját sablonok kikapcsolva), ami megakadályozza az új sablonok hozzáadását, miközben a már hozzáadottak továbbra is használhatók maradnak. Vendégek soha nem adhatnak hozzá sablonokat. A sablon hozzáadójának és a rendszeradminisztrátoroknak joga van a törléshez.
• A Teendő nincsen szerverbeállításokkal.

GitHub, GitLab és Jira

Ezek az alkalmazások összekötik az Antimattert a kódtárhellyel és a hibakezelő rendszerrel. Mindegyikhez az ellenoldalon OAuth-alkalmazás, valamint az Antimatterre mutató webhook szükséges. Engedélyezd az alkalmazást, majd futtasd a beállító parancsát bármely csatornában, amely lépésről lépésre vezet: /github setup, /gitlab setup vagy /jira setup.

A GitHub és GitLab alkalmazások az első mentéskor generálják a webhook titkot és a titkosítási kulcsot. A GitHub-alkalmazás szűkíthető szervezetekre (GithubOrg), a GitLab-alkalmazás pedig csoportokra (GitlabGroup); GitHub Enterprise vagy saját üzemeltetésű GitLab esetén állítsd be az alap URL-t.

Metriki

A Metrikák-alkalmazás az Antimatteren belül, egy kis idősort adatbázisba gyűjti a szerver teljesítménymutatóit, így letöltheted őket, vagy belefoglalhatod egy támogatási csomagba Prometheus futtatása nélkül. Induláskor bekapcsolja a szerver metrikák végpontját (MetricsSettings.Enable). Lásd: Működtetés.

Egyéb alkalmazások telepítése

Az Antimatter Mattermost-alkalmazásokat (bővítményeket) futtat. Három módszer a hozzáadásukhoz:

• Távoli piactérről. Az Távoli piactér engedélyezése (PluginSettings.EnableRemoteMarketplace) alapértelmezés szerint kikapcsolva van, és a Piactér URL (PluginSettings.MarketplaceURL) üres: az Antimatter nem használja a Mattermost piacterét, és ha egy Mattermost-ból származó konfiguráció még tartalmazza annak címét, azt figyelmen kívül hagyja. Egy megbízható piactérszerver appjainak listázásához kapcsolja be a beállítást, és állítsa be a URL-t. Az Antimatter által szállított appok (Hívás, Playbook, Kanban és a többi) piaci verziói elrejtve vannak, így nem helyettesíthetik az Antimatter saját appjait: az Az Antimatter-bővítmények piaci verzióinak engedélyezése (PluginSettings.AllowMarketplaceToReplaceAntimatterPlugins) alapértelmezés szerint kikapcsolva van.
• Egy csomag feltöltésével (.tar.gz). A feltöltések alapértelmezetten kikapcsolva vannak, és nincs rájuk kapcsoló a Rendszerkonzolban: állítsd be a AM_PLUGINSETTINGS_ENABLEUPLOADS=true értéket, majd használd a Bővítmény feltöltése lehetőséget a Bővítménykezelésben, vagy a amctl --local plugin add app.tar.gz parancsot.
• URL-címről: amctl plugin install-url <url>, szintén feltöltések engedélyezése mellett.

Az Antimatter az appok aláírásait a megbízott kulcsok ellenőrzi: az Antimatter kulcs, a Mattermost, Inc. által a publikált appok aláírásához használt kulcs (így a saját maga által letöltött Mattermost app telepíthető), valamint bármely olyan kulcs, amelyet a PluginSettings.SignaturePublicKeyFiles beállításhoz ad hozzá. Ha a Bővítmény aláírás szükséges (PluginSettings.RequirePluginSignature, alapértelmezés szerint kikapcsolva) be van kapcsolva, az aláíratlan appok elutasításra kerülnek, és a feltöltés letiltásra kerül.

Néhány a Mattermost fizetős kiadásaihoz készült app maga ellenőrzi a Mattermost licencet, és megtagadja a futtatást; az Antimatter nem állítja, hogy lenne ilyen licenc a számukra.