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

クイックデプロイガイド（Docker Compose ワンクリックデプロイ）

千桐テクノロジー2026/08/18約2分インストールとデプロイワンクリック起動クイックスタート

はじめに

このガイドに向いている方

  • qData を初めて利用し、機能をすばやく体験したい方
  • 環境設定、データベース初期化、各サービスの個別起動を手動で行いたくない方
  • スクリプト 1 つでプラットフォーム全体を起動したい方

使用前の確認事項

  • デプロイ中に Docker イメージをダウンロードするため、イメージレジストリへアクセスできるネットワーク環境が必要です。
  • 中国大陸のネットワーク環境では、利用可能な Docker レジストリミラーを事前に設定してください。
  • Windows で Docker Desktop を使用する場合は、Linux Containers モードへ切り替えてください。

Docker イメージは 2 つのアーキテクチャに対応

このデプロイパッケージで使用する Docker イメージは、amd64（x86_64） と arm64 の両方に対応しています。イメージを pull すると、Docker がホストの CPU アーキテクチャを自動判別し、適切なイメージを選択します。イメージタグを手動で切り替える必要はありません。

デプロイパッケージには次のものが含まれています。

  • ✅ フロントエンド静的リソース（ビルド済みの dist フォルダー）
  • ✅ DolphinScheduler スケジューラー
  • ✅ Hadoop（HDFS + YARN）
  • ✅ Spark 3.5.6
  • ✅ 設定済みの .env 環境変数ファイル
  • ✅ 完全なディレクトリ構成、Docker Compose 設定、ワンクリックスクリプト

フロントエンドのビルドやデータベースの手動初期化は不要です。Docker をインストールし、デプロイパッケージを展開して、対応するスクリプトを実行するだけで起動できます。

Docker イメージには Python 3 がインストール済みです。ホストに Python を別途インストールする必要はありません。

ステップ 1：Docker と Docker Compose をインストールする

qData は Docker コンテナで動作します。デプロイ前に Docker をインストールして起動してください。

  • Docker：≥ v20.10
  • Docker Compose：≥ v2.20.2
🖥️ Windows / macOS

Docker Desktop をダウンロードしてインストールします。Docker Compose は Docker Desktop に含まれているため、別途インストールする必要はありません。

インストール後、次のコマンドで確認します。

docker version
docker compose version

ステップ 2：デプロイパッケージをダウンロードする

🔗 Baidu Netdisk：https://pan.baidu.com/s/1sKgeBnMZmRnIr42_pVHmiw

🔑 展開コード：QQ コミュニティグループに参加し、グループファイルで確認してください。👉 QQ コミュニティグループに参加する

ダウンロードして展開した後、デプロイパッケージ内の docker フォルダーでスクリプトを実行します。

ステップ 3：ワンクリックスクリプトを実行する

3.1 Linux / macOS

Linux と macOS では qdata.sh を使用し、軽量起動、フル起動、アンインストールを選択できます。

コマンド用途
sh qdata.sh start light --demoqData の軽量環境とデモデータベースを起動します。DolphinScheduler と Spark は起動しません
sh qdata.sh start all --demoqData のフル環境とデモデータベースを起動します
sh qdata.sh uninstallqData をアンインストールし、コンテナ、データ、関連イメージを削除します

起動

docker フォルダーでターミナルを開き、次を実行します。

# 軽量起動
sh qdata.sh start light --demo

# フル起動
sh qdata.sh start all --demo

アンインストール

sh qdata.sh uninstall

確認を求められたら DELETE QDATA と入力します。

警告

アンインストールすると qData のコンテナと実行データが削除されます。必要なデータは事前にバックアップしてください。

3.2 Windows

Windows では 3 つのスクリプトを提供しています。

スクリプト用途違い
start-light.batqData 軽量版を起動DolphinScheduler と Spark を起動しないため、起動が速く、使用リソースも少なくなります
start-all.batqData フル版を起動DolphinScheduler、Spark など、すべての依存サービスを起動します
uninstall.batqData をアンインストールコンテナ、データ、関連イメージを削除します

実行方法

デプロイパッケージの docker フォルダーを開き、必要な .bat ファイルをダブルクリックします。

PowerShell または CMD でも実行できます。

# 軽量版を起動
.\start-light.bat

# フル版を起動
.\start-all.bat

# アンインストール
.\uninstall.bat

どの起動スクリプトを選ぶべきですか？

  • qData をすばやく体験する場合：start-light.bat を実行します。
  • DolphinScheduler や Spark などの全機能を利用する場合：start-all.bat を実行します。

アンインストール時は、確認を求められたら DELETE QDATA と入力します。qData のコンテナと実行データが削除されるため、必要なデータは事前にバックアップしてください。

デプロイ完了！🎉

デプロイ後、次のアドレスへアクセスできます。

  • 🌐 qData データプラットフォーム
    http://<サーバーIP>:80
    アカウント：admin
    パスワード：qData123

  • 📅 DolphinScheduler
    http://<サーバーIP>:12345/dolphinscheduler/ui/home
    アカウント：admin
    パスワード：dolphinscheduler123

⚠️ DolphinScheduler はフル版でのみ起動します。

🔑 <サーバーIP> はサーバーのパブリック IP またはプライベート IP に置き換えてください。

💡 重要

  • 初回起動後は、すべてのコンテナの初期化が完了するまで 1～2 分 待つことを推奨します。
  • docker ps でコンテナの状態を確認できます。
  • アクセスできない場合は、サーバーのファイアウォールでポート 80 が開放されているか確認してください。
最終更新:
qData オープンソースデータプラットフォーム
Copyright © 2026 千桐テクノロジー