docker鏡像alpine中安裝oracle客戶端
1.背景
有項目需使用python連接oracle數(shù)據(jù)庫,然后查詢一些數(shù)據(jù)進行分析。在安裝oracle客戶端驅(qū)動過程中遇到了一些問題,在此記錄下來分享讀者。
一點限制:
- oracle數(shù)據(jù)庫與本應用程序不在同一臺機器上,數(shù)據(jù)連接為遠程訪問方式,針對同一臺機器的應用訪問,網(wǎng)上有很多;
- 本應用支行在docker容器中,鏡像基于alpine:3.7版本編譯,針對在ubuntu中的安裝網(wǎng)上有很多;
- 基礎信息:alping3.7 + python3.6.5 + cx_Oracle7.0.0 + instantclient-basic-linux.x64-11.2.0.4.0
搭建目標:
使用python -c "import cx_Oracle as ora; ora.connect('xxx')"可正常連接oracle數(shù)據(jù)庫
2.下載instant_client程序包
可直接從oracle 官網(wǎng)下載,本應用下載了【instantclient-basic-linux.x64-11.2.0.4.0.zip】包。原因為最好與oracle數(shù)據(jù)庫版本對應。
該壓縮包中有instanclient_11_2目錄,其目錄結(jié)構(gòu):
./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客戶端連接數(shù)據(jù)庫的所需的庫。
3.Dockerfile
直接先上代碼然后再說明其中的關(guān)鍵點:
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)使用環(huán)境變量PACKAGES和BUILD_PACKAGES來區(qū)分應用運行時和編譯安裝時所需要的庫,在RUN命令最后刪除了BUILD_PACKAGES的依賴庫,從而保證鏡像盡可能的??;
02)PACKAGES中含有l(wèi)ibaio和libnsl兩個依賴庫,此2個依賴庫為cx_Oracle程序包所需的庫(更具體的是instant_client驅(qū)動包中l(wèi)ibclntsh.so.11.1庫文件依賴這兩個包);
03)LD_LIBRARY_PATH環(huán)境變量保證在python程序運行時能夠找到instant_client的驅(qū)動包位置,本文中是將驅(qū)動包解壓至容器的/oracle_client/目錄下(解壓過程見后面的RUN里的unzip);
04)RUN中第1步,是從github上下載上面的驅(qū)動包。原因:本應用編譯時是使用公共云平臺進行編譯,在編譯過程中綁定了github,從github上讀取Dockerfile和*.zip文件進行編譯。若是在本地編譯鏡像,可以使用COPY或ADD來添加文件,但這樣可能會讓鏡像的大小增加,理由是COPY和ADD不能自動解壓縮zip,即使在RUN的后面寫上rm *.zip,也無法降低鏡像的大小,更多信息請查詢鏡像層的原理。
05)RUN第1步,【ln -s libclntsh.so.11.1 libclntsh.so】是建立驅(qū)動包中軟連接,這樣cx_Oracle在尋找動態(tài)連接庫時就能找到了,如果不軟連接或重命名,那么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步可調(diào)換順序,但個人覺得應該這個順序,因為如果編譯的依賴包覆蓋了運行所需的包,那么在刪除BUILD_PACKAGES后,程序運行時就會出現(xiàn)問題;
09)RUN第5步,建立一些python中簡單的軟連接,方便后面使用;同時更新了pip的版本;
10)RUN第6步,使用pip安裝cx_Oracle程序包;
11)RUN第7步,清理BUILD_PACKAGES這些依賴包;
12)最后就是暴露的端口和啟動腳本了;
4.遇到的問題
以下遇到的問題,均是通過執(zhí)行【python -c "import cx_Oracle as o; o.connect('xxx')"】來驗證是否客戶端安裝成功。
4.1.找不到libclntsh.so動態(tài)連接庫
詳細信息:
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環(huán)境變量,導致python在加載應用時,操作系統(tǒng)未設置正確的庫路徑;
- 未設置軟連接libclntsh.so指向libclntsh.so.11.1,也會導致無法加載;
診斷方法:
在python命令行里,手工【from ctypes import find_library as f, CDLL】,嘗試使用find_library來查找動態(tài)連接庫,如果能用此命令找到,比如f('libclntsh.so.11.1')可以找到,但f('libclntsh.so')找不到,說明LD_LIBRARY_PATH設置正確了,只是沒有軟連接。然后再用CDLL嘗試加載動態(tài)連接庫,看中間加載是否會出問題。
4.2.找不到libaio.so.1動態(tài)連接庫
請確認libaio是否安裝成功,安裝成功后,應該在/usr/lib/libaio.so.1.0.1文件,同時會存在libaio.so.1的軟連接。
4.3.找不到libnsl.so.1動態(tài)連接庫
由于當前l(fā)ibnsl的版本已經(jīng)是libns.so.2.0.0,因此在安裝libnsl后會自動存在libnsl.so.2的軟連接,而本應用中oracle的驅(qū)動版本是較老的,因此直接手工建立了軟連接【ln -s /usr/lib/libnsl.so.2.0.0 /usr/lib/libnsl.so.1】,試驗成功!
以上就是docker鏡像alpine中安裝oracle客戶端的詳細內(nèi)容,更多關(guān)于docker鏡像alpine安裝oracle的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
使用Jenkins+docker打包部署后端服務的實現(xiàn)
本文主要介紹了使用Jenkins+docker打包部署后端服務的實現(xiàn),文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2022-08-08遷移變更Docker默認數(shù)據(jù)存儲目錄的步驟詳解
Docker安裝的默認數(shù)據(jù)目錄為/var/lib/docker,但是如果/目錄掛載的磁盤空間不夠,就需要遷移docker數(shù)據(jù)到其他目錄,接下來本就給大家介紹遷移變更Docker默認數(shù)據(jù)存儲目錄的操作步驟,需要的朋友可以參考下2023-12-12使用elasticsearch定時刪除索引數(shù)據(jù)
這篇文章主要介紹了使用elasticsearch定時刪除索引數(shù)據(jù)的操作,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2021-03-03