perconalab/sysbench

percona-openshift

概述

percona-openshift是一套用于在OpenShift、Kubernetes及Google Cloud Kubernetes Engine（GKE）中运行Percona软件的脚本集，主要支持Percona XtraDB Cluster、PMM-Server等组件的部署与管理，并提供备份恢复、配置自定义及问题反馈等功能。

重要提示：建议考虑使用https://github.com/Percona-Lab/percona-xtradb-cluster-operator%E3%80%82

提交Bug报告

若在Percona Docker镜像或相关项目中发现Bug，需提交至对应项目的JIRA issue跟踪系统。

报告流程

1. 搜索现有报告：先通过搜索确认是否存在类似问题，如有可投票提升可见性。
2. 提交新报告（无现有报告时）：
   • 登录Percona JIRA（无账号需创建）。
   • 进入创建Issue页面并选择相关项目。
   • 填写摘要、描述、复现步骤及影响版本，若涉及崩溃需附加日志中的堆栈跟踪。

报告要求

• 可复现：包含复现步骤。
• 具体：提供版本、环境等详细信息。
• 唯一：不重复现有工单。
• 单一Bug：每个报告仅包含一个Bug。

参考资源：Elika Etemad的Bug报告撰写指南。

Helm部署

推荐通过Helm图表部署软件套件。

PMM-Server（监控用）

若需使用PMM监控，从helm/helm-pmm-server目录执行部署：

bash
helm install --name monitoring ./helm/helm-pmm-server

部署后通过以下命令查看暴露的公网IP：

bash
kubectl get service

示例输出：

NAME                 TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)        AGE
monitoring-service   LoadBalancer   10.31.242.113   35.233.168.128   80:32516/TCP   10m

Percona XtraDB Cluster

基本部署

bash
helm install --name cluster1 ./helm/helm-server

默认部署包含前端ProxySQL及每个节点的PMM-Client。查看Pod状态：

bash
kubectl get service

示例输出：

NAME                  READY     STATUS    RESTARTS   AGE
cluster1-node-0       2/2       Running   0          5m
cluster1-node-1       2/2       Running   0          4m
cluster1-node-2       2/2       Running   0          3m
cluster1-proxysql-0   2/2       Running   0          5m
monitoring-0          1/1       Running   0          1h

连接方式

• ProxySQL管理端：

  bash
  kubectl exec -it cluster1-proxysql-0 -c proxysql -- mysql -h127.0.0.1 -P6032 -uadmin -padmin
  

• 通过ProxySQL连接PXC（客户端应用）：

  bash
  kubectl run -i --tty percona-client --image=percona:5.7 --restart=Never -- bash -il
  root@percona-client:/# mysql -hcluster1-proxysql -uroot -psecr3t    
  

主从复制集（ReplicaSet）

注意：当前ReplicaSet功能损坏，不支持ProxySQL。

部署命令：

bash
helm install --name rs1 . -f values.yaml  --set kind=replicaset

Helm与OpenShift

PMM-Server和PMM-Client需以root用户（user:0）运行，在OpenShift中部署时需执行：

bash
helm install --name dep1 . -f values.yaml  --set pmm.enabled=false,platform=openshift

或编辑values.yaml修改pmm.enabled和platform配置。

备份与恢复

执行备份

1. 创建持久备份卷：根据需求调整backup-volume.yaml。
2. 执行备份作业：

   bash
   kubectl apply -f xtrabackup-job.yaml
   

从备份恢复

1. 确保集群未运行。
2. 定位备份卷中的目标目录（如cluster1-node-0.cluster1-nodes-2018-06-18-17-26）。
3. 调整并运行恢复作业：参考https://github.com/Percona-Lab/percona-openshift/blob/master/deploy/xtrabackup-restore-job-pxc.yaml%E3%80%82

Kubernetes部署（不使用Helm）

MySQL密码

部署前需创建访问Percona Server/Percona XtraDB Cluster的密码（密钥）。提供https://github.com/Percona-Lab/percona-openshift/blob/master/deploy/secret.yaml%EF%BC%8C**%E8%AF%B7%E4%BD%BF%E7%94%A8%E8%87%AA%E5%AE%9A%E4%B9%89%E5%AE%89%E5%85%A8%E5%AF%86%E7%A0%81**%E3%80%82

• 编码密码：echo -n 'securepassword' | base64（用于secret.yaml）。
• 解码密码：echo YmFja3VwX3Bhc3N3b3Jk | base64 -d（从secret.yaml解码）。

注意事项

• 已在Kubernetes 1.9/OpenShift Origin 3.9测试，早期版本可能不兼容。
• 部署依赖默认StorageClass提供持久卷（Persistent Volume），若无需手动创建。

部署步骤

Percona XtraDB Cluster N节点

部署文件pxc.yaml将创建包含N个节点的有状态集（StatefulSet），副本数由replicas: 3定义。注意服务名（如name: pxccluster1）。

待办事项：

• 客户端到PXC节点的加密连接
• PXC节点间的加密连接

ProxySQL服务（基于Percona XtraDB Cluster）

部署文件proxysql-pxc.yaml创建ProxySQL服务并自动配置流量处理，通过- -service=pxccluster1指定目标PXC服务。

待办事项：

• ProxySQL到PXC节点的加密连接

自定义MySQL配置

支持通过配置映射（ConfigMap）自定义MySQL配置：

1. 编辑mysql-configmap.yaml添加所需配置。
2. 创建ConfigMap（需在部署前执行）：

   bash
   kubectl create -f mysql-configmap.yaml
   

后续工作

• 提供PMM Server部署方案
• 配置节点的PMM Client
• 提供备份创建/恢复指南

命令参考（Cheatsheet）

在OpenShift中，将kubectl替换为oc。

常用命令

• 查看节点：kubectl get nodes
• 查看运行中的Pod：kubectl get pods
• 创建部署：kubectl create -f replica-set.yaml
• 删除部署：kubectl delete -f replica-set.yaml
• 监控部署过程中的Pod变化：watch kubectl get pods
• 诊断故障Pod：kubectl describe po/rsnode-0
• 查看Pod日志：kubectl logs -f rsnode-0
• 查看Pod中特定容器日志：kubectl logs -f rsnode-1 -c clone-mysql
• 进入容器bash：kubectl exec rsnode-0 -it -- bash
• 访问容器中的MySQL：kubectl exec rsnode-0 -it -- mysql -uroot -proot_password
• 访问ProxySQL管理端：kubectl exec proxysql-0 -it -- mysql -uadmin -padmin -h127.0.0.1 -P6032

Sysbench

一键准备sysbench-tpcc数据库：

bash
kubectl run sysbench1 --image=perconalab/sysbench --restart=Never --env="LUA_PATH=/sysbench/sysbench-tpcc/?.lua" --command -- sysbench-tpcc/tpcc.lua --mysql-host=cluster1-node-0.cluster1-nodes --mysql-user=root --mysql-password=secr3t --scale=10 --mysql-db=sbtest --db-driver=mysql --force-pk=1 prepare