Python 개발 환경 설정

이 튜토리얼에서는 Cloud de Confiance by S3NS에서 실행되는 Python 앱 개발을 포함하여 Python 개발을 위해 로컬 머신을 준비하는 방법을 보여줍니다.

개발 환경이 이미 설정되어 있으면 Python 및 Cloud de Confiance을 참조하여 Cloud de Confiance에서 Python 앱을 실행하는 방법에 대한 개요를 보실 수 있습니다.

목표

Cloud de Confiance와 호환되는 지원되는 Python 버전을 설치합니다.
venv를 사용하여 종속 항목 격리
편집기 설치(선택사항)
Google Cloud CLI 설치(선택사항)
Python용 Cloud 클라이언트 라이브러리 설치(선택 사항).
다른 유용한 도구 설치
인증을 설정합니다 (선택사항).

Python 설치

Python의 설치 지침은 운영체제별로 다릅니다. macOS, Windows 또는 Linux 등 개발 환경에서 실행 중인 운영체제용 가이드를 따르세요.

macOS

macOS에는 기본적으로 Python 버전이 포함되어 있으며 자체 용도로 사용됩니다. macOS와 간섭을 방지하기 위해서는 별도의 개발 환경을 만들고 Cloud de Confiance용 지원되는 버전의 Python을 설치하는 것이 좋습니다. Python을 설치하려면 homebrew를 사용합니다.

homebrew를 사용하여 Python 패키지를 설치하려면 컴파일러가 필요한데, Xcode의 명령줄 도구를 설치하여 얻을 수 있습니다.
```
xcode-select --install
```
homebrew 홈페이지의 안내에 따라 bomebrew를 설치한 다음 homebrew를 사용하여 Python을 설치하기 위해 다음 단계를 따르세요.
```
brew install pyenv
pyenv install PYTHON_VERSION
```
Python 버전 번호는 x.y 형식이어야 합니다. 예를 들면 다음과 같습니다.
```
pyenv install 3.12
```
설치가 완료되었으면 Python 3을 python 및 python3로 사용할 수 있고 pip도 설치되었는지 확인합니다.

Python을 사용할 수 있는지 확인하기 위해 다음 명령어를 실행합니다.
```
python3 --version
```
출력에 버전이 표시됩니다. Homebrew Python Formulae 페이지에서 Python Homebrew에 대해 알아본 다음 버전을 확인할 수 있습니다.

pip3를 사용할 수 있는지 확인하려면 다음 명령어를 실행합니다.
```
pip3 --version
```
설치된 경우 출력에 pip3 버전이 표시됩니다. 최신 버전의 pip3에 대한 자세한 내용은 pip 출시 노트를 참고하세요.

이전 명령어가 pip3 버전을 표시하지 않으면 pip3가 올바르게 설치되었는지 확인합니다. pip3이 설치되어 있지만 작동하지 않는 경우 다음 명령어를 사용하여 최신 버전으로 업그레이드하세요.
```
python -m pip install --upgrade pip
```
Homebrew는 플랫폼에서 이용할 수 있는 최신 버전의 Python을 설치합니다. 출력의 버전 번호는 Python의 최신 공식 출시 버전과 다를 수 있습니다.

Windows

Windows 환경에 Python을 설치하려면 Python 웹사이트에서 필요한 버전의 Python 설치 프로그램을 다운로드하세요. 자세한 내용은 Cloud de Confiance의 지원되는 Python 버전을 참고하세요.
Python 버전에 액세스하려면 Windows용 Python 런처를 사용하세요.

설치한 Python 버전을 시작하려면 다음 명령어를 실행하세요.
```
py
```
설치한 Python 3 버전을 시작하려면 다음 명령어를 실행하세요.
```
py -3
```
사용 가능한 pip 버전을 확인하려면 다음 명령어를 실행합니다.
```
py -m pip --version
```
출력에 C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages의 버전이 표시됩니다.

pip 출시 노트에서 pip의 최신 버전에 대해 알아볼 수 있습니다.

Linux

대부분의 Linux 배포판에는 최신 버전의 Python이 포함되어 있습니다.

Linux 환경에 Python을 설치하려면 배포에 적합한 패키지를 설치합니다. Debian 및 Ubuntu의 경우 이러한 패키지는 python3, python3-dev, python3-venv, python3-pip입니다.

다음 명령어를 사용하여 패키지를 설치합니다.
```
sudo apt update
sudo apt install python3 python3-dev python3-venv python3-pip
```
설치가 완료되면 pip가 설치되었는지 확인합니다.
```
pip3 --version
```
pip 출시 노트에서 pip의 최신 버전에 대해 알아볼 수 있습니다.

venv를 사용하여 종속항목 격리

venv은 격리된 Python 환경을 만드는 도구입니다. 이러한 격리된 환경은 개별적인 Python 패키지 버전을 가질 수 있으므로, 한 프로젝트의 종속 항목을 다른 프로젝트의 종속 항목으로부터 격리시킬 수 있습니다. Python을 사용해서 로컬로 개발할 때는 항상 프로젝트별로 가상 환경을 사용하는 것이 좋습니다.

venv 명령어를 사용하여 전체 Python 설치의 가상 복사본을 만듭니다. 이 가이드에서는 env라는 폴더에 가상 복사본을 만들지만, 폴더 이름을 다르게 지정할 수도 있습니다.
macOS
```
cd your-project
python -m venv env
```
Windows
```
cd your-project
py -m venv env
```
Linux
```
cd your-project
python3 -m venv env
```
가상 환경을 활성화하여 Python용 venv 경로를 사용하도록 셸을 설정합니다.
macOS
```
source env/bin/activate
```
Windows
```
.\env\Scripts\activate
```
Linux
```
source env/bin/activate
```
이제 다른 프로젝트나 전역 Python 설치에 영향을 주지 않고 패키지를 설치할 수 있습니다.
```
pip install google-cloud-storage
```
가상 환경 사용을 중지하고 전역 Python으로 돌아가려면 다음을 사용 중지할 수 있습니다.
```
deactivate
```

venv에 대한 상세 내용은 venv 문서를 참조하세요.

편집기 설치

Python 앱을 개발하려면 편집자가 필요합니다. 다음은 더 인기 있는 편집기(특정 순서 없음) 중 몇 가지입니다.

Microsoft Visual Studio Code
Sublime Text - Jon Skinner
PyCharm - JetBrains

Python용 Cloud 클라이언트 라이브러리 설치

Python용 Cloud 클라이언트 라이브러리는 Python 개발자가 Datastore 및 Cloud Storage와 같은 Cloud de Confiance 서비스와 통합하는 방법입니다. Cloud Storage와 같은 개별 API용 패키지를 설치하려면 다음과 유사한 명령어를 사용합니다.

pip install --upgrade google-cloud-storage

gcloud CLI 설치

gcloud CLI는 Cloud de Confiance용 명령줄 도구 모음입니다. 여기에는 명령줄에서 Compute Engine, Cloud Storage, BigQuery, 기타 제품 및 서비스에 액세스하기 위해 사용할 수 있는 gcloud, bq가 포함됩니다. 이러한 도구를 대화식으로 또는 자동화 스크립트를 사용하여 실행할 수 있습니다.

인증 설정

클라이언트 라이브러리를 사용하려면 먼저 인증을 설정해야 합니다.

Create local authentication credentials for your user account:

gcloud auth application-default login

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

자세한 내용은 클라이언트 라이브러리 사용을 위한 인증을 참조하세요.

다음 단계

Cloud de Confiance의 Python에 대해 자세히 알아보세요.
Google의 인증 방법을 이해합니다.
Cloud de Confiance 제품 문서를 살펴봅니다.