글로벌 데이터 스토어 사용(CLI) - Amazon ElastiCache
다운로드 및 구성 AWS CLI글로벌 데이터 스토어에서 AWS CLI 사용

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

글로벌 데이터 스토어 사용(CLI)

AWS Command Line Interface (AWS CLI)를 사용하여 명령줄에서 여러 AWS 서비스를 제어하고 스크립트를 통해 자동화할 수 있습니다. 임시(일회성) 작업에 를 AWS CLI 사용할 수 있습니다.

다운로드 및 구성 AWS CLI

는 Windows, macOS 또는 Linux에서 AWS CLI 실행됩니다. 다음 절차에 따라 다운로드 및 구성합니다.

를 다운로드, 설치 및 구성하려면 CLI

  1. AWS 명령줄 인터페이스 웹 페이지에서 AWS CLI를 다운로드합니다.

  2. CLI AWS Command Line Interface 사용 설명서의 설치 AWS CLI 및 구성 AWS 지침을 따릅니다.

글로벌 데이터 스토어에서 AWS CLI 사용

글로벌 데이터 스토어에서 작업하려면 다음 CLI 작업을 사용합니다.

  • create-global-replication-group

    aws elasticache create-global-replication-group \
   --global-replication-group-id-suffix my global datastore  \
   --primary-replication-group-id sample-repl-group  \
   --global-replication-group-description an optional description of the global datastore

    Amazon은 글로벌 데이터 스토어 ID가 생성될 때 자동으로 접두사를 ElastiCache 적용합니다. 각 AWS 리전에는 고유한 접두사가 있습니다. 예를 들어 미국 서부(캘리포니아 북부) 리전에서 생성된 글로벌 데이터 스토어 ID는 사용자가 제공한 접미사 이름과 함께 ‘virxk’로 시작합니다. 접미사는 자동으로 생성된 접두사와 결합되어 여러 리전에서 글로벌 데이터 스토어 이름의 고유성을 보장합니다.

    다음 표에는 각 AWS 리전과 해당 글로벌 데이터 스토어 ID 접두사가 나열되어 있습니다.

    리전 이름/리전 접두사 

    US East (Ohio) Region

    us-east-2

    fpkhr

    미국 동부(버지니아 북부) 리전

    us-east-1

    ldgnf

    미국 서부(캘리포니아 북부) 리전

    us-west-1

    virxk

    미국 서부(오레곤) 리전

    us-west-2

    sgaui

    캐나다(중부) 리전

    ca-central-1

    bxodz

    Asia Pacific (Mumbai) Region

    ap-south-1

    erpgt

    아시아 태평양(도쿄) 리전

    ap-northeast-1

    quwsw

    Asia Pacific (Seoul) Region

    ap-northeast-2

    lfqnh

    Asia Pacific (Osaka) Region

    ap-northeast-3

    nlapn

    아시아 태평양(싱가포르) 리전

    ap-southeast-1

    vlqxn

    아시아 태평양(시드니) 리전

    ap-southeast-2

    vbgxd

    Europe (Frankfurt) Region

    eu-central-1

    iudkw

    Europe (Ireland) Region

    eu-west-1

    gxeiz

    Europe (London) Region

    eu-west-2

    okuqm

    EU(파리) 리전

    eu-west-3

    fgjhi

    South America (São Paulo) Region

    sa-east-1

    juxlw

    중국(베이징) 리전

    cn-north-1

    emvgo

    중국(닝샤) 리전

    cn-northwest-1

    ckbem

    Asia Pacific (Hong Kong) Region

    ap-east-1

    knjmp

    AWS GovCloud (미국 서부)

    us-gov-west-1

    		 sgwui

  • create-replication-group - 이 작업을 사용하여 글로벌 데이터 스토어의 이름을 --global-replication-group-id 파라미터에 제공하여 글로벌 데이터 스토어에 대한 보조 클러스터를 생성합니다.

    aws elasticache create-replication-group \
  --replication-group-id secondary replication group name \
  --replication-group-description “Replication group description" \
  --global-replication-group-id global datastore name

    이 작업을 호출하고 --global-replication-group-id 값을 전달할 때 ElastiCache 는 다음 파라미터에 대해 전역 복제 그룹의 기본 복제 그룹에서 값을 추론합니다. 다음 파라미터에 대한 값을 전달하지 마십시오.

    "PrimaryClusterId",

    "AutomaticFailoverEnabled",

    "NumNodeGroups",

    "CacheParameterGroupName",

    "CacheNodeType",

    "Engine",

    "EngineVersion",

    "CacheSecurityGroupNames",

    "EnableTransitEncryption",

    "AtRestEncryptionEnabled",

    "SnapshotArns",

    "SnapshotName"

  • describe-global-replication-groups

    aws elasticache describe-global-replication-groups \
   --global-replication-group-id my global datastore  \
   --show-member-info an optional parameter that returns a list of the primary and secondary clusters that make up the global datastore

  • modify-global-replication-group

    aws elasticache modify-global-replication-group \
   --global-replication-group-id my global datastore  \
   --automatic-failover-enabled \
   --cache-node-type node type \
   --cache-parameter-group-name parameter group name \ 
   --engine-version engine version \
   -—apply-immediately \
   --global-replication-group-description description

    에 대한 OSS Valkey 교차 엔진 업그레이드로 재분배 ElastiCache GlobalDataStore

    콘솔 API 또는 를 사용하여 기존 Redis OSS 글로벌 복제 그룹을 Valkey 엔진으로 업그레이드할 수 있습니다CLI.

    기존 Redis OSS 글로벌 복제 그룹이 있는 경우 를 사용하여 새 엔진 및 엔진 버전을 지정하여 Valkey로 modify-global-replication-group 업그레이드할 수 있습니다API.

    Linux, macOS, Unix의 경우:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --apply-immediately \
   --engine-version 7.2

    Windows의 경우:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --apply-immediately ^
   --engine-version 7.2

    업그레이드하려는 기존 Redis OSS 글로벌 복제 그룹에 사용자 지정 캐시 파라미터 그룹이 적용된 경우 요청에서도 사용자 지정 Valkey 캐시 파라미터 그룹을 전달해야 합니다. 입력 Valkey 사용자 지정 파라미터 그룹은 기존 Redis 사용자 OSS 지정 파라미터 그룹과 동일한 Redis OSS 정적 파라미터 값을 가져야 합니다.

    Linux, macOS, Unix의 경우:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --engine-version 7.2 \
   --apply-immediately \
   --cache-parameter-group-name myParamGroup

    Windows의 경우:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --engine-version 7.2 ^
   --apply-immediately ^
   --cache-parameter-group-name myParamGroup

  • delete-global-replication-group

    aws elasticache delete-global-replication-group \
   --global-replication-group-id my global datastore  \
   --retain-primary-replication-group defaults to true

  • disassociate-global-replication-group

    aws elasticache disassociate-global-replication-group \
   --global-replication-group-id my global datastore  \
   --replication-group-id my secondary cluster  \
   --replication-group-region the AWS Region in which the secondary cluster resides

  • failover-global-replication-group

    aws elasticache failover-replication-group \
   --global-replication-group-id my global datastore \
   --primary-region The AWS Region of the primary cluster \  
   --primary-replication-group-id  The name of the global datastore, including the suffix.

  • increase-node-groups-in-global-replication-group

    aws elasticache increase-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • decrease-node-groups-in-global-replication-group

    aws elasticache decrease-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • rebalance-shards-in-global-복제-그룹

    aws elasticache rebalance-shards-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name

도움말을 사용하여 Valkey 또는 Redis 에서 에 사용할 수 ElastiCache 있는 모든 명령을 나열합니다OSS.

aws elasticache help

도움말을 사용하면 특정 명령을 설명하고 그 사용법에 대해 자세히 알아볼 수도 있습니다.

aws elasticache create-global-replication-group help