Memorystore를 사용하여 Redis 캐시에 연결

Cloud Run 서비스에 분산형 인메모리 데이터 캐시를 설정하려면 Redis용 Memorystore를 사용합니다. Redis용 Memorystore를 사용하면 인메모리 Redis 데이터 스토어를 사용하여 규모에 맞춰 보안성과 고가용성이 보장된 애플리케이션 캐시를 저장할 수 있습니다. Cloud Run 서비스에서 직접 Redis 인스턴스에 연결할 수 있지만 이를 위해서는 서버리스 VPC 액세스 커넥터를 설정하는 추가 단계가 필요합니다.

이 페이지에 설명된 Cloud Run 통합(프리뷰)을 사용하면 서버리스 VPC 액세스 커넥터를 설정할 필요 없이 Memorystore를 사용하여 Cloud Run 서비스를 새로운 Redis 캐시에 빠르게 연결할 수 있습니다. Cloud Run 서비스를 기존 redis 인스턴스에 연결하려면 Cloud Run 서비스에서 Redis 인스턴스에 연결을 참조하세요.

시작하기 전에

  • 통합하려는 Cloud Run 서비스가 이미 배포되었는지 확인합니다.
  • Memorystore 가격 책정 페이지를 검토합니다. 통합에 사용되는 개별 리소스에 대해 요금이 청구됩니다.

필요한 역할

Cloud Run 통합을 사용하려면 사용자 또는 관리자가 두 가지 서로 다른 주 구성원에 IAM 역할을 부여해야 합니다.

Google 계정에 필요한 역할을 보려면 클릭하세요.

Cloud Run 통합을 사용하는 데 필요한 권한을 얻으려면 관리자에게 Google 계정에 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

클릭하여 서비스 계정에 필요한 역할 보기

Cloud Run 서비스를 배포하려면 자동 생성된 Compute Engine 기본 서비스 계정을 사용하거나 사용자 관리 서비스 계정을 지정하면 됩니다. 서비스 계정에는 다음 역할이 있어야 합니다.

새 Redis 캐시에 서비스 연결

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

콘솔 또는 명령줄을 사용하여 Redis 캐시에 Cloud Run 서비스를 연결할 수 있습니다. 메모리 크기를 지정하지 않으면 캐시 1GB가 사용됩니다.

Console

  1. Google Cloud 콘솔에서 Cloud Run 페이지로 이동합니다.

    Cloud Run으로 이동

  2. 서비스 목록에서 이 통합에서 사용할 서비스를 클릭합니다.

  3. Integrations 탭을 클릭합니다.

  4. 통합 추가를 클릭합니다.

  5. Redis - Google Cloud MemoryStore를 클릭합니다.

    이미지

  6. 기본값을 그대로 사용하거나 이름과 캐시 크기를 사용하려는 값으로 변경합니다.

  7. API 목록을 사용 설정하라는 메시지가 표시되면 사용 설정을 클릭하고 API가 사용 설정될 때까지 기다립니다.

  8. 리소스에서 이 통합으로 인해 생성되는 새 리소스를 확인합니다.

  9. 제출을 클릭하고 통합 및 리소스가 생성될 때까지 기다립니다. 최대 15분이 걸릴 수 있습니다.

명령줄

  1. 최신 Google Cloud CLI로 업데이트합니다.

    gcloud components update

  2. 통합을 만듭니다.

    gcloud beta run integrations create \
--type=redis \
--service=SERVICE \
--parameters=memory-size-gb=MEMORY-SIZE

    다음과 같이 바꿉니다.

    • SERVICE를 Cloud Run 서비스 이름으로 바꿉니다.
    • MEMORY-SIZE를 원하는 캐시 크기(GB)로 바꿉니다. 기본값은 1GB입니다.

    선택적으로 --service-account=SERVICE_ACCOUNT_EMAIL 플래그를 포함합니다.

    • SERVICE_ACCOUNT_EMAIL을 서비스를 배포하는 데 사용되는 사용자 관리 서비스 계정 이메일 주소(PROJECT_NUMBER-compute@developer.gserviceaccount.com)로 바꿉니다. 기본 컴퓨팅 서비스 계정(SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com)을 사용하려면 이 플래그를 생략합니다.

      Cloud Run 통합을 배포할 때 지정된 서비스 계정을 계속 사용하려면 다음을 실행합니다.

      gcloud config set runapps/deployment-service-account

  3. 완전히 구성된 Redis 캐시가 생성되고 연결되기를 최대 15분 동안 기다립니다. 또한 Redis 캐시에 필요한 네트워킹 구성 및 환경 변수를 포함하는 새로운 Cloud Run 버전이 생성됩니다. 프로세스가 완료되면 다음 메시지가 표시됩니다.

    [redis] integration [redis-xxx] has been updated successfully.

To connect to the Redis instance, utilize the environment variables
REDISHOST and REDISPORT. These have been added to the Cloud Run service
for you.

    gcloud beta run integrations describe를 사용하여 상태를 확인할 수 있습니다.

Redis 캐시 통합 업데이트

통합을 업데이트하면 해당 통합과 연결된 모든 Google Cloud 리소스가 업데이트됩니다. Cloud Run 서비스에서 Redis 캐시 통합을 업데이트하려면 다음 안내를 따르세요.

Console

  1. Google Cloud 콘솔에서 Cloud Run 페이지로 이동합니다.

    Cloud Run으로 이동

  2. 업데이트할 서비스를 클릭합니다.

  3. Integrations 탭을 클릭합니다.

  4. Redis 캐시 통합을 찾고 수정을 클릭합니다.

  5. 필드 업데이트를 마쳤으면 업데이트를 클릭합니다.

명령줄

  1. 다음 명령어를 사용하여 사용 가능한 통합 목록을 가져옵니다.

    gcloud beta run integrations list

  2. 명령어를 실행하여 통합을 업데이트합니다.

    gcloud beta run integrations update INTEGRATION_NAME

    다음과 같이 바꿉니다.

    • INTEGRATION_NAME을 Redis 캐시 통합의 이름으로 바꿉니다.

    선택적으로 다음 플래그 옵션을 사용할 수 있습니다.

    옵션 설명
    --parameters 캐시의 메모리 크기(GB)입니다.
    --service-account 서비스를 업데이트할 때 지정할 사용자 관리 서비스 계정 이메일 주소입니다. 이 서비스 계정은 배포 시 사용된 이전 서비스 계정을 재정의합니다.

Redis 캐시 통합 보기

Cloud Run 서비스에 대한 Redis 캐시 통합의 현재 상태를 보려면 다음 안내를 따르세요.

Console

  1. Google Cloud 콘솔에서 Cloud Run 페이지로 이동합니다.

    Cloud Run으로 이동

  2. 서비스 목록에서 이 통합에서 사용할 서비스를 클릭합니다.

  3. Integrations 탭을 클릭합니다.

  4. 관심 있는 Redis 캐시 통합을 찾아 세부정보 보기를 클릭합니다.

명령줄

  1. 다음 명령어를 사용하여 사용 가능한 통합 목록을 가져옵니다.

    gcloud beta run integrations list

  2. 반환된 목록의 이름을 사용하여 세부정보를 표시합니다.

    gcloud beta run integrations describe INTEGRATION_NAME

    INTEGRATION_NAME을 Redis 캐시 통합의 이름으로 바꿉니다.

Redis 캐시 통합 삭제

통합을 삭제하면 해당 통합에 연결된 모든 Google Cloud 리소스도 삭제되지만 Cloud Run 서비스는 삭제되지 않습니다.

Cloud Run 서비스에서 Redis 캐시 통합을 삭제하려면 다음 안내를 따르세요.

Console

  1. Google Cloud 콘솔에서 Cloud Run 페이지로 이동합니다.

    Cloud Run으로 이동

  2. 통합을 삭제하려는 서비스를 클릭합니다.

  3. Integrations 탭을 클릭합니다.

  4. 관심 있는 Redis 캐시 통합을 찾고 통합 오른쪽에 있는 줄임표 아이콘을 클릭한 다음 삭제를 클릭합니다.

명령줄

  1. 다음 명령어를 사용하여 사용 가능한 통합 목록을 가져옵니다.

    gcloud beta run integrations list

  2. 반환된 목록의 이름을 사용하여 통합을 삭제합니다.

    gcloud beta run integrations delete INTEGRATION_NAME

    다음과 같이 바꿉니다.

    • INTEGRATION_NAME을 Redis 캐시 통합의 이름으로 바꿉니다.

    선택적으로 다음 플래그 옵션을 사용할 수 있습니다.

    옵션 설명
    --service-account 삭제 작업을 수행할 사용자 관리 서비스 계정 이메일 주소입니다.

코드에서 Redis 캐시에 액세스

이 페이지에서 설명하는 통합을 완료하면 REDISHOST 및 REDISPORT 환경 변수가 자동으로 추가되며 Cloud Run 서비스 코드에서 해당 환경 변수를 사용할 수 있습니다.

Redis를 사용하는 서비스용 샘플 코드

Memorystore 문서에서 Redis를 사용하는 여러 언어로 작성된 전체 Cloud Run 및 Redis 코드 샘플을 참조하세요.

제한사항