blocklet server init コマンドは、現在の作業ディレクトリに専用の設定ディレクトリ .blocklet-server を作成することで、新しい Blocklet Server インスタンスを初期化します。このディレクトリには、サーバーを実行するために必要な config.yml ファイルやその他のアセットが含まれています。このプロセスは、ガイド付きセットアップを通じて対話的に実行することも、コマンドラインフラグを使用して非対話的に実行することもできます。
使用方法
新しいサーバー設定を初期化するには、目的のディレクトリに移動して次のコマンドを実行します。
基本的な初期化コマンド
blocklet server initこのコマンドをフラグなしで実行すると、対話式のセットアップウィザードが起動し、設定プロセスをガイドします。
対話式設定
対話モードで実行すると、CLI は必要な設定詳細を尋ねるプロンプトを表示します。以下の表は、各質問、その説明、および提供されるデフォルト値の概要です。
| プロンプト | 説明 | デフォルト値 |
|---|---|---|
| サーバーの名前は？ | Blocklet Server インスタンスの人間が読める名前。 | ランダムに生成された名前（例：purple-shape-7133） |
| サーバーの説明は？ | サーバーの目的を概説する簡単な説明。 | My Blocklet Server |
| サーバーがリッスンするポートはどれですか？ | Blocklet Server デーモンプロセスの内部ポート。 | 3030 |
| ルーティングエンジンを選択 | 受信トラフィックを管理するルーティングプロバイダー（例：Nginx）。 | nginx のような既存のプロバイダーを自動的に検出します。 |
| 管理ダッシュボードをどこにマウントしますか？ | サーバーの管理インターフェースにアクセスするための URL パス。 | /admin |
| どの Web ウォレットを使用しますか？ | サーバーと統合される Web ウォレットの URL。 | 環境によって異なります。 |
| https サポートを有効にしますか... | ダッシュボードと blocklet の SSL/TLS を有効または無効にします。 | true |
| IP ワイルドカードドメインは何ですか？ | サーバーの IP アドレス経由で blocklet にアクセスするためのドメイン。 | ip.abtnet.io |
| ワイルドカード証明書はどこからダウンロードしますか？ | HTTPS サポート用のワイルドカード証明書を取得するための URL。 | https://releases.arcblock.io/certs/ |
| サーバーで許可される最大アップロードファイルサイズ（MB）は？ | アップロードに許可される最大ファイルサイズ。 | 16 MB |
| サービスゲートウェイがリッスンする http ポートはどれですか？ | ルーティングエンジンの公開 HTTP ポート。 | 80 |
| サービスゲートウェイがリッスンする https ポートはどれですか？ | ルーティングエンジンの公開 HTTPS ポート。 | 443 |
| Blocklet Server の最大メモリ制限（GB）は？ | Blocklet Server デーモンに割り当てられる最大 RAM。 | 4 GB |
| 各 Blocklet の最大メモリ制限（GB）は？ | 個々の blocklet に割り当てられる最大 RAM。 | 1 GB |
コマンドオプション
初期化プロセスは、次のコマンドラインオプションを使用してカスタマイズまたは自動化できます。
| オプション | 説明 |
|---|---|
-y, --yes | サーバーを非対話的に初期化し、すべてのデフォルト値を受け入れます。これは自動化スクリプトに便利です。 |
--force | -y および --yes のエイリアス。 |
--mode <mode> | サーバーの動作モードを設定します。有効なオプションは production (デフォルト) と debug です。 |
--no-https | サーバーの HTTPS サポートを無効にします。HTTPS はデフォルトで有効です。 |
--http-port <port> | サービスゲートウェイの公開 HTTP ポートを指定し、対話式プロンプトを上書きします。 |
--https-port <port> | サービスゲートウェイの公開 HTTPS ポートを指定し、対話式プロンプトを上書きします。 |
--sk <secret_key> | 新しいランダムなウォレットを作成する代わりに、カスタムの秘密鍵を提供してサーバーのウォレットを生成します。 |
--interactive | 他の非対話的なフラグが存在する場合でも、コマンドを強制的に対話モードで実行します。 |
非対話的な例
プロンプトなしでサーバーを初期化するには、-y フラグを使用します。このコマンドは、スクリプト作成や自動化に最適です。
非対話的な初期化
blocklet server init -y --mode production --http-port 8080生成されるファイル
初期化が成功すると、現在の作業ディレクトリに次のファイルとディレクトリが作成されます。
.blocklet-server/: Blocklet Server インスタンスの主要な設定ディレクトリ。.blocklet-server/config.yml: YAML 形式のメイン設定ファイル。サーバー名、ポート、ルーティング情報、ウォレットの詳細など、セットアップ中に提供されたすべての設定が保存されます。.blocklet-server/.sock:config.yml内のサーバーウォレットの秘密鍵を保護するために使用される暗号化キーを含むファイル。このファイルはウォレットの回復に不可欠であり、安全にバックアップする必要があります。
次のステップ
サーバーの設定が完了したら、次のステップはサーバーを起動することです。Blocklet Server デーモンを起動する方法については、次のセクションに進んでください。