Gateway
GatewayはAnyyの常駐ランタイムです。ライブセッション、ツール、チャンネル、スケジュール、バックグラウンドジョブ、配信を所有し、TUI、Dashboard、CLI、メッセージングクライアントが接続します。
サービスを確認する
anyy gateway status
解決済みProfileホーム、サービスホスト、ソケット、プロセス状態を示します。両バージョンが分かれば、実行Gatewayと現在CLIの不一致も報告します。
製品全体の確認には次も実行します。
anyy status
起動と停止
anyy gateway start
anyy gateway restart
anyy gateway stop
startは対応ユーザーサービスがなければインストールし、到達可能になるまで短く待ちます。restartも不足するサービス導入を復旧してから起動します。
ホストの対応サービスマネージャーを使います。macOSはlaunchdユーザーサービス、一般的Linuxはsystemdユーザーサービス、導入済みの場合は対応procd／s6連携を使います。
Gateway停止はチャンネルを切断し、ライブ制御、スケジュール、接続ランタイム作業を止めます。保守前にジョブ／プロセスを確認してください。別のDashboardプロセスやタブは、Gateway不在でも開いたままの場合があります。
Profileを選ぶ
各Gatewayは解決済みの1Profileを提供します。
anyy --profile work gateway status
選択はHomeを解決し、Profileごとのネイティブユーザーサービス資産は作りません。macOSは固定のcom.anyy.anyy、systemdはanyy.serviceを使います。既存資産が別Homeに属せば、サービスファイルを上書きせず所有権の問題を解決します。s6には独自のProfile別処理があります。Profileを参照してください。
TUIは既定ソケットがない場合、一時的にプロセス内Gatewayを開始でき、終了時に片付けます。その後も作業を続けるには常駐サービスを入れて起動します。2つの非管理プロセスで同Profileを開かないでください。所有権は状態変更するオフライン操作も保護します。
再起動する場面
対応する設定やDashboardの変更の多くは手動再起動なしで反映します。channel_webhooks.enabledとchannel_webhooks.listenは起動リスナー設定で再起動が必要です。アカウントReloadだけでは反映しません。Webhook設定を参照してください。再起動するのは次の場合です。
gateway statusがCLIとの版不一致を報告する。- 対処メッセージが明示的に求める。
- サービス導入済みだが通常再読み込み後も到達不能。
- オフライン保守手順を完了する。
トラブルシューティング
-
サービスを確認します。
anyy gateway status -
製品診断を実行します。
anyy doctor -
解決したProfileのサービスを再起動します。
anyy gateway restart -
ソケットやサービス管理ファイルを手動変更する前に
statusとdoctorを再実行します。
| 症状 | 次の操作 |
|---|---|
| サービス未導入 | anyy gateway start |
| CLIと実行Gatewayの版が違う | 更新後anyy gateway restart |
| Dashboard/TUI接続不能 | Profileとソケットが同じか確認 |
| オフライン保守で所有権取得不能 | そのProfileのGatewayを止めて再試行 |
診断項目はStatusとDoctorを参照してください。