自訂環境範本

您可以變更所建立環境範本的名稱、說明及硬體配置。 您可以透過 conda 通道或使用 pip 來自訂 Jupyter Notebook 環境範本的軟體配置。 您可以提供 conda 套件清單、pip 套件清單或兩者的組合。 使用 conda 套件時，您可以提供可透過其取得套件的其他 conda 通道位置清單。

必要的許可權

您必須在專案中具有 管理者 或 編輯者 角色，才能自訂環境範本。

限制

您無法變更現有環境範本的語言。

您無法自訂所建立 Spark 環境範本的軟體配置。

若要自訂您所建立的環境範本，請執行下列動作:

1. 在專案的 管理 標籤下，按一下 環境 頁面。

2. 在 作用中執行時期 區段中，檢查您要變更的環境範本沒有作用中執行時期。

3. 在 環境範本 區段中，按一下您要自訂的環境範本。

4. 進行變更。

   對於 Juyter Notebook 環境範本，請選取建立自訂作業，並指定要新增至依預設可用的標準套件的程式庫。 您也可以在標準軟體配置期間，使用自訂作業來升級或降級套件。

   透過自訂作業新增至環境範本的程式庫不會持續保存; 不過，每次啟動環境執行時期時都會自動安裝它們。 請注意，如果您透過 Notebook Cell 而非自訂作業使用 pip install 來新增程式庫，則只有您能夠使用此程式庫; 該程式庫無法供使用相同環境範本的其他人使用。

   視需要而定，您可使用提供的範本來新增自訂程式庫。 Python 和 R 有不同的範本。 下列範例顯示如何新增 Python 套件:

   # Modify the following content to add a software customization to an environment.
   # To remove an existing customization, delete the entire content and click Apply.
   
   # Add conda channels below defaults, indented by two spaces and a hyphen.
   channels:
    - defaults
   
   # To add packages through conda or pip, remove the comment on the following line.
   # dependencies:
   
   # Add conda packages here, indented by two spaces and a hyphen.
   # Remove the comment on the following line and replace sample package name with your package name:
   #  - a_conda_package=1.0
   
   # Add pip packages here, indented by four spaces and a hyphen.
   # Remove the comments on the following lines  and replace sample package name with your package name.
   #  - pip:
   #    - a_pip_package==1.0
   

   自訂時的重要事項：

   • 在自訂套件之前，請確認您所規劃的變更會有預期的效果。
     • conda 可以報告安裝給定套件所需的變更，不需實際安裝該套件。 您可以從 Notebook 驗證變更。 例如，對於程式庫 Plotly:
       • 在 Python 記事本中，輸入: !conda install --dry-run plotly
       • 在 R Notebook 中，輸入: print(system2("conda", args=c("install","--dry-run","r-plotly"), stdout=TRUE))
     • pip 即會安裝該套件。 不過，在驗證之後，重新啟動執行時期即會移除該套件。 屆時，您同樣可以從 Notebook 驗證變更。 例如，對於程式庫 Plotly:
       • 在 Python 記事本中，輸入: !pip install plotly
       • 在 R Notebook 中，輸入: print(system2("pip", args="install plotly", stdout=TRUE))
   • 如果您可以透過 conda 從預設通道取得套件，或是透過 pip 從 PyPI 取得套件，則偏好方法是透過 conda 從預設通道取得套件。
   • 當安裝套件時，Conda 會執行相依關係檢查，如果您將多個套件新增至自訂作業，則可以進行記憶體密集型作業。 請確定您選取具有足夠 RAM 的環境，以在執行時期啟動時啟用相依關係檢查。
   • 如果您只需要一個 Conda 通道中的套件，那麼為了防止多餘的相依關係檢查，請排除預設通道，方式是從範本的通道清單中移除 defaults，並新增 nodefaults。
   • 除了 Anaconda 主頻道之外，在 Anaconda 的 R 頻道中還可以找到許多用於 R 的套件。 在 R 環境中，此通道已經是預設通道的一部分，因此不需要個別新增。
   • 如果僅透過 pip 或僅透過 conda 將套件新增至自訂作業範本，則必須確保範本中未註銷 dependencies 。
   • 當您指定套件版本時，請針對 conda 套件使用單個 =，而針對 pip 套件使用 ==。 盡可能指定版本號碼，因為這樣會大大減少安裝時間和記憶體用量。 如果您未指定版本，套件管理程式可能會挑選可用的最新版本，或保留套件中可用的版本。
   • 無法將任意 Notebook 延伸新增為自訂項目，因為 Notebook 延伸必須預先安裝。

5. 套用您的變更。