WebSocket으로 영구 연결 만들기

리전 ID

REGION_ID는 앱을 만들 때 선택한 리전을 기준으로 Google에서 할당하는 축약된 코드입니다. 일부 리전 ID는 일반적으로 사용되는 국가 및 주/도 코드와 비슷하게 표시될 수 있지만 코드는 국가 또는 주/도와 일치하지 않습니다. 2020년 2월 이후에 생성된 앱의 경우 REGION_ID.r이 App Engine URL에 포함됩니다. 이 날짜 이전에 만든 기존 앱의 경우 URL에서 리전 ID는 선택사항입니다.

리전 ID에 대해 자세히 알아보세요.

WebSockets를 사용하여 클라이언트(휴대기기나 컴퓨터 등)에서 App Engine 인스턴스로의 영구 연결을 만들 수 있습니다. 개방형 연결은 언제든지 클라이언트와 서버 간의 양방향 데이터 교환을 허용함으로써 지연 시간을 단축하고 리소스를 더 효율적으로 사용할 수 있도록 합니다.

WebSockets

RFC 6455에 정의된 WebSockets 프로토콜은 클라이언트와 서버 간의 전이중 통신 채널을 제공합니다. 채널은 'upgrade' 헤더가 있는 HTTP(S) 요청으로 시작됩니다.

WebSockets의 일반적인 사용 사례는 다음과 같습니다.

  • 소셜 미디어 피드, 스포츠 점수, 뉴스, 주가 등의 실시간 이벤트 업데이트
  • 소프트웨어, 콘텐츠 업데이트 등의 사용자 알림
  • 채팅 애플리케이션
  • 협업 편집 도구
  • 멀티플레이어 게임

WebSockets는 추가적인 설정 없이 애플리케이션에서 항상 사용할 수 있습니다. 설정된 WebSockets 연결은 1시간 후에 타임아웃됩니다.

WebSockets로 샘플 애플리케이션 실행

먼저 App Engine의 .NET용 'Hello, World!'의 안내에 따라 환경과 프로젝트를 설정하고 App Engine.NET 앱의 구조에 대해 알아봅니다.

샘플 앱 클론

샘플 앱을 로컬 머신에 복사한 후 websockets 디렉터리로 이동합니다.

git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples
cd dotnet-docs-samples/appengine/flexible/WebSocket/

로컬에서 샘플 실행

로컬 컴퓨터에서 Hello World 앱을 실행하는 방법은 다음과 같습니다.

  1. .NET Core SDK 버전 2.2 이상을 설치합니다.

  2. PowerShell에서 다음 명령어를 실행합니다.

     dotnet restore
     dotnet run
    
  3. 웹브라우저에 다음 주소를 입력합니다.

     http://localhost:5000/chat
    

App Engine에서 샘플 배포 및 실행

App Engine 가변형 환경에 애플리케이션을 배포하려면 app.yaml가 위치한 디렉터리에서 다음 명령어를 실행합니다.

gcloud beta app deploy .\bin\Debug\netcoreapp2.2\publish\app.yaml

세션 어피니티

모든 클라이언트가 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