דלג לתוכן הראשי

⚙️ הגדרות doQumentation

הגדר את שרת Jupyter המשמש להרצת קוד Python בהדרכות.

סביבה נוכחית: לא זוהה

Backend שרת

בחר איזה backend להשתמש להרצת קוד:

מצב הרצהⓘ

בחר מה קורה כשלוחצים על הרץ בדפי הדרכה. זה חל על הרצת קוד מוטמע באתר זה בלבד — פתיחת מחברת ב-JupyterLab משתמשת בזמן ריצה הסטנדרטי של Qiskit.

שינויים נכנסים לתוקף בסשן הגרעין הבא. אם הקוד רץ, לחץ על חזרה ואז על הרץ להחיל.

חשבון IBM Quantum

הוראות הגדרה והערות אבטחה
הערת אבטחה: פרטי הזדהות מאוחסנים ב-localStorage של הדפדפן שלך כטקסט רגיל. הם לא מוצפנים וניתן לקרוא אותם על ידי הרחבות דפדפן או כל מי שיש לו גישה למכשיר זה. השתמש בהגדרת התפוגה למטה להגבלת החשיפה, ומחק פרטי הזדהות כשתסיים. במחשבים משותפים או ציבוריים, עדיף להשתמש בשיטת save_account() הידנית המתוארת למטה.

הזן את פרטי הזדהות IBM Quantum פעם אחת כאן. הם יוזרקו אוטומטית דרך save_account() כשהגרעין מתחיל, כך שאין צורך להזין אותם בכל מחברת. זה חל על הרצת קוד מוטמע באתר זה בלבד — פתיחת מחברת ב-JupyterLab דורשת קריאה ל-save_account() ידנית.

  1. הרשם ב-quantum.cloud.ibm.com/registration — לא נדרש כרטיס אשראי ל-30 הימים הראשונים
  2. התחבר ב-מופעים
  3. מופע — צור מופע Open Plan חינמי ב-דף הבית אם אין לך עדיין
  4. API Token — לחץ על סמל הפרופיל שלך (למעלה מימין), ואז "API token". העתק את המפתח.

לשלבים מפורטים, ראה מדריך הגדר אימות של IBM (שלב 2).

חלופה: הרץ save_account() ידנית בתא מחברת

אם אתה מעדיף לא לשמור פרטי הזדהות בדפדפן זה, הדבק את זה בכל תא קוד והרץ אותו. פרטי הזדהות נשמרים באחסון הזמני של גרעין Binder ואובדים כשהסשן מסתיים.

from qiskit_ibm_runtime import QiskitRuntimeService
QiskitRuntimeService.save_account(
    token="YOUR_API_TOKEN",
    instance="YOUR_CRN",
    overwrite=True
)

העדפות תצוגה

גודל גופן קוד

14px
from qiskit import QuantumCircuit

פלטים מחושבים מראש

כל דף מחברת מציג פלטים מחושבים מראש (תמונות, טבלאות, טקסט) מהריצות המקוריות של IBM. כשלוחצים על Run להרצת קוד חי, מוצגים גם הפלטים המקוריים וגם התוצאות החיות שלך. הפעל את הכפתור להסתרת הפלטים המקוריים בזמן הרצה חיה.

אזהרות Python

כברירת מחדל, אזהרות Python (הודעות על פיצ'רים מיושנים, רמזי זמן ריצה) מודחקות לפלט מחברת נקי יותר. השבת כדי לראות את כל האזהרות — שימושי לאיתור באגים או ללמידה על שינויי API.

נהל את הנתונים שלך

כל הנתונים מאוחסנים מקומית בדפדפן שלך (localStorage). שום דבר לא נשלח לשרתים שלנו. ניקוי נתוני הדפדפן או שימוש בדפדפן/מכשיר אחר מתחיל מחדש.

התקדמות לימוד

התקדמות הקריאה וההרצה שלך נעקבת מקומית בדפדפן. דפים שביקרת בהם מציגים ✓ בסרגל הצד; מחברות שהרצת מציגות ▶.

עדיין לא נמדדה התקדמות. בקר בהדרכות ומדריכים כדי להתחיל למדוד.

סימניות

אין סימניות עדיין. השתמש בכפתור הסימנייה בכל דף כדי לשמור אותו כאן.

תצוגה וממשק

סשנים ופרטי הזדהות

אפס הכל

הסר את כל הנתונים השמורים כולל התקדמות, סימניות, העדפות תצוגה ופרטי הזדהות.

הגדרות מתקדמות

IBM Cloud Code Engine

IBM Cloud Code Engine מספק גרעין Jupyter מהיר וserverless בחשבון IBM Cloud שלך. ההפעלה לוקחת שניות במקום דקות. הדרגה החינמית מכסה ~14 שעות/חודש.

הוראות הגדרה
  1. צור חשבון IBM Cloud ב-cloud.ibm.com (דרגה חינמית זמינה)
  2. עבור ל-IBM Cloud Code Engine console וצור פרויקט חדש באזור המועדף עליך
  3. צור אפליקציה חדשה עם תמונה ghcr.io/janlahmann/doqumentation-codeengine:latest, פורט האזנה 8080
    גודל: 1 vCPU / 2 GB למשתמש יחיד, 8 vCPU / 16 GB ל-workshops (עד 80 משתמשים)
  4. הגדר משתני סביבה: JUPYTER_TOKEN לטוקן מאובטח (מינימום 32 תווים) ו-CORS_ORIGIN לדומיין שלך (למשל https://doqumentation.org)

לפרטי גודל workshop, ראה תיעוד הגדרת workshop.

חבילות Binder

בעת הרצה על GitHub Pages, הקוד מורץ דרך MyBinder. סביבת Binder כוללת חבילות Qiskit מותקנות מראש:

qiskit[visualization], qiskit-aer,
qiskit-ibm-runtime, pylatexenc,
qiskit-ibm-catalog, qiskit-addon-utils, pyscf

כמה מחברות דורשות חבילות נוספות. ניתן להתקינן לפי הצורך על ידי הרצת זה בתא קוד:

!pip install -q <package>

או התקן את כל החבילות האופציונליות בבת אחת:

!pip install -q scipy scikit-learn qiskit-ibm-transpiler \
  qiskit-experiments plotly sympy qiskit-serverless \
  qiskit-addon-sqd qiskit-addon-mpf \
  qiskit-addon-aqc-tensor[aer,quimb-jax] \
  qiskit-addon-obp qiskit-addon-cutting ffsim \
  gem-suite python-sat

עזרת הגדרה

הגדרת RasQberry

אם אתה מריץ על RasQberry Pi, שרת Jupyter אמור להתגלות אוטומטית. אם לא, ודא שהשירות jupyter-tutorials פועל:

sudo systemctl status jupyter-tutorials

הגדרת Jupyter מקומי

הפעל שרת Jupyter עם CORS מופעל:

jupyter server --ServerApp.token='rasqberry' \
  --ServerApp.allow_origin='*' \
  --ServerApp.disable_check_xsrf=True

הגדרת Docker

קונטיינר Docker מייצר טוקן Jupyter אקראי בהפעלה. הרצת קוד דרך האתר (פורט 8080) עובדת אוטומטית — אין צורך בטוקן. הטוקן נדרש רק לגישה ישירה ל-JupyterLab בפורט 8888.

לאחזור הטוקן מלוגים של הקונטיינר:

docker compose --profile jupyter logs | grep "Jupyter token"

להגדרת טוקן קבוע:

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

שרת מרוחק

לשרתים מרוחקים, ודא ש-CORS מוגדר לאפשר חיבורים מאתר זה. הוסף את הדברים הבאים ל-jupyter_server_config.py שלך:

c.ServerApp.allow_origin = '*'
c.ServerApp.allow_credentials = True