本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 正在安装 AWS ParallelCluster AWS ParallelCluster 作为 Python 包分发`pip`，使用 Python 包管理器进行安装。有关安装 Python 程序包的更多信息，请参阅 *Python Packaging User Guide* 中的 [Installing packages](https://packaging.python.org/tutorials/installing-packages/)。 **安装方式 AWS ParallelCluster：** + [使用虚拟环境（推荐）](#install-tool-venv) + [使用 `pip`](#install-tool-pip) 您可以在的[发布页面上找到最新 CLI 的版本](https://github.com/aws/aws-parallelcluster/releases)号 GitHub。在本指南中，命令示例假定您已安装 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 上安装你可以使用`pip`适用于 Python 的包管理器来安装 AWS ParallelCluster 大多数 Linux 发行版及其对大多数 Linux 发行版的依赖关系。首先，确定是否已安装 Python 和 `pip`： 1. 要确定您的 Linux 版本是否包含 Python 和 `pip`，请运行 `pip --version`。 ``` $ pip --version ``` 如果您已`pip`安装，请转到 “使用 [p AWS ParallelCluster ip 安装](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. 使用 *Python 打包权威机构*提供的脚本来安装 `pip`。 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 ``` 此导出命令将路径（在本示例中为 `~/.local/bin`）插入到现有 `PATH` 变量的前面。 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 ``` 要升级到最新版本，请重新运行安装命令。 ``` $ 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，或者附带了早期版本，请在安装之前安装 Python `pip` 和 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) + [使用 pi AWS ParallelCluster p 在 macOS 上安装](#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)中的过程执行操作。 ## 使用 pi AWS ParallelCluster p 在 macOS 上安装您也可以`pip`直接使用进行安装 AWS ParallelCluster。如果您没有 `pip`，请按照主要[安装主题](install.md)中的说明执行操作。运行 `pip3 --version` 可查看您的 macOS 版本是否已包含 Python 和 `pip3`。 ``` $ pip3 --version ``` **要 AWS ParallelCluster 在 macOS 上安装** 1. 从 [Python.org](https://www.python.org) 的[下载页面](https://www.python.org/downloads/mac-osx/)下载并安装最新版本的 Python。 1. 下载并运行 Python 打包权威机构提供的 `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)。要升级到最新版本，请重新运行安装命令。 ``` $ pip3 install "aws-parallelcluster<3.0" --upgrade --user ``` ## 将 AWS ParallelCluster 可执行文件添加到您的命令行路径中在使用 `pip` 进行安装后，可能需要将 `pcluster` 程序添加到操作系统的 `PATH` 环境变量中。程序的位置取决于 Python 的安装位置。 **Example AWS ParallelCluster 安装位置——搭载 Python 3.6 的 macOS 和`pip`（用户模式）** ``` ~/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 上安装你可以使用 AWS ParallelCluster 在 Windows 上安装`pip`，这是一款适用于 Python 的包管理器。如果您已有 `pip`，请按照主要[安装主题](install.md)中的说明执行操作。 **Topics** + [AWS ParallelCluster 使用 Python 和`pip`在 Windows 上安装](#install-windows-pip) + [将 AWS ParallelCluster 可执行文件添加到您的命令行路径中](#install-windows-path) ## AWS ParallelCluster 使用 Python 和`pip`在 Windows 上安装 Python Software Foundation 为包含 `pip` 的 Windows 提供了安装程序。 **安装 Python 3.6 和 `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 并将其程序文件夹添加到您的用户路径。 **要使用 `pip3` (Windows) AWS ParallelCluster 进行安装** 如果您使用的是 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 ``` 要升级到最新版本，请重新运行安装命令。 ``` 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. 关闭任何运行的命令提示符并重新打开命令提示符窗口。