概要
・Windows11/WSL2でのQiskit環境構築手順は需要があるかもしれないで記載します。
・以前、pyenv,pipx,poetry環境構築手順を記載しましたが、uvの方が構築手順が少なく、圧倒的に速いので記載します。
環境
・手順では<Windows11, WSL2, openSuSE LEAP, uv>を組み合わせた環境を構築します。
本ドキュメントの範囲
★(1) windows11へのWSL2の導入
(2) uvの導入、Python仮想環境の作成
(3) vscode導入/Python仮想環境へのアクセス
(4) シミュレータでの量子回路実行(qiskit primitives)
(5) IBM Quantum量子コンピュータ実機での量子回路実行
WSL2の導入
★windowsのGUI操作を実施します。
※ubintuを導入する場合は、windows11のpowershell/コマンドプロンプトから
'wsl.exe --install"すればwsl2およびubuntu linuxまで自動で導入されるため、この手順は不要です。
本手順ではubuntuの導入を避けるため、windowsのコントロールパネルからWSL2を導入します。
[windows11から下記を実施]
スタートメニューにcont入力
-> コントロールパネル
-> プログラムと機能
「windowsの機能」画面で有効化選択
->下記にチェック入れてOK (OK実施後、)再起動要求があります。)
■ Hyper-V
■ Linux用 Windows サブシステム
■ Virtual Machine Platform
wsl2のアップデート
★Powershellまたはコマンドプロンプトから実行します。
Powershellまたはコマンドプロンプトを<管理者権限>で開きます。
下記コマンドを実行
wsl --version
wsl --update
wsl --version
openSuSE LEAPの導入
★Powershellまたはコマンドプロンプトから実行します。
WSL2でインストール可能なディストリビューションの一覧を出力
wsl --list --online
openSuSE LEAP 15.6を導入します。
wsl --install -d openSUSE-Leap-15.6
出力された指示に従って、Powershellコンソールから下記のコマンドを投入してlinuxに接続します。
wsl.exe -d openSUSE-Leap-15.6
linuxに接続すると、openSuSEの設定ユーティリティYaST2が起動しているので
パネルに従ってユーザ関連の設定をしてきます。
まず<Start>が選択されているので、エンターキーを押して次に進みます。
locale(使用する言語のセット)を設定します。
矢印キーの↑↓でlocaleを選んで、エンターキーを押します。
キーボード配列を設定します。
矢印キーの↑↓で選んで、エンターキーを押します。
使用許諾契約書を読んで、エンターキーを押します。
タイムゾーンを選択して、エンターキーを押します。
roptユーザのパスワードを指定して、エンターキーを押します。
記入欄が最初から選択されているのでそのままパスワード文字列を記入できます。
※テキストボックス内でキャレットが点滅しているので選択されていることがわかりますが、
選択されていない場合はtabキーを何度か押すことでテキストボックスを選択してください。
もう一度パスワードを入力して、エンターキーを押す。
ローカルユーザを作成します。
濃い青が選択されているテキストボックスです。
入力したら↑↓キーで他の欄も入力できます。
Username、Password、Password(again)の入力が済んだら、エンターキーを押します。
パスワード文字列があまりにも単純すぎるとcracklibでのチェックをパスできずにユーザー作成に失敗します。
その後、ユーザの作成画面に戻ります。
まあまあ単純なパスワードであれば警告の出力のみでユーザーが作成されます。
[YaST2の途中で失敗した場合]
ESCキーを押してquitできます。
再度、"wsl.exe -d openSUSE-Leap-15.6"コマンド実行でYsSTの最初から実行できます。
YaST2パネルが終了して、コンソールの画面に戻ります。
この段階ですでにコンソール上ではWSL2のlinuxにログオンしているので注意してください。
linuxのuname -aコマンドを実行すると"microsoft-standard-WSL2"版のlinuxであることがわかります。
exitでいったんコンソールを閉じます。
uname -a
exit
openSuSE導入後確認
★Powershellまたはコマンドプロンプトから実行します。
wsl -l -vコマンドでwsl2に導入されたディストリビューションの稼働状態を確認します。
wsl -l -v
サンプルではopenSUSE-Leap-15.6が稼働中であることがわかります。
先頭の* : デフォルトのディストリビューション
openSUSE-Leap-15.6 : 環境名。export/import操作により変更可能。
Runnung : 稼働中
VERSION 2 : wslバージョン2
# 導入をやり直したい場合にディストリビューションを削除するコマンド例
wsl -l -v
wsl --unregister openSUSE-Leap-15.6
wsl -l -v
openSuSEへのログイン
windowsのスタートメニューのプログラムに"openSUSE Leap 15.6"が追加されているので起動します。
※プログラムの実体はwindowsの"コンソール"プログラムですが、
起動後にWSL2内で稼働する"openSUSE-Leap-15.6"にログインしています。
「hostname,$PS1のカスタマイズやexport/import、ディストリビューション名変更」等のカスタマイズは別のエントリで記載予定。
PS1によるコマンドプロンプト変更
プロンプト、コマンド、出力が判別にしくいのでプロンプトを変更します。
ls -l ~/.bashrc
cp -p ~/.bashrc ~/.bashrc_orig ; echo $?
echo 'export PS1="\[\e[0;36m\]\[$(ppwd)\][\u@\h]:\w\n> \[\e[0m\]"' >> ~/.bashrc
source ~/.bashrc
openSuSEのアップデート
★linuxコンソールから下記コマンドを一通り実行
※openSuSEのレポジトリからの反応が遅い場合やパッケージの整合性がとれていないタイミングでは
無理せず別のタイミングで実施してください。
# sudoのパスワードを聞かれた場合は、YaST2で設定したパスワードを入力
sudo zypper refresh
# 更新があった場合は "y" を入力してエンター
sudo zypper dup
"sudo zypper dup"の結果、下記のメッセージが出力されていた場合は、openSuSE LEAPを再起動します。
"They should be restarted to benefit from the latest updates."
"実行中のプログラムが、直近のアップグレードにより削除もしくは更新されたファイルを使用しています。"
openSuSEの再起動
★前提作業としてopenSuSEのすべてのターミナルからexitしてください。vscode等起動していれば停止してください。
★openSuSEの再起動はwindowsのpowershellまたはコマンドプロンプトから実行します。
wsl -tオプションでディストリビューションを停止します。
実行後、STATE が "Stopped"になって停止したこと確認します。
wsl -l -v
wsl -t openSUSE-Leap-15.6
wsl -l -v
停止状態のディストリビューションを起動するには、windowsのスタートメニューのプログラムに"openSUSE Leap 15.6"を起動してログインすれば完了します。
openSuSEのパッケージ導入
基本的なパッケージを導入します。
何か聞かれたら、メッセージをちゃんと読んだうえでyを返答します。
> git -> githubへのpush/clone
> bash-completion -> uvコマンドの補完
> screenfetch -> 環境確認
> tar -> uvの導入で必要
> wsl_* -> wsl用基本パッケージ。
# パッケージ導入後、前出の手順でopenSuSEの再起動を実施してください
sudo zypper install -t pattern wsl_base
sudo zypper install -t pattern wsl_gui
sudo zypper install -t pattern wsl_systemd
sudo zypper install git bash-completion screenfetch tar
パッケージ導入後
Qiskit環境構築
【uv版】
(1) Linuxの導入/設定
(2) uvの導入/Python仮想環境の作成
(3) vscodeからのPython仮想環境接続
【poetry版】
(1) Linuxの導入/設定
(2) Python仮想環境の作成
(3) vscodeからのPython仮想環境接続
【uv/poetry共通】
(4) シミュレータでの量子回路実行
(5) IBMQ実機での量子回路実行
(6) メンテナンス