GCP Centos 7 makine üzerine Psycopg2 kurulumu

Psycopg2, Python ile PostgreSQL veritabanı arasında köprü kuran en yaygın kütüphanedir; Python kodunuzdan veritabanına bağlanıp sorgu çalıştırmanızı sağlar. Google Cloud (GCP) üzerindeki CentOS 7 makinelerde pip install psycopg2 çoğu zaman hata verir, çünkü psycopg2 kurulurken kaynaktan derlenir ve bunun için sistemde bulunmayan birkaç parça gerekir. Bu yazıda bu hatayı nasıl aşacağınızı anlatacağım.

Güncelleme (Kasım 2026): Bu yazıyı 2020'de yazmıştım. O zaman tek yol eksik derleme araçlarını tek tek kurmaktı. Bugün çok daha kolay bir yol var, onu başa ekledim. CentOS 7'nin desteğinin bittiğini de hatırlatayım; yeni bir makine kuracaksanız Rocky Linux ya da AlmaLinux kullanın.

Kolay yol: psycopg2-binary

En pratik çözüm, psycopg2'nin hazır derlenmiş halini (psycopg2-binary) kurmaktır. Bu paket hiçbir şey derlemez, doğrudan iner; yani yukarıda bahsettiğim eksik parça sorununa hiç takılmazsınız:

pip install psycopg2-binary

Çoğu durumda ihtiyacınız olan tek şey bu. (Bir not: psycopg2-binary, hızlı kurulum ve test için idealdir. Büyük, ciddi projelerde ise genelde aşağıdaki gibi kaynaktan derlenmiş sürüm tercih edilir, ama başlangıç için binary gayet iyidir.)

Daha yeni bir proje yapıyorsanız psycopg2'nin yerini alan güncel sürüm psycopg 3'ü de kullanabilirsiniz; o da aynı şekilde hazır gelir:

pip install "psycopg[binary]"

Zor yol: kaynaktan derlemek

Eğer illa normal psycopg2 paketini kurmanız gerekiyorsa (bazı projeler bunu ister), o zaman derleme için gereken parçaları önce sisteme kurmalısınız. GCP'deki CentOS 7 makinelerde eksik olanlar bunlar:

sudo yum groupinstall -y "Development Tools"
sudo yum install -y python3-devel postgresql-libs postgresql-devel

Bir de kurulumdan önce pip'i güncellemek sorunları azaltır:

pip install -U pip

Komut hata verirse pip yerine pip3.8 yazmayı deneyin (Python 3.8'i elle kurduysanız komut bu isimde olabilir).

Gerekli parçalar tamamlandıktan sonra psycopg2 artık sorunsuz kurulur:

pip install psycopg2

Kurulumun çalıştığını Python'da kısaca test edebilirsiniz; aşağıdaki komut hata vermeden sürüm numarası yazdırıyorsa her şey yolunda demektir:

python3 -c "import psycopg2; print(psycopg2.__version__)"