jupyterhub
1.0.0
نظرة فنية | التثبيت | التكوين | عامل الميناء | المساهمة | الترخيص | المساعدة والموارد
باستخدام JupyterHub، يمكنك إنشاء مركز متعدد المستخدمين يقوم بإنشاء مثيلات متعددة لخادم دفتر Jupyter للمستخدم الواحد وإدارتها وتوكيلها.
قام مشروع Jupyter بإنشاء JupyterHub لدعم العديد من المستخدمين. يمكن أن يقدم Hub خوادم أجهزة الكمبيوتر المحمولة لفئة من الطلاب، أو مجموعة عمل علوم بيانات الشركة، أو مشروع بحث علمي، أو مجموعة حوسبة عالية الأداء.
ثلاثة ممثلين رئيسيين يشكلون JupyterHub:
المبادئ الأساسية للتشغيل هي:
يوفر JupyterHub أيضًا واجهة REST API لإدارة Hub ومستخدميه.
نظام قائم على Linux/Unix
بايثون 3.8 أو أكبر
Nodejs/npm
إذا كنت تستخدم conda ، فسيتم تثبيت تبعيات Nodejs و npm لك بواسطة conda.
إذا كنت تستخدم pip ، فقم بتثبيت إصدار حديث (12.0 على الأقل) منnodejs/npm.
في حالة استخدام أداة مصادقة PAM الافتراضية، وحدة مصادقة قابلة للتوصيل (PAM).
شهادة TLS ومفتاح للاتصال HTTPS
اسم المجال
condaلتثبيت JupyterHub مع تبعياته بما في ذلك العقدة/npm:
conda install -c conda-forge jupyterhubإذا كنت تخطط لتشغيل خوادم الكمبيوتر الدفتري محليًا، فقم بتثبيت JupyterLab أو Jupyter Notebook:
conda install jupyterlab
conda install notebookpip يمكن تثبيت JupyterHub باستخدام pip والوكيل باستخدام npm :
npm install -g configurable-http-proxy
python3 -m pip install jupyterhubإذا كنت تخطط لتشغيل خوادم الكمبيوتر الدفتري محليًا، فستحتاج إلى تثبيت JupyterLab أو Jupyter Notebook:
python3 -m pip install --upgrade jupyterlab
python3 -m pip install --upgrade notebook
لبدء خادم Hub، قم بتشغيل الأمر:
jupyterhub
تفضل بزيارة http://localhost:8000 في متصفحك، وقم بتسجيل الدخول باستخدام اسم المستخدم وكلمة المرور الخاصين بالنظام.
ملاحظة : للسماح لعدة مستخدمين بتسجيل الدخول إلى الخادم، ستحتاج إلى تشغيل الأمر jupyterhub كمستخدم ذي امتيازات ، مثل الجذر. يصف الويكي كيفية تشغيل الخادم كمستخدم أقل امتيازات ، الأمر الذي يتطلب مزيدًا من تكوين النظام.
يشرح قسم "الشروع في العمل" في الوثائق الخطوات الشائعة في إعداد JupyterHub.
يوفر البرنامج التعليمي JupyterHub مقطع فيديو متعمقًا وعينة من تكوينات JupyterHub.
لإنشاء ملف تكوين افتراضي يتضمن الإعدادات والأوصاف:
jupyterhub --generate-config
لبدء تشغيل Hub على عنوان URL ومنفذ محددين 10.0.1.2:443 باستخدام https :
jupyterhub --ip 10.0.1.2 --port 443 --ssl-key my_ssl.key --ssl-cert my_ssl.cert
| الموثق | وصف |
|---|---|
| PAMAuthenticator | الافتراضي، المدمج في المصادقة |
| OAuthenticator | OAuth + JupyterHub Authenticator = OAuthenticator |
| ldapauthenticator | البرنامج المساعد LDAP Authenticator البسيط لـ JupyterHub |
| kerberosaauthenticator | البرنامج المساعد Kerberos Authenticator لـ JupyterHub |
| مولد | وصف |
|---|---|
| LocalProcessSpawner | يقوم المولد الافتراضي المدمج بتشغيل خوادم المستخدم الفردي كعمليات محلية |
| معرف com لهذا التطبيق هو com.dockerspawner | إنشاء خوادم للمستخدم الفردي في حاويات Docker |
| kubespawner | مولد Kubernetes لـ JupyterHub |
| com.sudospawner | إنشاء خوادم مستخدم واحد دون أن تكون جذرًا |
| com.systemdspawner | إنشاء خوادم دفتر ملاحظات لمستخدم واحد باستخدام systemd |
| معرف الدفعة | مصممة للمجموعات باستخدام برنامج جدولة الدفعات |
| com.yarnspawner | إنشاء خوادم دفتر ملاحظات لمستخدم واحد موزعة على مجموعة Hadoop |
| التفاف | يتيح WrapSpawner وProfilesSpawner تكوين وقت التشغيل للمولدين |
توفر صورة عامل الإرساء المبدئية لـ JupyterHub نشرًا أساسيًا لـ JupyterHub باستخدام Docker.
هام: تحتوي صورة quay.io/jupyterhub/jupyterhub هذه على Hub نفسه فقط، بدون أي تكوين. بشكل عام، يحتاج المرء إلى إنشاء صورة مشتقة، مع إعداد jupyterhub_config.py على الأقل Authenticator و/أو Spawner. لتشغيل خوادم المستخدم الفردي، والتي قد تكون على نفس النظام مثل Hub أم لا، يجب تثبيت الإصدار 4 من Jupyter Notebook أو أحدث.
يمكن بدء صورة JupyterHub docker باستخدام الأمر التالي:
docker run -p 8000:8000 -d --name jupyterhub quay.io/jupyterhub/jupyterhub jupyterhub
سيقوم هذا الأمر بإنشاء حاوية باسم jupyterhub والتي يمكنك إيقافها واستئنافها باستخدام docker stop/start .
سيتم الاستماع إلى خدمة Hub على جميع الواجهات في المنفذ 8000، مما يجعل هذا خيارًا جيدًا لاختبار JupyterHub على سطح المكتب أو الكمبيوتر المحمول .
إذا كنت تريد تشغيل عامل الإرساء على جهاز كمبيوتر يحتوي على عنوان IP عام، فيجب عليك (كما هو الحال في MUST) تأمينه باستخدام ssl عن طريق إضافة خيارات ssl إلى تكوين عامل الإرساء الخاص بك أو باستخدام وكيل مُمكّن بواسطة ssl.
ستسمح لك وحدات التخزين المتصاعدة بتخزين البيانات خارج صورة عامل الإرساء (النظام المضيف) بحيث تكون ثابتة ، حتى عند بدء صورة جديدة.
سوف يقوم الأمر docker exec -it jupyterhub bash بإنشاء غلاف جذر في حاوية عامل الإرساء الخاصة بك. يمكنك استخدام shell الجذر لإنشاء مستخدمي النظام في الحاوية . سيتم استخدام هذه الحسابات للمصادقة في التكوين الافتراضي لـ JupyterHub.
إذا كنت ترغب في المساهمة في المشروع، يرجى قراءة وثائق المساهمين و CONTRIBUTING.md . يشرح ملف CONTRIBUTING.md كيفية إعداد تثبيت التطوير، وكيفية تشغيل مجموعة الاختبار، وكيفية المساهمة في التوثيق.
للحصول على عرض عالي المستوى للرؤية والاتجاهات التالية للمشروع، راجع خريطة طريق مجتمع JupyterHub.
يتم دعم JupyterHub على الأنظمة المستندة إلى Linux/Unix.
JupyterHub رسميًا لا يدعم Windows. قد تتمكن من استخدام JupyterHub على نظام التشغيل Windows إذا كنت تستخدم Spawner وAuthenticator اللذين يعملان على نظام التشغيل Windows، لكن إعدادات JupyterHub الافتراضية لن تعمل. لن يتم قبول الأخطاء التي تم الإبلاغ عنها على Windows، ولن يتم تشغيل مجموعة الاختبار على Windows. ومع ذلك، قد يتم قبول التصحيحات الصغيرة التي تعمل على إصلاح مشكلات توافق Windows البسيطة (مثل التثبيت الأساسي). بالنسبة للأنظمة المستندة إلى Windows، نوصي بتشغيل JupyterHub في حاوية عامل إرساء أو Linux VM.
مرجع إضافي: وثائق Tornado حول دعم نظام التشغيل Windows
نحن نستخدم نموذج حقوق الطبع والنشر المشترك الذي يمكّن جميع المساهمين من الحفاظ على حقوق الطبع والنشر لمساهماتهم.
جميع الأكواد مرخصة بموجب شروط ترخيص BSD المعدل.
نحن نشجعك على طرح الأسئلة ومشاركة الأفكار في منتدى مجتمع Jupyter. يمكنك أيضًا التحدث معنا على قناة JupyterHub Gitter الخاصة بنا.
يتبع JupyterHub أدلة مجتمع Jupyter.
نظرة فنية | التثبيت | التكوين | عامل الميناء | المساهمة | الترخيص | المساعدة والموارد
