Docker में PostgreSQL: शुरुआती लोगों के लिए चरण-दर-चरण मार्गदर्शिका

Docker में PostgreSQL सेट अप करना

Docker में Postgres डेटाबेस चलाने के लिए आपको बस Docker इंजन की ज़रूरत होगी।

इस खंड में, मैं आपको प्रीरिक्विज़िट्स कवर करने और Docker कंटेनर में एक पूर्ण कार्यात्मक PostgreSQL डेटाबेस चलाने की प्रक्रिया से ले चलूँगा।

पूर्वापेक्षाएँ

Docker में PostgreSQL शुरू करने से पहले, आपके सिस्टम पर Docker इंस्टॉल होना चाहिए।

इंस्टॉलेशन ऑपरेटिंग सिस्टम के अनुसार बदलता है। Windows और macOS उपयोगकर्ता आसानी से Docker Desktop इंस्टॉल कर सकते हैं, जो कंटेनरों को मैनेज करने के लिए उपयोग में आसान ग्राफ़िकल इंटरफ़ेस है। इसे आधिकारिक Docker वेबसाइट से डाउनलोड करें।

Linux उपयोगकर्ता अपनी डिस्ट्रीब्यूशन के पैकेज मैनेजर से सीधे Docker Engine इंस्टॉल कर सकते हैं। उदाहरण के लिए, Ubuntu पर:

sudo apt update
sudo apt install docker.io
sudo systemctl enable --now dockerसंचालित द्वारा

Docker इंस्टॉल होने के अलावा, यह अनुशंसित है कि आप बुनियादी टर्मिनल कमांड और Docker की बुनियादी अवधारणाओं—जैसे इमेज, कंटेनर, और वॉल्यूम—से परिचित हों। DataCamp की ये व्यावहारिक गाइड आपकी मदद करेंगी:

• Docker for Beginners: A Practical Guide to Containers
• Install Docker on Ubuntu: From Setup to First Container

PostgreSQL Docker इमेज पुल करना

PostgreSQL चलाने से पहले, आपको Docker Hub से आधिकारिक PostgreSQL Docker इमेज डाउनलोड करनी होगी। यह इमेज कंटेनर बनाने के लिए टेम्पलेट का काम करती है।

लेटेस्ट PostgreSQL इमेज पुल करने के लिए, अपना टर्मिनल या कमांड प्रॉम्प्ट खोलें और चलाएँ:

docker pull postgresसंचालित द्वारा

यह कमांड PostgreSQL का नवीनतम स्थिर वर्ज़न डाउनलोड करता है। यदि आपको कोई विशिष्ट वर्ज़न चाहिए, तो टैग के साथ बताइए:

docker pull postgres:17संचालित द्वारा

छवि 1 - PostgreSQL डेटाबेस इमेज के नवीनतम स्थिर वर्ज़न को पुल करना

कुछ आम तौर पर इस्तेमाल होने वाले PostgreSQL इमेज टैग्स:

• postgres:latest - सबसे हाल का स्थिर PostgreSQL वर्ज़न
• postgres:17 - PostgreSQL वर्ज़न 14.x (वर्ज़न 17 का नवीनतम पैच)
• postgres:17.4 - एक विशिष्ट वर्ज़न (यहाँ 17.4)।
• postgres:bookworm - Debian Bookworm Linux डिस्ट्रीब्यूशन पर बना PostgreSQL।

आप सभी उपलब्ध टैग्स आधिकारिक PostgreSQL Docker Hub पेज पर देख सकते हैं।

Docker कंटेनर में PostgreSQL चलाना

एक बार आपके पास PostgreSQL इमेज हो, तो आप एक ही कमांड से कंटेनर बना और शुरू कर सकते हैं:

docker run --name postgres-db -e POSTGRES_PASSWORD=mypassword postgresसंचालित द्वारा

छवि 2 - PostgreSQL कंटेनर शुरू करना

यह कमांड postgres-db नाम से नया कंटेनर बनाता है और PostgreSQL पासवर्ड के लिए एक एनवायरनमेंट वेरिएबल सेट करता है।

हालाँकि, इस बुनियादी कमांड की सीमाएँ हैं। मैं कुछ अतिरिक्त विकल्प जोड़ने की सलाह देता हूँ:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydatabase \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgresसंचालित द्वारा

छवि 3 - एनवायरनमेंट वेरिएबल्स के साथ डिटैच्ड मोड में PostgreSQL कंटेनर शुरू करना

आइए इन अतिरिक्त विकल्पों को समझते हैं:

• एनवायरनमेंट वेरिएबल्स:
  • POSTGRES_PASSWORD: PostgreSQL सुपरयूज़र का पासवर्ड सेट करता है (आवश्यक)।
  • POSTGRES_USER: इस नाम से नया सुपरयूज़र बनाता है (डिफ़ॉल्ट "postgres" होता है)।
  • POSTGRES_DB: इस नाम से नया डेटाबेस बनाता है (डिफ़ॉल्ट तौर पर यूज़रनेम)।
• पोर्ट मैपिंग (-p 5432:5432) कंटेनर के PostgreSQL पोर्ट (5432) को आपके होस्ट मशीन के उसी पोर्ट से मैप करती है, जिससे आप localhost:5432 के ज़रिए PostgreSQL से जुड़ सकते हैं।
• वॉल्यूम माउंटिंग (-v postgres-data:/var/lib/postgresql/data) postgres-data नाम का Docker वॉल्यूम बनाती है जो डेटाबेस फ़ाइलों को कंटेनर के बाहर स्थायी रूप से रखता है। इससे कंटेनर रुकने या हटने पर भी डेटा सुरक्षित रहता है।
• -d फ़्लैग कंटेनर को डिटैच्ड मोड में चलाता है। आसान भाषा में कहें तो कंटेनर बैकग्राउंड में चलता है।

आप यह जाँच सकते हैं कि कंटेनर चल रहा है या नहीं:

docker psसंचालित द्वारा

छवि 4 - सभी चल रहे कंटेनरों की सूची

अगले खंड में, मैं आपको आपके विशेष उपयोग-केस के लिए PostgreSQL कंटेनर को और कॉन्फ़िगर करना दिखाऊँगा।

Docker में PostgreSQL कॉन्फ़िगर करना

पिछले खंड का बेसिक सेटअप शुरुआत के लिए पर्याप्त है, लेकिन कुछ उन्नत ज़रूरतों के लिए आप अपने PostgreSQL कंटेनर को कस्टमाइज़ करना चाहेंगे।

यही इस खंड का मकसद है।

वॉल्यूम्स के साथ स्थायी स्टोरेज सेट करना

Docker में डेटाबेस चलाते समय सबसे महत्वपूर्ण बातों में से एक है यह सुनिश्चित करना कि आपका डेटा कंटेनर के जीवनचक्र से आगे भी बना रहे। डिफ़ॉल्ट रूप से, कंटेनर हटाने पर उसके अंदर का सारा डेटा खो जाता है। डेटाबेस के लिए यह शायद ही वांछनीय होता है।

Docker वॉल्यूम्स इस समस्या का समाधान देते हैं—ये डेटा को कंटेनर फाइलसिस्टम के बाहर स्टोर करते हैं।

सेट करने के लिए, पहले एक नामित वॉल्यूम बनाएँ:

docker volume create postgres-dataसंचालित द्वारा

वैकल्पिक रूप से, आप वॉल्यूम विवरण इस कमांड से देख सकते हैं:

docker volume inspect postgres-dataसंचालित द्वारा

छवि 5 - वॉल्यूम विवरण सूचीबद्ध करना

अब, PostgreSQL कंटेनर शुरू करते समय वॉल्यूम को PostgreSQL डेटा डायरेक्टरी पर माउंट करें:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgresसंचालित द्वारा

-v postgres-data:/var/lib/postgresql/data पैरामीटर नामित वॉल्यूम को कंटेनर की डेटा डायरेक्टरी से जोड़ता है।

सारांश रूप में, PostgreSQL के लिए वॉल्यूम इस्तेमाल करने के ये लाभ हैं:

• कंटेनर हटाने पर भी आपका डेटा बना रहता है।
• आप कंटेनर को रोक, शुरू या अपग्रेड कर सकते हैं बिना डेटा खोए।
• वॉल्यूम का बैकअप लेकर आप डेटा का बैकअप बना सकते हैं।
• बाइंड माउंट्स की तुलना में बेहतर प्रदर्शन (खासतौर पर macOS और Windows पर)।

PostgreSQL से कनेक्ट करने के लिए पोर्ट्स एक्सपोज़ करना

होस्ट मशीन पर चल रहे ऐप्लिकेशनों से PostgreSQL डेटाबेस से कनेक्ट होने के लिए, आपको PostgreSQL पोर्ट (5432) को लोकल सिस्टम पर एक्सपोज़ करना होगा।

सबसे सरल तरीका है कंटेनर के 5432 पोर्ट को होस्ट के उसी पोर्ट से मैप करना:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5432:5432 \
  -d postgresसंचालित द्वारा

-p 5432:5432 पैरामीटर कंटेनर का 5432 पोर्ट होस्ट के 5432 पोर्ट से मैप करता है।

यदि आपके होस्ट पर 5432 पोर्ट पहले से PostgreSQL या किसी अन्य सर्विस द्वारा उपयोग में है, तो आप किसी अन्य पोर्ट से मैप कर सकते हैं:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5433:5432 \
  -d postgresसंचालित द्वारा

अब कंटेनर का 5432 पोर्ट आपके होस्ट पर 5433 पोर्ट से मैप है। कनेक्ट करते समय आपको डिफ़ॉल्ट 5432 की जगह 5433 पोर्ट बताना होगा।

डिफ़ॉल्ट रूप से, पोर्ट सभी नेटवर्क इंटरफेसेज़ (0.0.0.0) पर एक्सपोज़ होता है। अतिरिक्त सुरक्षा के लिए आप इसे वैकल्पिक रूप से localhost तक सीमित कर सकते हैं:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 127.0.0.1:5432:5432 \
  -d postgresसंचालित द्वारा

यह केवल आपकी लोकल मशीन से कनेक्शन की अनुमति देता है, नेटवर्क की अन्य मशीनों से नहीं।

PostgreSQL सेटिंग्स कॉन्फ़िगर करना

कंटेनर चलाते समय आप कई डिफ़ॉल्ट PostgreSQL सेटिंग्स बदल सकते हैं। एक सामान्य तरीका—हालाँकि अकेला नहीं—एनवायरनमेंट वेरिएबल्स का उपयोग करना है।

डेटाबेस को कॉन्फ़िगर करने के लिए आप ये वेरिएबल्स इस्तेमाल कर सकते हैं:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydatabase \
  -e POSTGRES_INITDB_ARGS="--data-checksums" \
  -e POSTGRES_HOST_AUTH_METHOD=scram-sha-256 \
  -d postgresसंचालित द्वारा

और ये उनमें से हर एक क्या करता है:

• POSTGRES_PASSWORD: सुपरयूज़र पासवर्ड सेट करता है (आवश्यक)।
• POSTGRES_USER: सुपरयूज़र का नाम सेट करता है (डिफ़ॉल्ट "postgres")।
• POSTGRES_DB: डिफ़ॉल्ट डेटाबेस नाम सेट करता है (डिफ़ॉल्ट यूज़र नेम होता है)।
• POSTGRES_INITDB_ARGS: PostgreSQL के initdb कमांड को आर्ग्युमेंट्स पास करता है।
• POSTGRES_HOST_AUTH_METHOD: ऑथेंटिकेशन मेथड सेट करता है।

एनवायरनमेंट वेरिएबल्स के अलावा, आप PostgreSQL कॉन्फ़िगरेशन को कस्टमाइज़ करके डेटाबेस में और उन्नत बदलाव भी कर सकते हैं।

कुछ अक्सर कस्टमाइज़ की जाने वाली PostgreSQL सेटिंग्स:

• max_connections: PostgreSQL कितने कनेक्शन स्वीकारेगा नियंत्रित करता है (डिफ़ॉल्ट 100)।
• shared_buffers: कैशिंग के लिए इस्तेमाल होने वाली मेमोरी सेट करता है (प्रोडक्शन के लिए डिफ़ॉल्ट अक्सर कम होता है)।
• work_mem: क्वेरी ऑपरेशनों के लिए मेमोरी।
• maintenance_work_mem: मेंटेनेंस ऑपरेशनों के लिए मेमोरी।

व्यावहारिक रूप से, एक फ़ाइल बनाएँ—मान लें my-postgres-conf:

max_connections = 200
shared_buffers = 1GB
work_mem = 16MB
maintenance_work_mem = 256MBसंचालित द्वारा

अब, कंटेनर चलाते समय इस फ़ाइल को माउंट करें:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v ./my-postgres.conf:/etc/postgresql/postgresql.conf \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgres \
  -c 'config_file=/etc/postgresql/postgresql.conf'संचालित द्वारा

संक्षेप में, परसिस्टेंस, नेटवर्क एक्सेस, और PostgreSQL सेटिंग्स को ठीक से कॉन्फ़िगर करके आप अपनी ज़रूरत के मुताबिक़ Docker-आधारित PostgreSQL वातावरण बना सकते हैं। बेस postgres:latest इमेज तो बस आधार है—बहुत कुछ आप ट्यून कर सकते हैं।

अगले खंड में, मैं आपको Docker में चल रहे PostgreSQL डेटाबेस से कनेक्ट करना दिखाऊँगा।

Docker में चल रहे PostgreSQL से कनेक्ट करना

अब जबकि आपका PostgreSQL कंटेनर चल रहा है, अगला कदम उससे कनेक्ट होना है। आख़िर आप डेटाबेस चलाते ही क्यों हैं?

इस खंड में, मैं आपको अपने कंटेनराइज़्ड PostgreSQL डेटाबेस से कनेक्ट होने के दो तरीके दिखाऊँगा: कमांड-लाइन psql टूल से और एक ग्राफ़िकल इंटरफ़ेस से।

संदर्भ के लिए, मैं अपना डेटाबेस कंटेनर इस कमांड से चला रहा हूँ:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydatabase \
  -v postgres-data:/var/lib/postgresql/data \
  -p 5432:5432 \
  -d postgresसंचालित द्वारा

psql कमांड-लाइन टूल का उपयोग करके कनेक्ट करना

psql कमांड-लाइन टूल आधिकारिक PostgreSQL क्लाइंट है जो आपको SQL कमांड के ज़रिए डेटाबेस से इंटरैक्ट करने देता है। 

कंटेनर में चल रहे PostgreSQL डेटाबेस से होस्ट मशीन से कनेक्ट करने के लिए यह कमांड चलाएँ, लेकिन यूज़र और डेटाबेस मान अपडेट करना न भूलें:

docker exec -it postgres-db psql -U myuser -d mydatabaseसंचालित द्वारा

छवि 6 - psql का उपयोग कर Postgres डेटाबेस से कनेक्ट करना

और बस!

यदि आप सुनिश्चित नहीं हैं कि कमांड क्या करता है, तो संक्षिप्त व्याख्या यह है:

• docker exec -it postgres-db: "postgres-db" नाम के कंटेनर के अंदर एक इंटरैक्टिव कमांड चलाएँ।
• psql -U myuser -d mydatabase: psql शुरू करें, "myuser" के रूप में "mydatabase" से कनेक्ट होते हुए।

यदि कनेक्ट करने में दिक्कत हो रही है, तो ये आम बातें जाँचें:

• docker ps से सुनिश्चित करें कि कंटेनर चल रहा है।
• docker port postgres-db से पोर्ट मैपिंग सत्यापित करें।

GUI टूल का उपयोग करके कनेक्ट करना

कई डेवलपर्स CLI की बजाय ग्राफ़िकल टूल पसंद करते हैं—मैं भी। pgAdmin PostgreSQL के लिए लोकप्रिय और मुफ़्त विकल्प है, लेकिन DBeaver, DataGrip, या TablePlus जैसे अन्य टूल्स में भी कनेक्शन प्रक्रिया मिलती-जुलती है।

pgAdmin का इंस्टॉलेशन सरल है, इसलिए मैं इसे यहाँ कवर नहीं करूँगा।

मान लें आपने इसे इंस्टॉल कर खोला हुआ है, ब्राउज़र पैनल में "Servers" पर राइट-क्लिक करें और "Register > Server" चुनें। अब, General टैब में अपने कनेक्शन को एक नाम दें:

छवि 7 - pgAdmin का General टैब

फिर "Connection" टैब पर जाएँ और ये विवरण भरें:

• Host name/address: localhost
• Port: 5432 (या जो भी पोर्ट आपने मैप किया है)
• Maintenance database: mydatabase
• Username: myuser
• Password: आपका PostgreSQL पासवर्ड

छवि 8 - pgAdmin का Connection टैब

अंत में, कनेक्ट करने के लिए "Save" पर क्लिक करें:

छवि 9 - सफल कनेक्शन

कनेक्ट हो जाने पर, आप अपने डेटाबेस के साथ वैसा ही काम कर सकते हैं जैसा लोकल इंस्टॉल्ड या क्लाउड-प्रोविज़न्ड PostgreSQL इंस्टेंस के साथ करते हैं। Docker की खूबसूरती यह है कि आपके ऐप्लिकेशन या क्लाइंट के नज़रिए से कोई फ़र्क नहीं—यह बस दिए गए पते पर उपलब्ध एक PostgreSQL डेटाबेस है।

>क्या आपको PostgreSQL डेटाबेस तक प्रोग्रामेटिक पहुँच चाहिए? जानें कि Python से कैसे एक्सेस करें।

अगले खंड में, मैं कंटेनर को रोकने, शुरू करने और मॉनिटर करने सहित PostgreSQL कंटेनर मैनेज करना कवर करूँगा।

Docker में PostgreSQL मैनेज करना

कंटेनर में PostgreSQL डेटाबेस चलाना और उससे कनेक्ट होना एक बात है, पर उसे मैनेज करना अलग कौशल है। सौभाग्य से, आपके पास कुछ उपयोगी कमांड्स उपलब्ध हैं।

इस खंड में, मैं कंटेनर को रोकना-शुरू करना, लॉग्स देखना, और PostgreSQL वर्ज़न को अपडेट रखना जैसे ज़रूरी ऑपरेशंस कवर करूँगा।

PostgreSQL कंटेनर को रोकना, रीस्टार्ट करना, और हटाना

Docker के कमांड-लाइन टूल्स आपको PostgreSQL कंटेनर के जीवनचक्र को मैनेज करने देते हैं।

चल रहे PostgreSQL कंटेनर को रोकने के लिए:

docker stop postgres-dbसंचालित द्वारा

इसी तरह, जब आपको फिर से शुरू करना हो:

docker start postgres-dbसंचालित द्वारा

छवि 10 - कंटेनर रोकना और शुरू करना

यदि आप चल रहे कंटेनर को रीस्टार्ट करना चाहते हैं—जो कुछ कॉन्फ़िगरेशन बदलने के बाद उपयोगी हो सकता है—तो यह कमांड चलाएँ:

docker restart postgres-dbसंचालित द्वारा

ऐसे मामलों में जब आप किसी कंटेनर से पूरी तरह काम निपटा चुके हों और उसे हटाना चाहते हों, तो ये दो कमांड पर्याप्त हैं:

docker stop postgres-db
docker rm postgres-dbसंचालित द्वारा

ध्यान रखें कि कंटेनर हटाने से आपका डेटा डिलीट नहीं होता यदि आपने वॉल्यूम सही तरह सेट किया है। आपका डेटा पहले बनाए गए postgres-data वॉल्यूम में रहेगा।

आप यह सत्यापित कर सकते हैं कि कंटेनर हट गया है:

docker ps -aसंचालित द्वारा

यहाँ -a फ़्लैग सभी कंटेनर दिखाता है, बंद किए हुए भी। यदि कंटेनर सफलतापूर्वक हट गया, तो वह सूची में नहीं दिखेगा:

छवि 11 - सभी कंटेनरों की सूची

लॉग्स का निरीक्षण

जब कुछ गलत हो या आप डेटाबेस गतिविधि मॉनिटर करना चाहें, तो लॉग्स देखना पहला अच्छा कदम है।

अपने PostgreSQL कंटेनर के लॉग्स देखने के लिए यह कमांड चलाएँ:

docker logs postgres-dbसंचालित द्वारा

यह कंटेनर शुरू होने से अब तक के सभी लॉग्स दिखाता है। यदि लॉग्स बहुत ज़्यादा हों, तो आप आउटपुट सीमित कर सकते हैं—मान लें आख़िरी 50 लॉग्स तक:

docker logs --tail 50 postgres-dbसंचालित द्वारा

छवि 12 - कंटेनर लॉग्स देखना

दूसरी ओर, यदि आप लॉग्स को रीयल-टाइम में फॉलो करना चाहते हैं, तो यह कमांड चलाएँ:

docker logs -f postgres-dbसंचालित द्वारा

छवि 13 - रीयल-टाइम में कंटेनर लॉग्स देखना

यह खासकर कनेक्शन समस्याओं को डिबग करने या विकास के दौरान डेटाबेस गतिविधि देखने में उपयोगी है।

लॉग्स को फॉलो करना रोकने के लिए Ctrl+C/CMD+C दबाएँ।

Docker में PostgreSQL अपडेट करना

समय के साथ, आपको नए फ़ीचर्स, परफ़ॉर्मेंस सुधार, और सुरक्षा पैच पाने के लिए PostgreSQL वर्ज़न अपडेट करना होगा।

लिखते समय postgres:17.4 लेटेस्ट वर्ज़न है, लेकिन मान लें postgres:17.5 रिलीज़ हो गया। यह खंड बताएगा कि कंटेनर में डेटाबेस वर्ज़न कैसे अपडेट करें।

शुरू करने के लिए, लेटेस्ट PostgreSQL इमेज (या कोई विशिष्ट वर्ज़न) पुल करें:

docker pull postgres:17.5संचालित द्वारा

फिर, मौजूदा कंटेनर को रोकें और हटाएँ:

docker stop postgres-db
docker rm postgres-dbसंचालित द्वारा

अंत में, उसी वॉल्यूम के साथ नया कंटेनर बनाइए:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydatabase \
  -v postgres-data:/var/lib/postgresql/data \
  -p 5432:5432 \
  -d postgres:17.5संचालित द्वारा

क्योंकि आप वही वॉल्यूम (postgres-data) उपयोग कर रहे हैं, आपका सारा मौजूदा डेटा सुरक्षित रहेगा।

यदि आप बड़े वर्ज़न (जैसे 17 से 18) पर अपग्रेड कर रहे हैं, तो PostgreSQL स्टार्ट होने पर ज़रूरी डेटा माइग्रेशन अपने-आप चलाता है। बस ये बातें ध्यान रखें:

• बड़े वर्ज़न अपग्रेड पहले नॉन-प्रोडक्शन वातावरण में टेस्ट करें।
• बड़े वर्ज़न अपग्रेड से पहले हमेशा अपने डेटा वॉल्यूम का बैकअप लें।
• PostgreSQL रिलीज़ नोट्स में ब्रेकिंग चेंजेस की जाँच करें।

अपग्रेड से पहले बैकअप बनाने के लिए, यह कमांड चलाएँ:

docker run --rm -v postgres-data:/data -v $(pwd):/backup postgres:17.4 \
  bash -c "pg_dumpall -U myuser > /backup/postgres_backup.sql"संचालित द्वारा

यह आपके मौजूदा डायरेक्टरी में SQL बैकअप फ़ाइल बना देगा, जिससे कुछ गड़बड़ होने पर आप डेटा रीस्टोर कर सकें।

>हमारा PostgreSQL Basics Cheat Sheet Docker में काम करते समय तुरंत संदर्भ के लिए उपयोगी लग सकता है।

अगले खंड में, मैं Docker में PostgreSQL इस्तेमाल करने के सर्वोत्तम अभ्यासों पर बात करूँगा, जिसमें सुरक्षा और ऑप्टिमाइज़ेशन टिप्स शामिल हैं।

Docker में PostgreSQL के लिए सर्वोत्तम अभ्यास

Docker की लचीलापन जिम्मेदारी के साथ आता है। इस खंड में, मैं कुछ सर्वोत्तम अभ्यास साझा करूँगा ताकि आपका कंटेनराइज़्ड PostgreSQL सेटअप भरोसेमंद, सुरक्षित, और उद्योग मानकों के अनुरूप हो।

नियमित बैकअप से अपना डेटा सुरक्षित रखें

आप PostgreSQL जैसे भी चलाएँ, नियमित बैकअप ज़रूरी हैं। मैंने पिछले खंड में बैकअप का उल्लेख किया था, लेकिन यहाँ इसे थोड़ा विस्तार देता हूँ। 

Docker में चल रहे PostgreSQL डेटाबेस का सबसे सरल बैकअप pg_dump से हो सकता है:

docker exec -t postgres-db pg_dump -U myuser mydatabase > backup.sqlसंचालित द्वारा

छवि 14 - PostgreSQL बैकअप

सभी डेटाबेस—रोल्स और टेबलस्पेसेज़ सहित—का पूरा बैकअप लेने के लिए pg_dumpall का उपयोग करें:

docker exec -t postgres-db pg_dumpall -U myuser > full_backup.sqlसंचालित द्वारा

छवि 15 - पूर्ण PostgreSQL डेटाबेस बैकअप

यह छवि केवल कुछ बैकअप कमांड्स दिखाती है, क्योंकि पूरी चीज़ स्क्रीन में समाना संभव नहीं।

बैकअप को स्वचालित करने के लिए आप एक साधारण शेल स्क्रिप्ट बना सकते हैं और उसे cron से चलाएँ:

#!/bin/bash
# backup.sh
TIMESTAMP=$(date +"%Y%m%d")
BACKUP_DIR="/Users/dradecic/Documents/pg-backups"

# Make sure the backup directory exists
mkdir -p $BACKUP_DIR

# Create the backup
docker exec postgres-db pg_dumpall -U myuser | gzip > $BACKUP_DIR/postgres_$TIMESTAMP.sql.gz

# Remove backups older than 30 days
find $BACKUP_DIR -name "postgres_*.sql.gz" -mtime +30 -deleteसंचालित द्वारा

स्क्रिप्ट को executable बनाएँ और चलाएँ:

chmod +x backup.sh

bash backup.shसंचालित द्वारा

छवि 16 - PostgreSQL डेटाबेस बैकअप स्क्रिप्ट चलाना

बैकअप को पूरी तरह स्वचालित करने के लिए, स्क्रिप्ट को अपनी crontab में रोज़ चलने के लिए जोड़ें:

0 3 * * * /path/to/backup.shसंचालित द्वारा

यह शेड्यूल हर रोज़ सुबह 3 बजे बैकअप चलाता है—आप अपनी ज़रूरत के मुताबिक़ समय और अंतराल बदल सकते हैं। 

>मेरी cron jobs पर पूरी गाइड देखें—इस उपयोगी ऑटोमेशन टूल के बारे में और जानने के लिए।

प्रोडक्शन वातावरण के लिए, बैकअप्स को ऑफ़-साइट या क्लाउड स्टोरेज में रखने पर विचार करें ताकि डिज़ास्टर रिकवरी सुनिश्चित हो।

डेटा परसिस्टेंस के लिए नामित वॉल्यूम्स का उपयोग करें

मैंने पहले वॉल्यूम्स का संक्षेप में ज़िक्र किया—यहाँ उन्हें थोड़ी अधिक विस्तार से देखते हैं।

आम नियम के तौर पर, आपको कभी भी Docker में PostgreSQL बिना ठीक से कॉन्फ़िगर किए वॉल्यूम के नहीं चलाना चाहिए। वरना कंटेनर हटने या Docker की क्लीनअप प्रक्रिया में आपका डेटा खो सकता है।

अनाम वॉल्यूम्स की बजाय नामित वॉल्यूम्स इस्तेमाल करने से बैकअप और मैनेजमेंट आसान हो जाता है:

# Create a named volume
docker volume create postgres-data

# Use it when running the container
docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgresसंचालित द्वारा

यहाँ कुछ नया नहीं।

नामित वॉल्यूम का बैकअप लेना भी आसान है। पूरे वॉल्यूम का बैकअप बनाने के लिए यह कमांड चलाएँ:

docker run --rm -v postgres-data:/data -v $(pwd):/backup alpine tar czf /backup/postgres-data-backup.tar.gz /dataसंचालित द्वारा

इससे उसी फ़ोल्डर में postgres-data-backup.tar.gz फ़ाइल बन जाएगी जहाँ से आपने कमांड चलाया।

अब, इस वॉल्यूम को रीस्टोर करने के लिए यह चलाएँ:

docker run --rm -v postgres-data:/data -v $(pwd):/backup alpine sh -c "cd /data && tar xzf /backup/postgres-data-backup.tar.gz --strip 1"संचालित द्वारा

बस इतना ही!

Docker में PostgreSQL को सुरक्षित बनाना

डेटाबेस के मामले में सुरक्षा कभी बाद की बात नहीं होनी चाहिए। यह उपखंड आपके PostgreSQL कंटेनर को सुरक्षित बनाने के लिए कुछ ज़रूरी अभ्यास बताएगा।

मजबूत और यूनिक पासवर्ड का उपयोग करें

डिफ़ॉल्ट या कमज़ोर पासवर्ड से बचें। PostgreSQL सुपरयूज़र के लिए एक मज़बूत, रैंडम पासवर्ड जनरेट करें:

export POSTGRES_PASSWORD=$(openssl rand -base64 32)
echo "$POSTGRES_PASSWORD" > postgres-password.txt

docker run --name postgres-db \
  -e POSTGRES_PASSWORD="$POSTGRES_PASSWORD" \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgresसंचालित द्वारा

छवि 17 - सुरक्षित पासवर्ड का उपयोग

इस पासवर्ड को सुरक्षित रूप से रखें—पासवर्ड मैनेजर में या ऐसे एनवायरनमेंट वेरिएबल फ़ाइल में जो वर्ज़न कंट्रोल में चेक-इन न हो।

नेटवर्क एक्सेस सीमित करें

डिफ़ॉल्ट रूप से, Docker PostgreSQL पोर्ट को सभी इंटरफेसेज़ पर एक्सपोज़ करता है। खासकर प्रोडक्शन में सुरक्षा सुधार के लिए, एक्सेस को localhost तक सीमित करें:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 127.0.0.1:5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgresसंचालित द्वारा

कस्टम PostgreSQL कॉन्फ़िगरेशन का उपयोग

नीचे दिए गए जैसे पैरामीटर संशोधित कर एक अधिक सुरक्षित PostgreSQL कॉन्फ़िगरेशन बनाएँ:

# Require SSL
ssl = on
ssl_cert_file = '/etc/ssl/certs/ssl-cert-snakeoil.pem'
ssl_key_file = '/etc/ssl/private/ssl-cert-snakeoil.key'

# Limit connection attempts
max_connections = 100
authentication_timeout = 1min

# Restrict access
listen_addresses = 'localhost'संचालित द्वारा

कंटेनर शुरू करते समय इस कॉन्फ़िगरेशन फ़ाइल को माउंट करें:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v ./pg_hba.conf:/var/lib/postgresql/data/pg_hba.conf \
  -v ./postgresql.conf:/var/lib/postgresql/data/postgresql.conf \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgresसंचालित द्वारा

अपना PostgreSQL इमेज नियमित रूप से अपडेट करें

नवीनतम सुरक्षा पैच पाने के लिए अपना PostgreSQL वर्ज़न अपडेट रखें:

docker pull postgres:latest
docker stop postgres-db
docker rm postgres-db
# Then recreate with the latest imageसंचालित द्वारा

ये सर्वोत्तम अभ्यास Docker में PostgreSQL का अधिक भरोसेमंद और सुरक्षित वातावरण बनाने में मदद करेंगे, जो विकास और प्रोडक्शन—दोनों उपयोग-केस के लिए उपयुक्त हो।

अगले खंड में, मैं Docker में PostgreSQL चलाते समय आने वाली आम समस्याओं का ट्रबलशूटिंग बताऊँगा।

Docker में PostgreSQL का ट्रबलशूटिंग

जल्दी या देर, Docker में PostgreSQL चलाते समय कुछ न कुछ समस्या आएगी ही। इस खंड में मैं आम समस्याएँ और उनके समाधान कवर करूँगा—जो समय और झुंझलाहट दोनों बचाएँगे।

PostgreSQL कंटेनरों की आम समस्याएँ

एक आम समस्या यह है कि कंटेनर शुरू होते ही तुरंत बंद हो जाता है। यदि आपके साथ ऐसा हो रहा है, तो कारण जानने के लिए लॉग्स देखें:

docker logs postgres-dbसंचालित द्वारा

आपकी त्रुटि माउंट किए गए वॉल्यूम्स पर परमिशन समस्याओं से जुड़ी हो सकती है। ऐसे में आपको ऐसा लॉग संदेश दिखेगा:

initdb: could not change permissions of directory "/var/lib/postgresql/data": Operation not permittedसंचालित द्वारा

समाधान के लिए, वॉल्यूम के ओनरशिप और परमिशन जाँचें और ज़रूरत पड़े तो ठीक करें:

# Check the ownership
docker run --rm -v postgres-data:/data alpine ls -la /data

# Fix the permissions
docker run --rm -v postgres-data:/data alpine chmod 700 /dataसंचालित द्वारा

एक और आम समस्या है आवश्यक एनवायरनमेंट वेरिएबल्स का मिस होना। तब का एक सामान्य लॉग संदेश ऐसा दिखता है:

Database is uninitialized and superuser password is not specifiedसंचालित द्वारा

इसे सुलझाने के लिए सुनिश्चित करें कि आप आवश्यक POSTGRES_PASSWORD—या कोई अन्य—एनवायरनमेंट वेरिएबल सेट कर रहे हैं:

docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgresसंचालित द्वारा

“डेटा डायरेक्टरी खाली नहीं है पर PostgreSQL फ़ाइलें गायब हैं” वाली त्रुटि भी आम है। अक्सर ऐसा लॉग संदेश दिखता है:

PostgreSQL Database directory appears to contain a database; Skipping initializationसंचालित द्वारा

इसके बाद फ़ाइलों के गायब होने को लेकर त्रुटियाँ आती हैं।

यह आमतौर पर तब होता है जब आपने ऐसा वॉल्यूम माउंट किया हो जिसमें फ़ाइलें तो हों लेकिन मान्य PostgreSQL डेटाबेस न हो। आपको नए वॉल्यूम से दोबारा इनिशियलाइज़ करना पड़ सकता है:

docker volume create postgres-data-new
docker run --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgres-data-new:/var/lib/postgresql/data \
  -d postgresसंचालित द्वारा

कनेक्टिविटी समस्याओं का समाधान

यदि आप कंटेनर में चल रहे PostgreSQL डेटाबेस से कनेक्ट नहीं हो पा रहे हैं, तो सबसे पहले सुनिश्चित करें कि कंटेनर चल रहा है:

docker ps | grep postgres-dbसंचालित द्वारा

यदि सूची में नहीं दिखता, तो हो सकता है क्रैश हो गया हो। ऊपर बताए अनुसार लॉग्स जाँचें।

यदि सूची में है, फिर भी कनेक्ट नहीं हो रहा, तो पोर्ट मैपिंग सत्यापित करें:

docker port postgres-dbसंचालित द्वारा

आपको कुछ ऐसा दिखना चाहिए:

छवि 18 - कंटेनर पोर्ट मैपिंग

यदि नहीं, तो आपकी पोर्ट मैपिंग गलत हो सकती है। सही -p विकल्प के साथ कंटेनर फिर से बनाएँ।

यदि फिर भी कनेक्ट न हो, तो अपनी कनेक्शन सेटिंग्स जाँचें। ये पैरामीटर्स देखें:

• Hostname: localhost या 127.0.0.1 (कंटेनर का नाम नहीं)।
• Port: आपकी मैपिंग में होस्ट का पोर्ट (आम तौर पर 5432)।
• Username: POSTGRES_USER का मान (डिफ़ॉल्ट "postgres")।
• Password: POSTGRES_PASSWORD का मान।
• Database: POSTGRES_DB का मान (डिफ़ॉल्ट POSTGRES_USER जैसा)।

इनका समाधान करने के बाद फिर से कोशिश करें। यदि समस्या बनी रहे, तो कंटेनर के अंदर से कनेक्टिविटी टेस्ट करें:

docker exec -it postgres-db psql -U postgresसंचालित द्वारा

यदि यह काम करता है, तो समस्या आपकी पोर्ट मैपिंग या बाहरी नेटवर्क में है।

अंत में, आप फ़ायरवॉल समस्याएँ जाँच सकते हैं। हो सकता है आपका सिस्टम फ़ायरवॉल PostgreSQL पोर्ट पर कनेक्शन ब्लॉक कर रहा हो, इसलिए तस्दीक करें:

# Linux
sudo iptables -L | grep 5432

# macOS
sudo pfctl -sr | grep 5432संचालित द्वारा

इन आम बातों की जाँच से आप Docker में PostgreSQL से जुड़ी अधिकतर समस्याओं की पहचान और समाधान कर पाएँगे। यदि फिर भी अटकें, तो PostgreSQL और Docker का प्रलेखन व सामुदायिक फ़ोरम अधिक विशिष्ट ट्रबलशूटिंग के उत्कृष्ट संसाधन हैं।

Docker में PostgreSQL डेटाबेस का समापन

लीजिए—Docker में PostgreSQL डेटाबेस को कॉन्फ़िगर और चलाने की अंतिम गाइड! मैंने शुरुआती कंटेनर सेटअप से लेकर कॉन्फ़िगरेशन, कनेक्शन, और मैनेजमेंट तक—शुरुआत के लिए ज़रूरी हर बात कवर की है। 

पारंपरिक विकल्प—जैसे लोकल इंस्टॉलेशन या क्लाउड में प्रोविज़निंग—विकास उद्देश्यों के लिए या तो कमतर हैं या महँगे। Docker इस अंतर को पाटता है। आप इसे लोकल डेवलपमेंट, टेस्टिंग, या यहाँ तक कि प्रोडक्शन के लिए इस्तेमाल करें—कंटेनराइज़्ड PostgreSQL लचीलापन और एकरूपता देता है जिसे मात देना कठिन है।

अब आप अपने अनुप्रयोगों में Dockerized Postgres डेटाबेस को शामिल करने के लिए पूरी तरह तैयार हैं।

यदि आप और गहराई से जाना चाहते हैं, तो DataCamp के ये कोर्स सुझाता हूँ:

• Creating PostgreSQL Databases
• Introduction to Docker
• SQL for Database Administrators
• Functions for Manipulating Data in PostgreSQL