1.1 快速开始

1.1.1 关于本节

本节内容为您介绍如何使用txle安装包快速部署并启动一个txle服务，并简单了解txle的使用和管理

1.1.2 安装准备

以下部分将被需要作为txle服务端启动的基础支撑

一个启动的MySQL实例
txle服务端是通过连接数据库实例来进行数据的存储，所以请至少准备一个正在运行的实例. 在此仅以一个最简单的情况举例，通过Docker运行MySQL
```
$ docker run -itd -p 3306:3306 --name=backend-mysql -e MYSQL_ROOT_PASSWORD=123456 -e MYSQL_DATABASE=txle mysql:5.7 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
```
一个启动的consul集群
txle服务端在集群部署场景下，每个服务都会执行各自的定时器任务，由于定时器任务中带有更新操作，故多定时器同时执行时会带来一定的隐患。 consul集群可自动选出一位TXLE的leader来执行特殊的定时器任务，若当前leader宕机，则再自动选出集群中另一个服务为leader。
```
$ docker run -d -p 8500:8500 --name=consul_1 --add-host ${txle_server_hostname}:${host_address} consul agent -server -ui -node=1 -client=0.0.0.0 -bootstrap
```
JVM环境
txle是使用java开发的，所以需要启动txle您先需要在机器上安装java版本1.8或以上，并且确保JAVA_HOME参数被正确的设置

1.1.3 下载并安装txle服务端

通过此连接下载最新版本的安装包https://github.com/actiontech/txle/releases/download/v${version}/actiontech-txle-${version}.tar.gz

解压并安装txle服务端到指定文件夹中

$ mkdir -p ${working_dir}
$ wget -P ${working_dir} https://github.com/actiontech/txle/releases/download/v2.19.10.0/actiontech-txle-2.19.10.0.tar.gz
$ tar -zxvf ${working_dir}/actiontech-txle-${version}.tar.gz -C ${working_dir}

1.1.4 txle服务端的初始化配置

根据当前环境修改配置文件${working_dir}/actiontech-txle-${version}/conf/application.yaml
```yaml ...

alpha: server: host: ${host_address} port: 8080

...

spring: profiles: mysql datasource: username: root password: 123456 url: jdbc:mysql://${mysql_host_address}/txle?useSSL=false

...

cloud: consul: enabled: true # Consul must be enabled in a production environment. host: ${consul_host_address} port: 8500


## 1.1.5 启动txle服务端
 + 启动命令  
```bash
$  ${working_dir}/actiontech-txle-${version}/bin/txle start

如果启动失败请使用此命令查看失败的详细原因

$ tail -f ${working_dir}/actiontech-txle-${version}/log/stdout.log

1.1.6 配置txle客户端

根据当前环境修改配置文件，这里以spring boot为例
```yaml spring: application: name: ${application.name}

...

alpha: cluster: address: ${alpha.cluster.addresses} ```

1.1.7 常见问题

启动txle服务端启动时报Name or service not known错误
解决方法： echo "127.0.0.1: ${txle_server_hostname} >> /etc/hosts"

1.1 常规部署