세션 어피니티(서비스) 설정

이 페이지에서는 Cloud Run 서비스 버전에 대한 세션 어피니티를 사용 설정하는 방법을 보여줍니다.

세션 어피니티 작동 방식

기본적으로 세션 어피니티는 사용 설정되어 있지 않으므로 다음과 같이 동일한 클라이언트의 요청이 다양한 인스턴스에서 처리될 수 있습니다.

세션 어피니티를 사용 설정하면 Cloud Run은 지정된 클라이언트의 순차적 요청을 동일한 버전 인스턴스로 라우팅합니다. Cloud Run은 TTL이 30일인 세션 어피니티 쿠키를 사용하고, 다음과 같이 해당 클라이언트의 값을 검사하여 동일한 클라이언트의 여러 요청을 식별하고 이러한 모든 요청을 동일한 인스턴스로 보냅니다.

알아야 할 주요 동작

위 다이어그램과 같이 세션 어피니티를 사용 설정하면 클라이언트가 동일한 인스턴스에 도달합니다. 그러나 인스턴스는 다른 클라이언트의 요청을 수신할 수 있습니다. 세션 어피니티는 인스턴스가 한 클라이언트 전용이라는 의미는 아닙니다.

Cloud Run의 자동 확장 동작으로 인해 세션 어피니티는 최선의 방식의 어피니티입니다. 어떤 이유로든 인스턴스가 종료되거나 최대 요청 동시 실행 수나 최대 CPU 사용률에 도달하면 세션 어피니티가 손상되고 추가 요청이 다른 인스턴스로 라우팅됩니다.

클라이언트 세션 데이터를 인스턴스의 메모리에 캐시할 수 있지만 클라이언트에서 세션 어피니티가 사용 설정되어 있더라도 항상 동일한 인스턴스에 다시 연결된다고 가정할 수 없습니다.

Cloud Load Balancing을 사용하는 경우 Cloud Run 서비스의 세션 어피니티는 전역 및 내부 부하 분산기의 세션 어피니티와 결합될 수 있습니다.

세션 어피니티 및 트래픽 분할

버전 수준에서 세션 어피니티를 사용 설정 또는 중지합니다. Cloud Run 버전에서 세션 어피니티를 사용 설정하고 트래픽 분할도 사용하는 경우 세션 어피니티가 트래픽 분할보다 우선합니다. 극단적으로 세션 어피니티를 사용하는 단일 클라이언트가 모든 요청의 대부분을 담당하는 경우 이러한 요청은 모두 트래픽 분할 구성에 관계없이 지정된 버전으로 라우팅될 수 있습니다.

일부 버전이 세션 어피니티를 사용 설정하고 일부 버전은 사용하지 않는 버전에 트래픽 분할을 사용 설정하면 명시적으로 트래픽 분할 구성을 변경하지 않더라도 요청이 세션 어피니티가 사용 설정된 버전으로 점진적으로 전환됩니다. 그 이유는 세션 어피니티 쿠키가 연결되지 않은 모든 요청에 무작위 분할이 적용되어 결국 일부는 세션 어피니티가 있는 버전에 할당되고 이후에 이러한 요청이 특정 버전에 유지되기 때문입니다.

Cloud Run 서비스의 트래픽 분할 구성을 업데이트할 때 세션 어피니티 쿠키가 연결된 후속 요청이 다른 버전에 할당될 수 있습니다. Cloud Run은 새 버전으로 리디렉션되는 클라이언트 수를 최소화합니다.

예를 들어 서비스가 90%/10%로 트래픽을 분할하고 트래픽 분할이 80%/20%로 업데이트된 경우, 트래픽의 10%는 현재 트래픽의 20%를 처리하는 버전으로 리디렉션됩니다.

세션 어피니티 설정

구성을 변경하면 새 버전이 생성됩니다. 이를 변경하는 명시적 업데이트가 없으면 이후 버전에도 이 구성 설정이 자동으로 적용됩니다.

세션 어피니티는 새 서비스 만들기 또는 새 버전 배포를 수행할 때 Google Cloud 콘솔, gcloud 명령줄, .yaml 파일을 사용하여 설정할 수 있습니다.

콘솔

Google Cloud 콘솔에서 Cloud Run으로 이동합니다.

Cloud Run으로 이동
배포할 새 서비스를 구성하려면 서비스 만들기를 클릭합니다. 기존 서비스를 구성하는 경우 서비스를 클릭한 후 새 버전 수정 및 배포를 클릭합니다.
새 서비스를 구성하는 경우 원하는 대로 초기 서비스 설정 페이지를 작성한 후 컨테이너, 볼륨, 네트워킹, 보안을 클릭하여 서비스 구성 페이지를 펼칩니다.
네트워킹 탭을 클릭합니다.
- 세션 어피니티 텍스트 상자를 클릭합니다.
만들기 또는 배포를 클릭합니다.

명령줄

세션 어피니티를 지정하려면 다음 명령어를 사용합니다.

gcloud run services update SERVICE --session-affinity

바꾸기

업데이트 중인 서비스 이름이 있는 SERVICE입니다.

세션 어피니티를 삭제하려면 다음 명령어를 사용합니다.

gcloud run services update SERVICE --no-session-affinity

YAML

새 서비스를 만드는 경우에는 이 단계를 건너뜁니다. 기존 서비스를 업데이트하는 경우 YAML 구성을 다운로드합니다.
```
gcloud run services describe SERVICE --format export > service.yaml
```
run.googleapis.com/sessionAffinity: 주석을 추가합니다.
```
spec:
 template:
   metadata:
     annotations:
       run.googleapis.com/sessionAffinity: 'BOOL'
```
바꾸기
- 'BOOL'을 값 'true'로 바꿔 세션 어피니티를 설정하거나 'false'로 바꿔 세션 어피니티를 삭제합니다.
다음 명령어를 사용하여 서비스를 만들거나 업데이트합니다.
```
gcloud run services replace service.yaml
```

세션 어피니티 설정 보기

Cloud Run 서비스의 현재 세션 어피니티 설정을 보려면 다음 안내를 따르세요.

콘솔

Google Cloud 콘솔에서 Cloud Run으로 이동합니다.

Cloud Run으로 이동
관심이 있는 서비스를 클릭하여 서비스 세부정보 페이지를 엽니다.
버전 탭을 클릭합니다.
오른쪽의 세부정보 패널의 세션 어피니티 설정이 네트워킹 탭 아래에 표시됩니다.

명령줄

다음 명령어를 사용하세요.
```
gcloud run services describe SERVICE
```
반환된 구성에서 세션 어피니티 설정을 찾습니다.