本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 安裝 AWS ParallelCluster 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 在虛擬環境中安裝（建議）建議您 AWS ParallelCluster 在虛擬環境中安裝。如果您在嘗試 AWS ParallelCluster 使用安裝時遇到問題`pip3`，您可以在[AWS ParallelCluster 虛擬環境中安裝](install-virtualenv.md) ，以隔離工具及其相依性。或者，您可以使用與平常不同的 Python 版本。 ## 使用 pip AWS ParallelCluster 在非虛擬環境中安裝 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\$1，我們建議您使用 **pip3** 命令。 ``` $ pip3 install "aws-parallelcluster<3.0" --upgrade --user ``` ## 安裝後要採取的步驟安裝之後 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`，請使用適用於您環境的程序。 ## 每個環境的詳細指示 + [AWS ParallelCluster 在虛擬環境中安裝（建議）](install-virtualenv.md) + [在 Linux AWS ParallelCluster 上安裝](install-linux.md) + [在 macOS AWS ParallelCluster 上安裝](install-macos.md) + [在 Windows AWS ParallelCluster 上安裝](install-windows.md) # AWS ParallelCluster 在虛擬環境中安裝（建議）我們建議您 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. 啟用新的虛擬環境。 ------ #### [ 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" ``` ------ # 在 Linux AWS ParallelCluster 上安裝您可以使用 Python 套件管理員 `pip`，在大多數 Linux 發行版本上安裝 AWS ParallelCluster 及其相依性。首先，判斷是否已安裝 Python 和 `pip`： 1. 若要判斷 Linux 版本是否包含 Python 和 `pip`，請執行 `pip --version`。 ``` $ pip --version ``` 如果您`pip`已安裝，請前往[AWS ParallelCluster 使用 pip 安裝](install.md)主題。否則，請繼續步驟 2。 1. 若要判斷是否已安裝 Python，請執行 `python --version`。 ``` $ python --version ``` 如果您已安裝 Python 3 3.6\$1 版或 Python 2 2.7 版，請前往[AWS ParallelCluster 使用 pip 安裝](install.md)主題。否則，請[安裝 Python](install-linux-python.md)，然後返回此程序來安裝 `pip`。 1. `pip` 使用 *Python Packaging Authority* 提供的指令碼安裝。 1. 使用 `curl` 命令下載安裝指令碼。 ``` $ curl -O https://bootstrap.pypa.io/get-pip.py ``` 1. 執行指令碼和 Python 來下載並安裝最新版本的 `pip` 及其他必要的支援套件。 ``` $ python get-pip.py --user ``` 或 ``` $ python3 get-pip.py --user ``` 當您加入 `--user` 參數，指令碼會將 `pip` 安裝到路徑 `~/.local/bin`。 1. 若要驗證包含的資料夾`pip`是 `PATH`變數的一部分，請執行下列動作： 1. 在您的使用者資料夾中尋找 Shell 的描述檔指令碼。如果您不確定您擁有哪個 Shell，請執行 `basename $SHELL`。 ``` $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads ``` + **Bash** – `.bash_profile`、`.profile` 或 `.bash_login` + **Zsh** – `.zshrc` + **Tcsh** – `.tcshrc`、`.cshrc` 或 `.login` 1. 在設定檔尾端新增匯出命令，類似於以下範例。 ``` export PATH=~/.local/bin:$PATH ``` 匯出命令會在現有 `PATH` 變數的前面插入路徑 (即這個範例中的 `~/.local/bin`)。 1. 若要讓這些變更生效，請將描述檔重新載入到目前的工作階段。 ``` $ source ~/.bash_profile ``` 1. 確認已正確安裝 `pip`。 ``` $ pip3 --version pip 21.3.1 from ~/.local/lib/python3.6/site-packages (python 3.6) ``` **Topics** + [AWS ParallelCluster 使用安裝 `pip`](#install-linux-with-pip) + [將 AWS ParallelCluster 可執行檔新增至命令列路徑](#install-linux-path) + [在 Linux 上安裝 Python](install-linux-python.md) ## AWS ParallelCluster 使用安裝 `pip` 使用 `pip` 進行安裝 AWS ParallelCluster。 ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` 當您使用 `--user` 參數時，`pip` 會將 AWS ParallelCluster 安裝至 `~/.local/bin`。確認 AWS ParallelCluster 安裝正確。 ``` $ pcluster version 2.11.9 ``` 更新到最新版本的＆CLI，再次執行安裝命令。 ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` ## 將 AWS ParallelCluster 可執行檔新增至命令列路徑在使用 `pip` 進行安裝之後，您可能需要將 `pcluster` 可執行檔新增到作業系統的 `PATH` 環境變數。若要驗證`pip`安裝所在的資料夾 AWS ParallelCluster，請執行下列命令。 ``` $ which pcluster /home/username/.local/bin/pcluster ``` 如果您在安裝時省略了`--user`交換器 AWS ParallelCluster，可執行檔可能位於 Python 安裝的 `bin`資料夾中。如果您不知道 Python 的安裝位置，請執行此命令。 ``` $ which python /usr/local/bin/python ``` 請注意，輸出可能是符號連結的路徑，而非實際可執行檔。若要查看符號連結指向何處，請執行 `ls -al`。 ``` $ ls -al $(which python) /usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6 ``` 如果這是您在[安裝 AWS ParallelCluster](install.md)的步驟 3 中新增至路徑的同一個資料夾，則您已完成安裝。否則，您必須再次執行步驟 3a – 3c，將此額外資料夾新增至路徑。 # 在 Linux 上安裝 Python 如果您的分發未隨附 Python，或隨附舊版，請在安裝 `pip`和之前安裝 Python AWS ParallelCluster。 **在 Linux 上安裝 Python 3** 1. 檢查是否已安裝 Python。 ``` $ python3 --version ``` 或 ``` $ python --version ``` **注意** 如果您的 Linux 發行版本隨附 Python，您可能需要安裝 Python 開發人員套件。開發人員套件包含編譯延伸模組和安裝 AWS ParallelCluster所需的標頭和程式庫。使用您的套件管理員來安裝開發人員套件。它通常命名為 `python-dev` 或 `python-devel`。 1. 如果未安裝 Python 2.7 或更高版本，請將 Python 與您的分發套件管理工具一起安裝。命令和套件名稱有所不同： + 在 Debian 的衍生產品，例如 Ubuntu，使用 `apt`。 ``` $ sudo apt-get install python3 ``` + 在 Red Hat 和衍生產品，請使用 `yum`。 ``` $ sudo yum install python3 ``` + 在 SUSE 和衍生產品，請使用 `zypper`。 ``` $ sudo zypper install python3 ``` 1. 若要驗證 Python 是否正確安裝，請開啟命令提示或 Shell，並執行以下命令。 ``` $ python3 --version Python 3.8.11 ``` # 在 macOS AWS ParallelCluster 上安裝 **Topics** + [先決條件](#install-bundle-macos-os-prereq) + [使用 pip 在 macOS AWS ParallelCluster 上安裝](#install-macos-pip) + [將 AWS ParallelCluster 可執行檔新增至命令列路徑](#install-macos-path) ## 先決條件 + Python 3 3.7\$1 版或 Python 2 2.7 版請檢查 Python 安裝。 ``` $ python --version ``` 如果您的電腦尚未安裝 Python，或是您想要安裝不同版本的 Python，請遵從[在 Linux AWS ParallelCluster 上安裝](install-linux.md)中的程序操作。 ## 使用 pip 在 macOS AWS ParallelCluster 上安裝您也可以`pip`直接使用來安裝 AWS ParallelCluster。如果您沒有 `pip`，請遵循主要[安裝主題](install.md)中的指示操作。執行 `pip3 --version` 查看您的 macOS 版本是否已包含 Python 和 `pip3`。 ``` $ pip3 --version ``` **在 macOS AWS ParallelCluster 上安裝** 1. 從 [Python.org](https://www.python.org) [的下載頁面下載](https://www.python.org/downloads/mac-osx/)並安裝最新版本的 Python。 1. 下載並執行 Python Packaging Authority 提供的 `pip3` 安裝指令碼。 ``` $ curl -O https://bootstrap.pypa.io/get-pip.py $ python3 get-pip.py --user ``` 1. 使用新安裝的 `pip3`進行安裝 AWS ParallelCluster。如果您使用 Python 版本 3\$1，我們建議您使用 `pip3` 命令。 ``` $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user ``` 1. 確認 AWS ParallelCluster 已正確安裝。 ``` $ pcluster version 2.11.9 ``` 如果找不到此程式，請[將它新增到命令列路徑](#install-macos-path)。更新到最新版本的＆CLI，再次執行安裝命令。 ``` $ pip3 install "aws-parallelcluster<3.0" --upgrade --user ``` ## 將 AWS ParallelCluster 可執行檔新增至命令列路徑在使用 `pip` 進行安裝後，您可能需要將 `pcluster` 程式新增到作業系統的 `PATH` 環境變數中。程式的位置取決於 Python 的安裝位置。 **Example AWS ParallelCluster 安裝位置 - 使用 Python 3.6 和 `pip`（使用者模式）的 macOS** ``` ~/Library/Python/3.6/bin ``` 請以您的 Python 版本替代上述範例中的版本。如果您不知道 Python 的安裝位置，請執行 `which python`。 ``` $ which python3 /usr/local/bin/python3 ``` 輸出可能是符號連結的路徑，而非實際程式的路徑。執行 `ls -al` 來查看其指向的路徑。 ``` $ ls -al /usr/local/bin/python3 lrwxr-xr-x 1 username admin 36 Mar 12 12:47 /usr/local/bin/python3 -> ../Cellar/python/3.6.8/bin/python3 ``` `pip` 將程式安裝到包含 Python 應用程式的相同資料夾中。將此資料夾新增至 `PATH` 變數。 **修改您的`PATH`變數 (Linux、macOS 或 Unix)** 1. 在您的使用者資料夾中尋找 Shell 的描述檔指令碼。如果您不確定您擁有哪個 Shell，請執行 `echo $SHELL`。 ``` $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads ``` + **Bash** – `.bash_profile`、`.profile` 或 `.bash_login` + **Zsh** – `.zshrc` + **Tcsh** – `.tcshrc`、 `.cshrc`或 `.login` 1. 將匯出命令新增至您的描述檔指令碼。 ``` export PATH=~/.local/bin:$PATH ``` 這個命令將路徑 (此範例中的 `~/.local/bin`) 新增到目前的 `PATH` 變數。 1. 將設定檔載入到目前工作階段中。 ``` $ source ~/.bash_profile ``` # 在 Windows AWS ParallelCluster 上安裝您可以使用來在 Windows AWS ParallelCluster 上安裝 `pip`，這是 Python 的套件管理員。如果您已經有 `pip`，請遵循主要[ 安裝主題 ](install.md)中的指示操作。 **Topics** + [`pip` 在 Windows AWS ParallelCluster 上使用 Python 和安裝](#install-windows-pip) + [將 AWS ParallelCluster 可執行檔新增至命令列路徑](#install-windows-path) ## `pip` 在 Windows AWS ParallelCluster 上使用 Python 和安裝 Python 軟體基金會為 Windows 提供包含 `pip` 的安裝程式。 **安裝 Python 和 `pip` (Windows)** 1. 從 [Python.org](https://www.python.org)：// 的下載[頁面下載](https://www.python.org/downloads/windows/) Python Windows x86-64 安裝程式。 1. 執行安裝程式。 1. 選擇**Add Python 3 to PATH (將 Python 3 新增到 PATH)**。 1. 選擇 **Install Now** (立即安裝)。安裝程式會將 Python 安裝到您的使用者資料夾中，並將其程式資料夾新增到您的使用者路徑。 **AWS ParallelCluster 使用安裝 `pip3`(Windows)** 如果您使用 Python 版本 3\$1，我們建議您使用 `pip3` 命令。 1. 從**開始**功能表開啟**命令提示**字元。 1. 使用下列命令確認 Python 和 `pip` 都已安裝正確。 ``` C:\>py --version Python 3.8.11 C:\>pip3 --version pip 21.3.1 from c:\python38\lib\site-packages\pip (python 3.8) ``` 1. AWS ParallelCluster 使用安裝 `pip`。 ``` C:\>pip3 install "aws-parallelcluster<3.0" ``` 1. 確認 AWS ParallelCluster 已正確安裝。 ``` C:\>pcluster version 2.11.9 ``` 更新到最新版本的＆CLI，再次執行安裝命令。 ``` C:\>pip3 install --user --upgrade "aws-parallelcluster<3.0" ``` ## 將 AWS ParallelCluster 可執行檔新增至命令列路徑 AWS ParallelCluster 使用安裝之後`pip`，請將`pcluster`程式新增至作業系統`PATH`的環境變數。您可以執行下列命令，找到 `pcluster` 程式的安裝位置。 ``` C:\>where pcluster C:\Python38\Scripts\pcluster.exe ``` 如果該命令未傳回任何結果，則必須手動新增路徑。使用命令列或 Windows 檔案總管來探索它在您電腦上的安裝位置。典型路徑包括： + **Python 3 和 `pip3`** – `C:\Python38\Scripts\` + **Python 3 和 `pip3` --user 選項** – `%APPDATA%\Python\Python38\Scripts` **注意** 包括版本號碼的資料夾名稱可能有所不同。上述範例顯示 Python38。視需要更換為您所使用的版本編號。 **修改 PATH 變數 (Windows)** 1. 按下 Windows 鍵並輸入 **environment variables**。 1. 選擇 **Edit environment variables for your account (編輯您帳戶的環境變數)**。 1. 選擇 **PATH**，然後選擇 **Edit (編輯)**。 1. 新增路徑至 **Variable value (變數值)** 欄位。例如：***C:\$1new\$1path*** 1. 選擇 **OK** (確定) 兩次以套用新的設定。 1. 關閉任何正在執行的命令提示，並重新開啟命令提示字元視窗。