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

# 安裝 AWS ParallelCluster
<a name="install"></a>

AWS ParallelCluster 以 Python 套件形式分佈，並使用 Python 套件管理員 `pip`進行安裝。如需安裝 Python 套件的詳細資訊，請參閱 Python Packaging 使用者指南中的[安裝](https://packaging.python.org/tutorials/installing-packages/)套件。 **

**安裝方式 AWS ParallelCluster：**
+ [使用虛擬環境 (建議)](#install-tool-venv)
+ [使用 `pip`](#install-tool-pip)

您可以在 [GitHub 的發行版本頁面](https://github.com/aws/aws-parallelcluster/releases)上找到最新 CLI 的版本號。

在這個指南中，命令範例假設您已安裝 Python v3。`pip` 命令範例使用的是 `pip3` 版本。

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

建議您 AWS ParallelCluster 在虛擬環境中安裝 。如果您在嘗試 AWS ParallelCluster 使用 安裝 時遇到問題`pip3`，您可以在[AWS ParallelCluster 虛擬環境中安裝](install-virtualenv.md) ，以隔離工具及其相依性。或者，您可以使用與平常不同的 Python 版本。

## 使用 pip AWS ParallelCluster 在非虛擬環境中安裝
<a name="install-tool-pip"></a>

Linux、Windows 和 macOS AWS ParallelCluster 上 的主要分發方法為 `pip`，這是 Python 的套件管理員。它提供一個簡單的方法來安裝、升級和移除 Python 套件及其依存項目。

**目前 AWS ParallelCluster 版本**  
AWS ParallelCluster 會定期更新。若要判斷是否有最新版本，請參閱[在 GitHub 上的發佈頁面](https://github.com/aws/aws-parallelcluster/releases)。

如果您已有 `pip`和支援的 Python 版本，您可以使用下列命令 AWS ParallelCluster 來安裝 。如果您已安裝 Python 版本 3\+，我們建議您使用 **pip3** 命令。

```
$ pip3 install "aws-parallelcluster<3.0" --upgrade --user
```

## 安裝後要採取的步驟
<a name="install-post"></a>

安裝之後 AWS ParallelCluster，您可能需要將可執行檔路徑新增至`PATH`變數。有關平台的特別說明，請參閱以下主題：
+ **Linux** – [將 AWS ParallelCluster 可執行檔新增至命令列路徑](install-linux.md#install-linux-path)
+ **macOS** – [將 AWS ParallelCluster 可執行檔新增至命令列路徑](install-macos.md#install-macos-path)
+ **Windows** – [將 AWS ParallelCluster 可執行檔新增至命令列路徑](install-windows.md#install-windows-path)

您可以執行 來驗證 是否正確 AWS ParallelCluster 安裝`pcluster version`。

```
$ pcluster version
2.11.9
```

AWS ParallelCluster 會定期更新。若要更新至最新版本的 AWS ParallelCluster，請再次執行安裝命令。如需最新版本 的詳細資訊 AWS ParallelCluster，請參閱[AWS ParallelCluster 版本備註](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/CHANGELOG.md)。

```
$ pip3 install "aws-parallelcluster<3.0" --upgrade --user
```

若要解除安裝 AWS ParallelCluster，請使用 `pip uninstall`。

```
$ pip3 uninstall "aws-parallelcluster<3.0"
```

如果您沒有 Python 和 `pip`，請使用適用於您環境的程序。

## 每個環境的詳細指示
<a name="install-sections"></a>
+ [AWS ParallelCluster 在虛擬環境中安裝 （建議）](install-virtualenv.md)
+ [在 Linux AWS ParallelCluster 上安裝](install-linux.md)
+ [在 macOS AWS ParallelCluster 上安裝](install-macos.md)
+ [在 Windows AWS ParallelCluster 上安裝](install-windows.md)