⚙️ Nastavení doQumentation

Nakonfiguruj server Jupyter používaný ke spouštění kódu Python v tutoriálech.

Aktuální prostředí: Nezjištěno

Backend pro spouštění

Je dostupných více backendů pro spouštění. Zvol který z nich se má použít ke spouštění kódu:

Automatická detekce (doporučeno)Binder — mybinder.orgIBM Cloud Code Engine — nenakonfigurováno — nastav nížeVlastní server — nenakonfigurováno — zadej URL níže

Režim spouštění

Zvol, co se stane, když klikneš Spustit na stránkách s tutoriály. To se vztahuje pouze na vložené spouštění kódu na tomto webu — otevření notebooku v JupyterLab používá standardní Qiskit runtime.

Bez automatického vkládání — Spravuj přihlašovací údaje a backend sám v buňkách kódu.AerSimulator — Ideální simulace, bez šumu. Rychlá, funguje pro všechny obvody.FakeBackend — Simuluje šum skutečného zařízení IBM. Realističtější, ale pomalejší.IBM Quantum (skutečný hardware) — Připoj se ke skutečnému kvantovému hardwaru přes přihlašovací údaje IBM Quantum.

Změny se projeví při příští relaci kernelu. Pokud kód běží, klikni Zpět a poté Spustit pro aplikování.

Účet IBM Quantum

Instrukce k nastavení a bezpečnostní poznámky

Bezpečnostní poznámka: Přihlašovací údaje jsou uloženy jako prostý text v localStorage tohoto prohlížeče, a to jen pro tuto jazykovou verzi webu (na jiné jazykové verzi je zadej znovu). Nikdy se nevkládají do cookie, takže se neodesílají webovému hostiteli. Nejsou šifrované a mohou je přečíst rozšíření prohlížeče nebo kdokoli s přístupem k tomuto zařízení. Omez riziko nastavením vypršení níže a po skončení přihlašovací údaje smaž. Na sdílených nebo veřejných počítačích raději použij níže popsanou ruční metodu save_account().

Zadej své přihlašovací údaje IBM Quantum jednou zde. Budou automaticky injektovány přes save_account() při spuštění kernelu, takže je nemusíš zadávat v každém notebooku. To se vztahuje pouze na vložené spouštění kódu na tomto webu — otevření notebooku v JupyterLab vyžaduje ruční volání save_account().

Zaregistrovat se na quantum.cloud.ibm.com/registration — kreditní karta není vyžadována prvních 30 dní
Přihlásit se na Instance
Instance — Vytvoř bezplatnou instanci Open Plan na domovská stránka, pokud ještě žádnou nemáš
API Token — Klikni na ikonu profilu (vpravo nahoře), poté „API token”. Zkopíruj klíč.

Pro podrobné kroky viz průvodce IBM Nastavit ověřování (krok 2).

API token

Cloud Resource Name (CRN) / instance

Typ plánu

Alternativa: Spustit save_account() ručně v buňce notebooku

Pokud nechceš ukládat přihlašovací údaje v tomto prohlížeči, vlož toto do libovolné buňky kódu a spusť ji. Přihlašovací údaje jsou uloženy v dočasném úložišti kernelu Binderu a ztratí se po skončení relace.

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

Předvolby zobrazení

Velikost písma kódu

14px

from qiskit import QuantumCircuit

Předpočítané výstupy

Každá stránka s notebookem zobrazuje předpočítané výstupy (obrázky, tabulky, text) z původních běhů IBM. Když klikneš na Run a spustíš kód naživo, zobrazí se původní výstupy i tvé nové živé výsledky. Vypnutím tohoto přepínače skryješ původní výstupy během živého spouštění a zůstanou viditelné jen tvé výsledky.

Zobrazovat předpočítané i živé výstupy

Varování Pythonu

Ve výchozím nastavení jsou varování Pythonu (oznámení o zastarání, rady pro běh) potlačena pro čistší výstup notebooku. Deaktivuj toto pro zobrazení všech varování — užitečné pro ladění nebo učení o změnách API.

Varování potlačena pro čistší výstup

Správa tvých dat

Všechna data zůstávají ve tvém prohlížeči. Na doqumentation.org se tvůj pokrok, záložky a nastavení ukládají do localStorage a do malých cookies, které je sdílejí mezi jazykovými verzemi webu; tyto cookies se s každým požadavkem na stránku odesílají statickému webovému hostiteli, nikdy na server doQumentation. Tvé přihlašovací údaje k IBM Quantum se nikdy nevkládají do cookie: zůstávají v localStorage na jazykové verzi webu, kde jsi je zadal. Po vymazání dat prohlížeče nebo při použití jiného prohlížeče či zařízení začínáš znovu.

Pokrok v učení

Navštívené stránky zobrazují ✓ v postranním panelu. Stránky s notebooky zobrazují </>: šedě do navštívení, modře po navštívení, zeleně poté, co na nich spustíš kód.

Zatím žádný sledovaný pokrok. Navštiv tutoriály a průvodce pro zahájení sledování.

Záložky

Zatím žádné záložky. Použij tlačítko záložky na libovolné stránce pro její uložení.

Zobrazení a UI

Relace a přihlašovací údaje

Resetovat vše

Odstraní všechna uložená data včetně pokroku, záložek, předvoleb zobrazení a přihlašovacích údajů.

Pokročilá nastavení

IBM Cloud Code Engine

Code Engine poskytuje rychlý, bezserverový kernel Jupyter napájený tvým vlastním účtem IBM Cloud. Spuštění trvá sekundy místo minut. Bezplatná úroveň pokryje ~14 hodin/měsíc.

Pokyny k nastavení

Vytvoř účet IBM Cloud na cloud.ibm.com (dostupná bezplatná úroveň)
Vytvoř projekt Code Engine ve svém preferovaném regionu
Nasaď novou aplikaci s obrazem ghcr.io/janlahmann/doqumentation-codeengine:latest, port 8080
Dimenzování: 1 vCPU / 2 GB pro jednotlivce, 8 vCPU / 16 GB pro workshopy (až 80 uživatelů)
Nastav proměnnou prostředí JUPYTER_TOKEN na bezpečný token (min. 32 znaků) a CORS_ORIGIN na svou doménu

Podrobnosti o dimenzování pro workshopy najdeš v dokumentaci k nastavení workshopu.

Balíčky Binderu

Při spouštění na GitHub Pages se kód spouští přes MyBinder. Prostředí Binderu obsahuje předinstalované základní balíčky Qiskitu:

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

Některé notebooky vyžadují další balíčky. Můžeš je nainstalovat na vyžádání spuštěním tohoto v buňce kódu:

!pip install -q <package>

Nebo nainstaluj všechny volitelné balíčky najednou:

!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

Nápověda k nastavení

Nastavení RasQberry

RasQberry spouští kontejner doQumentation (viz Nastavení Dockeru níže). Otevři web z adresy Pi na portu 8080 a kód se spouští na Pi bez dalšího nastavení.

Offline průvodce workshopem: veď výuku z jednoho Raspberry Pi

Místní nastavení Jupyter

Spusť server Jupyter, který přijímá pouze tento web, s tokenem podle vlastní volby, a poté zadej jeho URL a token výše v části Vlastní server:

jupyter server --ServerApp.token='choose-a-long-token' \
  --ServerApp.allow_origin='https://doqumentation.org' \
  --ServerApp.disable_check_xsrf=True

Nastavení Docker

Kontejner Docker generuje náhodný token Jupyter při spuštění. Spouštění kódu přes webovou stránku (port 8080) funguje automaticky — token není potřeba. Token je vyžadován pouze pro přímý přístup k JupyterLab na portu 8888.

Pro získání tokenu z protokolů kontejneru:

podman logs doq | grep "Jupyter token"

Pro nastavení pevného tokenu:

podman run -d --name doq --restart unless-stopped \
  -e JUPYTER_TOKEN=choose-a-token \
  -p 8080:80 -p 127.0.0.1:8888:8888 \
  ghcr.io/janlahmann/doqumentation:jupyter

Vzdálený server

Pro vzdálené servery se ujisti, že je CORS nakonfigurován tak, aby umožňoval připojení z tohoto webu. Přidej následující do souboru jupyter_server_config.py:

c.ServerApp.allow_origin = 'https://doqumentation.org'
c.ServerApp.allow_credentials = True