跳至主要内容

Rancher AWS 快速入門指南

以下步驟將在 AWS 上的單節點 K3s Kubernetes 叢集中快速部署 Rancher 伺服器,並附帶一個單節點下游 Kubernetes 叢集。

警告

這些指南的目的是快速啟動一個沙箱環境,您可以用來評估 Rancher。這些指南不適用於生產環境。有關全面的設定說明,請參閱安裝。

先決條件​

警告

部署到 Amazon AWS 將產生費用。

  • Amazon AWS 帳戶:需要 Amazon AWS 帳戶才能建立用於部署 Rancher 和 Kubernetes 的資源。
  • Amazon AWS 存取金鑰:如果您還沒有 Amazon AWS 存取金鑰,請使用此連結遵循教學建立。
  • 建立 IAM 政策:定義附加此政策的帳戶所擁有的權限。
  • 安裝 Terraform:用於在 Amazon AWS 中佈建伺服器和叢集。

IAM 政策範例​

AWS 模組只會建立 EC2 金鑰對、EC2 安全群組和 EC2 實例。一個簡單的政策如下:

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

開始使用​

  1. 使用 git clone https://github.com/rancher/quickstart 將 Rancher 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 私密金鑰
    • rancher_server_admin_password - 建立的 Rancher 伺服器的管理員密碼。有關密碼要求,請參閱設定啟動密碼。
  5. 選用: 修改 terraform.tfvars 中的選用變數。有關詳細資訊,請參閱 Quickstart Readme 和 AWS Quickstart Readme。 建議包括:

    • aws_region - Amazon AWS 區域,選擇最近的區域而不是預設的 (us-east-1)
    • prefix - 所有建立資源的前綴
    • instance_type - 使用的 EC2 實例大小,最小為 t3a.medium,但如果預算允許,可以使用 t3a.large 或 t3a.xlarge
    • add_windows_node - 如果為 true,則會將額外的 Windows 工作節點新增到工作負載叢集
  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 伺服器。

結果​

兩個 Kubernetes 叢集已部署到您的 AWS 帳戶中,一個執行 Rancher 伺服器,另一個準備用於實驗性部署。請注意,雖然此設定是探索 Rancher 功能的好方法,但生產設定應遵循我們的高可用性設定指南。VM 的 SSH 金鑰會自動生成並儲存在模組目錄中。

下一步?​

使用 Rancher 建立部署。有關詳細資訊,請參閱建立部署。

銷毀環境​

  1. 從 quickstart/rancher/aws 資料夾執行 terraform destroy --auto-approve。

  2. 等待確認所有資源已被銷毀。