メインコンテンツへスキップ

はじめに

このガイドでは、最初のBlocklet Serverインスタンスをセットアップして実行するための基本的な手順を説明します。わずか数分で、インストールから完全に機能するサーバーの起動までを完了できます。

前提条件

始める前に、お使いのシステムにNode.jsがインストールされていることを確認してください。Blocklet Serverが正しく機能するには、特定のバージョンのNode.jsが必要です。正確なバージョン要件については、プロジェクトのpackage.jsonにあるenginesフィールドを参照してください。

ステップ1：Blocklet CLIのインストール

最初のステップは、npmを使用してBlockletコマンドラインインターフェース（CLI）をグローバルにインストールすることです。このツールは、サーバーとblockletを管理するために必要なすべてのコマンドを提供します。

ターミナルを開き、次のコマンドを実行します：

Blocklet CLIのインストール

bash
npm install -g @blocklet/cli

インストールが完了したら、バージョンを確認して検証できます：

インストールの確認

bash
blocklet --version

ステップ2：サーバーの初期化

CLIがインストールされたので、Blocklet Serverの設定ファイルを作成する必要があります。これにはserver initコマンドを使用します。

  1. サーバー用の新しいディレクトリを作成し、そのディレクトリに移動します： サーバーディレクトリの作成 bash mkdir my-blocklet-server cd my-blocklet-server
  2. 初期化コマンドを実行します： サーバーの初期化 bash blocklet server init

このコマンドを実行すると、対話式のセットアップウィザードが起動し、設定プロセスをガイドします。サーバーの名前、説明、ポートなどの基本情報を尋ねられます。

対話式セットアップの例

text
? Naming the server? my-node
? Description of the server? My first Blocklet Server instance
? Which port do you want your server to listen on? 3030
? Choose routing engine (Use arrow keys)
❯ nginx
  caddy
  none
...

完了すると、config.ymlファイルやその他必要なサーバーデータを含む、新しい.blocklet-serverディレクトリが作成されます。

ステップ3：サーバーの起動

設定が完了したら、サーバーを起動できます。server startコマンドは、メインデーモンやサービスを含む、必要なすべてのバックグラウンドプロセスを起動します。

サーバーの起動

bash
blocklet server start

しばらくすると、サーバーが起動します。コンソールにはサーバーのダッシュボードへのアクセスURLが表示され、Webブラウザからサーバーを管理できます。

起動成功時の出力

text
...✅ Blocklet Server daemon started successfully!

ℹ Your Blocklet Server is running at the following URLs:
  - http://192.168.1.100/admin/
  - http://127.0.0.1/admin/

オールインワンコマンド

より迅速にセットアップを行うには、--auto-initフラグを使用して初期化と起動を1つのコマンドにまとめることができます。この方法は、サーバーをデフォルト設定で初期化してすぐに起動するため、開発環境やテスト環境に最適です。

自動初期化と起動

bash
# 空のディレクトリにいることを確認してください
blocklet server start --auto-init

このコマンドは、適切なデフォルト値で設定を自動的に作成し、サーバーを起動します。準備が整うと、アクセスURLが出力されます。

これで、Blocklet Serverのインストールと実行が完了しました。次にサーバー管理セクションに進み、インスタンスの停止、ステータスの確認、およびその他の管理方法について学びましょう。