Python 3.8이 이제 일반 안정화 버전으로 제공됩니다.

Memorystore로 데이터 캐싱

확장 가능한 고성능 웹 애플리케이션은 특정 태스크에 대해 분산형 메모리 내 데이터 캐시를 견고한 영구 스토리지 앞에 두거나 아예 대체하여 사용하는 경우가 많습니다. Redis용 Memorystore를 캐싱 서비스로 사용하는 것이 좋습니다. Redis용 Memorystore는 무료 등급을 제공하지 않습니다. 자세한 내용은 Memorystore 가격 책정을 참조하세요.

시작하기 전에 앱이 Redis용 Memorystore 할당량 내에 있는지 확인합니다.

메모리 캐시를 사용하는 경우

세션 데이터, 사용자 환경설정, 웹페이지의 쿼리를 통해 반환되는 기타 데이터도 캐시하기에 적절한 대상입니다. 일반적으로 자주 실행되는 쿼리가 앱에 즉시 표시할 필요가 없는 일련의 결과를 반환하는 경우 이 결과를 캐시할 수 있습니다. 후속 요청에서는 캐시를 확인하여 결과가 없거나 만료된 경우에만 데이터베이스를 쿼리합니다.

다른 영구 스토리지에 백업하지 않고 Memcache에만 값을 저장할 경우 값이 만료되어 캐시에서 삭제되면 애플리케이션이 정상적으로 동작하는지 확인해야 합니다. 예를 들어 사용자의 세션 데이터가 갑자기 사라져서 세션이 오작동하는 경우 세션 데이터를 Memorystore 외에 데이터베이스에도 저장해야 합니다.

Memorystore 권한 이해하기

Google Cloud 서비스와의 모든 상호작용은 승인을 받아야 합니다. 예를 들어 Memorystore에서 호스팅되는 Redis 데이터베이스와 상호작용하려면 앱에서 Memorystore에 액세스하도록 승인된 계정의 사용자 인증 정보를 제공해야 합니다.

기본적으로 앱은 앱과 동일한 프로젝트에 있는 데이터베이스에 액세스하도록 승인된 App Engine 기본 서비스 계정의 사용자 인증 정보를 제공합니다.

다음 조건 중 하나라도 해당하는 경우 사용자 인증 정보를 명시적으로 제공하는 대체 인증 기술을 사용해야 합니다.

  • 앱과 Memorystore 데이터베이스가 다른 Google Cloud 프로젝트에 있는 경우

  • 기본 App Engine 서비스 계정에 할당된 역할이 변경된 경우

대체 인증 기술에 대한 자세한 내용은 서버 간 프로덕션 애플리케이션용 인증 설정을 참조하세요.

Memorystore 사용 개요

앱에서 Memorystore를 사용하려면 다음 안내를 따르세요.

  1. Redis용 Memorystore를 설정합니다. 이를 위해서는 Memorystore에 Redis 인스턴스를 만들고 앱에서 Redis 인스턴스와 통신하는 데 사용하는 서버리스 VPC 액세스를 만들어야 합니다.

  2. Redis용 클라이언트 라이브러리를 설치하고 Redis 명령어를 사용하여 데이터를 캐시합니다.

    Redis용 Memorystore는 모든 Redis용 클라이언트 라이브러리와 호환됩니다. 이 가이드에서는 redis-py 3.0 클라이언트 라이브러리를 사용하여 앱에서 Redis 명령어를 전송하는 방법을 설명합니다.

  3. 업데이트를 테스트합니다.

  4. App Engine에 앱을 배포합니다.

Memorystore for Redis 설정

Memorystore for Redis를 설정하려면 다음 안내를 따르세요.

  1. Memorystore에서 Redis 인스턴스를 만듭니다.

    Redis 인스턴스의 리전을 선택하라는 메시지가 표시되면 App Engine 앱이 있는 리전과 동일한 리전을 선택합니다.

  2. 만들려는 Redis 인스턴스의 IP 주소와 포트 번호를 기록합니다. 이 정보는 코드에서 Redis 클라이언트를 만들 때 사용됩니다.

  3. App Engine을 VPC 네트워크에 연결합니다. 앱은 VPC 커넥터를 통해서만 Memorystore와 통신할 수 있습니다.

    앱에서 커넥터를 사용하도록 구성의 설명대로 VPC 연결 정보를 app.yaml 파일에 추가해야 합니다.

종속 항목 설치

App Engine에서 앱을 실행할 때 앱에 redis-py 클라이언트 라이브러리를 앱에서 사용할 수 있도록 만들려면 앱의 requirements.txt 파일에 다음 줄을 추가합니다.

  redis

App Engine Python 3 런타임은 앱을 배포할 때 앱의 requirements.txt 파일을 자동으로 업로드합니다.

로컬 개발의 경우 venv와 같은 가상 환경에 종속 항목을 설치하는 것이 좋습니다.

Redis 클라이언트 만들기

Redis 데이터베이스와 상호작용하려면 코드에서 Redis 클라이언트를 만들어 Redis 데이터베이스에 대한 연결을 관리해야 합니다. 다음 섹션에서는 redis-py 클라이언트 라이브러리를 사용하여 Redis 클라이언트를 만드는 방법을 설명합니다.

환경 변수 지정

redis-py 클라이언트 라이브러리는 두 가지 환경 변수를 사용하여 Redis 데이터베이스의 URL을 어셈블합니다.

  • Memorystore에 만든 Redis 데이터베이스의 IP 주소를 식별하는 변수입니다.
  • Memorystore에 만든 Redis 데이터베이스의 포트 번호를 식별하는 변수입니다.

이러한 변수를 코드에서 직접 정의하는 대신 앱의 app.yaml 파일에서 정의하는 것이 좋습니다. 이렇게 하면 로컬 환경 및 App Engine과 같은 다양한 환경에서 앱을 간편하게 실행할 수 있습니다.

예를 들어 app.yaml 파일에 다음 줄을 추가합니다.

 env_variables:
      REDISHOST: '10.112.12.112'
      REDISPORT: '6379'

redis-py 가져오기 및 클라이언트 만들기

REDISHOSTREDISPORT 환경 변수를 정의한 후 다음 줄을 사용하여 redis-py 라이브러리를 가져오고 클라이언트를 만듭니다.

  import redis

  redis_host = os.environ.get('REDISHOST', 'localhost')
  redis_port = int(os.environ.get('REDISPORT', 6379))
  redis_client = redis.Redis(host=redis_host, port=redis_port)

다른 앱에 이전 버전의 redis-py를 사용했다면 Client 대신 StrictClient 클래스를 사용한 것일 수 있습니다. 하지만 현재 redis-py에서는 StrictClient 대신에 Client를 사용하는 것이 좋습니다.

Redis 명령어를 사용하여 캐시에 데이터 저장 및 검색

Memorystore Redis 데이터베이스는 대부분의 Redis 명령어를 지원하지만 그 중 몇 가지 명령어만 사용하여 캐시에서 데이터를 저장 및 검색해야 합니다. 다음 표에는 데이터를 캐시하는 데 사용할 수 있는 Redis 명령어가 나와 있습니다. 앱에서 이러한 명령어를 호출하는 방법은 클라이언트 라이브러리의 문서를 참조하세요.

태스크 Redis 명령어
데이터 캐시에 항목을 만들고
항목의 만료 시간 설정
SETNX
MSETNX
캐시에서 데이터 검색 GET
MGET
기존 캐시 값 바꾸기 SET
MSET
숫자 캐시 값 증가 또는 감소 INCR
INCRBY
DECR
DECRBY
캐시에서 항목 삭제 DEL
UNLINK
캐시와 동시 상호작용 지원 Redis 트랜잭션에 대한 세부정보를 참조하세요. redis-py 클라이언트 라이브러리를 사용하려면 모든 트랜잭션이 파이프라인에서 발생해야 합니다.

업데이트 테스트

앱을 로컬에서 테스트할 때는 프로덕션 데이터와의 상호작용을 방지하기 위해 Redis의 로컬 인스턴스를 실행하는 것이 좋습니다(Memorystore는 에뮬레이터를 제공하지 않음). Redis를 로컬에 설치 및 실행하려면 Redis 문서의 안내를 따르세요. 현재 Windows에서는 Redis를 로컬에서 실행할 수 없습니다.

Python 3 앱 테스트에 대한 자세한 내용은 애플리케이션 테스트 및 배포를 참조하세요.

앱 배포

앱이 로컬 개발 서버에서 오류 없이 실행되면 다음을 수행합니다.

  1. App Engine에서 앱을 테스트합니다.

  2. 앱이 오류 없이 실행되면 트래픽 분할을 사용하여 업데이트된 앱의 트래픽을 천천히 늘립니다. 앱을 면밀히 모니터링하여 데이터베이스에 문제가 없는 것을 확인한 후 더 많은 트래픽을 업데이트된 앱으로 라우팅합니다.