ادفع صورتك الأولى إلى سجل حاوية Azure باستخدام Docker CLI
يقوم سجل حاوية Azure بتخزين وإدارة صور الحاويات الخاصة والتحف الأخرى، على غرار الطريقة التي يخزن بها Docker Hub صور حاوية Docker العامة. يمكنك استخدام واجهة سطر أوامر Docker (Docker CLI) لعمليات تسجيل الدخول والدفع والسحب وعمليات صورة الحاوية الأخرى في سجل الحاوية الخاص بك.
في الخطوات التالية، يمكنك تنزيل صورة Nginxعامة، ووضع علامة عليها لسجل حاوية Azure الخاص، ودفعها إلى السجل، ثم سحبها من السجل.
المتطلبات الأساسية
- سجل حاوية Azure - أنشئ سجل حاوية في اشتراك Azure الخاص بك. على سبيل المثال، استخدم مدخل Azureأو Azure CLIأو Azure PowerShell.
- Docker CLI - يجب أيضاً تثبيت Docker محلياً. يوفر Docker حزماً تعمل على تكوين Docker بسهولة على أي نظام macOSأو Windowsأو Linux .
تسجيل الدخول إلى التسجيل
هناك عدة طرق للمصادقة على سجل الحاوية الخاص.
الطريقة الموصى بها عند العمل في سطر الأوامر هي باستخدام الأمر Azure CLI التالي az acr login. على سبيل المثال، للوصول إلى سجل باسم myregistry، سجل الدخول إلى Azure CLI ثم قم بالمصادقة على السجل الخاص بك:
az login
az acr login --name myregistry
يمكنك أيضاً تسجيل الدخول باستخدام تسجيل دخول عامل الإرساء. على سبيل المثال، ربما تكون قد قمت بتعيين مدير خدمة إلى السجل الخاص بك لسيناريو الأتمتة. عند تشغيل الأمر التالي، قم بتوفير معرف التطبيق الرئيسي للخدمة (اسم المستخدم) وكلمة المرور بشكل تفاعلي عند مطالبتك بذلك. للحصول على أفضل الممارسات لإدارة بيانات اعتماد تسجيل الدخول، راجع مرجع الأمر تسجيل دخول عامل الإرساء :
docker login myregistry.azurecr.io
يعود كلا الأمرين Login Succeeded بمخزون اكتمالهما.
ملاحظة
- قد ترغب في استخدام Visual Studio Code مع ملحق Docker لتسجيل الدخول بشكل أسرع وأكثر ملاءمة.
تلميح
حدد دائماً اسم السجل المؤهل بالكامل (كلها أحرف صغيرة) عند استخدام docker login وعند وضع علامة على الصور لإرسالها إلى السجل الخاص بك. في الأمثلة الواردة في هذه المقالة، الاسم المؤهل بالكامل هو myregistry.azurecr.io.
اسحب صورة Nginx عامة
أولاً، اسحب صورة Nginx عامة إلى جهاز الكمبيوتر المحلي الخاص بك. يسحب هذا المثال صورة Nginx الرسمية.
docker pull nginx
تشغيل الحاوية على الصعيد المحلي
قم بتنفيذ الأمر التالي docker run لبدء مثيل محلي لحاوية Nginx بشكل تفاعلي (-it) على المنفذ 8080. تحدد الوسيطة --rm أنه يجب إزالة الحاوية عند إيقافها.
docker run -it --rm -p 8080:80 nginx
تصفح إلى http://localhost:8080 لعرض صفحة الويب الافتراضية التي يقدمها Nginx في الحاوية قيد التشغيل. يجب أن تشاهد صفحة مشابهة لما يلي:
نظراً لأنك بدأت الحاوية بشكل تفاعلي مع -it، يمكنك مشاهدة إخراج خادم Nginx في سطر الأوامر بعد الانتقال إليه في متصفحك.
لإيقاف الحاوية وإزالتها، اضغط على Control+C.
قم بإنشاء اسم مستعار للصورة
استخدم علامة عامل الإرساء لإنشاء اسم مستعار للصورة بالمسار المؤهل بالكامل إلى السجل الخاص بك. يحدد هذا المثال مساحة الاسم samples لتجنب الفوضى في جذر التسجيل.
docker tag nginx myregistry.azurecr.io/samples/nginx
لمزيد من المعلومات حول وضع العلامات باستخدام مساحات الأسماء، راجع قسم مساحات أسماء المستودعات في أفضل الممارسات لسجل حاوية Azure.
دفع الصورة إلى السجل الخاص بك
الآن بعد أن قمت بتمييز الصورة بالمسار المؤهل بالكامل إلى السجل الخاص، يمكنك دفعها إلى السجل باستخدام docker push:
docker push myregistry.azurecr.io/samples/nginx
اسحب الصورة من السجل الخاص بك
استخدم الأمر docker pull لسحب الصورة من السجل الخاص بك:
docker pull myregistry.azurecr.io/samples/nginx
ابدأ حاوية Nginx
استخدم الأمر docker run لتشغيل الصورة التي سحبتها من السجل:
docker run -it --rm -p 8080:80 myregistry.azurecr.io/samples/nginx
تصفح إلى http://localhost:8080 لعرض الحاوية قيد التشغيل.
لإيقاف الحاوية وإزالتها، اضغط على Control+C.
أزل الصورة (اختياري)
إذا لم تعد بحاجة إلى صورة Nginx، فيمكنك حذفها محلياً باستخدام الأمر docker rmi.
docker rmi myregistry.azurecr.io/samples/nginx
لإزالة الصور من سجل حاوية Azure، يمكنك استخدام أمر Azure CLI حذف مستودع az acr. على سبيل المثال، يحذف الأمر التالي البيان المشار إليه بواسطة العلامة samples/nginx:latest وأي بيانات طبقة فريدة وجميع العلامات الأخرى التي تشير إلى البيان.
az acr repository delete --name myregistry --image samples/nginx:latest
التوصيات
هنا يمكنك العثور على مزيد من المعلومات حول خيارات المصادقة.
الخطوات التالية
الآن بعد أن تعرفت على الأساسيات، أصبحت جاهزاً لبدء استخدام السجل الخاص بك! على سبيل المثال، انشر صور الحاوية من السجل الخاص بك إلى:
اختيارياً، قم بتثبيت Docker Extension for Visual Studio Code وAzure Account للعمل مع سجلات حاوية Microsoft Azure. اسحب الصور وقم برفعها إلى سجل حاوية Azure، أو قم بتشغيل مهام ACR، كل ذلك ضمن Visual Studio Code.