cityofsurrey/node-oracle

docker-node-oracle 镜像文档

镜像概述

docker-node-oracle是一个专为Node.js应用设计的Docker镜像，核心功能是提供OracleDB数据库连接能力。该镜像预配置了Oracle客户端依赖，可帮助开发者快速构建、部署需要连接Oracle数据库的Node.js应用容器，无需手动解决Oracle客户端环境配置问题。

核心功能与特性

• 预配置Oracle客户端：集成Oracle Instant Client基础组件，解决Node.js连接Oracle数据库时的客户端依赖问题
• 简化环境配置：无需手动安装和配置Oracle客户端库，降低开发和部署门槛
• 轻量级设计：基于官方Node.js镜像构建，保持较小体积的同时确保功能完整性
• 灵活兼容性：支持主流Node.js版本（建议Node.js 14+）和Oracle Database 12c及以上版本

使用场景与适用范围

• 本地开发环境：快速搭建支持Oracle数据库连接的Node.js开发环境，避免本地环境配置冲突
• CI/CD流程集成：作为自动化构建环节的基础镜像，确保测试和部署环境一致性
• 生产环境部署：用于部署需要稳定连接Oracle数据库的Node.js微服务或应用
• Oracle数据库迁移项目：在Node.js技术栈中对接Oracle数据库的迁移或集成场景

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name node-oracle-app \
  -e ORACLE_HOST=your-oracle-host \
  -e ORACLE_PORT=1521 \
  -e ORACLE_USER=your-username \
  -e ORACLE_PASSWORD=your-password \
  -e ORACLE_SERVICE_NAME=ORCLCDB \
  -v /path/to/your/node/app:/app \
  -p 3000:3000 \
  docker-node-oracle

Docker Compose配置示例

yaml
version: '3.8'
services:
  node-app:
    image: docker-node-oracle
    container_name: node-oracle-service
    restart: always
    environment:
      - ORACLE_HOST=oracle-db  # 与Oracle数据库服务名对应
      - ORACLE_PORT=1521
      - ORACLE_USER=app_user
      - ORACLE_PASSWORD=SecurePass123
      - ORACLE_SERVICE_NAME=ORCLCDB
    volumes:
      - ./node-app:/app  # 挂载本地Node.js应用代码
    ports:
      - "3000:3000"
    depends_on:
      - oracle-db

  # Oracle数据库服务（示例）
  oracle-db:
    image: oracle/database:19.3.0-ee
    container_name: oracle-db
    environment:
      - ORACLE_SID=ORCLCDB
      - ORACLE_PDB=ORCLPDB1
      - ORACLE_PWD=SecurePass123
    ports:
      - "1521:1521"
    volumes:
      - oracle-data:/opt/oracle/oradata

volumes:
  oracle-data:

环境变量配置说明

Node.js应用中使用示例

在Node.js应用代码中，可通过oracledb模块直接连接数据库（需在项目中安装oracledb依赖）：

javascript
const oracledb = require('oracledb');

async function run() {
  let connection;
  try {
    connection = await oracledb.getConnection({
      user: process.env.ORACLE_USER,
      password: process.env.ORACLE_PASSWORD,
      connectString: `${process.env.ORACLE_HOST}:${process.env.ORACLE_PORT}/${process.env.ORACLE_SERVICE_NAME}`
    });
    console.log('成功连接到Oracle数据库');
    // 执行数据库操作...
  } catch (err) {
    console.error('连接失败:', err);
  } finally {
    if (connection) {
      try {
        await connection.close();
      } catch (err) {
        console.error('关闭连接失败:', err);
      }
    }
  }
}

run();