

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS ParallelCluster 在虛擬環境中安裝 （建議）
<a name="install-virtualenv"></a>

我們建議您 AWS ParallelCluster 在虛擬環境中安裝 ，以避免需求版本與其他`pip`套件衝突。

**先決條件**
+ 確認已安裝 `pip` 和 Python。我們建議使用 `pip3`、 和 Python 3 3.8 版。如果您使用的是 Python 2，請使用 `pip` 來取代 `pip3`，以及使用 `virtualenv` 來取代 `venv`。

**在 AWS ParallelCluster 虛擬環境中安裝**

1. 如果未安裝 `virtualenv`，請使用 `pip3` 安裝 `virtualenv`。如果 `python3 -m virtualenv help` 顯示說明資訊，請前往步驟 2。

------
#### [ Linux, macOS, or Unix ]

   ```
   $ python3 -m pip install --upgrade pip
   $ python3 -m pip install --user --upgrade virtualenv
   ```

   執行 `exit` 以離開目前的終端機視窗，並且開啟一個新的終端機視窗來套用環境的變更。

------
#### [ Windows ]

   ```
   C:\>pip3 install --user --upgrade virtualenv
   ```

   執行 `exit` 以離開目前的命令提示，並且開啟新的命令提示以套用環境的變更。

------

1. 建立虛擬環境並為其命名。

------
#### [ Linux, macOS, or Unix ]

   ```
   $ python3 -m virtualenv ~/apc-ve
   ```

   或者，您可以使用該 `-p` 選項以指定特定版本的 Python。

   ```
   $ python3  -m virtualenv -p $(which python3) ~/apc-ve
   ```

------
#### [ Windows ]

   ```
   C:\>virtualenv %USERPROFILE%\apc-ve
   ```

------

1. <a name="activate-virtual-environment"></a>啟用新的虛擬環境。

------
#### [ Linux, macOS, or Unix ]

   ```
   $ source ~/apc-ve/bin/activate
   ```

------
#### [ Windows ]

   ```
   C:\>%USERPROFILE%\apc-ve\Scripts\activate
   ```

------

1. 在虛擬環境中安裝 AWS ParallelCluster 。

------
#### [ Linux, macOS, or Unix ]

   ```
   (apc-ve)~$ python3 -m pip install --upgrade "aws-parallelcluster<3.0"
   ```

------
#### [ Windows ]

   ```
   (apc-ve) C:\>pip3 install --upgrade "aws-parallelcluster<3.0"
   ```

------

1. 確認 AWS ParallelCluster 已正確安裝。

------
#### [ Linux, macOS, or Unix ]

   ```
   $ pcluster version
   2.11.9
   ```

------
#### [ Windows ]

   ```
   (apc-ve) C:\>pcluster version
   2.11.9
   ```

------

您可以使用 `deactivate` 命令來離開虛擬環境。每次啟動工作階段時，您必須[重新啟動環境](#activate-virtual-environment)。

若要升級至最新版本的 AWS ParallelCluster，請再次執行安裝命令。

------
#### [ Linux, macOS, or Unix ]

```
(apc-ve)~$ python3 -m pip install --upgrade "aws-parallelcluster<3.0"
```

------
#### [ Windows ]

```
(apc-ve) C:\>pip3 install --upgrade "aws-parallelcluster<3.0"
```

------