डॉकर क्विकस्टार्ट गाइड के लिए Ultralytics

यह मार्गदर्शिका आपके लिए डॉकर वातावरण स्थापित करने के लिए एक व्यापक परिचय के रूप में कार्य करती है Ultralytics परियोजनाओं। डॉकर कंटेनरों में एप्लिकेशन विकसित करने, शिपिंग करने और चलाने के लिए एक मंच है। यह सुनिश्चित करने के लिए विशेष रूप से फायदेमंद है कि सॉफ़्टवेयर हमेशा एक जैसा चलेगा, भले ही वह कहीं भी तैनात हो। अधिक जानकारी के लिए, पर जाएँ Ultralytics Docker रिपॉजिटरी on Docker Hub.

आप क्या सीखेंगे

• के साथ डॉकर की स्थापना NVIDIA जीविका
• स्थापित Ultralytics डॉकर छवियां
• भागना Ultralytics एक डॉकर कंटेनर में CPU नहीं तो GPU जीविका
• दिखाने के लिए डॉकर के साथ डिस्प्ले सर्वर का उपयोग करना Ultralytics पता लगाने के परिणाम
• कंटेनर में स्थानीय निर्देशिकाओं को माउंट करना

आवश्यकताएँ

• सुनिश्चित करें Docker आपके सिस्टम पर स्थापित है। यदि नहीं, तो आप इसे डॉकर की वेबसाइट से डाउनलोड और इंस्टॉल कर सकते हैं।
• सुनिश्चित करें कि आपके सिस्टम में NVIDIA GPU और NVIDIA ड्राइवर स्थापित हैं।

के साथ डॉकर की स्थापना NVIDIA जीविका

सबसे पहले, सत्यापित करें कि NVIDIA ड्राइवरों को चलाकर ठीक से स्थापित किया जाता है:

nvidia-smi

स्थापित NVIDIA डॉकर रनटाइम

अब, आइए NVIDIA सक्षम करने के लिए डॉकर रनटाइम GPU डॉकर कंटेनरों में समर्थन:

# Add NVIDIA package repositories
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
distribution=$(lsb_release -cs)
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list

# Install NVIDIA Docker runtime
sudo apt-get update
sudo apt-get install -y nvidia-docker2

# Restart Docker service to apply changes
sudo systemctl restart docker

जाँचना NVIDIA डॉकर के साथ रनटाइम

चलाना docker info | grep -i runtime यह सुनिश्चित करने के लिए कि nvidia रनटाइम की सूची में दिखाई देता है:

docker info | grep -i runtime

स्थापित Ultralytics डॉकर छवियाँ

Ultralytics विभिन्न प्लेटफार्मों और उपयोग-मामलों के लिए अनुकूलित कई डॉकर छवियां प्रदान करता है:

• डॉकरफाइल: GPU छवि, प्रशिक्षण के लिए आदर्श।
• डॉकरफाइल-आर्म64: ARM64 आर्किटेक्चर के लिए, रास्पबेरी पाई जैसे उपकरणों के लिए उपयुक्त।
• डॉकरफाइल-cpu: CPUअनुमान के लिए केवल संस्करण और गैर-GPU वातावरण।
• Dockerfile-jetson: के लिए अनुकूलित NVIDIA जेटसन डिवाइस।
• डॉकरफाइल-python: न्यूनतम Python हल्के अनुप्रयोगों के लिए पर्यावरण।
• Dockerfile-conda: Miniconda3 और शामिल हैं Ultralytics पैकेज कोंडा के माध्यम से स्थापित किया गया।

नवीनतम छवि खींचने के लिए:

# Set image name as a variable
t=ultralytics/ultralytics:latest

# Pull the latest Ultralytics image from Docker Hub
sudo docker pull $t

भागना Ultralytics in डॉकर कंटेनर

यहां बताया गया है कि कैसे निष्पादित करें Ultralytics डॉकर कंटेनर:

केवल का उपयोग करना CPU

# Run with all GPUs
sudo docker run -it --ipc=host $t

GPU का उपयोग करना

# Run with all GPUs
sudo docker run -it --ipc=host --gpus all $t

# Run specifying which GPUs to use
sudo docker run -it --ipc=host --gpus '"device=2,3"' $t

वही -it फ्लैग एक छद्म TTY असाइन करता है और STDIN को खुला रखता है, जिससे आप कंटेनर के साथ इंटरैक्ट कर सकते हैं। वही --ipc=host फ्लैग होस्ट के आईपीसी नेमस्पेस को साझा करने में सक्षम बनाता है, जो प्रक्रियाओं के बीच मेमोरी साझा करने के लिए आवश्यक है। वही --gpus ध्वज कंटेनर को होस्ट के जीपीयू तक पहुंचने की अनुमति देता है।

भागना Ultralytics in डॉकर कंटेनर

यहां बताया गया है कि कैसे निष्पादित करें Ultralytics डॉकर कंटेनर:

केवल का उपयोग करना CPU

# Run with all GPUs
sudo docker run -it --ipc=host $t

GPU का उपयोग करना

# Run with all GPUs
sudo docker run -it --ipc=host --gpus all $t

# Run specifying which GPUs to use
sudo docker run -it --ipc=host --gpus '"device=2,3"' $t

वही -it फ्लैग एक छद्म TTY असाइन करता है और STDIN को खुला रखता है, जिससे आप कंटेनर के साथ इंटरैक्ट कर सकते हैं। वही --ipc=host फ्लैग होस्ट के आईपीसी नेमस्पेस को साझा करने में सक्षम बनाता है, जो प्रक्रियाओं के बीच मेमोरी साझा करने के लिए आवश्यक है। वही --gpus ध्वज कंटेनर को होस्ट के जीपीयू तक पहुंचने की अनुमति देता है।

फ़ाइल अभिगम्यता पर ध्यान दें

कंटेनर के भीतर अपनी स्थानीय मशीन पर फ़ाइलों के साथ काम करने के लिए, आप उपयोग कर सकते हैं Docker वॉल्यूम:

# Mount a local directory into the container
sudo docker run -it --ipc=host --gpus all -v /path/on/host:/path/in/container $t

बदलें /path/on/host अपने स्थानीय मशीन पर निर्देशिका पथ के साथ और /path/in/container डॉकर कंटेनर के अंदर वांछित पथ के साथ।

ग्राफ़िकल यूज़र इंटरफ़ेस (GUI) एप्लिकेशन को डॉकर कंटेनर में चलाएँ

डॉकर का उपयोग मुख्य रूप से पृष्ठभूमि अनुप्रयोगों को कंटेनरीकृत करने के लिए किया जाता है और CLI प्रोग्राम, लेकिन यह ग्राफिकल प्रोग्राम भी चला सकता है। लिनक्स की दुनिया में, दो मुख्य ग्राफिक सर्वर ग्राफिकल डिस्प्ले को संभालते हैं: एक्स 11 (एक्स विंडो सिस्टम के रूप में भी जाना जाता है) और वेलैंड। शुरू करने से पहले, यह निर्धारित करना आवश्यक है कि आप वर्तमान में किस ग्राफिक्स सर्वर का उपयोग कर रहे हैं। पता लगाने के लिए इस कमांड को चलाएं:

env | grep -E -i 'x11|xorg|wayland'

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

GUI के साथ Docker कंटेनर चलाना

If you're using [GPUs](#using-gpus), you can add the `--gpus all` flag to the command.

xhost +local:docker && docker run -e DISPLAY=$DISPLAY \
-v /tmp/.X11-unix:/tmp/.X11-unix \
-v ~/.Xauthority:/root/.Xauthority \
-it --ipc=host $t

xhost +local:docker && docker run -e DISPLAY=$DISPLAY \
-v $XDG_RUNTIME_DIR/$WAYLAND_DISPLAY:/tmp/$WAYLAND_DISPLAY \
--net=host -it --ipc=host $t

GUI के साथ डॉकर का उपयोग करना

अब आप अपने अंदर ग्राफिकल एप्लिकेशन प्रदर्शित कर सकते हैं Docker कंटेनर। उदाहरण के लिए, आप निम्न चला सकते हैं CLI से भविष्यवाणियों की कल्पना करने के लिए आदेशYOLOv8 नमूना:

yolo predict model=yolov8n.pt show=True

जब डॉकर जीयूआई के साथ समाप्त हो गया

xhost -local:docker

बधाइयाँ! अब आप उपयोग करने के लिए सेट हैं Ultralytics डॉकर के साथ और इसकी शक्तिशाली क्षमताओं का लाभ उठाने के लिए तैयार है। वैकल्पिक स्थापना विधियों के लिए, बेझिझक एक्सप्लोर करें Ultralytics क्विकस्टार्ट डॉक्यूमेंटेशन।

अक्सर पूछे जाने वाले प्रश्न

मैं कैसे सेट अप करूँ Ultralytics डॉकर के साथ?

सेट अप करने के लिए Ultralytics साथ Docker, पहले सुनिश्चित करें कि आपके सिस्टम पर डॉकर स्थापित है। यदि आपके पास एक NVIDIA GPU, स्थापित करें NVIDIA सक्षम करने के लिए डॉकर रनटाइम GPU जीविका। फिर, नवीनतम खींचें Ultralytics से Docker छवि Docker हब निम्न कमांड का उपयोग करके:

sudo docker pull ultralytics/ultralytics:latest

विस्तृत चरणों के लिए, हमारे डॉकर क्विकस्टार्ट गाइड को देखें।

उपयोग करने के क्या लाभ हैं Ultralytics मशीन लर्निंग प्रोजेक्ट्स के लिए डॉकर छवियां?

का उपयोग करके Ultralytics डॉकर छवियां विभिन्न मशीनों में एक सुसंगत वातावरण सुनिश्चित करती हैं, एक ही सॉफ़्टवेयर और निर्भरताओं की नकल करती हैं। यह टीमों में सहयोग करने, विभिन्न हार्डवेयर पर मॉडल चलाने और प्रजनन क्षमता बनाए रखने के लिए विशेष रूप से उपयोगी है। के लिए GPU-आधारित प्रशिक्षण, Ultralytics अनुकूलित डॉकर छवियां प्रदान करता है जैसे कि Dockerfile सामान्य के लिए GPU उपयोग और Dockerfile-jetson के लिए NVIDIA जेटसन डिवाइस। पता लगाना Ultralytics डॉकर हब अधिक जानकारी के लिए।

मैं कैसे दौड़ सकता हूँ Ultralytics YOLO एक डॉकर कंटेनर में GPU जीविका?

सबसे पहले, सुनिश्चित करें कि NVIDIA डॉकर रनटाइम स्थापित और कॉन्फ़िगर किया गया है। फिर, चलाने के लिए निम्न आदेश का उपयोग करें Ultralytics YOLO के साथ GPU जीविका:

sudo docker run -it --ipc=host --gpus all ultralytics/ultralytics:latest

यह कमांड एक डॉकर कंटेनर सेट करता है GPU प्रवेश। अतिरिक्त विवरण के लिए, डॉकर क्विकस्टार्ट गाइड देखें।

मैं कल्पना कैसे करूं YOLO एक प्रदर्शन सर्वर के साथ एक डॉकर कंटेनर में भविष्यवाणी परिणाम?

कल्पना करने के लिए YOLO भविष्यवाणी के परिणाम एक डॉकर कंटेनर में जीयूआई के साथ, आपको डॉकर को अपने प्रदर्शन सर्वर तक पहुंचने की अनुमति देने की आवश्यकता है। X11 चलाने वाले सिस्टम के लिए, कमांड है:

xhost +local:docker && docker run -e DISPLAY=$DISPLAY \
-v /tmp/.X11-unix:/tmp/.X11-unix \
-v ~/.Xauthority:/root/.Xauthority \
-it --ipc=host ultralytics/ultralytics:latest

वायलैंड चलाने वाले सिस्टम के लिए, उपयोग करें:

xhost +local:docker && docker run -e DISPLAY=$DISPLAY \
-v $XDG_RUNTIME_DIR/$WAYLAND_DISPLAY:/tmp/$WAYLAND_DISPLAY \
--net=host -it --ipc=host ultralytics/ultralytics:latest

अधिक जानकारी में पाया जा सकता है ग्राफ़िकल यूज़र इंटरफ़ेस (GUI) एप्लिकेशन चलाएँ में एक Docker कंटेनर अनुभाग।

क्या मैं स्थानीय निर्देशिकाओं को Ultralytics डॉकर कंटेनर?

हां, आप स्थानीय निर्देशिकाओं को Ultralytics डॉकर कंटेनर का उपयोग करके -v झंडा:

sudo docker run -it --ipc=host --gpus all -v /path/on/host:/path/in/container ultralytics/ultralytics:latest

बदलें /path/on/host अपने स्थानीय मशीन पर निर्देशिका के साथ और /path/in/container कंटेनर के अंदर वांछित पथ के साथ। यह सेटअप आपको कंटेनर के भीतर अपनी स्थानीय फ़ाइलों के साथ काम करने की अनुमति देता है। अधिक जानकारी के लिए, संबंधित अनुभाग देखें बढ़ते स्थानीय निर्देशिकाएं.

टिप्पणियाँ