WebSockets를 사용하여 클라이언트(휴대기기나 컴퓨터 등)에서 App Engine 인스턴스로의 영구 연결을 만들 수 있습니다. 개방형 연결은 언제든지 클라이언트와 서버 간의 양방향 데이터 교환을 허용함으로써 지연 시간을 단축하고 리소스를 더 효율적으로 사용할 수 있도록 합니다.
WebSockets
RFC 6455에 정의된 WebSockets 프로토콜은 클라이언트와 서버 간의 전이중 통신 채널을 제공합니다. 채널은 'upgrade' 헤더가 있는 HTTP(S) 요청으로 시작됩니다.
WebSockets의 일반적인 사용 사례는 다음과 같습니다.
- 소셜 미디어 피드, 스포츠 점수, 뉴스, 주가 등의 실시간 이벤트 업데이트
- 소프트웨어, 콘텐츠 업데이트 등의 사용자 알림
- 채팅 애플리케이션
- 협업 편집 도구
- 멀티플레이어 게임
WebSockets는 추가적인 설정 없이 애플리케이션에서 항상 사용할 수 있습니다. 설정된 WebSockets 연결은 1시간 후에 타임아웃됩니다. WebSocket 사용 요금은 제한 시간이나 소켓 종료까지의 연결 사용량에 따라 청구됩니다.
WebSockets로 샘플 애플리케이션 실행
기본 요건 및 설정
이 문서의 코드 샘플은 Python 런타임 버전 3.7 이하용 WebSocket으로 샘플 애플리케이션을 실행하는 방법을 설명합니다. Python 버전 3.8 이상의 경우 최신 버전 사용에 대한 자세한 내용은 Python 런타임을 참조하세요.
개발 환경 설정의 안내에 따라 환경과 프로젝트를 설정하고 앱이 구조화되는 방식을 이해합니다.
샘플 앱 클론
샘플 앱을 로컬 머신에 복사한 후 websockets 디렉터리로 이동합니다.
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible_python37_and_earlier/websockets/
로컬에서 샘플 실행
로컬에서 실행하려면 Gunicorn을 flask_socket 작업자와 함께 사용해야 합니다.
$ gunicorn -b 127.0.0.1:8080 -k flask_sockets.worker main:app
App Engine에서 샘플 배포 및 실행
App Engine 가변형 환경에 애플리케이션을 배포하려면 app.yaml가 위치한 디렉터리에서 다음 명령어를 실행합니다.
gcloud app deploy
그런 다음 브라우저를 https://PROJECT_ID.REGION_ID.r.appspot.com으로 이동할 수 있습니다.
세션 어피니티
모든 클라이언트가 WebSockets를 지원하는 것은 아닙니다. 이를 해결하기 위해 많은 애플리케이션은 WebSockets를 지원하지 않는 클라이언트에서 http 장기 폴링으로 대체하는 socket.io와 같은 라이브러리를 사용합니다.
일반적으로 App Engine은 요청을 사용 가능한 인스턴스 간에 균등하게 분배합니다. 하지만 http 장기 폴링을 사용할 때는 특정 사용자의 여러 순차적 요청이 동일 인스턴스에 전달되어야 합니다.
App Engine이 동일 사용자의 요청을 동일 인스턴스에 보낼 수 있도록 하기 위해 세션 어피니티를 사용 설정할 수 있습니다. 그러면 App Engine이 쿠키를 조사하여 동일 사용자가 보낸 요청을 식별하고 해당 요청을 동일 인스턴스에 라우팅합니다.
App Engine에서 세션 어피니티는 최선의 방식으로 실행됩니다. 앱을 개발할 때는 항상 세션 어피니티가 보장되지 않는다고 가정해야 합니다. 다음과 같은 시나리오에서 클라이언트가 대상 인스턴스와의 어피니티를 잃을 수 있습니다.
- 애플리케이션을 제공하는 인스턴스를 App Engine 자동 확장 처리가 추가하거나 삭제할 수 있습니다. 이 애플리케이션은 부하를 재할당할 수 있으며, 대상 인스턴스가 이동할 수도 있습니다. 이 위험을 최소화하기 위해 예상 부하를 처리하기 위한 최소 인스턴스 수를 설정해야 합니다.
- 대상 인스턴스가 상태 확인에 실패할 경우 App Engine은 세션을 정상 인스턴스로 이동합니다. 상태 확인 및 맞춤설정 옵션에 대한 자세한 내용은 분할 상태 확인을 참조하세요.
- 유지보수 또는 소프트웨어 업데이트를 위해 인스턴스가 재부팅될 때 세션 어피니티가 손실됩니다. App Engine 가변형 환경 VM 인스턴스는 매주 다시 시작됩니다.
세션 어피니티는 보장되지 않으므로 연결이 끊어진 경우에만 socket.io 및 기타 라이브러리를 사용하여 HTTP 장기 폴링으로 대체해야 합니다. 스테이트풀(Stateful) 애플리케이션을 빌드하는 데 세션 어피니티를 사용해서는 안 됩니다.
세션 어피니티 사용 설정 및 중지
기본적으로 세션 어피니티는 모든 App Engine 애플리케이션에 대해 비활성화되어 있습니다. 세션 어피니티는 애플리케이션의 버전 수준에서 설정되며 배포 시 사용 설정되거나 중지될 수 있습니다.
App Engine 버전에 세션 어피니티를 사용 설정하려면 app.yaml 파일에 다음 항목을 추가합니다.
network:
session_affinity: true
업데이트된 app.yaml과 함께 버전이 배포되면 새 요청이 동일 인스턴스에서 제공되기 시작합니다. 단, 해당 인스턴스가 사용 가능한 상태여야 합니다.
세션 어피니티를 중지하려면 app.yaml 파일에서 항목을 삭제하거나 값을 false로 설정합니다.
network:
session_affinity: false