初めに
pythonの実行環境としてAnacondaを使用していたが、容量の関係などからMinicondaへと環境を移行した。
その際の移行手順をまとめた。
| 環境 | 詳細 |
|---|---|
| OS | windows11 |
本作業でよく使用したコマンドは以下にまとめた。
移行手順
1. 移行環境のexport
まず、移行する環境の情報をexportする。
テキスト出力もあるが、インポート時の手順からymlを推奨する。
※大括弧内は任意名称。初期のbaseでも可。
conda env export -n [任意環境名:base] --no-builds > [任意ファイル名:env.yml]
カレントディレクトリに任意のファイル名のymlファイルが作成される。
内容は以下のような情報が含まれている。
name: [任意環境名:base]
channels:
- conda-forge
- defaults
- xxx
dependencies:
- python=3.xx.xx
- xxxx=1.1.1
2. Minicondaのインストール
Minicondaのインストールは、以下のサイトから適当な環境のものを選択する。
https://docs.conda.io/en/latest/miniconda.html
※更新や偽の可能性もあるので自身で調べてください。
なお、minicondaとanacondaは共存可能なようなので、インストール前のanacondaアンインストールは必須ではない。
参考サイト:【後で困らないための】Miniconda windows版の環境構築
インストーラのダウンロード後、以下の手順で実行し、minicondaを導入する。
- インストーラーを実行
- セットアップ情報：「Next」をクリック
- ライセンス情報：「I Agree」をクリック
- インストール先：「All Users」 を選択し、「Next」をクリック ※任意選択
- インストール先：「Next」をクリック
- 環境変数設定：追加にチェックを入れ、「Install」をクリック ※任意選択
- インストール完了後：「Next」をクリック
- インストール完了後：「Finish」をクリック
インストール後、WindowsスタートメニューのAnaconda3(64-bit)に「Anaconda Prompt (Miniconda)」が追加されていれば完了。
3. 仮想環境の移行
前述のenv.ymlファイルを用いて環境の移行を行う。
Anaconda Prompt (Miniconda)を管理者権限で立ち上げる。
conda env create -n [新たな環境名] -f [env.yml]
新たな環境で既存のプログラムが動作することを確認したら、次のステップに移行する。
新規環境で構築しているので、SSL設定等が必要な場合はお忘れなく。
conda config --set ssl_verify no
4. Anacondaのアンインストール
Anaconda Promptで削除用のパッケージをインストールする。
conda install -c anaconda anaconda-clean
インストール後、コマンド実行し、削除していく。
削除に関しては実行要否が質問されるので、yを入力していく。
もしくは、コマンド実行時にすべてyesを指定する。
anaconda-clean
もしくは
anaconda-clean --yes
Delete .conda? (y/n): y
Delete .ipython? (y/n): y
Delete .jupyter? (y/n): y
...
Windowsの設定→アプリ→アプリと機能から、Anacondaを指定し、プログラムのアンインストールを実行する。
実行完了後、anaconda関連のディレクトリが削除されていれば完了。
その他
Jupyter Notebookの導入
Anaconda使用時にJupyter Notebookを使用していた人はMinicondaにはデフォルトでは入っていないので、導入する必要がある。
個人的には、開発環境はjupyterで使用しているipynbの対話型実行も拡張機能で対応しているVSCodeに集約している。
インストールは以下で実行。
pip install jupyter notebook
conda install notebook ipykernel
実行時はコマンドから実行して立ち上げる。
jupyter notebook
ライセンス
Anacondaのライセンスは、大規模商用利用の際には有償となる。
エラー対処
作業中に発生したエラーと原因、対処した方法を記す。
PackagesNotFoundError：1
詳細：The following packages are not available from current channels
新たな仮想環境を作成する際に発生。
環境構築時のコマンドミスが原因でエラーになった模様。
ymlファイルからの環境構築は以下のようにコマンドを使用する。
NG
conda create -n [仮想環境名] -f environment.yml
OK
conda env create -n [仮想環境名] -f environment.yml
ResolvePackageNotFound：2
さらに、環境構築時に発生。
ビルドの指定でパッケージインストールがうまくいかないことが原因でエラーになった模様。
環境export時に除外設定することでymlから記述を削除することで対応。
NG
conda env export -n [環境名] > env.yml
OK
conda env export -n [環境名] --no-builds > env.yml
ResolvePackageNotFound：3
さらに、環境構築時に発生。
今回、移行前と後でチャンネルを変更したため、昔もしくは最新のバージョンがチャンネル内になく、エラーとなった模様。
バージョン情報の指定をymlから除外することで対応。
ResolvePackageNotFound：4
さらに、環境構築時に発生。
チャンネル内に該当のパッケージが存在し無いことが原因でエラーになった模様。
今回、前提条件としてチャンネル制約を優先しているため、該当パッケージをymlから削除することで対応。
CondaValueError: Value error: prefix already exists
新たな仮想環境を作成する際に発生。
作成したい環境名と同じ名前の環境がすでに存在することが原因でエラーになった模様。
※おそらくデフォルトのbaseも該当。環境名を指定しない場合はbaseになっているケースもある。
環境をコマンド削除する。また、C:/ProgramData/Miniconda3/env/[仮想環境名]ディレクトリが存在していれば削除することで対応。
Found conflicts! Looking for incompatible packages.
パッケージ間の競合などが発生した場合にメッセージが出る。
エラーではなく、解決のために処理がされるが、長すぎるもしくは終わらないケースがある模様。
数件の記事では、バージョンのアップデートで解決した報告があった。
conda update —all
今回は、ymlの全パッケージのバージョン指定を削除することで対応。
コマンドプロンプトが起動しない
Anacondaのアンインストール後にコマンドプロンプトが起動しない不具合が発生する。
発生する場合と発生しない場合があり、原因は理解できていない。
解決法は以下の記事を引用する。
Reg Delete "HKCU\Software\Microsoft\Command Processor" /v AutoRun /f
最後に
仮想環境の移行は初で、エラーも多く、難儀したが、本記事にリンクした参考サイト様のおかげで解決した。多謝。