기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 설치 AWS ParallelCluster
<a name="install"></a>

AWS ParallelCluster 는 Python 패키지로 배포되며 Python 패키지 관리자`pip`인를 사용하여 설치됩니다. Python 패키지 설치에 대한 자세한 내용은 Python 패키징 사용 설명서의** [패키지 설치](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 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 에서의 기본 배포 방법은 Python의 패키지 관리자`pip`인 입니다. pip는 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>

설치 후 실행 파일 경로를 `PATH` 변수에 추가해야 할 AWS ParallelCluster수 있습니다. 플랫폼별 지침은 다음 주제를 참조하세요.
+ **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 릴리스 정보를](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/CHANGELOG.md) AWS ParallelCluster참조하세요.

```
$ 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)

# AWS ParallelCluster 가상 환경에 설치(권장)
<a name="install-virtualenv"></a>

요구 사항 버전이 다른 `pip` 패키지와 충돌하지 않도록 가상 환경에 AWS ParallelCluster 를 설치하는 것이 좋습니다.

**사전 조건**
+ `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 에 설치
<a name="install-linux"></a>

Python용 패키지 관리자`pip`인를 사용하여 대부분의 Linux 배포에 AWS ParallelCluster 및 해당 종속성을 설치할 수 있습니다. 먼저 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. Python Packaging Authority**에서 제공하는 스크립트를 사용하여 `pip`를 설치합니다.

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`
<a name="install-linux-with-pip"></a>

를 사용하여 `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 실행 파일 추가
<a name="install-linux-path"></a>

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

실제 실행 파일이 아니라 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 설치
<a name="install-linux-python"></a>

배포가 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을 설치합니다. 다음과 같이 명령과 패키지 이름이 다릅니다.
   + Ubuntu와 같은 Debian 계열 시스템에는 `apt`를 사용합니다.

     ```
     $ sudo apt-get install python3
     ```
   + Red Hat 및 계열 시스템에는 `yum`을 사용합니다.

     ```
     $ sudo yum install python3
     ```
   + SUSE 및 계열 시스템에는 `zypper`를 사용합니다.

     ```
     $ sudo zypper install python3
     ```

1. Python이 올바르게 설치되었는지 확인하려면 명령 프롬프트 또는 셸을 열고 다음 명령을 실행합니다.

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

# macOS AWS ParallelCluster 에 설치
<a name="install-macos"></a>

**Topics**
+ [

## 사전 조건
](#install-bundle-macos-os-prereq)
+ [

## pip를 사용하여 macOS AWS ParallelCluster 에 설치
](#install-macos-pip)
+ [

## 명령줄 경로에 AWS ParallelCluster 실행 파일 추가
](#install-macos-path)

## 사전 조건
<a name="install-bundle-macos-os-prereq"></a>
+ Python 3 버전 3.7\$1 또는 Python 2 버전 2.7

Python 설치를 확인합니다.

```
$ python --version
```

컴퓨터에 아직 Python이 설치되지 않았거나 다른 버전의 Python을 설치하려는 경우 [Linux AWS ParallelCluster 에 설치](install-linux.md)의 절차를 수행하세요.

## pip를 사용하여 macOS AWS ParallelCluster 에 설치
<a name="install-macos-pip"></a>

를 `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 이상을 사용하는 경우에는 `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 실행 파일 추가
<a name="install-macos-path"></a>

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

실제 프로그램 경로가 아니라 symlink 경로가 출력될 수 있습니다. `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. 사용자 폴더에서 셸의 프로파일 스크립트를 찾습니다. 어떤 셸을 가지고 있는지 잘 모르는 경우 `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 에 설치
<a name="install-windows"></a>

Python용 패키지 관리자`pip`인를 사용하여 Windows AWS ParallelCluster 에를 설치할 수 있습니다. `pip`가 이미 있는 경우 기본 [설치 주제](install.md)의 지침을 따릅니다.

**Topics**
+ [

## Windows`pip`에서 Python 및를 AWS ParallelCluster 사용하여 설치
](#install-windows-pip)
+ [

## 명령줄 경로에 AWS ParallelCluster 실행 파일 추가
](#install-windows-path)

## Windows`pip`에서 Python 및를 AWS ParallelCluster 사용하여 설치
<a name="install-windows-pip"></a>

Python Software Foundation은 `pip`가 포함된 Windows용 설치 관리자를 제공합니다.

**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(PATH에 Python 3 추가)**를 선택합니다.

1. **Install Now(지금 설치)**를 선택합니다.

설치 관리자가 사용자 폴더에 Python을 설치하고, 사용자 경로에 프로그램 폴더를 추가합니다.

**AWS ParallelCluster 를 사용하여를 설치하려면`pip3`(Windows)**

Python 버전 3 이상을 사용하는 경우에는 `pip3` 명령을 사용하는 것이 좋습니다.

1. **시작** 메뉴에서 Windows **명령 프롬프트**를 엽니다.

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 실행 파일 추가
<a name="install-windows-path"></a>

 AWS ParallelCluster 를 사용하여 설치한 후 운영 체제의 `PATH` 환경 변수에 `pcluster` 프로그램을 `pip`추가합니다.

다음 명령을 실행하여 `pcluster` 프로그램이 어디에 설치되어 있는지 확인할 수 있습니다.

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

해당 명령이 어떤 결과도 반환하지 않는다면 수동으로 경로를 추가해야 합니다. 명령줄 또는 Windows 탐색기를 사용하여 프로그램이 컴퓨터에서 어디에 설치되어 있는지 검색합니다. 일반적인 경로는 다음과 같습니다.
+ **Python 3 및 `pip3`** – `C:\Python38\Scripts\`
+ **Python 3 및 `pip3` --사용자 옵션** – `%APPDATA%\Python\Python38\Scripts`

**참고**  
버전 번호를 포함한 폴더 이름은 달라질 수 있습니다. 앞의 예제에서는 Python38을 보여 줍니다. 필요한 경우 사용 중인 버전 번호로 바꿉니다.

**PATH 변수를 수정하려면(Windows)**

1. Windows 키를 누르고 **environment variables**를 입력하세요.

1. **계정의 환경 변수 편집**을 선택합니다.

1. **경로**를 선택한 다음 **편집**을 선택합니다.

1. **Variable value(변수 값)** 필드에 경로를 추가합니다. 예: ***C:\$1new\$1path***

1. **확인**을 두 번 선택하여 새 설정을 적용합니다.

1. 실행 중인 명령 프롬프트를 모두 닫았다가 명령 프롬프트 창을 다시 엽니다.