跳到主要内容
版本:v2.9 (Preview)

Rancher AWS 快速入门指南

你可以参考以下步骤,在 AWS 的单节点 K3s Kubernetes 集群中快速部署 Rancher Server,并附加一个单节点下游 Kubernetes 集群。

警告

本章节中提供的指南,旨在帮助你快速启动一个用于 Rancher 的沙盒,以评估 Rancher 是否能满足你的使用需求。快速入门指南不适用于生产环境。如果你需要获取生产环境的操作指导,请参见安装

先决条件

警告

部署到 Amazon AWS 会产生费用。

IAM 策略示例

AWS 模块只创建一个 EC2 密钥对、一个 EC2 安全组和一个 EC2 实例。以下是一个简单的策略:

{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "ec2:*",
"Resource": "*"
}
]
}

开始使用

  1. 使用命令行工具,执行 git clone https://github.com/rancher/quickstartRancher Quickstart 克隆到本地。

  2. 执行 cd quickstart/rancher/aws 命令,进入包含 Terraform 文件的 AWS 文件夹。

  3. terraform.tfvars.example 文件重命名为 terraform.tfvars

  4. 编辑 terraform.tfvars 文件,并替换以下变量:

    • aws_access_key - 替换为 Amazon AWS 访问密钥
    • aws_secret_key - 替换为 Amazon AWS Secret 密钥
    • rancher_server_admin_password - 替换为创建 Rancher Server 的 admin 账号的密码(最少 12 字符)
  5. 可选:修改 terraform.tfvars 中的可选参数。参见 Quickstart Readme 以及 AWS Quickstart Readme 了解更多信息。 建议包括:

    • aws_region - Amazon AWS 区域。AWS 的默认区域 (us-east-1) 不一定是距离你最近的区域。建议修改为距离你最近的区域。
    • prefix - 所有创建资源的前缀
    • instance_type - EC2 使用的实例规格,最小规格为 t3a.medium 。如果在预算范围内,可以使用 t3a.larget3a.xlarge
    • add_windows_node - 如果设为 true,一个额外的 Windows worker 节点会添加到工作负载集群中。
  6. 执行 terraform init

  7. 执行 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
  8. 将以上输出中的 rancher_server_url 粘贴到浏览器中。在登录页面中登录(默认用户名为 admin,密码为在 rancher_server_admin_password 中设置的密码)。

  9. 使用 quickstart/rancher/aws 中生成的 id_rsa 密钥 SSH 到 Rancher Server。

结果

两个 Kubernetes 集群已部署到你的 AWS 账户中,一个运行 Rancher Server,另一个为实验部署做好准备。请注意,虽然这种设置是探索 Rancher 功能的好方法,但在生产环境中,应遵循我们的高可用设置指南。用于虚拟机的 SSH 密钥是自动生成的,存储在模块目录中。

后续操作

使用 Rancher 创建 deployment。详情请参见创建 Deployment

销毁环境

  1. 进入 quickstart/rancher/aws 文件夹,然后执行 terraform destroy --auto-approve

  2. 等待命令行界面显示资源已删除的消息。