

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# のインストール AWS ParallelCluster


AWS ParallelCluster は Python パッケージとして配布され`pip`、Python パッケージマネージャーである を使用してインストールされます。Python パッケージのインストールの詳細については、*「Python Packaging User Guide」*(Python パッケージユーザーガイド) の[「Installing packages」](https://packaging.python.org/tutorials/installing-packages/)(パッケージのインストール) を参照してください。

**インストール方法 AWS ParallelCluster：**
+ [仮想環境を使用する (推奨)](#install-tool-venv)
+ [`pip` を使用する](#install-tool-pip)

最新の CLI のバージョン番号は、[GitHub のリリースページ](https://github.com/aws/aws-parallelcluster/releases)で確認できます。

このガイドのコマンド例では、Python v 3 がインストールされていることを前提としています。`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 version 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 を使用している場合は、`pip3` の代わりに `pip` を、`venv` の代わりに `virtualenv` を使用します。

**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"
```

------

# Linux AWS ParallelCluster に をインストールする
リナックス

Python のパッケージマネージャーである を使用して`pip`、 AWS ParallelCluster とその依存関係をほとんどの Linux ディストリビューションにインストールできます。まず、Python と `pip` がインストールされているかどうかを判断します。

1. お使いの Linux に Python と `pip` が付属していることを確認するには、`pip --version` を実行します。

   ```
   $ pip --version
   ```

   `pip` をインストールした場合は、[「pip AWS ParallelCluster でインストール](install.md)」トピックに進みます。それ以外の場合は、ステップ 2 に進みます。

1. Python がインストールされているかどうかを確認するには、`python --version` を実行します。

   ```
   $ python --version
   ```

   Python 3 バージョン 3.6 以降または Python 2 バージョン 2.7 がインストールされている場合は、[「pip AWS ParallelCluster でのインストール](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
   ```

   or

   ```
   $ python3 get-pip.py --user
   ```

   `--user` スイッチを含めると、スクリプトは `pip` をパス `~/.local/bin` にインストールします。

1. `pip` を含むフォルダが `PATH` 変数の一部であることを確認するには、以下の操作を行います。

   1. ユーザーフォルダーでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、`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` を使用してインストールした後は、オペレーティングシステムの `PATH` 環境変数への `pcluster` 実行ファイルの追加が必要になる場合があります。

`pip` がインストールされているフォルダを確認するには AWS ParallelCluster、次のコマンドを実行します。

```
$ which pcluster
/home/username/.local/bin/pcluster
```

インストール時に`--user`スイッチを省略した場合 AWS ParallelCluster、実行可能ファイルは Python インストールの `bin`フォルダにある可能性があります。Python がインストールされた場所が不明な場合は、次のコマンドを実行します。

```
$ which python
/usr/local/bin/python
```

出力は、実際の実行可能ファイルではなく symlink へのパスになる場合があります。symlink の示す場所を確認するには、`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`と をインストールする前に Python をインストールします AWS ParallelCluster。

**Linux に Python 3 をインストールするには**

1. Python がインストール済みかどうかを確認します。

   ```
   $ python3 --version
   ```

   or

   ```
   $ python --version
   ```
**注記**  
ご使用の Linux ディストリビューションに Python が付属している場合は、Python 開発者パッケージをインストールする必要があります。開発者パッケージには、拡張機能をコンパイルして AWS ParallelClusterをインストールするのに必要なヘッダーとライブラリが含まれます。パッケージマネージャーを使用して、開発者パッケージをインストールします。通常、このファイル名は `python-dev` または `python-devel` です。

1. Python 2.7 以降がインストールされていない場合は、ご使用のディストリビューションのパッケージマネージャーを使用して Python をインストールします。コマンドとパッケージ名は、場合によって異なります。
   + Debian から派生した OS (Ubuntu など) では、`apt` を使用します。

     ```
     $ sudo apt-get install python3
     ```
   + Red Hat およびそれから派生した OS では、`yum` を使用します。

     ```
     $ sudo yum install python3
     ```
   + SUSE およびそれから派生した OS では、`zypper` を使用します。

     ```
     $ sudo zypper install python3
     ```

1. Python が正しくインストールされたことを確認するには、コマンドプロンプトまたはシェルを開き、次のコマンドを実行します。

   ```
   $ python3 --version
   Python 3.8.11
   ```

# macOS AWS ParallelCluster に をインストールする
macOS

**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/downloads/mac-osx/) の[ダウンロードページ](https://www.python.org)から最新の 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)します。

最新バージョンにアップグレードするには、インストールコマンドを再び実行します。

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

## コマンドラインパスに AWS ParallelCluster 実行可能ファイルを追加する


`pip` を使用してインストールした後は、オペレーティングシステムの `PATH` 環境変数への `pcluster` プログラムの追加が必要になる場合があります。プログラムの場所は、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、Unix、macOS)**

1. ユーザーフォルダーでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、`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

Python のパッケージマネージャーである を使用して `pip`Windows AWS ParallelCluster に をインストールできます。`pip` がすでに存在する場合は、メインの[インストールに関するトピック](install.md)の手順に従います。

**Topics**
+ [

## Python AWS ParallelCluster を使用して Windows `pip`に をインストールする
](#install-windows-pip)
+ [

## コマンドラインパスに AWS ParallelCluster 実行可能ファイルを追加する
](#install-windows-path)

## Python AWS ParallelCluster を使用して Windows `pip`に をインストールする


Python Software Foundation は、`pip` を含む Windows 用インストーラを提供しています。

**Python と `pip` をインストールするには (Windows)**

1. [Python.org](https://www.python.org/downloads/windows/) の[ダウンロードページ](https://www.python.org)から Python Windows x86-64 のインストーラーをダウンロードします。

1. インストーラーを実行します。

1. **[Add Python 3 to PATH]** (Python 3 を PATH に追加する) を選択します。

1. **[Install Now]** (今すぐインストールする) を選択します。

インストーラはユーザーフォルダに Python をインストールし、プログラムフォルダをユーザーパスに追加します。

**AWS ParallelCluster で をインストールするには `pip3` (Windows)**

Python version 3\$1 を使用する場合は、`pip3` コマンドの使用が推奨されます。

1. **[Start]** (スタート) メニューから**コマンドプロンプト**を開きます。

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`、オペレーティングシステムの`PATH`環境変数に`pcluster`プログラムを追加します。

次のコマンドを実行すると、`pcluster` プログラムがインストールされた場所を確認できます。

```
C:\>where pcluster
C:\Python38\Scripts\pcluster.exe
```

このコマンドで結果が返らない場合は、手動でパスを追加する必要があります。コマンドラインまたは Windows Explorer を使用して、コンピュータのインストールされている場所を見つけます。一般的なパスは、次のとおりです。
+ **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** を選択して、**編集** を選択します。

1. このパスを **[Variable value]** (変数値) フィールドに追加します。例: ***C:\$1new\$1path***。

1. **[OK]** を 2 回選択して、新しい設定を適用します。

1. 実行中のコマンドプロンプトを閉じ、コマンドプロンプトウィンドウを再度開きます。