preeo/node-mysql

Node.js 与 mysql-client 集成镜像

镜像概述

本镜像基于官方Node.js镜像构建，集成了mysql-client工具，提供一站式运行环境，便于在Node.js应用中直接使用MySQL客户端工具，无需额外安装配置，简化开发与部署流程。

核心功能与特性

• 内置完整Node.js运行环境，支持标准Node.js应用开发与运行
• 预装mysql-client工具，可直接执行mysql、mysqldump、mysqladmin等MySQL客户端命令
• 兼容官方Node.js镜像的所有基础功能与环境变量
• 支持多架构（如amd64、arm64），适配不同运行环境
• 基于官方Node.js slim版本构建，在保证功能的同时优化镜像体积

使用场景

• Node.js应用中需通过脚本执行MySQL数据库操作（如数据查询、插入、更新）
• 开发环境快速搭建，无需本地安装Node.js和mysql-client即可进行开发测试
• 自动化任务中执行MySQL数据库备份（使用mysqldump）或数据迁移
• CI/CD流程中集成MySQL命令行操作，验证数据库连接或初始化数据

使用方法与配置说明

基本使用

通过docker run命令启动容器，可直接执行Node.js应用或mysql命令：

bash
# 运行Node.js应用（当前目录为项目根目录）
docker run -v $(pwd):/app -w /app <镜像名称> node app.js

# 执行mysql命令连接远程MySQL数据库
docker run <镜像名称> mysql -h <mysql-host> -u <username> -p -e "SELECT VERSION();"

与MySQL容器交互示例

连接到同一网络中的MySQL容器，实现应用与数据库的联动：

1. 创建自定义网络：

bash
docker network create my-network

2. 启动MySQL容器并加入网络：

bash
docker run -d --name mysql-server --network my-network -e MYSQL_ROOT_PASSWORD=my-secret-pw docker.xuanyuan.run/mysql:latest

3. 使用本镜像连接到MySQL容器：

bash
docker run --network my-network <镜像名称> mysql -h mysql-server -u root -pmy-secret-pw -e "SHOW DATABASES;"

Docker Compose配置示例

通过docker-compose.yml实现Node.js应用与MySQL的协同部署：

yaml
version: '3'
services:
  node-app:
    image: docker.xuanyuan.run/<镜像名称>
    volumes:
      - ./app:/app
    working_dir: /app
    command: node app.js
    depends_on:
      - mysql-server
    environment:
      - NODE_ENV=production
      - MYSQL_HOST=mysql-server
      - MYSQL_USER=root
      - MYSQL_PASSWORD=my-secret-pw
    networks:
      - app-network

  mysql-server:
    image: docker.xuanyuan.run/mysql:latest
    environment:
      - MYSQL_ROOT_PASSWORD=my-secret-pw
      - MYSQL_DATABASE=testdb
    networks:
      - app-network

networks:
  app-network:

注意事项

• 镜像标签通常对应Node.js版本（如18、20等），请根据应用需求选择匹配的Node.js版本
• 执行敏感操作（如含密码的命令）时，建议通过环境变量或配置文件传递凭据，避免命令行明文显示
• 生产环境中建议使用非root用户运行容器，通过--user参数指定用户ID和组ID