Skip to main content
サイトの構築とホスティング

Sites:ウェブサイトの構築とホスティング

Qoder Sites を使うと、Qoder CLI から直接ウェブサイトを構築・公開・管理できます。静的ページから、データベース・サーバー関数・オブジェクトストレージを備えた Agent App まで対応します。エントリーポイントは 3 つあります:
  • セッション内の自然言語(推奨):対話セッションで目的を伝えると、組み込みの Sites Skills が構築・公開・管理のフローを駆動します。
  • /sites パネル:TUI 内でサイト、共有ポリシー、環境変数を視覚的に管理します。
  • qoder sites ターミナルサブコマンド:スクリプトや自動化向けの、機械可読な JSON インターフェースです。

セッション内で構築・管理する

対話セッションには以下の Sites Skills が組み込まれており、自然言語で意図を伝えると起動します:
Skill用途
sites:sites-buildingゼロから、または既存プロジェクトからウェブサイトを構築し、公開用にパッケージ化する
sites:sites-build-agent-appデータベースバックエンドを備えた Agent App を構築する
sites:sites-hostingドラフトの公開、公開進捗の追跡、公開済みサイトの復元
sites:sites-management日常管理:サイト情報、共有ポリシー、環境変数、データ、ログ、アナリティクス
例:「dist をサイトとして公開して」「このサイトを指定メンバーのみに公開して」「昨日のアクセス解析を見せて」。 公開、削除、共有ポリシーの変更、Secret の削除などの書き込み操作では、Agent が影響を明示し、あなたの明確な確認を得てから実行します。確認と冪等性のセマンティクスは Skills が編成するため、リクエストを手作業で組み立てる必要はありません。

/sites パネル

対話セッションで /sites と入力するとパネルが開き、以下が行えます:
  • 一覧:自分が所有するサイトと共有されたサイトを閲覧
  • 詳細:サイトの状態、現在のデプロイ、進捗の確認
  • 公開 / 停止 / 再開 / 削除:公開は準備完了のデプロイから選択、削除には再確認が必要
  • 共有:アクセスポリシーをプライベート / 指定メンバー(メールまたは UID で招待)/ 組織 / パブリックの間で切り替え。パブリック化には追加の確認が必要
  • 環境変数(Secrets):追加・置換・削除。値は書き込み専用で、読み出すことはできません
パネルはローカルの対話 TUI でのみ利用できます。

ターミナルサブコマンド qoder sites

qoder sites list                 # 自分のサイトを一覧表示
qoder sites operations           # 利用可能な操作カタログを一覧表示
qoder sites describe <operation> # 操作の入力 JSON Schema を表示
qoder sites <operation> [--input <JSON> | --input-file <path>]
  • 対話ターミナルでは人間が読みやすいレンダリング(グループ別の操作カタログ、エラーサマリー、整形済み JSON)を出力します。パイプ・リダイレクト、および --session を伴う呼び出し(セッション内 Skills の固定契約)では、常にスクリプト解析向けの単一行 JSON({"schemaVersion": 1, ...})を出力します
  • list は自分のサイトを一覧表示します(--input '{"scope":"shared"}' で共有されたサイトを表示)。operations は操作カタログを一覧表示し、describe <operation> はその操作の入力 JSON Schema を出力します。これがパラメーターの正式な情報源です
  • 終了コード:0 成功、2 無効な入力、3 ログインまたはセッションが必要、4 競合、5 書き込み結果不明(再試行前に状態を照会してください)、6 キャンセル済み、1 その他

直接呼び出しに適した操作

読み取り専用のクエリ操作は、スクリプトや自動化から直接呼び出して安全です: list_sites、get_site、get_analytics、get_site_access、check_subdomain、get_function_logs、list_storage_objects、get_operation
qoder sites list_sites --input '{"page": 1}'
qoder sites describe get_analytics

Skills が駆動する操作

以下の機能は、セッションコンテキスト(--session)を携えたセッション内 Skills から呼び出され、Agent ワークフローの一部です:
  • 構築と公開のパイプライン:prepare_site、publish_site、get_publish_status、get_context
  • データベース管理:get_database_schema、create_database_migration、apply_database_migration、query_database_rows など
  • ストレージと各種書き込み操作:upload_storage_file、delete_storage_object、update_access_policy、delete_project など、確認・冪等性・参照(ref)セマンティクスを伴う操作
これらの機能を使う場合は、セッション内で意図を伝え、確認と呼び出しを Agent に任せてください。リクエストを手作業で組み立てると、確認の保護を迂回することになります。

ログインとネットワーク

ターミナルサブコマンドはローカルの Qoder ログイン状態を使用し、未ログイン時はログインへ案内します(認証を参照)。セッション内の呼び出しは現在のセッションの ID を使用し、別のローカルログインにフォールバックすることはありません。ネットワークルーティングは CLI の現在のネットワーク設定に従います(ネットワークを参照)。

次のステップ