Skip to content

cornus storage

Cornus サーバーのストレージ消費量を、何も変更せずに報告します。

構文

sh
cornus storage usage [flags]

説明

cornus storage はサーバーのストレージ管理をまとめたものです。現時点では、非破壊的なレポートを一つ提供します。領域の回収はサーバー側 (POST /.cornus/v1/gc エンドポイントと定期 GC スケジューラー) のままです。

cornus storage usageGET /.cornus/v1/storage を取得し、現在の使用量を表示します: レジストリのコンテンツストア (ブロブ数と合計バイト数) と、ファイル単位のブロックキャッシュが有効な場合はその使用量。ガベージコレクションの読み取り専用の対応物であり、何も削除も退避もしません。

このレポートは、レジストリのすべてのブロブを列挙して stat することで算出されます。そのため、ファイルシステムバックエンドに対しては安価ですが、S3 のようなオブジェクトストアに対してはより高価です (ブロブごとに 1 回の HEAD)。タイトなループでポーリングするメトリクスではなく、たまに実行する運用者向けの問い合わせとして扱ってください。

このコマンドは、選択された接続プロファイル (cornus config を参照) を通じてサーバーを解決するため、--context、トークン、TLS がすべて適用されます。1 回の実行だけエンドポイントを上書きするには --server を渡します。

フラグ環境変数既定値説明
--serverCORNUS_SERVERリモート Cornus サーバーの URL (http(s):// または ws(s)://)。選択された接続プロファイルにフォールバックします。
--formattext出力形式: text (人間が読みやすい形式) または json (生のレポート)。

JSON 形式には次のフィールドがあります (ブロックキャッシュが無効な場合、fileCache* は省略されます):

フィールド説明
casBlobsレジストリのコンテンツストア内のブロブ数。純粋な再エクスポート構成 (コンテンツストアなし) ではゼロ。
casBytesそれらのブロブの合計バイト数。
fileCacheBytesファイル単位のブロックキャッシュのディスク上のサイズ。
fileCacheFilesブロックキャッシュのファイル数。

人間が読みやすいレポートを表示します。

sh
cornus storage usage
Registry CAS: 128 blobs, 3.4 GiB
Block cache:  12 files, 512.0 MiB

スクリプト向けに生のレポートを取得します。

sh
cornus storage usage --format json
json
{
  "casBlobs": 128,
  "casBytes": 3650722201,
  "fileCacheBytes": 536870912,
  "fileCacheFiles": 12
}

特定のサーバーに問い合わせます。

sh
cornus storage usage --server https://cornus.example.com

関連項目

  • cornus config — このコマンドが解決に使用する接続プロファイル。
  • ガベージコレクションはサーバー側です。サーバーリファレンスの POST /.cornus/v1/gc エンドポイントと CORNUS_GC_INTERVAL 定期スケジューラーを参照してください。

Released under the Apache-2.0 License.