Bundlete apper

Antimatters Docker-bilder inneholder en samling apper (plugins i Systemkonsollen). Denne siden lister dem, forteller hvilke som er på etter installasjon, og beskriver innstillingene hver app krever fra en administrator.

De medfølgende appene

Appene er listet som Plugins i Systemkonsollen. De finnes i bildet (i /antimatter/prepackaged_plugins), er signert med Antimatters app-signeringsnøkkel, og kan derfor installeres uten internettforbindelse.

Utgavearkivet og .deb- og .rpm-pakkene inneholder færre apper: se Apper i pakkene og arkivet.

Apper som er på som standard, installeres ved hver oppstart hvis de ikke allerede er installert, eller oppgraderes hvis bildet har en nyere versjon. Hvis du slår av en app, forblir den av: standardinnstillingen gjelder bare for apper som konfigurasjonen ennå ikke nevner. Apper som beholder sin Mattermost-id (Agenter, Samtaler, Kanban, Playbooks og integrasjonene) er Antimatters egne byggevarianter.

Aktiver, deaktiver og konfigurer apper

Gå til Systemkonsoll › Plugins › Pluginhåndtering. Under Installerte tillegg har hver app Aktiver eller Deaktiver, Innstillinger og Fjern, og viser sin status (Kjører, Kjører ikke, Feilet ved oppstart…). Hver app med innstillinger har også sin egen side under Systemkonsoll › Plugins.

De medfølgende appene som er av som standard, installeres fra bildets egen kopi: klikk på bildet ditt øverst i app-siden og velg Appmarkedet (i det klassiske grensesnittet finnes det i produktmenyen), finn appen og klikk Installer, og aktiver den deretter i Pluginhåndtering. 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>.

Aktiver apper gjennom konfigurasjonen

Hvilke apper som er på, styres av innstillingen PluginSettings.PluginStates, et kart over app-id-er. Du kan slå sammen poster i dette med amctl; med Aktiver automatisk forinstallerte plugins på (standard), installeres en aktivert medfølgende app ved neste oppstart:

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å hvordan du installerer Todo, som ikke er tilgjengelig i Markedets dialog. Variabelen AM_PLUGINSETTINGS_PLUGINSTATES fungerer også, men den erstatter hele kartet: oppfør alle appene du ønsker å ha på.

App-innstillinger

App-innstillingene lagres under PluginSettings.Plugins.<app id>, med nøkkeler i små bokstaver. Endre dem på appens Systemkonsoll-side, eller med amctl config patch som vist i Konfigurasjon. AM_PLUGINSETTINGS_PLUGINS erstaller innstillingene for alle apper samtidig og låser dem alle, så unngå å bruke den.

GIF-er

GIF-appen legger til en GIF- og klistermerke-fane i emoji-välgeren, støttet av Antimatters GIF-tjeneste (gifs-server), som kommuniserer med Tenor API. Nettstedets compose-fil kjører tjenesten og konfigurerer appen gjennom variabler. Innstillingene, i Systemkonsoll › Plugins › GIF-er:

For denne appen er variablene kun fallbacks: en verdi satt i Systemkonsollen har forrang over dem. Hvis GIF-välgeren forblir tom, sjekk tjeneste-URL og API-nøkkel på den siden.

Mens GIF-appen er konfigurert, erstatter fanen den innebygde Giphy-välgeren (Systemkonsoll › Integrasjoner › GIF › Aktiver GIF-välger, ServiceSettings.EnableGifPicker).

GIF-tjenesten

Tjenesten lagrer alt i sin datakatalog (/data, gifs-volumet): en søkeindeks og mediene. Dens hovedvariabler:

For å legge til egne GIF-er i stor skala, importer dem med en manifest fra en mappe montert i en engangskontainer:

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

For å re-importere start-stickers etter en oppgradering: docker compose run --rm gifs stickers. Manifestformatet og de andre kommandoene finnes i gifs-server README.

E-post og Kalender

E-post og Kalender kobler hver person til deres egen postkasse (IMAP og SMTP) og deres egen kalender (CalDAV). Personer oppgir sin server og passord i appen; passord lagres kryptert. Du konfigurerer ikke epost- eller kalenderserverer for dem, men du bestemmer hva de kan koble til:

For å la personer logge inn på Gmail- eller Microsoft 365-postkasser med deres konto i stedet for et passord, opprett en OAuth-klient og fyll inn feltene for Google eller Microsoft i Epost-appen:

• Google: en Web OAuth-klient med Gmail API og omfanget https://mail.google.com/.
• Microsoft: en Entra ID-app med delegerte tillatelser IMAP.AccessAsUser.All, SMTP.Send, offline_access, openid, email og profile. Tenanten er common som standard.
• I begge tilfeller er omdirigerings-URI-en https://chat.example.com/plugins/com.antimatterchat.mail/oauth/callback (nettsidens URL).

Kanban, Notater, Tavler, Avstemninger og Playbooks

• Kanban (focalboard) åpnes i sidepanelet ved siden av samtalen, slik Playbooks gjør. Gamle lenker til /kanban/…- og /boards/…-sider åpner samme board eller kort i en community. Den eneste innstillingen, Enable Publicly-Shared Boards (EnablePublicSharedBoards, av), lar board-redaktører dele et board med alle som har lenken, uten å logge inn.
• Notater og Avstemninger har ingen innstillinger.
• Tavler: systemadministratorer kan laste opp formsamlinger (Excalidraw .excalidrawlib-filer, opptil 5 MB hver) for hele serveren på innstillings siden. Community-administratorer administrerer bibliotekene for sin egen community.
• Playbooks åpnes i sidepanelet. Gamle lenker til /playbooks/…-sider åpner samme kjøring eller playbook i en community. Den har noen få innstillinger, hovedsakelig eksperimentelle funksjoner; standardinnstillingene passer de fleste servere.
• Memes: Who can add meme templates: Alle (standard), System admins eller Nobody (custom templates off), som stopper nye maler mens de som allerede er lagt til forblir i bruk. Gjestene legger aldri til maler. Personen som la til en mal og systemadministratorer kan slette den.
• Gjøremål har ingen serverinnstillinger.

GitHub, GitLab og Jira

Disse appene kobler Antimatter til kodedepotet og problemsporet. Hver av dem krever en OAuth-app på den andre siden og en webhook som peker tilbake til Antimatter. Aktiver appen, og kjør deretter oppsett-kommandoen i en hvilken som helst kanal, som veileder deg steg for steg: /github setup, /gitlab setup eller /jira setup.

GitHub- og GitLab-appene genererer webhook-nøkkelen og krypteringsnøkkelen ved første lagring. GitHub-appen kan begrenses til organisasjoner (GithubOrg), og GitLab-appen til en gruppe (GitlabGroup). For GitHub Enterprise eller en selvhostet GitLab, angi grunn-URL-en.

Målepunkter

Metrics-appen samler serverens ytelsesindikatorer i en liten tidsseries database i Antimatter, slik at du kan laste dem ned eller inkludere dem i en supportpakke uten å kjøre Prometheus. Når den starter, aktiverer den serverens indikatorer-endepunkt (MetricsSettings.Enable). Se Drift.

Installasjon av andre apper

Antimatter kjører Mattermost-apper (plugins). Tre måter å legge til en på:

• Fra et fjernt marked. Aktiver fjernt marked (PluginSettings.EnableRemoteMarketplace) er deaktivert som standard, og Markeds-URL (PluginSettings.MarketplaceURL) er tom: Antimatter bruker ikke Mattermosts marked, og ignorerer adressen hvis en konfigurasjon fra Mattermost fortsatt inneholder den. For å liste appene fra en markedsserver du stoler på, aktiver innstillingen og angi URL-en. Bygget av apper som Antimatter leverer (Calls, Playbooks, Kanban og andre) fra dette markedet er skjult, slik at de ikke kan erstatte Antimatters: Tillat markedsplassversjoner av Antimatter-plugins (PluginSettings.AllowMarketplaceToReplaceAntimatterPlugins) er deaktivert som standard.
• Ved å laste opp en pakke (.tar.gz). Opplasting er deaktivert som standard og har ingen bryter i Systemkonsollen: angi AM_PLUGINSETTINGS_ENABLEUPLOADS=true, og bruk deretter Last opp plugin i Plugin Management, eller amctl --local plugin add app.tar.gz.
• Fra en URL: amctl plugin install-url <url>, også med opplasting aktivert.

Antimatter sjekker app-signaturer mot nøklene den stoler på: Antimatter-nøkkelen, nøkkelen Mattermost, Inc. signerer sine utgitte apper med (slik at en Mattermost-app du laster ned selv installeres), og eventuelle nøkler du legger til i PluginSettings.SignaturePublicKeyFiles. Med Krev pluginsignatur (PluginSettings.RequirePluginSignature, deaktivert som standard) aktivert, avvises apper uten signatur, og opplasting deaktiveres.

Noen apper laget for Mattermosts betalte utgaver sjekker etter en Mattermost-lisens selv og nekter å kjøre; Antimatter gir ikke ut en slik lisens for dem.