安裝先決條件

由於所需的 Kubernetes 使用者自建物件已部署為 Kubernetes 中的 Helm 圖表以執行堆疊,因此您需要安裝 kubectl 以及 Helm。此外,您還需要 Oracle Cloud Infrastructure 命令行介面 (CLI),這是 kubectl 所需的介面,有助於執行其他工作。

在此步驟中,您將安裝下列元件:
  1. OCI 命令行介面。
  2. 如果還不存在,kubectl 版本 1.18 或更新版本。
  3. Helm 3.x。

安裝 Oracle Cloud Infrastructure 命令行介面

首先,您將安裝 Oracle Cloud Infrastructure 命令行介面 (CLI)。

  1. 若要在 Linux 或 Mac OS X 上安裝 OCI CLI,請執行以下命令:
    bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"

    按 Enter 可接受所有選項的預設值。

  2. 重新啟動您的 shell。
    exec -l $SHELL
  3. 收集租用戶和使用者 OCID:
    1. 按一下您的「使用者」圖示 (右上角),然後按一下租用戶,即可從 Oracle Cloud 主控台取得租用戶 OCID。複製租用戶的 OCID ( 租用戶欄位)。
    2. 按一下使用者,然後按一下使用者設定值,從主控台取得「使用者 OCID」。然後複製使用者的 OCID。
  4. 設定 OCI CLI。
    oci setup config
    系統將會提示您輸入下列資訊:
    • 組態的位置:按 Enter 鍵。
    • user_ocid :輸入您的使用者 OCID。
    • tenancy_ocid :輸入您的租用戶 OCID。
    • region:從提供的清單輸入您的區域。
    • 產生 RSA 金鑰組:按 Enter 表示「是」(預設值)。
    • 按鍵目錄:按 Enter 表示預設值。
    • 金鑰的名稱:預設為 Enter。
    • 密碼詞組:按 Enter 表示不使用密碼詞組。
    您應該會看到如下的執行結果:
    Private key written to: /home/oracle/.oci/oci_api_key.pem
    Fingerprint: 21:d4:f1:a0:55:a5:c2:ce:...
    Config written to ~/.oci/config
  5. 若要使用 CLI,您必須將產生的公開金鑰上傳到您的使用者帳戶。輸入下列資訊來取得關鍵內容:
    cat ~/.oci/oci_api_key_public.pem 

    或者,您可以使用偏好的編輯器開啟檔案,並將完整列印輸出複製到剪貼簿。

  6. 在 OCI Web 主控台上,新增上一個步驟中產生的金鑰:
    1. 按一下使用者,然後按一下使用者設定值
    2. 按一下 API 金鑰
    3. 按一下新增公開金鑰
    4. 按一下貼上公開金鑰
    5. 貼上上方複製的金鑰。
    6. 按一下新增
    7. 確定產生的指紋與組態的指紋輸出相符。
  7. 輸入下列內容來測試 CLI:
    oci os ns get
    此命令應該輸出您租用戶的命名空間 (通常是租用戶的名稱或隨機字串);例如:
    {
        "data": "your-tenancy-namespace"
    }
    

安裝 kubectl

接著,安裝 Kubernetes 命令行工具 kubectl

附註:

如果您在 Mac OS X 或 Windows 上使用 Docker 桌面,應該已經安裝 kubectl,而且您可以略過此步驟。

以下為安裝 kubectl 的高階程序。如需 O/S 的詳細說明,請參閱 Kubernetes 線上文件中的「安裝工具」,列示於「開始之前」主題。

  1. 若要安裝 kubectl,請執行此命令:
    PLATFORM=$(uname)
    curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/${PLATFORM,,}/amd64/kubectl"
    chmod +x ./kubectl
    sudo mv ./kubectl /usr/local/bin/kubectl
    
    在 Windows 上使用:
    curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.0/bin/windows/amd64/kubectl.exe
  2. 新增二進位檔至您的 PATH。
  3. 輸入下列項目,確認您使用的是 1.18 或更新版本的 kubectl
    kubectl version --client

安裝 Helm

現在,您將安裝 Helm CLI。

以下為安裝 Helm 的高階程序。如需 O/S 的詳細指示,請參閱「開始之前」主題中所列的「安裝 Helm」。

若要在 Mac OS X 和 Linux 上安裝 helm,請輸入:
curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash

安裝 Terraform

最後,如果尚未安裝,則需要安裝 Terraform。

附註:

您可以在「開始之前」主題中找到本主題中所參考之安裝文件的連結。
如果您使用以 Linux 為基礎的機器或 Mac OS X,建議您使用 tfswitch 來安裝 Terraform,如 tfswitch 文件中的「安裝」中所述,因為這可讓您在 Terraform 版本之間輕鬆切換。如果您安裝 tfswitch,請選取版本:
tfswitch

本手冊使用 Terraform 版本 0.14.11 進行測試

否則,如果您需要設定 Terraform 的指引,請造訪 Terraform 安裝文件並選取與您環境對應的路徑。