@aws-cdk/aws-globalaccelerator

中文文档
1.204.0发布于 2023/06/20Apache-2.0TypeScriptCommonJS近 30 天下载 11万

AWS 的 CDK 构建库: 全球加速器

此软件包已被标记为弃用

AWS CDK v1 has reached End-of-Support on 2023-06-01. This package is no longer being updated, and users should migrate to AWS CDK v2. For more information on how to migrate, see https://docs.aws.amazon.com/cdk/v2/guide/migrating-v2.html

中文使用文档
文档目录9 节
  1. 导言
  2. 示例
  3. 概念
  4. 终点类型
  5. 应用程序负载平衡器
  6. 网络负载平衡器
  7. EC2 实例
  8. 弹性 IP 地址
  9. 客户端 IP 地址保存和安全组

AWS: 全球加速器构建库


End-of-Support

AWS CDK v1在2023-06-01上达到了支持结束. 此软件包不再更新,用户应该迁移到 AWS CDK v2.

关于如何移徙的更多信息,请参见: 移动到 AWS CDK v2 指南。 。 。 .


导言

AWS Global Accelerator(AGA)是一种服务,可以改善可用性并改进服务 用于本地或全局用户的应用程序.

它拦截了用户在靠近边缘位置的网络连接 它们,并引导它到 一个潜在的多重,冗余的后端 更可靠、更不拥挤的AWS全球网络.

AGA 可用于路由流量到应用程序负载平衡器, 网络负载 平衡器,EC2实例和弹性IP地址.

更多信息,请参见 AWS 全球 加速开发者指南。 。 。 .

示例

以下是为两个应用程序加载设置全球加速器的例子 两个不同AWS区域的平衡器:

// Create an Accelerator
const accelerator = new globalaccelerator.Accelerator(this, 'Accelerator');

// Create a Listener
const listener = accelerator.addListener('Listener', {
  portRanges: [
    { fromPort: 80 },
    { fromPort: 443 },
  ],
});

// Import the Load Balancers
const nlb1 = elbv2.NetworkLoadBalancer.fromNetworkLoadBalancerAttributes(this, 'NLB1', {
  loadBalancerArn: 'arn:aws:elasticloadbalancing:us-west-2:111111111111:loadbalancer/app/my-load-balancer1/e16bef66805b',
});
const nlb2 = elbv2.NetworkLoadBalancer.fromNetworkLoadBalancerAttributes(this, 'NLB2', {
  loadBalancerArn: 'arn:aws:elasticloadbalancing:ap-south-1:111111111111:loadbalancer/app/my-load-balancer2/5513dc2ea8a1',
});

// Add one EndpointGroup for each Region we are targeting
listener.addEndpointGroup('Group1', {
  endpoints: [new ga_endpoints.NetworkLoadBalancerEndpoint(nlb1)],
});
listener.addEndpointGroup('Group2', {
  // Imported load balancers automatically calculate their Region from the ARN.
  // If you are load balancing to other resources, you must also pass a `region`
  // parameter here.
  endpoints: [new ga_endpoints.NetworkLoadBalancerEndpoint(nlb2)],
});

概念

这个 加速器 构造定义了全球加速器资源.

加速器包括一个或多个 听众 接受入境 在一个或多个端口上连接.

每个听众都有一个或一个以上 终点组,表示多个 您申请的地理分布。 有一个终点 每区组,用户流量默认会与最接近的区域接通.

端点组由一个或多个组成 终点,这里是 用户流量进入收听器 最终发送。 端点端口 和收听器的流量一样 除非被推翻.

终点类型

终点有4个类型,可以在 @aws-cdk/aws-globalaccelerator-endpoints 软件包 :

  • 应用程序负载平衡器
  • 网络负载平衡器
  • EC2 实例
  • 弹性 IP 地址

应用程序负载平衡器

declare const alb: elbv2.ApplicationLoadBalancer;
declare const listener: globalaccelerator.Listener;

listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.ApplicationLoadBalancerEndpoint(alb, {
      weight: 128,
      preserveClientIp: true,
    }),
  ],
});

网络负载平衡器

declare const nlb: elbv2.NetworkLoadBalancer;
declare const listener: globalaccelerator.Listener;

listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.NetworkLoadBalancerEndpoint(nlb, {
      weight: 128,
    }),
  ],
});

EC2 实例

declare const listener: globalaccelerator.Listener;
declare const instance: ec2.Instance;

listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.InstanceEndpoint(instance, {
      weight: 128,
      preserveClientIp: true,
    }),
  ],
});

弹性 IP 地址

declare const listener: globalaccelerator.Listener;
declare const eip: ec2.CfnEIP;

listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.CfnEipEndpoint(eip, {
      weight: 128,
    }),
  ],
});

客户端 IP 地址保存和安全组

使用时 preserveClientIp 特性, AGA 创建 弹性网络接口 在您的 AWS 账户中, 即 和AGA安全组有关 你可以用这个 由AGA作为其他安全小组的源组设立的安全小组 (例如EC2或弹性负载平衡器),如果你想 根据AGA安全小组规则限制流量.

AGA 创建特定的安全小组 GlobalAccelerator 用于每个VPC 它在(这种行为不能改变)中有一个ENI. 云阵不会 支持引用 AGA 创建的安全小组,但此构造 库带有自定义资源, 允许您引用 AGA 安全小组.

打电话 endpointGroup.connectionsPeer() 以便查阅安全小组的资料 用于关联规则。 你必须通过一个参考 的VPC 在谁 上下文将查找安全小组。 示例

declare const listener: globalaccelerator.Listener;

// Non-open ALB
declare const alb: elbv2.ApplicationLoadBalancer;

const endpointGroup = listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.ApplicationLoadBalancerEndpoint(alb, {
      preserveClientIp: true,
    }),
  ],
});

// Remember that there is only one AGA security group per VPC.
declare const vpc: ec2.Vpc;
const agaSg = endpointGroup.connectionsPeer('GlobalAcceleratorSG', vpc);

// Allow connections from the AGA to the ALB
alb.connections.allowFrom(agaSg, ec2.Port.tcp(443));

版本与发布记录

@aws-cdk/aws-globalaccelerator 共发布 187 个版本,首次发布于 2020/05/27;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.204.0latest2023/06/203 年前
1.203.02023/06/013 年前
1.202.02023/05/223 年前
1.201.02023/05/113 年前
1.200.02023/04/273 年前
1.199.02023/04/213 年前

关于 @aws-cdk/aws-globalaccelerator 的常见问题

@aws-cdk/aws-globalaccelerator 是什么?

AWS 的 CDK 构建库: 全球加速器注意:该包已被作者标记为弃用——AWS CDK v1 has reached End-of-Support on 2023-06-01. This package is no longer being updated, and users should migrate to AWS CDK v2. For more information on how to migrate, see https://docs.aws.amazon.com/cdk/v2/guide/migrating-v2.html

如何安装 @aws-cdk/aws-globalaccelerator?

在项目目录运行 npm install @aws-cdk/aws-globalaccelerator,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@aws-cdk/aws-ec2(1.204.0)、@aws-cdk/core(1.204.0)、@aws-cdk/custom-resources(1.204.0)、constructs(^3.3.69)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aws-cdk/aws-globalaccelerator 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aws-cdk/aws-globalaccelerator 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@aws-cdk/aws-globalaccelerator 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 14.15.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@aws-cdk/aws-globalaccelerator 可以商用吗?

@aws-cdk/aws-globalaccelerator 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aws-cdk/aws-globalaccelerator 的下载量有多少?

根据 npm 官方下载统计,@aws-cdk/aws-globalaccelerator 在 2026/10/08 – 2026/11/06 这 30 天内被下载 109,621 次,日均约 3,654 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aws-cdk/aws-globalaccelerator 还在维护吗?

最新版本 1.204.0 发布于 2023/06/20(3 年前);至今共发布 187 个版本,其中过去 12 个月发布了 0 个;首次发布于 2020/05/27。作者已将其标记为弃用,新项目建议寻找替代方案。