Rancher AWS 快速入门指南
你可以参考以下步骤,在 AWS 的单节点 K3s Kubernetes 集群中快速部署 Rancher Server,并附加一个单节点下游 Kubernetes 集群。
本章节中提供的指南,旨在帮助你快速启动一个用于 Rancher 的沙盒,以评估 Rancher 是否能满足你的使用需求。快速入门指南不适用于生产环境。如果你需要获取生产环境的操作指导,请参见安装。
先决条件
部署到 Amazon AWS 会产生费用。
- Amazon AWS 账号: 用于创建部署 Rancher Server 和 Kubernetes 的资源。
- Amazon AWS 访问密钥:如果你没有的话,请访问此链接查看相关指南。
- 已创建 IAM 策略:定义附加此策略的账号所具有的权限。
- Terraform: 用于在 Amazon AWS 中配置服务器和集群。
IAM 策略示例
AWS 模块只创建一个 EC2 密钥对、一个 EC2 安全组和一个 EC2 实例。以下是一个简单的策略:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "ec2:*",
"Resource": "*"
}
]
}
开始使用
使用命令行工具,执行
git clone https://github.com/rancher/quickstart
把 Rancher Quickstart 克隆到本地。执行
cd quickstart/rancher/aws
命令,进入包含 Terraform 文件的 AWS 文件夹。把
terraform.tfvars.example
文件重命名为terraform.tfvars
。编辑
terraform.tfvars
文件,并替换以下变量:aws_access_key
- 替换为 Amazon AWS 访问密钥aws_secret_key
- 替换为 Amazon AWS Secret 密钥rancher_server_admin_password
- 替换为创建 Rancher Server 的 admin 账号的密码(最少 12 字符)
可选:修改
terraform.tfvars
中的可选参数。参见 Quickstart Readme 以及 AWS Quickstart Readme 了解更多信息。 建议包括:aws_region
- Amazon AWS 区域。AWS 的默认区域 (us-east-1
) 不一定是距离你最近的区域。建议修改为距离你最近的区域。prefix
- 所有创建资源的前缀instance_type
- EC2 使用的实例规格,最小规格为t3a.medium
。如果在预算范围内,可以使用t3a.large
或t3a.xlarge
。add_windows_node
- 如果设为 true,一个额外的 Windows worker 节点会添加到工作负载集群中。
执行
terraform init
。执行
terraform apply --auto-approve
以初始化环境。然后,等待命令行工具返回以下信息:Apply complete! Resources: 16 added, 0 changed, 0 destroyed.
Outputs:
rancher_node_ip = xx.xx.xx.xx
rancher_server_url = https://rancher.xx.xx.xx.xx.sslip.io
workload_node_ip = yy.yy.yy.yy将以上输出中的
rancher_server_url
粘贴到浏览器中。在登录页面中登录(默认用户名为admin
,密码为在rancher_server_admin_password
中设置的密码)。使用
quickstart/rancher/aws
中生成的id_rsa
密钥 SSH 到 Rancher Server。
结果
两个 Kubernetes 集群已部署到你的 AWS 账户中,一个运行 Rancher Server,另一个为实验部署做好准备。请注意,虽然这种设置是探索 Rancher 功能的好方法,但在生产环境中,应遵循我们的高可用设置指南。用于虚拟机的 SSH 密钥是自动生成的,存储在模块目录中。
后续操作
使用 Rancher 创建 deployment。详情请参见创建 Deployment。
销毁环境
进入
quickstart/rancher/aws
文件夹,然后执行terraform destroy --auto-approve
。等待命令行界面显示资源已删除的消息。