From 69410875add50fc70edda91fa5ffc27c8dae91e2 Mon Sep 17 00:00:00 2001 From: Collapsar Date: Fri, 23 Apr 2021 12:31:28 +0800 Subject: [PATCH] docker improvement (#215) --- .../0.3.1_dble_quick_start_docker.md | 26 +++++++++---------- .../0.3.2_dble_docker_compose.md | 22 ++++++++-------- 2 files changed, 24 insertions(+), 24 deletions(-) diff --git a/0.overview/0.3_quick_start/0.3.1_dble_quick_start_docker.md b/0.overview/0.3_quick_start/0.3.1_dble_quick_start_docker.md index bf5f6104d..09be9b9d2 100644 --- a/0.overview/0.3_quick_start/0.3.1_dble_quick_start_docker.md +++ b/0.overview/0.3_quick_start/0.3.1_dble_quick_start_docker.md @@ -1,13 +1,13 @@ -## 0.3.2 快速开始(docker) -### 0.3.2.1 关于本节 +## 0.3.1 快速开始(docker) +### 0.3.1.1 关于本节 + 本节内容为您介绍如何通过dockerhub上的dble镜像快速启动一个dble -### 0.3.2.2 安装准备 +### 0.3.1.2 安装准备 + 安装docker + 若需要使用docker-compose快速启动,请安装docker-compose + 安装mysql连接工具,用于进行连接测试观察结果 -### 0.3.2.3 安装过程 +### 0.3.1.3 安装过程 按照顺序依次执行以下docker命令: > docker network create -o "com.docker.network.bridge.name"="dble-net" --subnet 172.18.0.0/16 dble-net @@ -23,7 +23,7 @@ 通过以上命令依次创建一个docker网络,两个分别映射到主机 33061 和 33062 端口的mysql服务,一个将服务端和管理端映射到主机 8066 和 9066 端口的服务 服务将在约一分钟之后被启动,这是由于为了进行快速的启动需要对于mysql和dble的配置进行一些初始化 -### 0.3.2.4 连接并使用 +### 0.3.1.4 连接并使用 使用准备好的mysql连接工具连接主机的8066或者9066端口,在docker的默认配置中 8066 端口(服务端口能够执行SQL语句)的用户和密码为 root/123456 9066 端口(管理端口能够执行管理语句)的用户和密码为 man1/654321 @@ -42,7 +42,7 @@ mysql -P33062 -u root -p123456 -h 127.0.0.1 ``` -### 0.3.2.5 环境清理 +### 0.3.1.5 环境清理 使用完成或者进行环境重建的时候可以使用以下命令进行环境的清空 ``` docker stop backend-mysql1 @@ -54,11 +54,11 @@ docker rm dble-server docker network rm dble-net ``` -### 0.3.2.6 docker-compose 版本快速启动 +### 0.3.1.6 docker-compose 版本快速启动 docker-compose启动需要先从github项目下载对应的配置文件 ``` -wget https://raw.githubusercontent.com/actiontech/dble/master/docker-images/docker-compose.yml +wget https://raw.githubusercontent.com/actiontech/dble/master/docker-images/quick-start/docker-compose.yml ``` 通过使用docker-compose的配置脚本直接启动两个mysql镜像以及一个dble镜像,在配置文件存放目录执行 ``` @@ -72,23 +72,23 @@ docker-compose up docker-compose stop docker-compose rm ``` -### 0.3.2.7 尝试使用本地配置启动docker-compose +### 0.3.1.7 尝试使用本地配置启动docker-compose ***注意*** -本小结的内容需要用户在充分了解并掌握dble配置和结构的状态下进行,作为一种快速启动特定配置dble以供测试或调试使用 +本小结的内容需要用户在充分了解并掌握dble配置和结构的状态下进行,作为一种快速启动特定配置dble以供测试或调试使用 首次了解并使用dble的用户可以跳过此节 本地配置启动dble的原理是通过volumes配置的映射将本地的配置目录映射到docker容器中,之后初始化的时候在初始化脚本中将本地配置目录中的文件复制到对应的dble/conf目录中,之后再进行初始化和dble启动 首先需要在docker-compose.yml的最后一段dble-server容器配置中添加以下内容 ``` - volumes: - - /opt/test/conf:/opt/self_conf +volumes: + - /opt/test/conf:/opt/self_conf ``` 此命令将本地的/opt/test/conf目录映射到目标容器/opt/self_conf目录中去 之后调整dble-server容器的启动命令 ``` - command: ["/opt/dble/bin/wait.sh", "backend-mysql1:3306","--","/opt/self_conf/docker_init_start.sh"] +command: ["/opt/dble/bin/wait.sh", "backend-mysql1:3306","--","/opt/self_conf/docker_init_start.sh"] ``` 将原本调用的/opt/dble/bin/docker_init_start.sh修改为本次初始化准备使用的self_conf目录下的初始化脚本 这里对于本地启动的初始化脚本只给出如下一些建议 diff --git a/0.overview/0.3_quick_start/0.3.2_dble_docker_compose.md b/0.overview/0.3_quick_start/0.3.2_dble_docker_compose.md index 814c5c22e..5be0ffe8d 100644 --- a/0.overview/0.3_quick_start/0.3.2_dble_docker_compose.md +++ b/0.overview/0.3_quick_start/0.3.2_dble_docker_compose.md @@ -1,13 +1,13 @@ -## 0.3.1 dble 镜像本地build -### 0.3.1 关于本节 +## 0.3.2 dble 镜像本地build +### 0.3.2.1 关于本节 + 本节内容为您介绍如何打包生成 dble 的 docker 镜像 + 如何使用 docker-compose 快速搭建dble不同运行容器环境 -### 0.3.2 准备 +### 0.3.2.2 准备 + 安装docker + 安装docker-compose -### 0.3.3 打包过程 +### 0.3.2.3 打包过程 若使用dockerhub中的镜像,则可跳过下面的步骤。 @@ -31,7 +31,7 @@ DBLE_VERSION:指定 docker 镜像所使用的 dble 的版本 1. 指定 MODE 后所使用的配置文件对应 $working_dir/docker-images/dble-image 下面各个文件夹里面的配置文件,如果需要自定义,请自行调整 2. 3.20.10.0版本的配置文件有重大变动,因此和 3.20.10.0 之前版本的配置文件是不兼容的,因此若使用 3.20.10.0 之前的版本做镜像,需要调整配置文件 -### 0.3.4 docker-compose 运行镜像 +### 0.3.2.4 docker-compose 运行镜像 在 dble 的解压文件中,$working_dir/docker-images 下分别有 mgr,quick-start,rwSplit 三个文件夹,每个文件夹中包含了各自运行的 docker-compose 文件,其中: + mgr:启动两组mgr(六个mysql实例),一个 dble + quick-start:生成两个 mysql 实例,一个 dble @@ -48,12 +48,12 @@ docker-compose stop docker-compose rm ``` -### 0.3.5 验证效果 -#### 0.3.5.1 验证读写分离效果 +### 0.3.2.5 验证效果 +#### 0.3.2.5.1 验证读写分离效果 1. 查看主从复制关系: - ``` - mysql> show slave status\G; +``` +mysql> show slave status\G; *************************** 1. row *************************** Slave_IO_State: Waiting for master to send event Master_Host: 10.186.61.151 @@ -113,9 +113,9 @@ Master_SSL_Verify_Server_Cert: No Channel_Name: Master_TLS_Version: 1 row in set (0.00 sec) - ``` +``` -#### 0.3.5.2 验证mgr效果 +#### 0.3.2.5.2 验证mgr效果 1. 查看两组mgr关系: ```