インスタンス管理パネル

/instance-adminにあるインスタンス管理パネルは、インスタンス管理者がサーバー上のすべてのアカウントを横断的に確認できる場所です。いくつのアカウントがあるか、誰がそこに所属しているか、そして運用者だけが持つべき、ごく一部の破壊的な操作もここにあります。このページでは、このパネルでできることと、同じくらい重要な、意図的にできないようにされていることを説明します。

アカウントが1つだけの個人用インスタンスを運用しているなら、このパネルを使う機会は一度もないかもしれません。クラブや家族向けのサーバーのように、複数のアカウントを持つ共有インスタンスでこそ、その価値を発揮します。

概要

パネルを開くと、まずインスタンス全体の概要が表示されます。

• サーバー全体のアカウント数、ユーザー数、コレクション数、アイテム数。
• 今月作成されたアカウント数と今月のアクティブユーザー数。インスタンスが成長しているか、落ち着いているかがわかります。
• 過去12か月分の月ごとの登録者数を示すグラフ。

これらの数値はインスタンス全体のものです。誰かのカタログの中身が明らかになることはありません。

アカウントを閲覧する

アカウントエリアには、インスタンス上のすべてのアカウントが1ページあたり25件ずつ、それぞれのメンバー数とコレクション数とともに一覧表示されます。

メンバーのメールアドレスでアカウントを検索したり、権限で絞り込んだりできます。アカウント名や個人名での検索はできません。名前はデータベース内で暗号化されているため、照合できないからです。頼りになる手がかりはメールアドレスです。

アカウントを開くと、そのメンバーがオーナー、編集者、閲覧者の順に並んで表示され、そのアカウントのコレクション数とアイテム数、直近15件の操作履歴も確認できます。

削除の理由

ユーザーを削除する人は、その前に理由を尋ねられます。削除の理由の画面には、その回答が新しい順に、1ページあたり25件ずつ並びます。

1件は文章と日付だけです。書いた人とは結び付いておらず、その人がいなくなったあとも残ります。ユーザーは消えますが、文章は残ります。開くものも操作するものもないので、この画面は一覧を表示するだけです。

理由は保存時に暗号化されていて、アプリケーションで人が書くほかの文章と同じです。そのため、この画面に検索欄はありません。

サイトオプション

サイトオプションは、公開マーケティングサイト、つまり訪問者がログイン前に見るページの設定をまとめた場所です。セルフホストのインスタンスでは、このサイトは既定でオフになっています（インスタンスを設定するを参照）。一度もオンにしていないなら、ここでの設定がユーザーの目に触れることはありません。

お知らせバナー

バナーは、マーケティングサイトの各ページ最上部に表示される黒い帯です。短い一文を置くための場所で、注目してほしいリリース、メンテナンスの予定、イベントの告知などに向いています。

必要なのは文だけで、それ以外はすべて任意です。

• バナーを表示で表示と非表示を切り替えます。いいえにすると、他に何を入力していても帯は表示されません。
• バージョンは左側の小さな緑色のピルで、v0.9のように表示されます。空にすればピルは消えます。
• リンクはバナーのリンク先、リンクのラベルは訪問者がクリックする文字です。何かを伝えるだけのバナーにしたいときは、リンクを空のままにします。
• 文がお知らせ本体です。

マーケティングサイトは複数の言語で配信されるため、文とリンクのラベルは言語ごとに、タブを切り替えて書きます。空のままにした言語は英語にフォールバックするので、英語だけ書いておけば、すべての訪問者にバナーが表示されます。タブの緑の点は、その言語に固有の文があることを示します。

フォーム上部のプレビューには、いま開いているタブの言語で、訪問者に見えるとおりの帯が表示されます。保存するとCloudflareのキャッシュも自動的に消えるので、変更はすぐに反映されます。

Cloudflareのキャッシュを消す

マーケティングページはめったに変わらないため、各ページは一度だけレンダリングされ、その後7日間はCloudflareが保持します。おかげで公開サイトは高速ですが、その裏返しとして、修正が1週間見えないままになることもあります。

キャッシュを消すは、Cloudflareが保持しているページを一度にすべて破棄します。公開サイトが表示する内容のうち、アプリケーションが把握していないものを変更したとき、たとえばサーバー上でドキュメントのページを編集したときに使ってください。バナーの保存やレビューの承認は、それ自体でキャッシュを消します。

消しても失われるものはありません。各ページは次に誰かが開いたときに再びレンダリングされ、唯一の代償は、最初の訪問者がそのレンダリングを待つことだけです。同じことはコマンドラインのphp artisan kollek:purge-cloudflare-cacheでもできます。コマンドラインで管理するで説明しています。

このセクションは、Cloudflareの背後で配信されているインスタンス、つまりCLOUDFLARE_API_TOKENとCLOUDFLARE_ZONE_IDが設定されているインスタンスにだけ表示されます。設定がなければ消すものもありません。直接配信されるインスタンスは、求められたその場で各ページをレンダリングします。なお、訪問者自身のブラウザは何をしても5分間ページを保持し、どんな削除もその複製には届きません。

破壊的な操作

パネルには、データを変更または削除する操作が3つあり、いずれも取り消せません。

• アカウントの削除。 そのアカウントに含まれるすべてのコレクション、アイテム、コピー、メンバー、履歴が削除されます。
• ユーザーの削除。 その人がアカウントから削除されます。
• 他のユーザーの管理者フラグの切り替え。 他の人にインスタンス管理権限を付与したり、剥奪したりします。

インスタンス自体を守るための安全策が2つあります。管理者は自分自身のフラグを剥奪できず、パネルから自分自身のユーザーを削除することもできません。どう使われても、インスタンスには少なくとも1人の機能する管理者が残ります。

このパネルにないもの

このパネルは設計上、Web専用です。JSON APIは単一のアカウントに限定されており、インスタンス全体にまたがる操作はそこに存在しないため、これらの機能はAPIエンドポイントとしては提供されていません。

パネルに表示されているサポートとレビューのエリアはプレースホルダーであり、まだ実装されていません。機能の対応状況とロードマップを参照してください。

次に読むべきもの

• インスタンス管理者権限を付与するで、このフラグ自体の付与や剥奪について確認しましょう。
• メンバーと権限を管理するで、アカウントオーナーがあなたなしですでにできることを理解しましょう。
• コマンドラインで管理するで、他の運用者向けツールを確認しましょう。