지원 종료 공지: 2026년 10월 7일에는에 대한 지원을 중단할 AWS 예정입니다 AWS IoT Greengrass Version 1. 2026년 10월 7일 이후에는 더 이상 AWS IoT Greengrass V1 리소스에 액세스할 수 없습니다. 자세한 내용은 [에서 마이그레이션 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)을 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Python AWS IoT Device SDK 용 설치
클라이언트 디바이스는 Python AWS IoT Device SDK 용를 사용하여 AWS IoT 및 AWS IoT Greengrass 코어 디바이스와 통신할 수 있습니다(Python 프로그래밍 언어 사용). 요구 사항을 포함한 자세한 내용은 GitHub의 Python [ Readme](https://github.com/aws/aws-iot-device-sdk-python) AWS IoT Device SDK 용 섹션을 참조하세요.
이 단계에서는 SDK를 설치하고 컴퓨터의 시뮬레이션된 클라이언트 장치에서 사용하는 `basicDiscovery.py` 샘플 함수를 가져옵니다.
1. 컴퓨터에 SDK와 모든 필수 구성 요소를 함께 설치하려면 운영 체제를 선택합니다.
------
#### [ Windows ]
1. [관리자 권한 명령 프롬프트](https://technet.microsoft.com/en-us/library/cc947813(v=ws.10).aspx)를 열고 다음 명령을 실행합니다.
```
python --version
```
버전 정보가 반환되지 않았거나 버전 번호가 2.7 미만(Python 2) 또는 3.3 미만(Python 3)이면 [Python 다운로드](https://wiki.python.org/moin/BeginnersGuide/Download)의 지침에 따라 Python 2.7 이상 또는 Python 3.3 이상을 설치합니다. 자세한 내용은 [Windows에서 Python 사용](https://docs.python.org/3.6/using/windows.html)을 참조하십시오.
1. [Python용AWS IoT Device SDK](https://github.com/aws/aws-iot-device-sdk-python)을 `zip` 파일로 다운로드하고 컴퓨터의 적절한 위치에 압축을 해제합니다.
`setup.py` 파일이 들어 있는 압축 해제된 `aws-iot-device-sdk-python-master` 폴더의 파일 경로를 메모합니다. 다음 단계에서 이 파일 경로는 {{path-to-SDK-folder}}로 표시됩니다.
1. 관리자 권한 명령 프롬프트에서 다음을 실행합니다.
```
cd {{path-to-SDK-folder}}
python setup.py install
```
------
#### [ macOS ]
1. 터미널 창을 열고 다음 명령을 실행합니다.
```
python --version
```
버전 정보가 반환되지 않았거나 버전 번호가 2.7 미만(Python 2) 또는 3.3 미만(Python 3)이면 [Python 다운로드](https://wiki.python.org/moin/BeginnersGuide/Download)의 지침에 따라 Python 2.7 이상 또는 Python 3.3 이상을 설치합니다. 자세한 내용은 [Macintosh에서 Python 사용](https://docs.python.org/3/using/mac.html)을 참조하십시오.
1. 터미널 창에서 다음 명령을 실행하여 OpenSSL 버전을 확인합니다.
```
python
>>>import ssl
>>>print ssl.OPENSSL_VERSION
```
OpenSSL 버전 값을 기록해 둡니다.
**참고**
Python 3를 실행 중인 경우 **print(ssl.OPENSSL\_VERSION)**를 사용합니다.
Python 셸을 닫으려면 다음 명령을 실행합니다.
```
>>>exit()
```
OpenSSL 버전이 1.0.1 이상이면 [c단계](#step-c-install-python-sdk)로 건너뜁니다. 그렇지 않은 경우 다음 단계를 따르십시오.
1. 터미널 창에서 다음 명령을 실행하여 컴퓨터에서 Simple Python Version Management를 사용 중인지 확인합니다.
```
which pyenv
```
파일 경로가 반환되면 [**`pyenv` 사용**] 탭을 선택합니다. 반환되지 않으면 [**`pyenv` 사용 안 함**] 탭을 선택합니다.
------
#### [ Using pyenv ]
1. [Mac OS X용 Python 릴리스](https://www.python.org/downloads/mac-osx/)(또는 유사 항목)를 참조하여 안정적인 최신 Python 버전을 확인하십시오. 다음 예에서 이 값은 {{latest-Python-version}}으로 표시됩니다.
1. 터미널 창에서 다음 명령을 실행합니다.
```
pyenv install {{latest-Python-version}}
pyenv global {{latest-Python-version}}
```
예를 들어 Python 2의 최신 버전이 2.7.14이면 이 명령은 다음과 같습니다.
```
pyenv install 2.7.14
pyenv global 2.7.14
```
1. 터미널 창을 닫았다가 다시 열고 다음 명령을 실행합니다.
```
python
>>>import ssl
>>>print ssl.OPENSSL_VERSION
```
OpenSSL 버전은 1.0.1 이상이어야 합니다. 버전이 1.0.1 미만이면 업데이트가 실패한 것입니다. **pyenv install** 및 **pyenv global** 명령에서 사용된 Python 버전 값을 확인하고 다시 시도하십시오.
1. 다음 명령을 실행하여 Python 셸을 종료합니다.
```
exit()
```
------
#### [ Not using pyenv ]
1. 터미널 창에서 다음 명령을 실행하여 [brew](https://brew.sh/)가 설치되어 있는지 확인합니다.
```
which brew
```
파일 경로가 반환되지 않으면 다음과 같이 `brew`를 설치합니다.
```
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
**참고**
설치 프롬프트에 따릅니다. Xcode 명령줄 도구 다운로드에 약간의 시간이 걸릴 수 있습니다.
1. 다음 명령을 실행합니다.
```
brew update
brew install openssl
brew install python@2
```
Python AWS IoT Device SDK 용 에는 Python 실행 파일로 컴파일된 OpenSSL 버전 1.0.1(또는 이상)이 필요합니다. **brew install python** 명령은 이 요구 사항을 충족하는 `python2` 실행 파일을 설치합니다. `python2` 실행 파일은 `/usr/local/bin` 디렉터리에 설치되며, `PATH` 환경 변수의 일부여야 합니다. 확인하려면 다음 명령을 실행합니다.
```
python2 --version
```
`python2` 버전 정보가 제공되면 다음 단계로 건너뜁니다. 그렇지 않으면 셸 프로필에 다음 줄을 추가하여 `PATH` 환경 변수에 대한 `/usr/local/bin` 경로를 영구적으로 추가합니다.
```
export PATH="/usr/local/bin:$PATH"
```
예를 들어 `.bash_profile`을 사용 중이거나 아직 셸 프로필이 없는 경우 터미널 창에서 다음 명령을 실행합니다.
```
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile
```
이후 셸 프로필에 [source](https://en.wikipedia.org/wiki/Source_(command))를 지정한 다음 `python2 --version`에서 버전 정보를 제공하는지 확인합니다. 예를 들어 `.bash_profile`을 사용 중인 경우 다음 명령을 실행합니다.
```
source ~/.bash_profile
python2 --version
```
`python2` 버전 정보가 반환되어야 합니다.
1. 다음 줄을 셸 프로필에 추가합니다.
```
alias python="python2"
```
예를 들어 `.bash_profile`을 사용 중이거나 아직 셸 프로필이 없는 경우 다음 명령을 실행합니다.
```
echo 'alias python="python2"' >> ~/.bash_profile
```
1. 이후 셸 프로필에 [source](https://en.wikipedia.org/wiki/Source_(command))를 지정합니다. 예를 들어 `.bash_profile`을 사용 중인 경우 다음 명령을 실행합니다.
```
source ~/.bash_profile
```
**python** 명령을 호출하면 필수 OpenSSL 버전이 포함된 Python 실행 파일(예: `python2`)이 실행됩니다.
1. 다음 명령을 실행합니다.
```
python
import ssl
print ssl.OPENSSL_VERSION
```
OpenSSL 버전은 1.0.1 이상이어야 합니다.
1. Python 셸을 종료하려면 다음 명령을 실행합니다.
```
exit()
```
------
1. 다음 명령을 사용하여 Python용 AWS IoT Device SDK 을 설치합니다.
```
cd ~
git clone https://github.com/aws/aws-iot-device-sdk-python.git
cd aws-iot-device-sdk-python
sudo python setup.py install
```
------
#### [ UNIX-like system ]
1. 터미널 창에서 다음 명령을 실행합니다.
```
python --version
```
버전 정보가 반환되지 않았거나 버전 번호가 2.7 미만(Python 2) 또는 3.3 미만(Python 3)이면 [Python 다운로드](https://wiki.python.org/moin/BeginnersGuide/Download)의 지침에 따라 Python 2.7 이상 또는 Python 3.3 이상을 설치합니다. 자세한 내용은 [Unix 플랫폼에서 Python 사용](https://docs.python.org/3.6/using/unix.html)을 참조하십시오.
1. 터미널에서 다음 명령을 실행하여 OpenSSL 버전을 확인합니다.
```
python
>>>import ssl
>>>print ssl.OPENSSL_VERSION
```
OpenSSL 버전 값을 기록해 둡니다.
**참고**
Python 3를 실행 중인 경우 **print(ssl.OPENSSL\_VERSION)**를 사용합니다.
Python 셸을 닫으려면 다음 명령을 실행합니다.
```
exit()
```
OpenSSL 버전이 1.0.1 이상이면 다음 단계로 건너뜁니다. 그렇지 않으면 해당 명령을 실행하여 배포용 OpenSSL을 업데이트합니다(예: `sudo yum update openssl`, `sudo apt-get update` 등).
다음 명령을 실행하여 OpenSSL 버전이 1.0.1 이상인지 확인합니다.
```
python
>>>import ssl
>>>print ssl.OPENSSL_VERSION
>>>exit()
```
1. 다음 명령을 사용하여 Python용 AWS IoT Device SDK 을 설치합니다.
```
cd ~
git clone https://github.com/aws/aws-iot-device-sdk-python.git
cd aws-iot-device-sdk-python
sudo python setup.py install
```
------
1. Python AWS IoT Device SDK 용를 설치한 후 `samples` 폴더로 이동하여 `greengrass` 폴더를 엽니다.
이 자습서에서는 [AWS IoT Greengrass 그룹에 클라이언트 디바이스 생성](device-group.md)에서 다운로드한 인증서와 키를 사용하는 `basicDiscovery.py` 샘플 함수를 복사합니다.
1. HelloWorld\_Publisher 및 HelloWorld\_Subscriber 장치 인증서 및 키가 포함된 폴더에 `basicDiscovery.py`를 복사합니다.