txstatemws/node-oracle

Oracle Instant Client Basic Lite Node镜像

镜像概述

本镜像基于Node 14-buster-slim构建，集成了Oracle Instant Client Basic Lite版本，为Node.js应用程序提供连接Oracle数据库的轻量级运行环境。通过预配置Oracle客户端库路径和依赖，简化Node应用与Oracle数据库的集成过程。

核心功能与特性

• 轻量级基础：基于Debian slim发行版，镜像体积小，资源占用低
• Node环境：内置Node.js 14运行时，支持Node应用直接部署
• Oracle客户端：集成Oracle Instant Client Basic Lite版本，包含基本数据库连接所需组件
• 预配置环境：已设置LD_LIBRARY_PATH环境变量及动态链接库配置，无需手动配置库路径
• 依赖完整：预装libaio1等Oracle客户端运行所需系统依赖

使用场景

• 开发/部署需要连接Oracle数据库的Node.js应用程序
• 构建轻量级Oracle数据库客户端应用
• 企业级Node.js服务与Oracle数据库的集成场景
• 对镜像体积有严格要求的容器化部署环境

使用方法与配置

基本使用

可直接基于此镜像构建或运行Node应用，示例docker run命令：

bash
docker run -it --rm \
  -v /path/to/your/node/app:/app \
  -w /app \
  your-image-name \
  node your-app.js

配置说明

sqlnet.ora配置

如需自定义Oracle网络配置，可通过挂载sqlnet.ora文件到客户端配置目录：

bash
docker run -it --rm \
  -v /path/to/your/sqlnet.ora:/opt/oracle/instantclient/sqlnet.ora \
  your-image-name

配置参数详情可参考Oracle官方文档：sqlnet.ora参数说明

客户端更新

如需更新Oracle Instant Client版本，可参考Oracle官方下载页面获取最新ZIP包链接及许可信息：Linux x86-64 Instant Client下载

安全通信配置

如需配置客户端与数据库之间的加密通信，可参考Oracle文档：客户端-服务器通信加密

Oracle Wallet TLS配置

如需通过命令行设置Oracle Wallet TLS，可参考指南：Oracle Wallet TLS配置

构建信息

镜像采用多阶段构建，以下是构建流程概述：

1. 基础阶段：使用node:14-buster-slim，安装unzip和wget
2. 下载并解压Oracle Instant Client Basic Lite ZIP包
3. 最终阶段：复制客户端文件，安装libaio1依赖，配置动态链接库路径

详细Dockerfile参考：

dockerfile
FROM node:14-buster-slim as BUILD

RUN apt-get update \
  && apt-get install -y unzip \
  && apt-get install -y wget

ENV ZIPFILE=instantclient-basiclite-linux.x64-21.1.0.0.0.zip  
ENV URL_SUBDIR=211000

RUN mkdir -p opt/oracle \
  && wget https://download.oracle.com/otn_software/linux/instantclient/${URL_SUBDIR}/${ZIPFILE} \
  && unzip  ${ZIPFILE} && rm -rf ${ZIPFILE} \
  && mv instantclient_*/* /opt/oracle/instantclient

FROM node:14-buster-slim

COPY --from=BUILD /opt/oracle/instantclient /opt/oracle/instantclient

RUN apt-get update \
  && apt-get install -y libaio1

ENV LD_LIBRARY_PATH="/opt/oracle/instantclient"

RUN echo '/opt/oracle/instantclient/' | tee -a /etc/ld.so.conf.d/oracle_instant_client.conf && ldconfig

注意事项

• 使用前请仔细阅读Oracle Instant Client的许可协议
• 不同版本Oracle客户端的安装细节可参考官方文档：Instant Client安装指南
• 确保Node应用中使用的Oracle客户端驱动（如oracledb）版本与Instant Client版本兼容