readme doc
diff --git a/rocketmq-ansible/Rocketmq Ansible Playbook cn.md b/rocketmq-ansible/Rocketmq Ansible Playbook cn.md
new file mode 100644
index 0000000..2bb7973
--- /dev/null
+++ b/rocketmq-ansible/Rocketmq Ansible Playbook cn.md
@@ -0,0 +1,118 @@
+Rocketmq playbook提供rocketmq集群部署和rocketmq exporter部署功能。
+
+Rocketmq playbook集成了部署环境初始化、源码包下载、操作系统参数调优、broker最佳配置参数、rocketmq集群部署、rocketmq exporter部署、rocketmq exporter接入、开机自启动等任务编排到一起。
+
+Rocketmq playbook可以嵌入在CI/CD流程中或者编排到terraform流程中,这在自动化运维或者vdc一键部署(SDE)有非常重要的意义。
+
+## 使用说明
+Rocketmq playbook入口文件为rocketmq.yml。rocketmq.yml包含namesrv.yml、broker.yml、exporter.yml3个子playbook。rocketmq.yml可以单独执行部署一个完整的rocketmq集群或者3个子playbook单独执行。hosts文件配置了namesrv、broker、exporter部署的机器列表及变量,当使用terraform编排时hosts可以当做变量传递。
+
+rocketmq-ansible
+
+│
+
+│ broker.yml#部署broker
+
+│ exporter.yml#部署exporter
+
+│ hosts#部署机器列表及变量
+
+│ namesrv.yml#部署namesrv
+
+│ rocketmq.yml#playbook入口文件
+
+│
+
+├─roles
+
+│ ├─broker
+
+│ │ ├─tasks
+
+│ │ │ main.yml #部署broker流程
+
+│ │ │
+
+│ │ ├─templates
+
+│ │ │ broker.conf.j2 #broker最佳配置模版
+
+│ │ │ logback_broker.xml.j2 #broker logback配置模版
+
+│ │ │ mqbroker.service #broker开机自启动脚本模版
+
+│ │ │
+
+│ │ └─vars
+
+│ │ main.yml #broker.yml使用的变量
+
+│ │
+
+│ ├─exporter
+
+│ │ ├─files
+
+│ │ │ mqexportershutdown.sh #exporter停止脚本
+
+│ │ │
+
+│ │ ├─tasks
+
+│ │ │ main.yml #exporter部署流程
+
+│ │ │
+
+│ │ ├─templates
+
+│ │ │ mqexporter.service #exporter开机自动脚本模版
+
+│ │ │ mqexporter.sh.j2 #exporter启动脚本模版
+
+│ │ │
+
+│ │ └─vars
+
+│ │ main.yml #exporter.yml使用的变量
+
+│ │
+
+│ └─namesrv
+
+│ ├─tasks
+
+│ │ main.yml #namesrv部署流程
+
+│ │
+
+│ ├─templates
+
+│ │ logback_namesrv.xml.j2 #namesrv logback配置模版
+
+│ │ mqnamesrv.service #namesrv开机自启动脚本模版
+
+│ │
+
+│ └─vars
+
+│ main.yml #namesrv.yml使用的变量
+
+│
+
+└─vars
+
+ main.yml #rocketmq.yml使用的变量
+
+
+## rocketmq.yml
+rocketmq.yml描述了使用linux root用户部署,在执行3个子playbook执行之前做一些部署环境初始化的任务,创建应用文件目录和数据文件目录。
+
+## namesrv.yml
+namesrv.yml描述了部署namesrv的过程。包含了创建部署目录、下载rocketmq编译代码、修改日志文件目录、添加开机自启动机制、启动进程等任务。
+
+## broker.yml
+broker.yml描述了部署broker的过程。包含了创建部署目录、下载rocketmq编译代码、修改日志文件目录、优化操作系统参数、优化broker配置、添加开机自启动机制、启动进程等任务。
+
+## exporter.yml
+exporter.yml描述了部署rocketmq exporter的过程。包含了创建部署目录、下载rocketmq exporter编译代码、生成启动和停止脚本、添加开机自启动机制、启动进程等任务。
+
diff --git a/rocketmq-ansible/Rocketmq Ansible Playbook en.md b/rocketmq-ansible/Rocketmq Ansible Playbook en.md
new file mode 100644
index 0000000..7bad6fc
--- /dev/null
+++ b/rocketmq-ansible/Rocketmq Ansible Playbook en.md
@@ -0,0 +1,133 @@
+Rocketmq Playbook provides the Rocketmq cluster deployment and Rocketmq exporter deployment function.
+
+Rocketmq Playbook integrates deployment environment initialization, source pack download, operating system parameter tuning, broker optimal configuration parameters, Rocketmq cluster deployment, Rocketmq deployment, Rocketmq export access, and startup.
+
+The Rocketmq Playbook can be embedded in CI/CD processes or choreographed into Terraform processes, making it important for automated operations or VDC one-click deployment (SDE).
+
+## instructions
+The Rocketmq Playbook entry file is rocketmq.yml.
+
+Rocketmq.yml contains namesrv.yml, broker.yml, and exporter.
+
+Rocketmq.yml can be executed separately by deploying a full RocketMQ cluster or three child Playbooks.
+
+The hosts file is configured with a list of machines and variables for Namesrv, Broker, and exporter deployment.
+
+The hosts file can be used as a variable.
+
+
+rocketmq-ansible
+
+│
+
+│ broker.yml #Deploy the broker
+
+│ exporter.yml #Deploy the exporter
+
+│ hosts #Deploy machine list and variables
+
+│ namesrv.yml #Deploy the namesrv
+
+│ rocketmq.yml #Playbook entry file
+
+│
+
+├─roles
+
+│ ├─broker
+
+│ │ ├─tasks
+
+│ │ │ main.yml #Deploy the Broker process
+
+│ │ │
+
+│ │ ├─templates
+
+│ │ │ broker.conf.j2 #Broker best configuration template
+
+│ │ │ logback_broker.xml.j2 #Broker Logback configuration template
+
+│ │ │ mqbroker.service #Self boot automatic script template
+
+│ │ │
+
+│ │ └─vars
+
+│ │ main.yml #The variable used by broker.yml
+
+│ │
+
+│ ├─exporter
+
+│ │ ├─files
+
+│ │ │ mqexportershutdown.sh #Exporter stop script
+
+│ │ │
+
+│ │ ├─tasks
+
+│ │ │ main.yml #Export Deployment Process
+
+│ │ │
+
+│ │ ├─templates
+
+│ │ │ mqexporter.service #Self boot automatic script template
+
+│ │ │ mqexporter.sh.j2 #Exporter startup script template
+
+│ │ │
+
+│ │ └─vars
+
+│ │ main.yml #A variable used by exporter.yml
+
+│ │
+
+│ └─namesrv
+
+│ ├─tasks
+
+│ │ main.yml #Namesrv deployment process
+
+│ │
+
+│ ├─templates
+
+│ │ logback_namesrv.xml.j2 #Namesrv logback configuration template
+
+│ │ mqnamesrv.service #Self boot automatic script template
+
+│ │
+
+│ └─vars
+
+│ main.yml #The variable used by namesrv.yml
+
+│
+
+└─vars
+
+ main.yml #The variable used by rocketmq.yml
+
+
+## rocketmq.yml
+rocketmq. yml describes how to deploy as Linux root user, perform some deployment environment initialization tasks, and create application file directories and data file directories before executing three sub-Playbooks.
+
+## namesrv.yml
+namesrv.yml describes the process of deploying namesrv.
+
+This includes creating a deployment directory, downloading rocketMQ compilation code, modifying the log file directory, adding a startup mechanism, and starting processes.
+
+## broker.yml
+broker.yml describes the process of deploying the broker.
+
+This includes creating a deployment directory, downloading RocketMQ compiled code, modifying log file directories, optimizing operating system parameters, optimizing broker configuration, adding a startup mechanism, and starting processes.
+
+## exporter.yml
+exporter.yml describes the process of deploying RocketMQ exporter.
+
+It contains tasks such as creating a deployment directory, downloading RocketMQ exporter compile code, generating startup and stop scripts, adding a self-boot mechanism, and starting processes.
+