सुरुकर्ताहरूका लागि: Dockerfile बाट Ubuntu वातावरण निर्माण | आधारभूत Python गाइड

1. परिचय

Docker र Dockerfile भनेको के हो?

Ubuntu लाई आधार बनाउने कारण

• धेरै आधिकारिक र सामुदायिक दस्तावेजहरू उपलब्ध छन्, जसले सिकाइ लागत कम छ
• धेरै प्याकेज र टुलहरू APT बाट सजिलै स्थापना गर्न सकिन्छ
• हल्का मिनिमल इमेजहरू (ubuntu:20.04, ubuntu:24.04 आदि) आधिकारिक रूपमा प्रदान गरिएका छन्

यो लेखको उद्देश्य र लक्षित पाठक

• पहिलो पटक Dockerfile प्रयोग गरेर वातावरण निर्माण गर्न चाहनेहरू
• Ubuntu मा विकास वातावरणलाई उच्च पुनरावृत्ति सहित बनाउन चाहनेहरू
• समस्या समयको समाधानसम्म समावेश गरेर ज्ञान गहिरो बनाउन चाहनेहरू

2. Dockerfile को आधारभूत संरचना

Dockerfile भनेको के हो? यसको भूमिका बुझौं

• वातावरण निर्माणको स्वचालितीकरण (हातले काम दोहोर्याउनु पर्दैन)
• एकभन्दा बढी व्यक्तिहरूले विकास गर्दा वातावरणको भिन्नता हट्छ
• CI/CD पाइपलाइनमा पनि सजिलै समावेश गर्न सकिन्छ

Dockerfile मा सामान्यतया प्रयोग हुने आधारभूत कमान्डहरू (डाइरेक्टिभहरू)

Ubuntu आधारित Dockerfile को न्यूनतम उदाहरण

FROM ubuntu:24.04

RUN apt-get update && apt-get install -y 
    curl 
    vim

CMD ["/bin/bash"]

Ubuntu को ट्याग चयन बारे

• ubuntu:22.04 (LTS: दीर्घकालीन समर्थन संस्करण, स्थिरता प्राथमिकता)
• ubuntu:24.04 (नवीनतम LTS उम्मेदवार, कार्यक्षमता प्राथमिकता)

3. अभ्यास: Ubuntu आधारित Dockerfile निर्माण

Ubuntu वातावरणमा आवश्यक प्याकेजहरू स्थापना गर्नुहोस्

• curl: फाइल प्राप्ति वा API जाँचका लागि
• vim: सरल टेक्स्ट सम्पादक
• git: संस्करण व्यवस्थापन उपकरण
• build-essential: C/C++ को निर्माणका लागि आवश्यक आधारभूत उपकरण समूह

FROM ubuntu:24.04

RUN apt-get update && apt-get install -y 
    curl 
    vim 
    git 
    build-essential

गैर-संवादात्मक स्थापनाको सेटिङ

ENV DEBIAN_FRONTEND=noninteractive

अनावश्यक क्यास हटाएर हल्का बनाउने

RUN apt-get update && apt-get install -y 
    curl 
    vim 
    && rm -rf /var/lib/apt/lists/*

सर्वोत्तम अभ्यासहरू: Dockerfile को व्यवस्था

• RUN आदेशहरूलाई सकेसम्म समेटेर, तह संख्यालाई घटाउने
• ENV मा स्पष्ट रूपमा संस्करण वा सेटिङ परिभाषित गर्ने
• टिप्पणी प्रयोग गरेर प्रक्रियाको उद्देश्य स्पष्ट लेख्ने
• अनावश्यक फाइलहरू नराख्न rm वा --no-install-recommends प्रयोग गर्ने

RUN apt-get update && apt-get install -y --no-install-recommends 
    curl 
    git 
    && rm -rf /var/lib/apt/lists/*

4. Docker छविको निर्माण र जाँच

Dockerfile बाट Docker छवि निर्माण गर्ने

docker build -t my-ubuntu-image .

• -t विकल्पले छविमा नाम (ट्याग) दिन्छ। उदाहरणमा my-ubuntu-image नाम दिइएको छ।
• . ले Dockerfile रहेको हालको डाइरेक्टरीलाई जनाउँछ।

निर्माण गरिएको Docker छविको जाँच

docker images

• REPOSITORY (छवि नाम)
• TAG (ट्याग)
• IMAGE ID (अनौठो पहिचानकर्ता)
• CREATED (निर्माण मिति)
• SIZE (आकार)

REPOSITORY        TAG       IMAGE ID       CREATED          SIZE
my-ubuntu-image   latest    abcd1234abcd   5 minutes ago    189MB

Docker कन्टेनर सुरु गरेर कार्य जाँच गर्ने

docker run -it my-ubuntu-image

• -it विकल्प निर्दिष्ट गर्दा, अन्तर्क्रियात्मक मोडमा टर्मिनल सुरु गर्न सकिन्छ।
• सामान्य रूपमा सुरु भएमा, कन्टेनर भित्रको bash प्रोम्प्ट देखिन्छ, र Ubuntu वातावरणमा लगइन भएको जस्तो अवस्था हुन्छ।

curl --version
vim --version

अनावश्यक छवि वा कन्टेनरहरूको सफाई

• रोकिएका कन्टेनरहरूको हटाउने：

docker container prune

• अप्रयुक्त छविहरूको हटाउने：

docker image prune

• सबै अप्रयुक्त डाटाहरू हटाउने (सावधानी！)：

docker system prune

5. प्रयोग: Python वातावरणको निर्माण

Ubuntu-आधारित Dockerfile मा Python प्रयोगयोग्य बनाउने

apt प्रयोग गरेर Python स्थापना गर्ने विधि

FROM ubuntu:24.04

RUN apt-get update && apt-get install -y 
    python3 
    python3-pip 
    && rm -rf /var/lib/apt/lists/*

pyenv प्रयोग गरेर Python को संस्करण व्यवस्थापन गर्ने

FROM ubuntu:24.04

ENV DEBIAN_FRONTEND=noninteractive

RUN apt-get update && apt-get install -y 
    git 
    curl 
    make 
    build-essential 
    libssl-dev 
    zlib1g-dev 
    libbz2-dev 
    libreadline-dev 
    libsqlite3-dev 
    wget 
    llvm 
    libncurses5-dev 
    libncursesw5-dev 
    xz-utils 
    tk-dev 
    libffi-dev 
    liblzma-dev 
    && rm -rf /var/lib/apt/lists/*

# pyenv को स्थापना
RUN git clone https://github.com/pyenv/pyenv.git ~/.pyenv

ENV PYENV_ROOT="$HOME/.pyenv"
ENV PATH="$PYENV_ROOT/bin:$PATH"

RUN echo 'eval "$(pyenv init --path)"' >> ~/.bashrc

# कुनै पनि Python संस्करण स्थापना गर्नुहोस्
RUN pyenv install 3.11.6 && pyenv global 3.11.6

requirements.txt प्रयोग गरेर प्याकेज व्यवस्थापन

flask==2.3.2
requests>=2.25.1
pandas

COPY requirements.txt /app/requirements.txt
WORKDIR /app

RUN pip install --no-cache-dir -r requirements.txt

सर्वोत्तम अभ्यासहरू

• Python प्रयोग गर्दा, virtualenv वा venv ले भर्चुअल वातावरण निर्माण गर्दा, निर्भरता द्वन्द्वहरू रोक्न सजिलो हुन्छ।
• क्यास हटाउने (--no-cache-dir) गरेर, Docker इमेजलाई हल्का बनाउन सकिन्छ।
• Python प्याकेज स्थापना गर्नुअघि pip install --upgrade pip ले नवीनतम संस्करणमा राख्दा त्रुटिहरू रोक्न सकिन्छ।

6. सामान्य समस्याहरू र समाधानहरू

अनुमतिपत्र (अधिकार) त्रुटि

उदाहरण:

Permission denied

समाधान:

• फाइललाई कार्यान्वयन योग्य बनाउनुहोस्:

  RUN chmod +x script.sh

• आवश्यकताअनुसार, प्रयोगकर्तालाई परिवर्तन गर्नुहोस्:

  RUN chown root:root /path/to/file

प्याकेज फेला पार्न सकिँदैन, वा स्थापना गर्न सकिँदैन

उदाहरण:

E: Unable to locate package xxx

समाधान:

• apt-get update लाई install भन्दा पहिले अवश्य लेख्नुहोस्:

  RUN apt-get update && apt-get install -y curl

• प्याकेज नाम जाँच गर्नुहोस् र टाइपिङ त्रुटि छैन भनेर हेर्नुहोस्

नेटवर्क सम्बन्धी त्रुटि

उदाहरण:

Temporary failure resolving 'deb.debian.org'

समाधान:

• Docker डेमनलाई पुन: सुरु गर्दा सुधार हुन सक्छ:

  sudo systemctl restart docker

• Docker को DNS सेटिङ पुनरावलोकन गर्नुहोस् (/etc/docker/daemon.json मा DNS निर्दिष्ट थप्नुहोस्):

  {
    "dns": ["8.8.8.8", "8.8.4.4"]
  }

क्यासको प्रभावले पुरानो अवस्थामा नै निर्माण

समाधान:

• क्यासलाई असक्षम बनाएर पुन: निर्माण गर्नुहोस्:

  docker build --no-cache -t my-image .

कन्टेनर भित्रको सुरु कमान्ड कार्यान्वयन नहुनु वा तुरुन्तै समाप्त हुनु

कारण:

• CMD वा ENTRYPOINT मा निर्दिष्ट कमान्डमा त्रुटि छ
• CMD मा ["/bin/bash"] आदि निर्दिष्ट गरे पनि, अन्तर्क्रियात्मक नभए तुरुन्तै समाप्त हुन्छ

समाधान:

• कन्टेनरलाई डिबगका लागि सुरु गरेर जाँच गर्नुहोस्:

  docker run -it my-image /bin/bash

• CMD र ENTRYPOINT को भिन्नता बुझ्नुहोस् र उद्देश्य अनुसार प्रयोग गर्नुहोस्

7. सारांश

Ubuntu आधारित Dockerfile सिर्जनाका बुँदाहरू पुन: पुष्टि

• Dockerfile को आधारभूत संरचना लाई बुझ्नु पहिलो चरण हो FROM, RUN, CMD, ENV जस्ता आदेशहरूलाई संयोजन गरेर वातावरण निर्माणलाई स्वचालित गर्न सकिन्छ।
• Ubuntu स्थिरता र लचकताको उच्च आधारभूत इमेज हो धनी प्याकेजहरू, व्यापक प्रयोगकर्ता समूह, LTS संस्करणको अस्तित्वका कारण, विकास वातावरणको आधारको रूपमा उपयुक्त छ।
• व्यावहारिक प्याकेज व्यवस्थापन मार्फत, आवश्यक उपकरणहरू वा लाइब्रेरीहरू स्थापना गर्न सकिन्छ apt-get को प्रयोग विधि वा क्यास हटाउने, गैर-संवादात्मक स्थापनाजस्ता कुराहरू कुञ्जी बन्छन्।
• Python जस्ता व्यावहारिक वातावरण निर्माण पनि Dockerfile मार्फत सम्भव छ pyenv वा pip, requirements.txt जस्ता उपकरणहरूसँग, पुनरावृत्तिको उच्च विकास वातावरण प्राप्त गर्न सकिन्छ।
• समस्या समाधान क्षमता स्थिर सञ्चालनसँग सीधा जोडिएको छ अनुमतिहरू, नेटवर्क, निर्माण क्यास जस्ता ठोक्किने बुँदाहरूलाई बुझेर, विकास दक्षतालाई ठूलो मात्रामा सुधार गर्न सकिन्छ।

Dockerfile सिकाइको अर्को चरण

• Docker Compose प्रयोग गरेर बहु-कन्टेनर संरचनाको व्यवस्थापन
• CI/CD उपकरणहरू (GitHub Actions, GitLab CI आदि) सँगको एकीकरण
• Kubernetes जस्ता कन्टेनर ओरकेस्ट्रेसन उपकरणहरू सँगको अन्तरक्रिया

आधिकारिक दस्तावेजहरू- सन्दर्भ लिङ्कहरू

• Docker आधिकारिक दस्तावेज (जापानी)
• Docker Hub – Ubuntu आधिकारिक इमेज
• pyenv GitHub रिपोजिटरी

8. FAQ (बारम्बार सोधिने प्रश्नहरू)

Q1. Dockerfile मा Ubuntu को कुन संस्करण छान्नु उपयुक्त हुन्छ?

Q2. apt-get install मा “प्याकेज फेला परेन” भन्ने सन्देश किन आउँछ?

RUN apt-get update && apt-get install -y curl

Q3. Dockerfile मा वातावरण चरहरू कसरी सेट गर्ने?

ENV DEBIAN_FRONTEND=noninteractive

Q4. Dockerfile मा CMD र ENTRYPOINT को भिन्नता के हो?

CMD ["python3", "app.py"]
# vs
ENTRYPOINT ["python3"]
CMD ["app.py"]

Q5. Dockerfile सम्पादन गरे पनि परिवर्तन प्रतिबिम्बित हुँदैन। किन?

docker build --no-cache -t my-image .