このタスクを使用して、Conda 環境を作成してアクティブ化します。
このタスクを使用して、Conda 環境を作成してアクティブ化します。
構文
# Conda environment v1
# This task is deprecated. Use `conda` directly in script to work with Anaconda environments.
- task: CondaEnvironment@1
inputs:
#createCustomEnvironment: false # boolean. Create a custom environment. Default: false.
#environmentName: # string. Required when createCustomEnvironment == true. Environment name.
#packageSpecs: 'python=3' # string. Package specs. Default: python=3.
#updateConda: true # boolean. Update to the latest Conda. Default: true.
#installOptions: # string. Optional. Use when createCustomEnvironment == false. Other options for `conda install`.
#createOptions: # string. Optional. Use when createCustomEnvironment == true. Other options for `conda create`.
#cleanEnvironment: false # boolean. Optional. Use when createCustomEnvironment == true. Clean the environment. Default: false.
入力
createCustomEnvironment
-
カスタム環境 を作成する
boolean。 既定値: false.
このブール値の値が trueに設定されている場合、base を作成するか、Conda 環境を再アクティブ化します。 セルフホステッド エージェントでは、値を true に設定することをお勧めします。
environmentName
-
環境名の
string。
createCustomEnvironment == trueする場合に必要です。
作成してアクティブ化する Conda 環境の名前。既に存在する場合は再アクティブ化します。
packageSpecs
-
パッケージ の仕様
string。 既定値: python=3.
環境にインストールするパッケージのスペース区切りの一覧。
最新の Condaに更新する updateConda -
boolean。 既定値: true.
Conda を最新バージョンに更新します。 これは、PATH で見つかった Conda のインストール、または CONDA 環境変数で指定されたパスに適用されます。
installOptions
-
conda install
のその他のオプション
string。 任意
createCustomEnvironment == falseするときに使用します。
conda install コマンドに渡す追加の引数のスペース区切りのリスト。
createOptions
-
conda create
のその他のオプション
string。 任意
createCustomEnvironment == trueするときに使用します。
conda create コマンドに渡す追加オプションのスペース区切りのリスト。
cleanEnvironment
-
環境 をクリーンアップする
boolean。 任意
createCustomEnvironment == trueするときに使用します。 既定値: false.
環境を削除し、既に存在する場合は再作成します。 このブール値が選択されていない場合、タスクは既存の環境を再アクティブ化します。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクを使用して、Conda 環境を作成してアクティブ化します。
このタスクでは、Conda 環境が作成され、後続のビルド タスク用にアクティブ化されます。
タスクが同じ名前の既存の環境を見つけた場合、タスクは単に再アクティブ化します。 これは、セルフホステッド エージェントで可能です。 環境を再作成し、そのパッケージを再インストールするには、[環境をクリーン] オプションを設定します。
"最新の Conda に更新" オプションを指定して実行すると、環境を作成またはアクティブ化する前に Conda の更新が試みられます。 セルフホステッド エージェントを実行していて、タスク で動作するように Conda インストールを構成場合は、Conda のインストールが更新される可能性があります。
注
Microsoft がホストするエージェントでは、既定では、PATH に Conda は含まれません。 Conda を使用するには、このタスクを実行する必要があります。
このタスクを実行すると、PATH には、アクティブ化された環境のバイナリ ディレクトリと、Conda インストール自体のバイナリ ディレクトリが含まれます。
スクリプトは、インストールする他のパッケージから Python、Conda、またはコマンドライン ユーティリティを実行する後続のビルド タスクとして実行できます。
たとえば、pytest を使用してテストを実行したり、Anaconda クライアントを使用して Anaconda Cloud にパッケージをアップロードしたりできます。
ヒント
このタスクを実行すると、環境が "アクティブ化" され、conda install を呼び出してインストールしたパッケージがこの環境にインストールされます。
前提条件
- Microsoft がホストするエージェント、または Anaconda または Miniconda がインストールされているセルフホステッド エージェント。
- セルフホステッド エージェントを使用する場合は、
conda実行可能ファイルをPATHに追加するか、CONDA環境変数を Conda インストールのルートに設定する必要があります。
このタスクを使用するようにセルフホステッド エージェントを構成するにはどうすればよいですか?
このタスクは、完全な Anaconda インストールまたは Miniconda インストールで使用できます。
セルフホステッド エージェントを使用する場合は、conda 実行可能ファイルを PATHに追加する必要があります。
または、CONDA 環境変数を Conda インストールのルート (つまり、Conda のインストール時に "プレフィックス" として指定したディレクトリ) に設定することもできます。