Medföljande appar

Antimatters Docker-images innehåller en uppsättning appar (plugins, i Systemkonsolen). Denna sida listar dem, anger vilka som är aktiverade efter installationen och beskriver de inställningar varje app kräver från en administratör.

De medföljande apparna

Apparna listas som Plugins i Systemkonsolen. De finns i image:n (i /antimatter/prepackaged_plugins), är signerade med Antimatters app-signeringsnyckel och installeras därför utan internetanslutning.

Släpparkivet samt .deb- och .rpm-paketerna innehåller färre appar: se Appar i paketen och arkivet.

Appar som är aktiverade som standard installeras vid varje start om de inte redan finns, eller uppgraderas om image:n innehåller en nyare version. Om du inaktiverar en app förblir den inaktiverad: standardinställningen gäller endast för appar som konfigurationen inte ännu nämner. Appar som behåller sitt Mattermost-id (Agenter, Samtal, Kanban, Playbooks och integreringarna) är Antimatters egna byggen.

Aktivera, inaktivera och konfigurera appar

Gå till Systemkonsol › Plugin › Pluginadministration. Under Installerade plugins finns Aktivera eller Avaktivera, Inställningar och Ta bort för varje app, samt dess status (Kör, Ej i körning, Start misslyckades…). Varje app med inställningar har också en egen sida under Systemkonsol › Plugin.

De medföljande appar som är avstängda som standard installeras från bildens egen kopia: klicka på din bild i toppen av appspalten och välj App Marketplace (i det klassiska gränssnittet finns det i produktmenyn), hitta appen och klicka på Installera, aktivera den sedan i Pluginadministration. Från kommandoraden:

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

Andra kommandon: amctl plugin list, amctl plugin disable <id>, amctl plugin delete <id>.

Aktivera appar via konfigurationen

Vilka appar som är aktiverade anges i inställningen PluginSettings.PluginStates, en mappning av app-id:n. Du kan slå ihop poster i den med amctl; med Aktivera Automatiska förpaketerade plugins på (standardinställningen) installeras en aktiverad medföljande app vid nästa 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

Detta är också hur du installerar Att göra, som inte erbjuds i dialogrutan för Marketplace. Variabeln AM_PLUGINSETTINGS_PLUGINSTATES fungerar också, men den ersätter hela mappningen: lista alla appar du vill ha aktiverade.

Appinställningar

App-inställningarna lagras under PluginSettings.Plugins.<app id>, med nycklar i gemena bokstäver. Ändra dem på appens Systemkonsol-sida eller med amctl config patch som visas i Konfiguration. AM_PLUGINSETTINGS_PLUGINS byter ut inställningarna för alla appar på en gång och låser dem, så undvik det.

GIF

Appen GIF-bilder lägger till en flik för GIF-bilder och klistermärken i emojiväljaren, med Antimatters GIF-tjänst (gifs-server) som bakgrund, som kommunicerar med Tenor API. Webbplatsens compose-fil startar tjänsten och konfigurerar appen genom variabler. Dess inställningar, under Systemkonsol › Plugin › GIF-bilder:

För denna app är variablerna bara fallbacks: ett värde satt i Systemkonsolen har företräde framför dem. Om GIF-väljaren förblir tom, kontrollera tjänstens URL och API-nyckeln på den sidan.

När appen GIF-bilder är konfigurerad ersätter dess flik den inbyggda Giphy-väljaren (Systemkonsol › Integrationer › GIF › Aktivera GIF-väljare, ServiceSettings.EnableGifPicker).

GIF-tjänsten

Tjänsten lagrar allt i sin datakatalog (/data, volymen gifs): en sökindex och medien. Dess huvudvariabler:

För att lägga till egna GIF:er i bulk, importera dem med en manifestfil från en katalog som är monterad i en engångskontainer:

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

För att återimportera startstickrarna efter en uppgradering: docker compose run --rm gifs stickers. Manifestformatet och de andra kommandona finns i gifs-server README.

E-post och Kalender

E-post och Kalender kopplar varje person till sin egen postlåda (IMAP och SMTP) och sin egen kalender (CalDAV). Personer anger sin server och lösenord i appen; lösenorden lagras krypterade. Du konfigurerar inte e-post- eller kalendrarserver för dem, men du bestämmer vad de får ansluta till:

För att låta personer logga in på Gmail- eller Microsoft 365-postlådor med sitt konto i stället för ett lösenord, skapa en OAuth-klient och fyll i fälten för Google eller Microsoft i E-post-appen:

• Google: en web-OAuth-klient med Gmail API och omfånget https://mail.google.com/.
• Microsoft: en Entra ID-app med de delegerade behörigheterna IMAP.AccessAsUser.All, SMTP.Send, offline_access, openid, email och profile. Tenanten är common som standard.
• I båda är omdirigerings-URI:en https://chat.example.com/plugins/com.antimatterchat.mail/oauth/callback (din webbplats-URL).

Kanban, Anteckningar, Whiteboard, Omröstningar och Playbooks

• Kanban (focalboard) öppnas i sitt sidopanel intill konversationen, precis som Playbooks. Gamla länkar till /kanban/… och /boards/…-sidor öppnar samma tavla eller kort i en gemenskap. Dess enda inställning, Aktivera Offentligt Delade Tavlor (EnablePublicSharedBoards, av), gör det möjligt för tavleredigerare att dela en tavla med alla som har länken, utan att logga in.
• Anteckningar och Omröstningar har inga inställningar.
• Whiteboard: systemadministratörer kan ladda upp formsamlingar (Excalidraw-filer med ändelsen .excalidrawlib, högst 5 MB vardera) för hela servern på inställningssidan. Community-administratörer hanterar sina egna communitys formsamlingar.
• Playbooks öppnas i sitt sidofält. Gamla länkar till /playbooks/…-sidor öppnar samma körning eller playbook i en community. Det finns några inställningar, mest experimentella funktioner; standardinställningarna passar de flesta servrar.
• Memes: Vem kan lägga till mememallar: Alla (standard), Systemadministratörer eller Ingemån (anpassade mallar avstängda), vilket stoppar nya mallar medan de som redan har lagts till fortfarande går att använda. Gäster lägger aldrig till mallar. Personen som lade till en mall och systemadministratörer kan ta bort den.
• Att göra har inga serverinställningar.

GitHub, GitLab och Jira

Dessa appar kopplar Antimatter till din kodhosting och ditt problemspårningssystem. Varje app kräver en OAuth-tillämpning på den andra sidan och en webhook som pekar tillbaka till Antimatter. Aktivera appen och kör sedan dess installationskommando i valfri kanal, vilket guidar dig steg för steg: /github setup, /gitlab setup eller /jira setup.

GitHub- och GitLab-apparna genererar sin webhook-secret och sin krypteringsnyckel vid första sparande. GitHub-appen kan begränsas till organisationer (GithubOrg) och GitLab-appen till en grupp (GitlabGroup); för GitHub Enterprise eller en självhostad GitLab, ställ in dess bas-URL.

Metriker

Metrics-appen samlar in serverns prestandamått i en liten tidsseriedatabas inuti Antimatter, så att du kan ladda ner dem eller inkludera dem i ett supportpaket utan att köra Prometheus. När den startar, aktiverar den serverns metrics-endpoint (MetricsSettings.Enable). Se Drift.

Installera andra appar

Antimatter kör Mattermost-appar (plugins). Tre sätt att lägga till en:

• Från en fjärrmarketplace. Remote Marketplace aktiverad (PluginSettings.EnableRemoteMarketplace) är avstängd som standard, och Marketplace URL (PluginSettings.MarketplaceURL) är tom: Antimatter använder inte Mattermosts marketplace och ignorerar dess adress om en konfiguration från Mattermost fortfarande innehåller den. För att visa apparna från en marketplace-server du litar på, aktivera inställningen och ange dess URL. Marktplatsens versioner av appar som Antimatter levererar (Calls, Playbooks, Kanban och andra) döljs, så att de inte kan ersätta Antimatters: Tillåt Marketplace-versioner av Antimatter-plugins (PluginSettings.AllowMarketplaceToReplaceAntimatterPlugins) är avstängd som standard.
• Vid uppladdning av en bundle (.tar.gz). Uppladdningar är inaktiverade som standard och har ingen växlar i Systemkonsolen: sätt AM_PLUGINSETTINGS_ENABLEUPLOADS=true, använd sedan Ladda upp plugin i Pluginhanteringen, eller amctl --local plugin add app.tar.gz.
• Från en URL: amctl plugin install-url <url>, även med uppladdningar aktiverade.

Antimatter verifierar app-signaturer mot de nycklar den litar på: Antimatters nyckel, den nyckel Mattermost, Inc. signar sina publicerade appar med (så att en Mattermost-app du laddar ner själv kan installeras) och eventuella nycklar du lägger till i PluginSettings.SignaturePublicKeyFiles. Med Kräv Plugin-signatur (PluginSettings.RequirePluginSignature, avstängd som standard) aktiverad, avvisas appar utan signatur och uppladdningar stängs av.

Vissa appar gjorda för Mattermosts betalda utgåvor kontrollerar själva efter en Mattermost-licens och vägrar att köra; Antimatter gör inte anspråk på att ha en sådan för dem.