Medfølgende apps

Antimatters Docker-billeder leveres med en række apps (plugins i Systemkonsolen). Denne side viser dem, angiver hvilke der er aktiveret efter installationen og dækker de indstillinger, hver app kræver fra en administrator.

De medfølgende apps

Apps vises som Plugins i Systemkonsolen. De er indeholdt i billedet (i /antimatter/prepackaged_plugins), signeret med Antimatters app-signeringsnøgle, så de kan installeres uden internetforbindelse.

Udgivelsesarkivet og .deb- og .rpm-pakkerne indeholder færre apps: se Apps i pakkerne og arkivet.

Apps, der er aktiveret som standard, installeres ved hver opstart, hvis de ikke allerede er installeret, eller opgraderes, hvis image'en indeholder en nyere version. Hvis du deaktiverer en app, forbliver den deaktiveret: Standardindstillingen gælder kun for apps, som konfigurationen ikke nævner endnu. Apps, der beholder deres Mattermost-id (AI-chat, Opkald og integrationerne), er Antimatters egne builds.

Kanban (focalboard) og Playbooks (playbooks) er ikke længere bundtet med serveren eller nogen af image'erne: Installer den, du ønsker, fra dens egen GitHub-release (se Apps i pakkerne og arkivet), ligesom enhver anden app, der ikke er bundtet som standard. En server, der allerede har en installeret, beholder den ved opgradering. Begge forbliver Antimatters egne builds: Marketplace'ens vanilla-builds erstatter aldrig Antimatters.

Aktivér, deaktivér og konfigurer apps

Gå til Systemkonsol › Plugins › Plugin-håndtering. Under Installerede plugins har hver app Aktivér eller Deaktiver, Indstillinger og Fjern, og viser dens status (Kører, Kører ikke, Kunne ikke starte…). Hver app med indstillinger har også sin egen side under Systemkonsol › Plugins.

De medfølgende apps, der er deaktiveret som standard, installeres fra billedets egen kopi: Klik på dit billede øverst i app-railen, og vælg App Marketplace (i det klassiske grænseflade er det i produktmenuen), find appen, og klik på Installer, og aktiver den derefter i Plugin Management. Fra kommandolinjen:

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

Andre kommandoer: amctl plugin list, amctl plugin disable <id>, amctl plugin delete <id>.

Aktivér apps gennem konfigurationen

Hvilke apps der er aktiveret, er indstillingen PluginSettings.PluginStates, et map over app-id'er. Du kan føje poster til det med amctl; med Aktivér automatisk forudpakkede plugins slået til (standard) installeres en aktiveret medfølgende app ved næste start:

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

Dette er også måden at installere To-do på, som ikke tilbydes i Marketplace-dialogen. Variablen AM_PLUGINSETTINGS_PLUGINSTATES virker også, men den erstatter hele mappen: oplist alle apps, du vil have aktiveret.

App-indstillinger

App-indstillingerne gemmes under PluginSettings.Plugins.<app id> med nøgler i små bogstaver. Du kan ændre dem på appens Systemkonsol-side eller med amctl config patch, som vist i Konfiguration. AM_PLUGINSETTINGS_PLUGINS erstatter indstillingerne for alle apps på én gang og låser dem alle, så undgå at bruge den.

GIFs

GIFs-appen tilføjer en fane til GIF'er og klistermærker i emoji-vælgeren, understøttet af Antimatters GIF-tjeneste (gifs-server), der taler Tenor API. Websitets compose-fil kører tjenesten og konfigurerer appen gennem variabler. Indstillingerne findes i Systemkonsol › Plugins › GIFs:

For denne app er variablerne kun fallbacks: En værdi sat i Systemkonsolen har forrang over dem. Hvis GIF-vælgeren forbliver tom, skal du kontrollere tjeneste-URL'en og API-nøglen på den side.

Mens GIF-appen er opsat, erstatter dens fane den indbyggede Giphy-vælger (Systemkonsol › Integrationer › GIF › Aktivér GIF-vælger, ServiceSettings.EnableGifPicker).

GIF-tjenesten

Tjenesten opbevarer alt i sin datamappe (/data, gifs-volumen): en søgeindex og medier. Dens vigtigste variabler:

For at importere dine egne GIF'er i mængder, importer dem med et manifest fra en mappe, der er monteret i en engangskontainer:

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

For at genimportere start-stickers efter en opgradering: docker compose run --rm gifs stickers. Manifestformatet og de andre kommandoer findes i gifs-server README.

E-mail og Kalender

E-mail og Kalender kobler hver person til deres egen postkasse (IMAP og SMTP) og deres egen kalender (CalDAV). Personer indtaster deres server og adgangskode i appen; adgangskoder gemmes krypteret. Du konfigurerer ikke e-mail- eller kalenderservere for dem, men du bestemmer, hvad de må forbinde til:

For at lade personer logge ind på Gmail- eller Microsoft 365-postkasser med deres konto i stedet for en adgangskode, skal du oprette en OAuth-klient og udfylde E-mail-appens Google- eller Microsoft-felter:

• Google: en Web OAuth-klient med Gmail API og omfanget https://mail.google.com/.
• Microsoft: en Entra ID-app med de delegerede tilladelser IMAP.AccessAsUser.All, SMTP.Send, offline_access, openid, email og profile. Tenanten er common som standard.
• I begge tilfælde er redirect-URI'en https://chat.example.com/plugins/com.antimatterchat.mail/oauth/callback (din site-URL).

Kanban, Noter, Whiteboard, Afstemninger og Playbooks

• Kanban (focalboard) åbnes i sit sidepanel ved siden af samtalen, ligesom Playbooks. Gamle links til /kanban/… og /boards/…-sider åbner det samme board eller kort i et community. Dens eneste indstilling, Enable Publicly-Shared Boards (EnablePublicSharedBoards, deaktiveret), lader board-redaktører dele et board med alle, der har linket, uden at logge ind.
• Notes og Polls har ingen indstillinger.
• Whiteboard: systemadministratorer kan uploade formsamlinger (Excalidraw .excalidrawlib-filer, op til 5 MB hver) til hele serveren på dens indstillingsside. Community-administratorer administrerer deres egen communitys formsamlinger.
• Playbooks åbnes i sit sidepanel. Gamle links til /playbooks/…-sider åbner den samme kørsel eller playbook i et community. Den har et par indstillinger, hovedsagelig eksperimentelle funktioner; standardindstillingerne passer til de fleste servere.
• Memes: Hvem kan tilføje memetemplates: Alle (standard), System admins eller Ingen (brugerdefinerede templates deaktiveret), som stopper nye templates, mens de allerede tilføjede forbliver brugbare. Gæster tilføjer aldrig templates. Personen, der tilføjede et template, og systemadministratorer kan slette det.
• Todo har ingen serverindstillinger.

GitHub, GitLab og Jira

Disse apps kobler Antimatter til din kodehosting og din issue tracker. Hver app kræver en OAuth-application på den anden side og en webhook, der peger tilbage til Antimatter. Aktivér appen, og kør derefter dens opsætningskommando i en vilkårlig kanal, som vejleder dig trin for trin: /github setup, /gitlab setup eller /jira setup.

GitHub- og GitLab-appene genererer deres webhook-secret og krypteringsnøgle ved første gemning. GitHub-appen kan begrænses til organisationer (GithubOrg), og GitLab-appen til en gruppe (GitlabGroup); for GitHub Enterprise eller en selvhostet GitLab skal du indstille dens base URL.

Målinger

Metrics-appen indsamler serverens ydelsesmetrikker i en lille tidsseriesdatabase inde i Antimatter, så du kan downloade dem eller inkludere dem i et supportpakke uden at køre Prometheus. Når den starter, slår den serverens metrik-endpoint til (MetricsSettings.Enable). Se Operations.

Installation af andre apps

Antimatter kører Mattermost-apps (plugins). Tre måder at tilføje en på:

• Fra en fjernmarketplace. Aktivér fjernmarketplace (PluginSettings.EnableRemoteMarketplace) er slået fra som standard, og Marketplace-URL (PluginSettings.MarketplaceURL) er tom: Antimatter bruger ikke Mattermosts marketplace og ignorerer adressen, hvis en konfiguration fra Mattermost stadig indeholder den. For at vise apps fra en marketplace-server, du stoler på, skal du slå indstillingen til og angive dens URL. Byggerier af apps, som Antimatter leverer (Calls, Playbooks, Kanban og andre), fra den marketplace er skjult, så de ikke kan erstatte Antimatters: Tillad Marketplace-byggerier af Antimatter-plugins (PluginSettings.AllowMarketplaceToReplaceAntimatterPlugins) er slået fra som standard.
• Ved at uploade en bundle (.tar.gz). Uploads er slukket som standard og har ingen indstilling i Systemkonsolen: sæt AM_PLUGINSETTINGS_ENABLEUPLOADS=true, og brug derefter Upload Plugin i Plugin Management, eller amctl --local plugin add app.tar.gz.
• Fra en URL: amctl plugin install-url <url>, også med uploads slået til.

Antimatter kontrollerer app-signaturer mod de nøgler, det stoler på: Antimatter-nøglen, nøglen Mattermost, Inc. signerer sine udgivne apps med (så en Mattermost-app, du downloader selv, kan installeres) og enhver nøgle, du tilføjer i PluginSettings.SignaturePublicKeyFiles. Med Kræv pluginsignatur (PluginSettings.RequirePluginSignature, slået fra som standard) slået til, afvises apps uden signatur, og uploads deaktiveres.

Nogle apps lavet til Mattermosts betalte udgaver tjekker efter en Mattermost-licens selv og nægter at køre; Antimatter påstår ikke at have en for dem.