Python 3 런타임으로 마이그레이션

Python 3 런타임으로 마이그레이션하면 최신 언어 기능을 사용하고 관용적인 코드로 이동성이 향상된 앱을 빌드할 수 있습니다. Python 3 런타임은 Python Software Foundation에서 제공하는 최신 버전의 오픈소스 Python 인터프리터를 사용합니다. Python 3 런타임에 빌드된 앱은 Python의 패키지 및 프레임워크(requirements.txt 파일에서 종속 항목을 선언하여 C 코드를 사용하는 패키지 및 프레임워크 포함)로 이루어진 풍부한 생태계를 사용할 수 있습니다.

런타임 마이그레이션 프로세스 개요

런타임 마이그레이션에 다음과 같은 점진적 방법을 사용하는 것이 좋습니다. 이 방법은 프로세스 전반에 걸쳐 작동 및 테스트 가능한 애플리케이션을 유지보수합니다.

  1. Python 2 및 Python 3과 호환되도록 앱을 업그레이드하세요.

    이 업그레이드에 유용한 몇 가지 솔루션이 있습니다. 예를 들어 Six, Python-Future 또는 Python-Modernize를 사용합니다.

    이 런타임 마이그레이션 프로세스 단계에 대한 자세한 내용은 Python Software Foundation 문서 사이트의 Porting Python 2 Code to Python 3(Python 2 코드를 Python 3로 포팅)을 참조하세요.

  2. 앱에서 사용하는 모든 App Engine 번들 서비스에 대해 다음 구현 전략 중 하나를 선택하세요.

    1. Python 2 앱의 App Engine 번들 서비스를 번들되지 않은 Google Cloud 서비스, 타사 서비스 또는 기타 권장 교체로 마이그레이션합니다.

    2. Python 3 앱에서 기존 번들 서비스를 사용합니다. 이 방식을 사용하면 나중에 마이그레이션 주기 시 번들되지 않은 서비스로 유연하게 전환할 수 있습니다.

    각 서비스를 마이그레이션한 후 앱을 테스트해야 합니다.

  3. Python 3 런타임용 App Engine 구성 파일을 준비합니다. 다음을 포함하여 여러 중요한 변경사항이 app.yaml의 구성 설정에 영향을 미칩니다.

    • 이제 앱은 스레드로부터 안전한 것으로 간주됩니다. 애플리케이션이 스레드 안전이 아닌 경우 app.yaml의 max_concurrent_requests를 1로 설정해야 합니다. 이 설정으로 인해 스레드 안전 앱에 필요한 것보다 더 많은 인스턴스가 생성될 수 있으며 불필요한 비용이 발생할 수 있습니다.

    • app.yaml 파일이 더 이상 요청을 스크립트로 라우팅하지 않습니다. 대신 인앱 라우팅이 포함된 웹 프레임워크를 사용하고 app.yaml의 모든 script 핸들러를 업데이트하거나 삭제해야 합니다. Flask 프레임워크로 이 작업을 수행하는 방법의 예시는 GitHub의 App Engine 마이그레이션 가이드 코드 샘플을 참조하세요.

      이 구성 파일과 다른 구성 파일 변경에 대한 자세한 내용은 구성 파일 섹션을 참조하세요.

  4. Python 3 환경에서 업그레이드된 앱을 테스트 및 배포합니다.

    모든 테스트를 통과한 후 업그레이드된 앱을 App Engine에 배포하되 트래픽이 새 버전으로 자동 라우팅되지 않도록 합니다. 트래픽 분할을 사용하여 Python 2 런타임의 앱에서 Python 3 런타임의 앱으로 트래픽을 천천히 마이그레이션합니다. 문제가 발생하면 문제가 해결될 때까지 모든 트래픽을 정식 버전으로 라우팅하세요.

Python 2 앱을 Python 3로 변환하는 방법의 예시는 추가 리소스를 참조하세요.

Python 2 런타임과 Python 3 런타임의 주요 차이점

Python 2와 Python 3 런타임에는 다음과 같은 차이점이 있으며 런타임 마이그레이션 시 필요한 변경사항 대부분은 이 차이점에서 비롯됩니다.

Python 2와 Python 3 사이의 호환성 문제

Python 3이 2008년 처음 출시되었을 당시 여러 가지 이전 버전과 호환되지 않는 변경사항이 언어에 도입되었습니다. 이러한 변경사항 중 일부는 print 문을 print() 함수로 바꾸는 등 사소한 코드 업데이트를 수행해야 합니다. 기타 변경사항은 바이너리 데이터, 텍스트, 문자열을 처리하는 방법을 업데이트하는 등 코드를 대폭 업데이트해야 할 수 있습니다.

Python 표준 라이브러리를 비롯한 널리 사용되는 여러 오픈소스 라이브러리도 Python 2에서 Python 3으로 이동할 때 변경되었습니다.

Python 3 런타임의 App Engine 번들 서비스

마이그레이션과 복잡성을 줄이기 위해 App Engine 표준 환경에서는 Python 3 런타임에서 Memcache와 같은 여러 기존 번들 서비스 및 API에 액세스할 수 있습니다. Python 3 앱은 언어 관용구 라이브러리를 통해 번들 서비스 API를 호출할 수 있으며 Python 2 런타임에서와 같이 동일한 기능에 액세스할 수 있습니다.

기존 번들 서비스와 비슷한 기능을 제공하는 Google Cloud 제품을 사용할 수도 있습니다. 번들되지 않은 Google Cloud 제품으로 마이그레이션하는 것이 좋습니다. 지속적인 개선과 새로운 기능을 활용할 수 있기 때문입니다.

이미지 처리, 검색, 메시징과 같은 Google Cloud에서 별도의 제품으로 제공되지 않는 번들 서비스의 경우 Google에서 권장하는 타사 제공업체 또는 다른 해결 방법을 사용할 수 있습니다.

구성 파일

App Engine 표준 환경의 Python 3 런타임에서 앱을 실행하려면 App Engine에서 사용하는 구성 파일의 일부를 변경해야 할 수도 있습니다.

동적 콘텐츠 요청을 라우팅하는 데 필요한 웹 프레임워크

Python 2 런타임에서 app.yaml 파일에 URL 핸들러를 만들어 특정 URL 또는 URL 패턴이 요청될 때 실행할 앱을 지정할 수 있습니다.

Python 3 런타임에서 앱은 app.yaml에서 URL 핸들러를 사용하는 대신 Flask 또는 Django와 같은 웹 프레임워크를 사용하여 동적 콘텐츠 요청을 라우팅해야 합니다. 정적 콘텐츠의 경우 앱의 app.yaml 파일에서 URL 핸들러 생성을 계속할 수 있습니다.

테스트

dev_appserver에 의존하지 않고 Python에 관용적인 테스트 방법을 사용하는 것이 좋습니다. 예를 들어 venv를 사용하여 격리된 로컬 Python 3 환경을 만들 수 있습니다. 모든 표준 Python 테스트 프레임워크를 사용하여 단위 테스트, 통합 테스트, 시스템 테스트를 작성할 수 있습니다. 서비스의 개발 버전을 설정하거나 많은 Google Cloud 제품에서 사용할 수 있는 로컬 에뮬레이터를 사용할 수도 있습니다.

선택적으로 Python 3을 지원하는 dev_appserver의 미리보기 버전을 사용할 수 있습니다. 이 테스트 기능에 대한 자세한 내용은 로컬 개발 서버 사용을 참조하세요.

배포

appcfg.py를 통한 배포는 Python 3에서 지원되지 않습니다. 대신 gcloud 명령줄 도구를 사용하여 앱을 배포합니다.

로깅

Python 3 런타임의 로깅은 Cloud Logging의 로깅 표준을 따릅니다. Python 3 런타임에서 앱 로그는 더 이상 요청 로그와 번들로 묶이지 않고 다른 레코드로 분리됩니다. Python 3 런타임에서 로그를 읽고 쓰는 방법에 대한 자세한 내용은 로깅 가이드를 참조하세요.

추가 마이그레이션 리소스

App Engine 앱을 독립형 Cloud 서비스 또는 Python 3 런타임으로 마이그레이션하는 방법에 대한 자세한 내용은 다음 App Engine 리소스를 참조하세요.