docker镜像alpine中安装oracle客户端
1.背景
2.下载instant_client程序包
3.Dockerfile
说明:
4.遇到的问题
4.1.找不到libclntsh.so动态连接库
4.2.找不到libaio.so.1动态连接库
4.3.找不到libnsl.so.1动态连接库
1.背景有项目需使用python连接oracle数据库,然后查询一些数据进行分析。在安装oracle客户端驱动过程中遇到了一些问题,在此记录下来分享读者。
一点限制:
oracle数据库与本应用程序不在同一台机器上,数据连接为远程访问方式,针对同一台机器的应用访问,网上有很多;
本应用支行在docker容器中,镜像基于alpine:3.7版本编译,针对在ubuntu中的安装网上有很多;
基础信息:alping3.7 + python3.6.5 + cx_Oracle7.0.0 + instantclient-basic-linux.x64-11.2.0.4.0
搭建目标:
2.下载instant_client程序包使用python -c "import cx_Oracle as ora; ora.connect('xxx')"可正常连接oracle数据库
可直接从oracle 官网下载,本应用下载了【instantclient-basic-linux.x64-11.2.0.4.0.zip】包。原因为最好与oracle数据库版本对应。
该压缩包中有instanclient_11_2目录,其目录结构:
./instantclient_11_2:
|---BASIC_README
|---adrci
|---genezi
|---libclntsh.so.11.1
|---libnnz11.so
|---libocci.so.11.1
|---libociei.so
|---libocijdbc11.so
|---ojdbc5.jar
|---ojdbc6.jar
|---uidrvci
|---xstreeams.jar
即包中为oracle客户端连接数据库的所需的库。
3.Dockerfile直接先上代码然后再说明其中的关键点:
FROM alpine:3.7
ENV ALPINE_VERSION=3.7
#### packages from https://pkgs.alpinelinux.org/packages
# These are always installed. Notes:
# * dumb-init: a proper init system for containers, to reap zombie children
# * bash: For entrypoint, and debugging
# * ca-certificates: for SSL verification during Pip and easy_install
# * python: the binaries themselves
# * openblas: required for numpy.
# * libaio libnsl: for cx_Oracle
ENV PACKAGES="\
dumb-init \
bash vim tini \
ca-certificates \
python3==3.6.5-r0 \
openblas \
libaio libnsl \
"
# These packages are not installed immediately, but are added at runtime or ONBUILD to shrink the image as much as possible. Notes:
# * build-base: used so we include the basic development packages (gcc)
# * linux-headers: commonly needed, and an unusual package name from Alpine.
ENV BUILD_PACKAGES="\
build-base \
linux-headers \
"
## for install oracle instant client
## from https://oracle.github.io/odpi/doc/installation.html#linux
ENV TNS_ADMIN=/oracle_client/instantclient_11_2
ENV NLS_LANG=SIMPLIFTED_CHINESE_CHINA_ZHS16GBK
ENV LD_LIBRARY_PATH=/oracle_client/instantclient_11_2
RUN echo \
# 1.install oracle client and create soft link
&& mkdir /oracle_client && cd /oracle_client \
&& wget -O client.zip "https://raw.githubusercontent.com/tianxiawuzhe/alpine37-py365-django21-ai/master/instantclient-basic-linux.x64-11.2.0.4.0.zip" \
&& unzip client.zip && rm client.zip \
&& cd /oracle_client/instantclient_11_2 \
&& ln -s libclntsh.so.11.1 libclntsh.so \
&& ln -s /usr/lib/libnsl.so.2.0.0 /usr/lib/libnsl.so.1 \
# 2.replacing default repositories with edge ones
&& echo "http://dl-cdn.alpinelinux.org/alpine/edge/testing" >> /etc/apk/repositories \
&& echo "http://dl-cdn.alpinelinux.org/alpine/edge/community" >> /etc/apk/repositories \
&& echo "http://dl-cdn.alpinelinux.org/alpine/edge/main" >> /etc/apk/repositories \
# 3.Add the build packages, and then will be deleted
&& apk add --no-cache --virtual=.build-deps $BUILD_PACKAGES \
# 4.Add the packages, with a CDN-breakage fallback if needed
&& apk add --no-cache $PACKAGES || \
(sed -i -e 's/dl-cdn/dl-4/g' /etc/apk/repositories && apk add --no-cache $PACKAGES) \
# 5.make some useful symlinks that are expected to exist
&& cd /usr/bin \
&& { [[ -e idle ]] || ln -s idle3 idle; } \
&& { [[ -e pydoc ]] || ln -s pydoc3 pydoc; } \
&& { [[ -e python ]] || ln -sf python3.6 python; } \
&& { [[ -e python-config ]] || ln -sf python3-config python-config; } \
&& { [[ -e pip ]] || ln -sf pip3 pip; } \
&& ls -l idle pydoc python* pip* \
&& python -m pip install --upgrade --no-cache-dir pip \
&& ls -l idle pydoc python* pip* \
# 6.install my app software
&& pip install --no-cache-dir cx_Oracle \
# 7.End
&& apk del .build-deps \
&& ls -l idle pydoc python* pip* \
&& echo
EXPOSE 8080
ENTRYPOINT tail -f /dev/null
CMD ["/bin/bash"]
说明:
01)使用环境变量PACKAGES和BUILD_PACKAGES来区分应用运行时和编译安装时所需要的库,在RUN命令最后删除了BUILD_PACKAGES的依赖库,从而保证镜像尽可能的小;
02)PACKAGES中含有libaio和libnsl两个依赖库,此2个依赖库为cx_Oracle程序包所需的库(更具体的是instant_client驱动包中libclntsh.so.11.1库文件依赖这两个包);
03)LD_LIBRARY_PATH环境变量保证在python程序运行时能够找到instant_client的驱动包位置,本文中是将驱动包解压至容器的/oracle_client/目录下(解压过程见后面的RUN里的unzip);
04)RUN中第1步,是从github上下载上面的驱动包。原因:本应用编译时是使用公共云平台进行编译,在编译过程中绑定了github,从github上读取Dockerfile和*.zip文件进行编译。若是在本地编译镜像,可以使用COPY或ADD来添加文件,但这样可能会让镜像的大小增加,理由是COPY和ADD不能自动解压缩zip,即使在RUN的后面写上rm *.zip,也无法降低镜像的大小,更多信息请查询镜像层的原理。
05)RUN第1步,【ln -s libclntsh.so.11.1 libclntsh.so】是建立驱动包中软连接,这样cx_Oracle在寻找动态连接库时就能找到了,如果不软连接或重命名,那么cx_Oracle将会找不到该库;【ln -s /usr/lib/libnsl.so.2.0.0 /usr/lib/libnsl.so.1】建立libnsl库的软连接,当libclntsh库在运行时会查找此库;
06)RUN第2步,向/etc/apk/repositories文件中添加一些alpine特有的库地址,后面在安装时就能自动下载并安装了;
07)RUN第3步,安装编译过程中所需的依赖包;
08)RUN第4步,安装运行过程中所需的依赖包,此2步可调换顺序,但个人觉得应该这个顺序,因为如果编译的依赖包覆盖了运行所需的包,那么在删除BUILD_PACKAGES后,程序运行时就会出现问题;
09)RUN第5步,建立一些python中简单的软连接,方便后面使用;同时更新了pip的版本;
10)RUN第6步,使用pip安装cx_Oracle程序包;
11)RUN第7步,清理BUILD_PACKAGES这些依赖包;
12)最后就是暴露的端口和启动脚本了;
4.遇到的问题以下遇到的问题,均是通过执行【python -c "import cx_Oracle as o; o.connect('xxx')"】来验证是否客户端安装成功。
4.1.找不到libclntsh.so动态连接库详细信息:
cx_Oracle.DatabaseError:
DPI-1047: 64-bit Oracle Client library cannot be loaded:
"Error loading shared library libclntsh.so: No such file or directory".
See https://oracle.github.io/odpi/doc/installation.html#linux for help
原因有2:
未正确设置LD_LIBRARY_PATH环境变量,导致python在加载应用时,操作系统未设置正确的库路径;
未设置软连接libclntsh.so指向libclntsh.so.11.1,也会导致无法加载;
诊断方法:
在python命令行里,手工【from ctypes import find_library as f, CDLL】,尝试使用find_library来查找动态连接库,如果能用此命令找到,比如f('libclntsh.so.11.1')可以找到,但f('libclntsh.so')找不到,说明LD_LIBRARY_PATH设置正确了,只是没有软连接。然后再用CDLL尝试加载动态连接库,看中间加载是否会出问题。
4.2.找不到libaio.so.1动态连接库请确认libaio是否安装成功,安装成功后,应该在/usr/lib/libaio.so.1.0.1文件,同时会存在libaio.so.1的软连接。
4.3.找不到libnsl.so.1动态连接库由于当前libnsl的版本已经是libns.so.2.0.0,因此在安装libnsl后会自动存在libnsl.so.2的软连接,而本应用中oracle的驱动版本是较老的,因此直接手工建立了软连接【ln -s /usr/lib/libnsl.so.2.0.0 /usr/lib/libnsl.so.1】,试验成功!
以上就是docker镜像alpine中安装oracle客户端的详细内容,更多关于docker镜像alpine安装oracle的资料请关注易知道(ezd.cc)其它相关文章!
相关内容
-
oracle中NUMBER类型和java中对应类型
oracle中NUMBER类型和java中对应类型,类型,数据类型,问题: 今...
-
oracle中dmp文件是什么文件
oracle中dmp文件是什么文件,文件,数据库,在oracle中,dmp文件是...
-
oracle 11g中的g是什么意思
oracle 11g中的g是什么意思,网格,方面,在oracle中,11g中的g是网...
-
Oracle指定某些值排最前或最后|oracle字段值相
Oracle指定某些值排最前或最后|oracle字段值相同排序,字段,升...
-
弃用共享存储,部署高可用、低成本 oracle 12c ra
弃用共享存储,部署高可用、低成本 oracle 12c rac集群,虚拟机,...
-
plsql developer连接oracle 12.2报错 ora-28040
plsql developer连接oracle 12.2报错 ora-28040 No matching...
-
docker容器添加微软雅黑字体|docker 环境缺字体
docker容器添加微软雅黑字体|docker 环境缺字体,字体,容器,添...
-
Oracle常用ASM操作命令
Oracle常用ASM操作命令,磁盘,路径,在Oracle RAC环境下,使用grid...
-
oracle数据库 存储过程
oracle数据库 存储过程,存储过程,语句,数据库,执行,编译,参数,Oracl...
-
聊聊docker下怎么启动容器
聊聊docker下怎么启动容器,镜像,应用程序,下载,启动,名称,命令,Dock...
-
如何创建oracle用户(过程浅析)
如何创建oracle用户(过程浅析),用户,命令,授权,角色,数据库,权限,Orac...
-
oracle有哪些版本
oracle有哪些版本,版本,数据库,企业,推出,性能,新技术,oracle的版本...
-
mysql与oracle有区别吗
mysql与oracle有区别吗,数据库,数据,关系数据库,管理系统,语句,开...
-
如何在linux上安装docker
如何在linux上安装docker,安装,运行,命令,步骤,用户,版本,随着容器...
-
如何彻底卸载docker
如何彻底卸载docker,删除,命令,软件包,文件,卸载,步骤,随着云计算和...