Mattermost: mmctlを使用したMattermostの高度な管理

このドキュメントははじめにガイドの一部です。完全なガイドはこちらからご覧いただけます：Mattermostの始め方。

Stackheroドキュメントへようこそ

Stackheroは、シームレスなコラボレーションと強力なデータ保護のために設計された、プロダクション対応のMattermost cloud環境を提供します。主な特長は以下の通りです：

• チームの成長を制限しない、無制限のユーザー数とチャンネル数。
• 追加制限なしで利用できる、専用のSMTPメールサーバーを標準搭載。
• ご自身のドメイン名を完全に管理可能、HTTPSで自動的にセキュア化（例：https://chat.your-company.com）。
• ワンクリックで実行できる、手間のかからないアップデート管理。
• プライベートかつ専用インフラ上での高いパフォーマンスと高度なセキュリティ：データは常に分離され、機密性が保たれます。
• 🇪🇺 ヨーロッパおよび🇺🇸 USAリージョンでのホスティングに対応。

数分で導入を開始できます。Stackheroがセットアップ、セキュリティ、運用管理を担当し、Mattermost cloud hostingを安全かつスケーラブルなコラボレーションプラットフォームとして、最小限の手間でご利用いただけます。

さらに深く掘り下げたい方には、mmctl CLIがMattermostインスタンスを管理および設定するための強力なツールを提供します。詳細は公式ドキュメントで確認できます：https://docs.mattermost.com/manage/mmctl-command-line-tool.html。

MattermostでのCLI mmctlの使用

mmctlをコンピュータにインストールするか、Dockerを使用して実行するオプションがあります。Dockerの使用をお勧めします。インタラクティブなbashシェルでコンテナを起動するには、次を実行します。

docker run -it mattermost/mattermost-team-edition:latest /bin/bash

ログインするには、次を実行してサーバーに接続を確立します。

mmctl auth login -n stackhero https://<XXXXXX>.stackhero-network.com

Mattermostの認証情報を入力するよう求められます。ログイン後、mmctl CLIを使用してさまざまな管理タスクを実行できます。

二要素認証を使用していて「could not initiate client: Invalid MFA token」というエラーが発生した場合は、MFAトークン（MFAアプリからの6桁のコード）を次のように実行して含めます。

mmctl auth login -n stackhero --mfa-token <XXXXXX> https://<XXXXXX>.stackhero-network.com

認証に成功した後、次のコマンドでMattermostユーザーをすべてリストすることができます。

mmctl user list

mmctlを使用したMattermostユーザーの削除

注意: この操作はユーザーと関連データを完全に削除し、復元は不可能です。

Mattermostシステムコンソールからユーザーを無効にすることはできますが、削除はmmctl CLIを使用して行う必要があります。ユーザーを削除するには、次を実行します。

mmctl user delete [email protected]

「Permanent user deletion feature is not enabled. Please contact your System Administrator」というエラーが発生した場合は、次のようにしてAPIサポートを介してユーザー削除を有効にします。

mmctl config set ServiceSettings.EnableAPIUserDeletion true

mmctlを使用したMattermostチャンネルの削除

mmctl CLIを使用してチャンネルを削除できます。

注意: この操作はチャンネルとそのデータを完全に削除し、復元は不可能です。

チャンネルを削除するには、<TEAM>と<CHANNEL>を特定の値に置き換えて実行します。

mmctl channel delete <TEAM>:<CHANNEL>

「Permanent channel deletion feature is not enabled. Please contact your System Administrator.」というエラーが発生した場合は、次のようにしてこの機能を有効にします。

mmctl config set ServiceSettings.EnableAPIChannelDeletion true