

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

# Elastic Beanstalk를 관리하기 위한 EB 명령줄 인터페이스(EB CLI) 설정
<a name="eb-cli3"></a>

EB CLI는 환경을 생성, 업데이트 및 모니터링하는 대화형 명령을 제공하는 명령줄 인터페이스입니다 AWS Elastic Beanstalk. EB CLI 오픈 소스 프로젝트는 Github: `[aws/aws-elastic-beanstalk-cli](https://github.com/aws/aws-elastic-beanstalk-cli)`에 있습니다.

EB CLI를 설치하고 프로젝트 디렉토리를 구성한 후 단일 명령으로 환경을 생성할 수 있습니다.

```
$ eb create {{my-beanstalk-environment}}
```

설정 스크립트를 사용하여를 설치하고 [설정 스크립트를 사용하여 EB CLI 설치(권장)](#eb-cli3-install)에서 방법을 알아보는 것이 좋습니다.

 는 하위 수준 Elastic Beanstalk APIs에 대한 직접 액세스를 AWS CLI 제공합니다. 강력하지만 상세하고 EB CLI보다 선호도가 낮습니다. 예를 들어를 사용하여 환경을 생성하려면 다음과 같은 일련의 명령이 AWS CLI 필요합니다.

```
$ aws elasticbeanstalk check-dns-availability \
    --cname-prefix {{my-cname}}
$ aws elasticbeanstalk create-application-version \
    --application-name {{my-application}} \
    --version-label {{v1}} \
    --source-bundle S3Bucket={{amzn-s3-demo-bucket,S3Key=php-proxy-sample.zip}}
$ aws elasticbeanstalk create-environment \
    --cname-prefix {{my-cnam}}e \
    --application-name {{my-app}} \
    --version-label {{v1}} \
    --environment-name {{my-env}} \
    --solution-stack-name "{{64bit Amazon Linux 2023 v4.5.0 running Ruby 3.4}}"
```

## 설정 스크립트를 사용하여 EB CLI 설치(권장)
<a name="eb-cli3-install"></a>

**설치 프로그램 스크립트를 사용하는 것이 좋습니다.**  
설치 프로그램 스크립트를 사용하여 EB CLI 및 해당 종속성을 설정하고 다른 Python 패키지와의 잠재적 충돌을 방지하는 것이 좋습니다.

사전 조건: Git, Python 및 [virtualenv](https://virtualenv.pypa.io/en/latest/installation.html)

**설치 프로그램 스크립트를 다운로드하고 사용하려면**

1. 리포지토리를 복제합니다.

   ```
   git clone https://github.com/aws/aws-elastic-beanstalk-cli-setup.git
   ```

1. EB CLI를 설치 또는 업그레이드합니다.

   Bash 또는 Zsh의 **macOS/Linux**

   ```
   python ./aws-elastic-beanstalk-cli-setup/scripts/ebcli_installer.py
   ```

   PowerShell 또는 명령 창의 **Windows**

   ```
   python .\aws-elastic-beanstalk-cli-setup\scripts\ebcli_installer.py
   ```

1. EB CLI가 올바르게 설치되었는지 확인합니다.

   ```
   $ eb --version
   EB CLI 3.21.0 (Python 3.12)
   ```

전체 설치 지침은 GitHub의 [https://github.com/aws/aws-elastic-beanstalk-cli-setup](https://github.com/aws/aws-elastic-beanstalk-cli-setup) 리포지토리를 참조하세요.

## 수동으로 EB CLI 설치
<a name="eb-cli3-install-advanced"></a>

Python 패키지 및 해당 종속성의 설치, 업그레이드 및 제거를 제공하는 Python용 `pip` 패키지 관리자를 사용하여 Linux, macOS 및 Windows에 EB CLI를 설치할 수 있습니다.

**설치 프로그램 스크립트를 사용하는 것이 좋습니다.**  
[EB CLI 설치](#eb-cli3-install)를 사용하여 EB CLI를 설정하고 종속성 충돌을 방지하는 것이 좋습니다.

**사전 조건** - 지원되는 버전의 Python이 설치되어 있어야 합니다. Python 웹 사이트의 [Python 다운로드](https://www.python.org/downloads/) 페이지에서 다운로드할 수 있습니다.

**수동으로 EB CLI 설치**

1. 다음 명령을 실행합니다.

   ```
   $ pip install awsebcli --upgrade --user
   ```

   `--upgrade` 옵션은 `pip`에 이미 설치된 요구 사항을 업그레이드하라고 지시합니다. `--user` 옵션은 운영 체제에서 사용한 라이브러리를 수정하지 않도록 사용자 디렉터리의 하위 디렉터리에 프로그램을 설치할 것을 `pip`에 지시합니다.
**문제 해결**  
`pip`를 사용하여 EB CLI를 설치할 때 문제가 발생할 경우 [가상 환경에 EB CLI 설치](#eb-cli3-install-virtualenv)를 수행하여 도구 및 해당 종속 항목을 격리하거나 일반적으로 사용하는 것과 다른 Python 버전을 사용할 수 있습니다.

1. `PATH` 변수에 실행 파일 경로를 추가합니다.
   + Linux 및 macOS:

     **Linux** – `~/.local/bin`

     **macOS** – `~/Library/Python/{{3.12}}/bin`

     `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. 내보내기 명령을 프로필 스크립트에 추가하세요. 다음 예제에서는 {{LOCAL\_PATH}}로 표현되는 경로를 현재 `PATH` 변수에 추가했습니다.

        ```
        export PATH={{LOCAL_PATH}}:$PATH
        ```

     1. 첫 번째 단계에서 설명한 프로파일 스크립트를 현재 세션에 로드합니다. 다음 예제에서는 {{PROFILE\_SCRIPT}}로 표현되는 프로파일 스크립트를 로드합니다.

        ```
        $ source ~/{{PROFILE_SCRIPT}}
        ```
   + Windows의 경우:

     **Python 3.12** – `%USERPROFILE%\AppData\Roaming\Python\Python312\Scripts`

     **Python 이전 버전** – `%USERPROFILE%\AppData\Roaming\Python\Scripts`

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

     1. Windows 키를 누르고 **environment variables**를 입력합니다.

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

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

     1. 세미콜론으로 구분하여 경로를 **변수 값** 필드에 추가합니다. 예: `{{C:\item1\path}};{{C:\item2\path}}`

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

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

1. **eb --version**을 실행하여 EB CLI가 올바르게 설치되었는지 확인합니다.

   ```
   $ eb --version
   EB CLI 3.21.0 (Python 3.12)
   ```

[최신 Elastic Beanstalk 기능](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/)을 지원하는 기능을 추가하도록 EB CLI를 정기적으로 업데이트합니다. 최신 버전의 EB CLI로 업데이트하려면 설치 명령을 다시 실행합니다.

```
$ pip install awsebcli --upgrade --user
```

EB CLI를 제거해야 하는 경우 `pip uninstall`를 사용합니다.

```
$ pip uninstall awsebcli
```

## 가상 환경에 EB CLI 설치
<a name="eb-cli3-install-virtualenv"></a>

가상 환경에 EB CLI를 설치하면 버전 요구 사항이 다른 `pip` 패키지와 충돌하는 것을 방지할 수 있습니다.

**가상 환경에 EB CLI를 설치하려면**

1. 먼저 `pip`를 사용하여 `virtualenv`를 설치합니다.

   ```
   $ pip install --user virtualenv
   ```

1. 가상 환경을 생성합니다.

   ```
   $ virtualenv {{~/eb-ve}}
   ```

   기본값 이외의 Python 실행 파일을 사용하려면 `-p` 옵션을 사용합니다.

   ```
   $ virtualenv -p /usr/bin/python3.12 {{~/eb-ve}}
   ```

1. 가상 환경을 활성화합니다.

   **Linux, Unix 또는 macOS**

   ```
   $ source {{~/eb-ve}}/bin/activate
   ```

   **Windows**

   ```
   $ {{%USERPROFILE%\eb-ve}}\Scripts\activate
   ```

1. EB CLI를 설치합니다.

   ```
   (eb-ve)$ pip install awsebcli --upgrade
   ```

1. EB CLI가 올바르게 설치되었는지 확인합니다.

   ```
   $ eb --version
   EB CLI 3.23.0 (Python 3.12)
   ```

`deactivate` 명령을 사용하여 가상 환경을 종료할 수 있습니다. 새 세션을 시작할 때마다 정품 인증 명령을 다시 실행합니다.

최신 버전으로 업그레이드하려면 설치 명령을 다시 실행합니다.

```
(eb-ve)$ pip install awsebcli --upgrade
```

## Homebrew로 EB CLI 설치
<a name="eb-cli3-install-osx-homebrew"></a>

최신 버전의 EB CLI는 일반적으로 `pip`에서 표시되고 며칠 뒤에 `Homebrew`에서 사용할 수 있습니다.

**설치 프로그램 스크립트를 사용하는 것이 좋습니다.**  
[EB CLI 설치](#eb-cli3-install)를 사용하여 EB CLI를 설정하고 종속성 충돌을 방지하는 것이 좋습니다.

**`Homebrew`와 함께 EB CLI를 설치하려면**

1. 최신 버전의 `Homebrew`가 있는지 확인합니다.

   ```
   $ brew update
   ```

1. `brew install awsebcli`를 실행합니다.

   ```
   $ brew install awsebcli
   ```

1. EB CLI가 올바르게 설치되었는지 확인합니다.

   ```
   $ eb --version
   EB CLI 3.21.0 (Python 3.12)
   ```