progressoft/dbtool-ubi

dbtool Docker镜像文档

镜像概述

dbtool镜像是基于Debian sid-slim构建的轻量级环境，集成了多种数据库客户端工具及常用开发运维工具，旨在为数据库操作、开发调试及CI/CD流程提供便捷、统一的工具集支持。

核心功能与特性

数据库客户端支持

• PostgreSQL：集成postgresql-client，支持PostgreSQL数据库连接与操作
• MySQL：包含mysql-client，支持MySQL/MariaDB数据库交互
• SQL Server：预装mssql-tools及依赖unixodbc-dev，支持SQL Server数据库操作（需接受EULA）

基础工具集

• 网络工具：curl、wget、apt-transport-https
• 版本控制与开发：git、openssh-client、vim
• 数据处理：jq（JSON处理工具）
• 系统工具：gnupg2（密钥管理）、software-properties-common（软件源管理）、ca-certificates（证书支持）

环境特性

• 基于Debian sid-slim，体积轻量
• 预配置微软SQL Server工具APT源及GPG密钥
• 默认工作目录/app，支持数据持久化与挂载
• 交互式入口点/bin/bash，便于命令行操作

使用场景与适用范围

• 数据库管理与维护：一站式操作多类型数据库，无需单独安装客户端
• 开发环境快速搭建：为本地开发提供统一的数据库工具环境，避免系统环境冲突
• CI/CD流程集成：在自动化部署流程中执行数据库迁移、数据校验、备份恢复等任务
• 跨数据库操作：同时处理PostgreSQL、MySQL、SQL Server的混合环境场景

使用方法与配置说明

基本使用

通过docker run启动交互式容器：

bash
docker run -it --rm progressoft/cicd5/dbtool:latest

数据库客户端使用示例

PostgreSQL连接

bash
psql -h <host> -p <port> -U <user> -d <database>

MySQL连接

bash
mysql -h <host> -P <port> -u <user> -p <database>

SQL Server连接

bash
sqlcmd -S <host>,<port> -U <user> -P <password> -d <database>

数据持久化

挂载本地目录至容器/app工作目录，保存操作文件：

bash
docker run -it --rm -v $(pwd):/app progressoft/cicd5/dbtool:latest

CI/CD集成示例（GitLab CI）

在.gitlab-ci.yml中使用该镜像执行数据库迁移：

yaml
database-migration:
  image: progressoft/cicd5/dbtool:latest
  script:
    - psql -h $POSTGRES_HOST -U $POSTGRES_USER -d $POSTGRES_DB -f migrations/20240101_init.sql
    - mysql -h $MYSQL_HOST -u $MYSQL_USER -p$MYSQL_PASSWORD -D $MYSQL_DB < migrations/20240101_init.sql

配置参数说明

环境变量

• ACCEPT_EULA=Y：默认设置，用于接受SQL Server工具的最终用户许可协议（EULA）

预装软件清单

• 数据库工具：postgresql-client、mysql-client、mssql-tools、unixodbc-dev
• 基础工具：curl、wget、gnupg2、software-properties-common、apt-transport-https、ca-certificates
• 开发工具：vim、git、openssh-client、jq

基础信息

• 基础镜像：debian:sid-slim
• 工作目录：/app
• 入口点：/bin/bash（交互式shell）
• 维护者：Progressoft CICD Team（基于Dockerfile推断）