使用python-slim鏡像遇到無(wú)法使用PostgreSQL的問(wèn)題及解決方法

更新時(shí)間：2024年08月21日 09:29:38 作者：程序設(shè)計(jì)實(shí)驗(yàn)室

這篇文章主要介紹了使用python-slim鏡像遇到無(wú)法使用PostgreSQL的問(wèn)題及解決方法,本文給大家介紹的非常詳細(xì),感興趣的朋友跟隨小編一起看看吧

前言

之前不是把 DjangoStarter 的 docker 方案重新搞好了嗎

一開(kāi)始demo部署是使用 SQLite 數(shù)據(jù)庫(kù)的，用著沒(méi)問(wèn)題，但很快切換到 PostgreSQL 的時(shí)候就遇到問(wèn)題了…

報(bào)錯(cuò)

docker 啟動(dòng)之后，app 容器報(bào)錯(cuò)

django.core.exceptions.ImproperlyConfigured: Error loading psycopg2 or psycopg module

排錯(cuò)

一開(kāi)始我還以為是 psycopg2 庫(kù)裝不上，或者是在 python_builder 階段的依賴沒(méi)有正確復(fù)制到 final 階段的容器，但后面改了幾個(gè)地方，重新試了一下都不行。

接下來(lái)使用 python src/manage.py shell 進(jìn)入 shell，測(cè)試一下能否導(dǎo)入 psycopg2 庫(kù)

>>> import psycopg2
Traceback (most recent call last):
  File "<console>", line 1, in <module>
  File "/project/.venv/lib/python3.11/site-packages/psycopg2/__init__.py", line 51, in <module>
    from psycopg2._psycopg import (                     # noqa
ImportError: libpq.so.5: cannot open shared object file: No such file or directory

好的，經(jīng)常被 docker 坑的人應(yīng)該已經(jīng)看出問(wèn)題出在系統(tǒng)環(huán)境上了

不使用 slim 鏡像換成普通的 python 鏡像就正常了…

解決

OK，既然找出問(wèn)題原因，那么就可以來(lái)著手解決了。

使用 psycopg2-binary

最簡(jiǎn)單的方法就是將 psycopg2 庫(kù)換成 psycopg2-binary，這是一個(gè)預(yù)編譯的 psycopg2 包，不需要編譯環(huán)境，安裝更簡(jiǎn)便。

手動(dòng)安裝 libpq 庫(kù)

既然缺了 libpq 庫(kù)，那就在 docker 鏡像里安裝。

這個(gè)方法我還沒(méi)測(cè)試，又麻煩又不優(yōu)雅

# 使用 Python 3.11 slim 基礎(chǔ)鏡像
FROM python:3.11-slim
# 安裝 psycopg2 依賴
RUN apt-get update && apt-get install -y \
    libpq-dev \
    gcc \
    # 清理緩存以減少鏡像大小
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

不同的python基礎(chǔ)鏡像

python鏡像基于 Debian 系統(tǒng)，默認(rèn)是用 Debian 的最新穩(wěn)定版，也可以自己指定版本，比如 python3.11-slim-bookworm 就是指定用 Debian 12 ("bookworm") 作為基礎(chǔ)鏡像

python3.11-slim-bookworm 基礎(chǔ)鏡像打包出來(lái)的鏡像大小是424MB，python3.11-slim 打包出來(lái)也是這個(gè)大小
使用 python3.11 基礎(chǔ)鏡像打包出來(lái)就到 1.3G 了，大小直接翻了幾倍

還可以選擇 alpine 鏡像，不過(guò)可能會(huì)遇到更多兼容性問(wèn)題，我就不折騰了，心累。

小結(jié)

一般選 slim 鏡像還是可以的，基于 Debian 不怎么需要擔(dān)心兼容性問(wèn)題

偶爾遇到小問(wèn)題還是比較好解決的

alpine 鏡像不一樣的地方就很多了，太折騰了…

到此這篇關(guān)于使用python-slim鏡像遇到無(wú)法使用PostgreSQL的問(wèn)題的文章就介紹到這了,更多相關(guān)python-slim無(wú)法使用PostgreSQL內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: