使用全局数据存储 (CLI) - 亚马逊 ElastiCache (RedisOSS)
正在下载和配置 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. 按照AWS Command Line Interface 用户指南中有关安装 AWS CLI 和配置 AWS CLI 的说明进行操作。

将 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

    创建全球数据存储库 ID 时，Amazon ElastiCache 会自动为其添加前缀。每个 AWS 区域都有自己的前缀。例如，在美国西部（北加利福尼亚）区域创建的全局数据存储 ID 以“virxk”和您提供的后缀名称开头。后缀与自动生成的前缀相结合，保证了全局数据存储名称在多个区域中的唯一性。

    下表列出了每个 AWS 区域及其全局数据存储 ID 前缀。

    区域名称/区域 Prefix

    美国东部（俄亥俄州）区域

    us-east-2

    fpkhr

    美国东部（弗吉尼亚州北部）区域

    us-east-1

    ldgnf

    美国西部（北加利福尼亚）区域

    us-west-1

    virxk

    美国西部（俄勒冈州）区域

    us-west-2

    sgaui

    加拿大（中部）区域

    ca-central-1

    bxodz

    亚太地区（孟买）区域

    ap-south-1

    erpgt

    Asia Pacific（Tokyo）Region

    ap-northeast-1

    quwsw

    亚太地区（首尔）区域

    ap-northeast-2

    lfqnh

    亚太地区（大阪）区域

    ap-northeast-3

    nlapn

    亚太地区（新加坡）区域

    ap-southeast-1

    vlqxn

    亚太地区（悉尼）区域

    ap-southeast-2

    vbgxd

    欧洲地区（法兰克福）区域

    eu-central-1

    iudkw

    欧洲地区（爱尔兰）区域

    eu-west-1

    gxeiz

    欧洲地区（伦敦）区域

    eu-west-2

    okuqm

    欧洲（巴黎）区域

    eu-west-3

    fgjhi

    南美洲（圣保罗）区域

    sa-east-1

    juxlw

    中国（北京）区域

    cn-north-1

    emvgo

    中国（宁夏）区域

    cn-northwest-1

    ckbem

    亚太地区（香港）区域

    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 (Redis OSS) 将从全局复制组的主复制组中推断出以下参数的值。请勿传入这些参数的值：

    "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

  • 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

使用帮助列出所有可用的命令 ElastiCache (Redis OSS)。

aws elasticache help

您还可以使用帮助来描述特定命令并了解有关其用法的详细信息：

aws elasticache create-global-replication-group help