Compare commits
5 Commits
8933613114
...
c2de0ef9d9
Author | SHA1 | Date |
---|---|---|
![]() |
c2de0ef9d9 | |
![]() |
112fb2b629 | |
![]() |
ee078f0a17 | |
![]() |
9843ddaf4b | |
![]() |
65265bd84e |
|
@ -4,80 +4,69 @@ title: 用 Docker 快速体验 TDengine
|
|||
description: 使用 Docker 快速体验 TDengine 的高效写入和查询
|
||||
---
|
||||
|
||||
本节首先介绍如何通过 Docker 快速体验 TDengine,然后介绍如何在 Docker 环境下体验 TDengine 的写入和查询功能。如果你不熟悉 Docker,请使用[安装包的方式快速体验](../../get-started/package/)。如果您希望为 TDengine 贡献代码或对内部技术实现感兴趣,请参考 [TDengine GitHub 主页](https://github.com/taosdata/TDengine)下载源码构建和安装。
|
||||
本节首先介绍如何通过 Docker 快速体验 TDengine,然后介绍如何在 Docker 环境下体验 TDengine 的写入和查询功能。如果您不熟悉 Docker,请使用[安装包的方式快速体验](../../get-started/package/)。如果您希望为 TDengine 贡献代码或对内部技术实现感兴趣,请参考 [TDengine GitHub 主页](https://github.com/taosdata/TDengine)下载源码构建和安装。
|
||||
|
||||
:::note
|
||||
从 3.3.7.0 版本开始,TDengine TSDB 的镜像名称从 `tdengine/tdengine` 重命名为 `tdengine/tsdb`.
|
||||
:::
|
||||
|
||||
## 启动 TDengine
|
||||
|
||||
如果已经安装了 Docker,首先拉取最新的 TDengine 容器镜像:
|
||||
1. 拉取 TDengine 容器镜像:
|
||||
|
||||
```shell
|
||||
# 拉取最新版本的 Docker 镜像
|
||||
docker pull tdengine/tsdb:latest
|
||||
```
|
||||
|
||||
或者指定版本的容器镜像:
|
||||
|
||||
```shell
|
||||
# 拉取制定版本的 Docker 进入容器,例如:3.3.7.0
|
||||
docker pull tdengine/tsdb:3.3.7.0
|
||||
```
|
||||
|
||||
然后只需执行下面的命令:
|
||||
|
||||
```shell
|
||||
docker run -d \
|
||||
-p 6030:6030 -p 6041:6041 -p 6043:6043 -p 6060:6060 \
|
||||
-p 6044-6049:6044-6049 -p 6044-6045:6044-6045/udp \
|
||||
tdengine/tsdb
|
||||
```
|
||||
|
||||
:::note
|
||||
|
||||
1. 从 3.3.7.0 版本开始,TDengine 的镜像名称从 `tdengine/tdengine` 重命名为 `tdengine/tsdb`.
|
||||
1. TDengine 3.0 服务端仅使用 6030 TCP 端口。6041 为 taosAdapter 所使用提供 REST 服务端口。6043 为 taosKeeper 使用端口。6044-6049 TCP 端口为 taosAdapter 提供第三方应用接入所使用端口,可根据需要选择是否打开。6044 和 6045 UDP 端口为 statsd 和 collectd 格式写入接口,可根据需要选择是否打开。6060 为 taosExplorer 使用端口。具体端口使用情况请参考[网络端口要求](../../operation/planning#网络端口要求)。
|
||||
|
||||
:::
|
||||
|
||||
如果需要将数据持久化到本机的某一个文件夹,则执行下边的命令:
|
||||
2. 启动 TDengine Docker 容器:
|
||||
|
||||
```shell
|
||||
docker run -d \
|
||||
-v ~/data/taos/dnode/data:/var/lib/taos \
|
||||
-v ~/data/taos/dnode/log:/var/log/taos \
|
||||
-p 6030:6030 -p 6041:6041 -p 6043:6043 -p 6060:6060 \
|
||||
-p 6044-6049:6044-6049 -p 6044-6045:6044-6045/udp \
|
||||
-p 6044-6049:6044-6049 \
|
||||
-p 6044-6045:6044-6045/udp \
|
||||
--name tdengine-tsdb
|
||||
tdengine/tsdb
|
||||
```
|
||||
|
||||
:::note
|
||||
关于 TDengine 的端口占用情况,请参考运维指南中的[网络端口要求](../../operation/planning/#网络端口要求)章节。
|
||||
|
||||
- /var/lib/taos: TDengine 默认数据文件目录。可通过[配置文件]修改位置。你可以修改 ~/data/taos/dnode/data 为你自己的数据目录
|
||||
- /var/log/taos: TDengine 默认日志文件目录。可通过[配置文件]修改位置。你可以修改 ~/data/taos/dnode/log 为你自己的日志目录
|
||||
|
||||
:::
|
||||
|
||||
确定该容器已经启动并且在正常运行。
|
||||
3. 查看 TDengine Docker 容器的运行状态:
|
||||
|
||||
```shell
|
||||
docker ps
|
||||
docker ps -f name=tdengine-tsdb
|
||||
```
|
||||
|
||||
进入该容器并执行 `bash`
|
||||
请查看已命令输出的 STATUS (状态) 字段,如果该状态的值为 "Up ... (healthy)", 说明容器已启动并正常运行。
|
||||
|
||||
4. 进入容器体验 TDengine
|
||||
|
||||
执行以下命令,进入容器内部:
|
||||
|
||||
```shell
|
||||
docker exec -it <container name> bash
|
||||
docker exec -it tdegnine-tsdb bash
|
||||
```
|
||||
|
||||
然后就可以执行相关的 Linux 命令操作和访问 TDengine。
|
||||
然后,就可以执行相关的 Linux 命令操作和访问 TDengine.
|
||||
|
||||
## TDengine 命令行界面
|
||||
|
||||
进入容器,执行 `taos`:
|
||||
进入容器后,在命令行执行 `taos` 即可进入 taos shell:
|
||||
|
||||
```shell
|
||||
$ taos
|
||||
taos
|
||||
|
||||
taos>
|
||||
```
|
||||
|
||||
关于使用 Docker 部署 TDengine 的更多详情,请参考运维指南中的 [Docker 部署](../../operation/deployment/#docker-部署)章节。
|
||||
|
||||
import Getstarted from './_get_started.mdx'
|
||||
|
||||
<Getstarted />
|
||||
|
|
|
@ -35,6 +35,7 @@ else
|
|||
${csudo}rm -f ${bin_link_dir}/taosdemo || :
|
||||
${csudo}rm -f ${bin_link_dir}/taoskeeper || :
|
||||
${csudo}rm -f ${bin_link_dir}/taos-explorer || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosmqtt || :
|
||||
${csudo}rm -f ${cfg_link_dir}/* || :
|
||||
${csudo}rm -f ${inc_link_dir}/taos.h || :
|
||||
${csudo}rm -f ${inc_link_dir}/taosdef.h || :
|
||||
|
|
|
@ -110,7 +110,8 @@ sed -i "s/versionType=\"enterprise\"/versionType=\"community\"/g" ${pkg_dir}${in
|
|||
cp ${compile_dir}/build/bin/taosd ${pkg_dir}${install_home_path}/bin
|
||||
cp ${compile_dir}/build/bin/taosudf ${pkg_dir}${install_home_path}/bin
|
||||
cp ${compile_dir}/build/bin/taosBenchmark ${pkg_dir}${install_home_path}/bin
|
||||
cp ${compile_dir}/build/bin/taosdump ${pkg_dir}${install_home_path}/bin
|
||||
cp ${compile_dir}/build/bin/taosdump ${pkg_dir}${install_home_path}/bin
|
||||
cp ${compile_dir}/build/bin/taosmqtt ${pkg_dir}${install_home_path}/bin
|
||||
|
||||
if [ -f "${compile_dir}/build/bin/taosadapter" ]; then
|
||||
cp ${compile_dir}/build/bin/taosadapter ${pkg_dir}${install_home_path}/bin ||:
|
||||
|
|
|
@ -101,6 +101,7 @@ cp %{_compiledir}/build/bin/taosd %{buildroot}%{homepath}/bin
|
|||
cp %{_compiledir}/build/bin/taosudf %{buildroot}%{homepath}/bin
|
||||
cp %{_compiledir}/build/bin/taosBenchmark %{buildroot}%{homepath}/bin
|
||||
cp %{_compiledir}/build/bin/taosdump %{buildroot}%{homepath}/bin
|
||||
cp %{_compiledir}/build/bin/taosmqtt %{buildroot}%{homepath}/bin
|
||||
cp %{_compiledir}/../../enterprise/packaging/start-all.sh %{buildroot}%{homepath}/bin
|
||||
cp %{_compiledir}/../../enterprise/packaging/stop-all.sh %{buildroot}%{homepath}/bin
|
||||
sed -i "s/versionType=\"enterprise\"/versionType=\"community\"/g" %{buildroot}%{homepath}/bin/start-all.sh
|
||||
|
@ -245,6 +246,7 @@ if [ $1 -eq 0 ];then
|
|||
${csudo}rm -f ${bin_link_dir}/taoskeeper || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosdump || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosBenchmark || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosmqtt || :
|
||||
${csudo}rm -f ${cfg_link_dir}/* || :
|
||||
${csudo}rm -f ${inc_link_dir}/taos.h || :
|
||||
${csudo}rm -f ${inc_link_dir}/taosdef.h || :
|
||||
|
|
|
@ -41,6 +41,7 @@ explorerName="${PREFIX}-explorer"
|
|||
keeperName="${PREFIX}keeper"
|
||||
inspect_name="${PREFIX}inspect"
|
||||
set_malloc_bin="set_taos_malloc.sh"
|
||||
mqtt_name="${PREFIX}mqtt"
|
||||
|
||||
bin_link_dir="/usr/bin"
|
||||
lib_link_dir="/usr/lib"
|
||||
|
@ -160,7 +161,7 @@ done
|
|||
|
||||
#echo "verType=${verType} interactiveFqdn=${interactiveFqdn}"
|
||||
|
||||
tools=(${clientName} ${benchmarkName} ${dumpName} ${demoName} ${inspect_name} remove.sh ${udfdName} set_core.sh TDinsight.sh start_pre.sh start-all.sh stop-all.sh)
|
||||
tools=(${clientName} ${benchmarkName} ${dumpName} ${demoName} ${inspect_name} ${mqtt_name} remove.sh ${udfdName} set_core.sh TDinsight.sh start_pre.sh start-all.sh stop-all.sh)
|
||||
if [ "${verMode}" == "cluster" ]; then
|
||||
if [ "${entMode}" == "lite" ]; then
|
||||
services=(${serverName} ${adapterName} ${explorerName} ${keeperName})
|
||||
|
@ -170,7 +171,7 @@ if [ "${verMode}" == "cluster" ]; then
|
|||
elif [ "${verMode}" == "edge" ]; then
|
||||
if [ "${pkgMode}" == "full" ]; then
|
||||
services=(${serverName} ${adapterName} ${keeperName} ${explorerName})
|
||||
tools=(${clientName} ${benchmarkName} ${dumpName} ${demoName} remove.sh ${udfdName} set_core.sh TDinsight.sh start_pre.sh start-all.sh stop-all.sh)
|
||||
tools=(${clientName} ${benchmarkName} ${dumpName} ${demoName} ${mqtt_name} remove.sh ${udfdName} set_core.sh TDinsight.sh start_pre.sh start-all.sh stop-all.sh)
|
||||
else
|
||||
services=(${serverName})
|
||||
tools=(${clientName} ${benchmarkName} remove.sh start_pre.sh)
|
||||
|
|
|
@ -174,6 +174,8 @@ function install_bin() {
|
|||
${csudo}rm -f ${bin_link_dir}/taosudf || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosBenchmark || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosdump || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosmqtt || :
|
||||
|
||||
${csudo}rm -f ${bin_link_dir}/${uninstallScript} || :
|
||||
|
||||
if [ "$osType" != "Darwin" ]; then
|
||||
|
@ -186,6 +188,7 @@ function install_bin() {
|
|||
[ -f ${binary_dir}/build/bin/taosadapter ] && ${csudo}cp -r ${binary_dir}/build/bin/taosadapter ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/taoskeeper ] && ${csudo}cp -r ${binary_dir}/build/bin/taoskeeper ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/taosudf ] && ${csudo}cp -r ${binary_dir}/build/bin/taosudf ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/taosmqtt ] && ${csudo}cp -r ${binary_dir}/build/bin/taosmqtt ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/taosx ] && ${csudo}cp -r ${binary_dir}/build/bin/taosx ${install_main_dir}/bin || :
|
||||
${csudo}cp -r ${binary_dir}/build/bin/${serverName} ${install_main_dir}/bin || :
|
||||
|
||||
|
@ -201,6 +204,7 @@ function install_bin() {
|
|||
[ -x ${install_main_dir}/bin/taosadapter ] && ${csudo}ln -s ${install_main_dir}/bin/taosadapter ${bin_link_dir}/taosadapter > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taoskeeper ] && ${csudo}ln -s ${install_main_dir}/bin/taoskeeper ${bin_link_dir}/taoskeeper > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosudf ] && ${csudo}ln -s ${install_main_dir}/bin/taosudf ${bin_link_dir}/taosudf > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosmqtt ] && ${csudo}ln -s ${install_main_dir}/bin/taosmqtt ${bin_link_dir}/taosmqtt > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosdump ] && ${csudo}ln -s ${install_main_dir}/bin/taosdump ${bin_link_dir}/taosdump > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosBenchmark ] && ${csudo}ln -s ${install_main_dir}/bin/taosBenchmark ${bin_link_dir}/taosBenchmark > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosx ] && ${csudo}ln -s ${install_main_dir}/bin/taosx ${bin_link_dir}/taosx > /dev/null 2>&1 || :
|
||||
|
@ -215,6 +219,7 @@ function install_bin() {
|
|||
[ -f ${binary_dir}/build/bin/taosadapter ] && ${csudo}cp -r ${binary_dir}/build/bin/taosadapter ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/taoskeeper ] && ${csudo}cp -r ${binary_dir}/build/bin/taoskeeper ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/taosudf ] && ${csudo}cp -r ${binary_dir}/build/bin/taosudf ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/taosmqtt ] && ${csudo}cp -r ${binary_dir}/build/bin/taosmqtt ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/taosx ] && ${csudo}cp -r ${binary_dir}/build/bin/taosx ${install_main_dir}/bin || :
|
||||
[ -f ${binary_dir}/build/bin/*explorer ] && ${csudo}cp -r ${binary_dir}/build/bin/*explorer ${install_main_dir}/bin || :
|
||||
${csudo}cp -r ${binary_dir}/build/bin/${serverName} ${install_main_dir}/bin || :
|
||||
|
@ -227,6 +232,7 @@ function install_bin() {
|
|||
[ -x ${install_main_dir}/bin/taosadapter ] && ${csudo}ln -s ${install_main_dir}/bin/taosadapter ${bin_link_dir}/taosadapter > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taoskeeper ] && ${csudo}ln -s ${install_main_dir}/bin/taoskeeper ${bin_link_dir}/taoskeeper > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosudf ] && ${csudo}ln -s ${install_main_dir}/bin/taosudf ${bin_link_dir}/taosudf > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosmqtt ] && ${csudo}ln -s ${install_main_dir}/bin/taosmqtt ${bin_link_dir}/taosmqtt > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosdump ] && ${csudo}ln -s ${install_main_dir}/bin/taosdump ${bin_link_dir}/taosdump > /dev/null 2>&1 || :
|
||||
[ -f ${install_main_dir}/bin/taosBenchmark ] && ${csudo}ln -sf ${install_main_dir}/bin/taosBenchmark ${bin_link_dir}/taosBenchmark > /dev/null 2>&1 || :
|
||||
[ -x ${install_main_dir}/bin/taosx ] && ${csudo}ln -s ${install_main_dir}/bin/taosx ${bin_link_dir}/taosx > /dev/null 2>&1 || :
|
||||
|
|
|
@ -99,6 +99,7 @@ else
|
|||
${build_dir}/bin/${clientName}adapter \
|
||||
${build_dir}/bin/${clientName}keeper \
|
||||
${build_dir}/bin/taosudf \
|
||||
${build_dir}/bin/taosmqtt \
|
||||
${script_dir}/remove.sh \
|
||||
${script_dir}/set_core.sh \
|
||||
${script_dir}/startPre.sh \
|
||||
|
|
|
@ -240,6 +240,7 @@ function install_bin() {
|
|||
${csudo}rm -f ${bin_link_dir}/taos || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosd || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosudf || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosmqtt || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosadapter || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosBenchmark || :
|
||||
${csudo}rm -f ${bin_link_dir}/taoskeeper || :
|
||||
|
@ -264,6 +265,9 @@ function install_bin() {
|
|||
if [ -x ${bin_dir}/taosudf ]; then
|
||||
${csudo}ln -s ${bin_dir}/taosudf ${bin_link_dir}/taosudf 2>>${install_log_path} || return 1
|
||||
fi
|
||||
if [ -x ${bin_dir}/taosmqtt ]; then
|
||||
${csudo}ln -s ${bin_dir}/taosmqtt ${bin_link_dir}/taosmqtt 2>>${install_log_path} || return 1
|
||||
fi
|
||||
if [ -x ${bin_dir}/taosadapter ]; then
|
||||
${csudo}ln -s ${bin_dir}/taosadapter ${bin_link_dir}/taosadapter 2>>${install_log_path} || return 1
|
||||
fi
|
||||
|
|
|
@ -151,6 +151,7 @@ clean_service
|
|||
${csudo}rm -f ${bin_link_dir}/taos || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosd || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosudf || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosmqtt || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosadapter || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosBenchmark || :
|
||||
${csudo}rm -f ${bin_link_dir}/taosdemo || :
|
||||
|
|
|
@ -46,6 +46,7 @@ xName="${PREFIX}x"
|
|||
explorerName="${PREFIX}-explorer"
|
||||
inspect_name="${PREFIX}inspect"
|
||||
tarbitratorName="tarbitratord"
|
||||
mqtt_name="${PREFIX}mqtt"
|
||||
productName="TDengine TSDB"
|
||||
|
||||
#install main path
|
||||
|
@ -59,15 +60,14 @@ config_dir="/etc/${PREFIX}"
|
|||
|
||||
if [ "${verMode}" == "cluster" ]; then
|
||||
if [ "${entMode}" == "full" ]; then
|
||||
services=(${PREFIX}"d" ${PREFIX}"adapter" ${PREFIX}"keeper")
|
||||
services=("${serverName}" ${adapterName} "${keeperName}")
|
||||
else
|
||||
services=(${PREFIX}"d" ${PREFIX}"adapter" ${PREFIX}"keeper" ${PREFIX}"-explorer")
|
||||
services=("${serverName}" ${adapterName} "${keeperName}" "${explorerName}")
|
||||
fi
|
||||
tools=(${PREFIX} ${PREFIX}"Benchmark" ${PREFIX}"dump" ${PREFIX}"demo" ${PREFIX}"inspect" ${PREFIX}"udf" set_core.sh TDinsight.sh $uninstallScript start-all.sh stop-all.sh)
|
||||
tools=("${clientName}" "${benchmarkName}" "${dumpName}" "${demoName}" "${inspect_name}" "${PREFIX}udf" "${mqtt_name}" "set_core.sh" "TDinsight.sh" "$uninstallScript" "start-all.sh" "stop-all.sh")
|
||||
else
|
||||
tools=(${PREFIX} ${PREFIX}"Benchmark" ${PREFIX}"dump" ${PREFIX}"demo" ${PREFIX}"udf" set_core.sh TDinsight.sh $uninstallScript start-all.sh stop-all.sh)
|
||||
|
||||
services=(${PREFIX}"d" ${PREFIX}"adapter" ${PREFIX}"keeper" ${PREFIX}"-explorer")
|
||||
tools=("${clientName}" "${benchmarkName}" "${dumpName}" "${demoName}" "${PREFIX}udf" "${mqtt_name}" "set_core.sh" "TDinsight.sh" "$uninstallScript" "start-all.sh" "stop-all.sh")
|
||||
services=("${serverName}" ${adapterName} "${keeperName}" "${explorerName}")
|
||||
fi
|
||||
|
||||
csudo=""
|
||||
|
@ -214,15 +214,15 @@ function clean_log() {
|
|||
}
|
||||
|
||||
function clean_service_on_launchctl() {
|
||||
${csudo}launchctl unload -w /Library/LaunchDaemons/com.taosdata.taosd.plist || :
|
||||
${csudo}launchctl unload -w /Library/LaunchDaemons/com.taosdata.${PREFIX}adapter.plist || :
|
||||
${csudo}launchctl unload -w /Library/LaunchDaemons/com.taosdata.${PREFIX}keeper.plist || :
|
||||
${csudo}launchctl unload -w /Library/LaunchDaemons/com.taosdata.${PREFIX}-explorer.plist || :
|
||||
${csudo}launchctl unload -w /Library/LaunchDaemons/com.taosdata.${serverName}.plist || :
|
||||
${csudo}launchctl unload -w /Library/LaunchDaemons/com.taosdata.${adapterName}.plist || :
|
||||
${csudo}launchctl unload -w /Library/LaunchDaemons/com.taosdata.${keeperName}.plist || :
|
||||
${csudo}launchctl unload -w /Library/LaunchDaemons/com.taosdata.${explorerName}.plist || :
|
||||
|
||||
${csudo}launchctl remove com.tdengine.taosd || :
|
||||
${csudo}launchctl remove com.tdengine.${PREFIX}adapter || :
|
||||
${csudo}launchctl remove com.tdengine.${PREFIX}keeper || :
|
||||
${csudo}launchctl remove com.tdengine.${PREFIX}-explorer || :
|
||||
${csudo}launchctl remove com.tdengine.${adapterName} || :
|
||||
${csudo}launchctl remove com.tdengine.${keeperName} || :
|
||||
${csudo}launchctl remove com.tdengine.${explorerName} || :
|
||||
|
||||
${csudo}rm /Library/LaunchDaemons/com.taosdata.* >/dev/null 2>&1 || :
|
||||
}
|
||||
|
|
Loading…
Reference in New Issue