主页
产品
Red Hat OpenShift Service on AWS
4
安装集群
1.3. 为 Red Hat OpenShift Service on AWS 集群创建虚拟私有云

1.3. 为 Red Hat OpenShift Service on AWS 集群创建虚拟私有云

您必须有一个 AWS Virtual Private Cloud (VPC)才能在 AWS 集群上创建 Red Hat OpenShift Service。您可以使用以下方法创建 VPC：

使用 ROSA CLI 创建 VPC
使用 Terraform 模板创建 VPC
在 AWS 控制台中手动创建 VPC 资源

注意

Terraform 指令用于测试和演示目的。您自己的安装需要对 VPC 的一些修改才能自行使用。您还应确保使用此链接的 Terraform 配置时，它位于您要安装集群的同一区域。在这些示例中，使用了 us-east-2。

使用 ROSA CLI 创建 AWS VPC

rosa create network 命令在 ROSA CLI 的 v.1.2.48 或更高版本中提供。命令使用 AWS CloudFormation 创建 VPC 以及在 AWS 集群上安装 Red Hat OpenShift Service 所需的相关网络组件。CloudFormation 是一个原生 AWS 基础架构即代码工具，与 AWS CLI 兼容。

如果没有指定模板，CloudFormation 将使用以下参数来创建资源的默认模板：

Expand

VPC 参数	value
可用区	1
区域	`us-east-1`
VPC CIDR	`10.0.0.0/16`

您可以创建和自定义 CloudFormation 模板，以用于 rosa create network 命令。如需有关默认 VPC 模板的信息，请参阅本节的其他资源。

先决条件

您已配置了 AWS 帐户
您已配置了您的红帽帐户
已安装 ROSA CLI 并将其配置为最新版本

流程

运行以下命令，使用默认的 CloudFormations 模板创建 AWS VPC：
```
rosa create network
```
```
$ rosa create network
```
Copy to Clipboard Toggle word wrap
可选：通过指定附加参数来自定义 VPC。
您可以使用- -param 标志指定对默认 VPC 模板的更改。以下示例命令为 region、Name、AvailabilityZoneCount 和 VpcCidr 指定自定义值。
```
rosa create network --param Region=us-east-2 --param Name=quickstart-stack --param AvailabilityZoneCount=3 --param VpcCidr=10.0.0.0/16
```
```
$ rosa create network --param Region=us-east-2 --param Name=quickstart-stack --param AvailabilityZoneCount=3 --param VpcCidr=10.0.0.0/16
```
Copy to Clipboard Toggle word wrap
该命令需要大约 5 分钟来运行，并在创建资源时从 AWS 提供常规状态更新。如果 CloudFormation 存在问题，则会尝试回滚。对于遇到的所有其他错误，请按照错误消息说明或联系 AWS 支持。

验证

完成后，您会收到创建的资源概述：

INFO[0140] Resources created in stack:
INFO[0140] Resource: AttachGateway, Type: AWS::EC2::VPCGatewayAttachment, ID: <gateway_id>
INFO[0140] Resource: EC2VPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: EcrApiVPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: EcrDkrVPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: ElasticIP1, Type: AWS::EC2::EIP, ID: <IP>
INFO[0140] Resource: ElasticIP2, Type: AWS::EC2::EIP, ID: <IP>
INFO[0140] Resource: InternetGateway, Type: AWS::EC2::InternetGateway, ID: igw-016e1a71b9812464e
INFO[0140] Resource: KMSVPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: NATGateway1, Type: AWS::EC2::NatGateway, ID: <nat-gateway_id>
INFO[0140] Resource: PrivateRoute, Type: AWS::EC2::Route, ID: <route_id>
INFO[0140] Resource: PrivateRouteTable, Type: AWS::EC2::RouteTable, ID: <route_id>
INFO[0140] Resource: PrivateSubnetRouteTableAssociation1, Type: AWS::EC2::SubnetRouteTableAssociation, ID: <route_id>
INFO[0140] Resource: PublicRoute, Type: AWS::EC2::Route, ID: <route_id>
INFO[0140] Resource: PublicRouteTable, Type: AWS::EC2::RouteTable, ID: <route_id>
INFO[0140] Resource: PublicSubnetRouteTableAssociation1, Type: AWS::EC2::SubnetRouteTableAssociation, ID: <route_id>
INFO[0140] Resource: S3VPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: STSVPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: SecurityGroup, Type: AWS::EC2::SecurityGroup, ID: <security-group_id>
INFO[0140] Resource: SubnetPrivate1, Type: AWS::EC2::Subnet, ID: <private_subnet_id-1> \ 
INFO[0140] Resource: SubnetPublic1, Type: AWS::EC2::Subnet, ID: <public_subnet_id-1> \ 
INFO[0140] Resource: VPC, Type: AWS::EC2::VPC, ID: <vpc_id>
INFO[0140] Stack rosa-network-stack-5555 created \

INFO[0140] Resources created in stack:
INFO[0140] Resource: AttachGateway, Type: AWS::EC2::VPCGatewayAttachment, ID: <gateway_id>
INFO[0140] Resource: EC2VPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: EcrApiVPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: EcrDkrVPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: ElasticIP1, Type: AWS::EC2::EIP, ID: <IP>
INFO[0140] Resource: ElasticIP2, Type: AWS::EC2::EIP, ID: <IP>
INFO[0140] Resource: InternetGateway, Type: AWS::EC2::InternetGateway, ID: igw-016e1a71b9812464e
INFO[0140] Resource: KMSVPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: NATGateway1, Type: AWS::EC2::NatGateway, ID: <nat-gateway_id>
INFO[0140] Resource: PrivateRoute, Type: AWS::EC2::Route, ID: <route_id>
INFO[0140] Resource: PrivateRouteTable, Type: AWS::EC2::RouteTable, ID: <route_id>
INFO[0140] Resource: PrivateSubnetRouteTableAssociation1, Type: AWS::EC2::SubnetRouteTableAssociation, ID: <route_id>
INFO[0140] Resource: PublicRoute, Type: AWS::EC2::Route, ID: <route_id>
INFO[0140] Resource: PublicRouteTable, Type: AWS::EC2::RouteTable, ID: <route_id>
INFO[0140] Resource: PublicSubnetRouteTableAssociation1, Type: AWS::EC2::SubnetRouteTableAssociation, ID: <route_id>
INFO[0140] Resource: S3VPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: STSVPCEndpoint, Type: AWS::EC2::VPCEndpoint, ID: <vpce_id>
INFO[0140] Resource: SecurityGroup, Type: AWS::EC2::SecurityGroup, ID: <security-group_id>
INFO[0140] Resource: SubnetPrivate1, Type: AWS::EC2::Subnet, ID: <private_subnet_id-1> \


INFO[0140] Resource: SubnetPublic1, Type: AWS::EC2::Subnet, ID: <public_subnet_id-1> \


INFO[0140] Resource: VPC, Type: AWS::EC2::VPC, ID: <vpc_id>
INFO[0140] Stack rosa-network-stack-5555 created \

Copy to Clipboard

Toggle word wrap

1 2: 使用 rosa create cluster 命令时，这两个子网 ID 用于创建集群。
3: 网络堆栈名称用于稍后删除资源。

使用 Terraform 创建虚拟私有云

Terraform 是一个工具，可让您使用已建立的模板创建各种资源。以下流程根据需要使用默认选项在 AWS 集群上创建 Red Hat OpenShift Service。有关使用 Terraform 的更多信息，请参阅其他资源。

先决条件

您已在机器上安装 Terraform 版本 1.4.0 或更新版本。
您已在机器上安装了 Git。

流程

运行以下命令，打开 shell 提示符并克隆 Terraform VPC 存储库：
```
git clone https://github.com/openshift-cs/terraform-vpc-example
```
```
$ git clone https://github.com/openshift-cs/terraform-vpc-example
```
Copy to Clipboard Toggle word wrap
运行以下命令来进入创建的目录：
```
cd terraform-vpc-example
```
```
$ cd terraform-vpc-example
```
Copy to Clipboard Toggle word wrap
运行以下命令来启动 Terraform 文件：
```
terraform init
```
```
$ terraform init
```
Copy to Clipboard Toggle word wrap
在此过程完成后会显示确认初始化的消息。
要根据现有的 Terraform 模板构建 VPC Terraform 计划，请运行 plan 命令。您必须包含 AWS 区域。您可以选择指定集群名称。在 terraform plan 完成后，一个 rosa.tfplan 文件会被添加到 hypershift-tf 目录。有关更详细的选项，请参阅 Terraform VPC 存储库的 README 文件。
```
terraform plan -out rosa.tfplan -var region=<region>
```
```
$ terraform plan -out rosa.tfplan -var region=<region>
```
Copy to Clipboard Toggle word wrap
运行以下命令应用此计划文件来构建 VPC：
```
terraform apply rosa.tfplan
```
```
$ terraform apply rosa.tfplan
```
Copy to Clipboard Toggle word wrap
1. 可选：您可以通过运行以下命令捕获在创建 Red Hat OpenShift Service on AWS 集群时要使用的 Terraform-provisioned private、public 和 machinepool 子网 ID 的值：
  $ export SUBNET_IDS=$(terraform output -raw cluster-subnets-string)
  Copy to Clipboard Toggle word wrap
2. 使用以下命令验证变量是否已正确设置：
  $ echo $SUBNET_IDS
  Copy to Clipboard Toggle word wrap
  输出示例
  $ subnet-0a6a57e0f784171aa,subnet-078e84e5b10ecf5b0
  
  Copy to Clipboard Toggle word wrap

手动创建 AWS Virtual Private Cloud

如果您选择手动创建 AWS Virtual Private Cloud (VPC)而不是使用 Terraform，请访问 AWS 控制台中的 VPC 页面。

您的 VPC 必须满足下表中显示的要求。

Expand

表 1.2. VPC 的要求
要求	详情
VPC 名称	创建集群时，您需要具有特定的 VPC 名称和 ID。
CIDR 范围	您的 VPC CIDR 范围应该与您的机器 CIDR 匹配。
可用区	您需要一个区域的可用区，并且需要三个用于多区的可用区。
公共子网	您必须有一个公共子网，其中包含公共集群的 NAT 网关。私有集群不需要公共子网。
DNS 主机名和解析	您必须确保启用 DNS 主机名和解析。

1.3.1. 故障排除
复制链接

如果集群无法安装，请排除这些常见问题：

确保您的 DHCP 选项集包含一个域名，并确保域名不包含任何空格或大写字母。
如果您的 VPC 使用自定义 DNS 解析器（您的 DHCP 选项集 的域名 servers 字段不是 AmazonProvideDNS），请确保它能够正确解析在 Route53 中配置的专用托管区。

如需有关对 Red Hat OpenShift Service on AWS 集群安装进行故障排除的更多信息，请参阅对 Red Hat OpenShift Service on AWS 集群安装进行故障排除。

获得支持

如果您需要额外的支持，请访问红帽客户门户网站查看知识库文章、提交支持问题单，以及查看其他产品文档和资源。

标记子网

在使用 VPC 创建 Red Hat OpenShift Service on AWS 集群前，您必须标记 VPC 子网。自动服务 preflight 检查会在将这些资源用于集群之前验证这些资源是否已正确标记。下表显示了如何标记您的资源：

Expand

资源	键	value
公共子网	`kubernetes.io/role/elb`	`1 (` 或无值)
专用子网	`kubernetes.io/role/internal-elb`	`1 (` 或无值)

注意

您必须至少标记一个专用子网；如果适用，您必须只标记一个公共子网。

先决条件

您已创建了 VPC。
已安装 aws CLI。

流程

运行以下命令在终端中标记您的资源：

对于公共子网，请运行：

aws ec2 create-tags --resources <public-subnet-id> --region <aws_region> --tags Key=kubernetes.io/role/elb,Value=1

$ aws ec2 create-tags --resources <public-subnet-id> --region <aws_region> --tags Key=kubernetes.io/role/elb,Value=1

Copy to Clipboard

Toggle word wrap

对于专用子网，请运行：

aws ec2 create-tags --resources <private-subnet-id> --region <aws_region> --tags Key=kubernetes.io/role/internal-elb,Value=1

$ aws ec2 create-tags --resources <private-subnet-id> --region <aws_region> --tags Key=kubernetes.io/role/internal-elb,Value=1

Copy to Clipboard

Toggle word wrap

验证

运行以下命令验证标签是否已正确应用：

aws ec2 describe-tags --filters "Name=resource-id,Values=<subnet_id>"

$ aws ec2 describe-tags --filters "Name=resource-id,Values=<subnet_id>"

Copy to Clipboard

Toggle word wrap

输出示例

TAGS    Name                    <subnet-id>        subnet  <prefix>-subnet-public1-us-east-1a
TAGS    kubernetes.io/role/elb  <subnet-id>        subnet  1

TAGS    Name                    <subnet-id>        subnet  <prefix>-subnet-public1-us-east-1a
TAGS    kubernetes.io/role/elb  <subnet-id>        subnet  1

Copy to Clipboard

Toggle word wrap

返回顶部

1.3. 为 Red Hat OpenShift Service on AWS 集群创建虚拟私有云

使用 ROSA CLI 创建 AWS VPC

使用 Terraform 创建虚拟私有云

手动创建 AWS Virtual Private Cloud

1.3.1. 故障排除
复制链接

获得支持

标记子网

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

1.3. 为 Red Hat OpenShift Service on AWS 集群创建虚拟私有云

使用 ROSA CLI 创建 AWS VPC

使用 Terraform 创建虚拟私有云

手动创建 AWS Virtual Private Cloud

1.3.1. 故障排除复制链接链接已复制到粘贴板!

获得支持

标记子网

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

1.3.1. 故障排除
复制链接