IBM Cloud Docs
開始使用解決方案指導教學

開始使用解決方案指導教學

解決方案指導教學提供逐步指示，說明如何使用 IBM Cloud，以根據最佳作法和經過驗證的技術來實作一般型樣。

在瀏覽指導教學集合之前，本手冊將協助您設定開發環境，以順利遵循在此集合中找到的手冊指示。

目標

使用 IBM Cloud來安裝 must-haves 工具以提高生產力:

  • IBM Cloud CLI-與 IBM Cloud API 互動的指令行介面。
  • Docker-在稱為儲存器的套件中交付及執行軟體。
  • kubectl-針對 Kubernetes 叢集執行指令的指令行介面。
  • oc-管理 OpenShift 應用程式，並提供工具來與系統的每個元件互動。
  • Helm 3-協助您管理 Kubernetes 應用程式- Helm 圖表可協助您定義、安裝及升級最複雜的 Kubernetes 應用程式。
  • Terraform-自動化資源佈建。
  • jq-輕量型且彈性的指令行 JSON 處理器。
  • Git-免費且開放程式碼分散式版本控制系統。

若要避免安裝這些工具，您也可以從 IBM Cloud 主控台使用 Cloud Shell。

Microsoft Windows

下列各節假設您在具有「管理者」專用權的使用者下執行 Microsoft Windows 10 64 位元。 完成特定區段之後，請繼續 所有作業系統共用 配置。

IBM Cloud CLI

  1. 從 https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest下載並安裝 IBM Cloud CLI。

  2. 使用下列項目驗證安裝:

    ibmcloud version

    安裝之後，您可能需要重新啟動機器。

Docker

  1. Docker Desktop on Windows 是在 Windows 上執行儲存器映像檔的一個選項。 在繼續安裝之前，請務必檢閱 授權合約 的條款。

  2. 如果您沒有，請在 https://hub.docker.com/signup註冊免費帳戶。

  3. 從 https://docs.docker.com/docker-for-windows/install/下載並安裝 Docker Desktop on Windows。

  4. 使用下列項目驗證安裝:

    docker --version
docker run hello-world

    您可能需要登出並等待 Docker 常駐程式啟動。

kubectl

  1. 從 https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windows下載 kubectl。
  2. 將 kubectl.exe 二進位檔移至您的 PATH。
  3. 使用下列項目驗證安裝:
    kubectl version --client=true

OC

  1. 從 https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/下載最新的 4.x OpenShift CLI (oc)。
  2. 將 oc.exe 二進位檔移至您的 PATH。
  3. 使用下列項目驗證安裝:
    oc version

Helm 3

  1. 從 https://github.com/helm/helm/releases/latest下載 helm。
  2. 解壓縮下載的保存檔。
  3. 將 helm.exe 二進位檔移至您的 PATH。
  4. 使用下列項目驗證安裝:
    helm version

Terraform

  1. 從 https://developer.hashicorp.com/terraform/downloads下載 terraform。
  2. 解壓縮下載的保存檔。
  3. 將 terraform.exe 二進位檔移至 PATH。
  4. 使用下列項目驗證安裝:
    terraform version

若要使用 Terraform 管理 IBM Cloud 資源，您還需要安裝 IBM Cloud 提供者。 從 Terraform 0.13開始，可以從 Terraform 外掛程式登錄自動下載提供者。 遵循 提供者說明文件 中的指示，在 Terraform 範本中配置 required_providers 內容。

jq

  1. 從 https://jqlang.github.io/jq/下載 jq。
  2. 將 jq-win64.exe 重新命名為 jq.exe。
  3. 將 jq.exe 二進位檔移至您的 PATH。
  4. 使用下列項目驗證安裝:
    jq --version

Git

  1. 從 https://github.com/git-for-windows/git/releases/latest下載並安裝 git。
  2. 使用下列項目驗證安裝:
    git --version

繼續 所有作業系統共用 配置。

Apple macOS

下列各節假設您在具有「管理者」專用權的使用者下執行 macOS High Sierra 或更新版本。 完成特定區段之後，請繼續 所有作業系統共用 配置。

IBM Cloud CLI

  1. 從 https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest下載並安裝 IBM Cloud CLI。
  2. 使用下列項目驗證安裝:
    ibmcloud version

Docker

  1. Docker Desktop on Mac 是在 macOS上執行容器映像檔的一個選項。 在繼續安裝之前，請務必檢閱 授權合約 的條款。 其他選項包括 Podman。
  2. 如果您沒有，請在 https://hub.docker.com/signup註冊免費帳戶。
  3. 從 https://docs.docker.com/docker-for-mac/install/下載並安裝 Docker Desktop on Mac。
  4. 使用下列項目驗證安裝:
    docker --version
docker run hello-world

kubectl

  1. 從 https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macos下載 kubectl。
  2. 將 kubectl 二進位設為執行檔。
    chmod +x ./kubectl
  3. 將二進位檔移至 PATH。
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. 使用下列項目驗證安裝:
    kubectl version --client=true

OC

  1. 從 https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/下載最新的 4.x OpenShift CLI (oc)。
  2. 解壓縮 openshift-client-mac.tar.gz (Intel) 或 openshift-install-mac-arm64.tar.gz (Apple Silicon):
    tar zxvf openshift-client-mac*.tar.gz oc
  3. 將 oc 二進位檔移至 PATH。
    sudo mv ./oc /usr/local/bin/oc
  4. 使用下列項目驗證安裝:
    oc version
    macOS Catalina 以及更新版本可能會提示您一則訊息，指出無法驗證開發人員。 若要容許一律執行 oc，請執行 sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc。

Helm 3

  1. 從 https://github.com/helm/helm/releases/latest下載 helm。
  2. 解壓縮下載的保存檔。
  3. 將 helm 二進位檔移至 PATH。
    sudo mv ./darwin-amd64/helm /usr/local/bin/helm
  4. 使用下列項目驗證安裝:
    helm version
    macOS Catalina 以及更新版本可能會提示您一則訊息，指出無法驗證開發人員。 若要容許一律執行 helm，請執行 sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm。

Terraform

  1. 從 https://developer.hashicorp.com/terraform/downloads下載 terraform。
  2. 解壓縮下載的保存檔。
  3. 將 terraform 二進位檔移至 PATH。
    sudo mv ./terraform /usr/local/bin/terraform
  4. 使用下列項目驗證安裝:
    terraform version

若要使用 Terraform 管理 IBM Cloud 資源，您還需要安裝 IBM Cloud 提供者。 從 Terraform 0.13開始，可以從 Terraform 外掛程式登錄自動下載提供者。 遵循 提供者說明文件 中的指示，在 Terraform 範本中配置 required_providers 內容。

jq

  1. 從 https://jqlang.github.io/jq/下載 jq。
  2. 將下載的檔案重新命名為 jq。
  3. 將 jq 二進位設為執行檔。
    chmod +x ./jq
  4. 將 jq 二進位檔移至 PATH。
    sudo mv ./jq /usr/local/bin/jq
  5. 使用下列項目驗證安裝:
    jq --version
    macOS Catalina 以及更新版本可能會提示您一則訊息，指出無法驗證開發人員。 若要容許一律執行 jq，請執行 sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq。

Git

  1. 檢查是否已安裝 git :
    git --version
    macOS 可能會提示您安裝開發人員工具。 這些工具包括 git 指令行。

繼續 所有作業系統共用 配置。

Ubuntu Linux

下列各節假設您以具有 root 專用權存取權的非 root 使用者身分執行 Ubuntu Linux。 完成特定區段之後，請繼續 所有作業系統共用 配置。 如果您使用 Linux型 Cloud Shell，請繼續 Cloud Shell 上的小節。

IBM Cloud CLI

  1. 從 https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest下載並安裝 IBM Cloud CLI。
  2. 使用下列項目驗證安裝:
    ibmcloud version

Docker

  1. 如果您沒有，請在 https://hub.docker.com/signup註冊免費帳戶。
  2. 遵循 https://docs.docker.com/engine/install/ubuntu/中的指示，在 Ubuntu 上安裝 Docker Engine。
  3. 使用下列項目驗證安裝:
    docker --version
sudo docker run hello-world
    若要以您自己的使用者而非 root 使用者身分執行 Docker，請執行 後置安裝 步驟。

kubectl

  1. 從 https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linux下載 kubectl。
  2. 將 kubectl 二進位設為執行檔。
    chmod +x ./kubectl
  3. 將二進位檔移至 PATH。
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. 使用下列項目驗證安裝:
    kubectl version --client=true

OC

  1. 從 https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/下載最新的 4.x OpenShift CLI (oc)。
  2. 擷取 openshift-client-linux.tar.gz:
    tar zxvf openshift-client-linux.tar.gz oc
  3. 將 oc 二進位檔移至 PATH。
    sudo mv ./oc /usr/local/bin/oc
  4. 使用下列項目驗證安裝:
    oc version

Helm 3

  1. 從 https://github.com/helm/helm/releases/latest下載 helm。
  2. 解壓縮下載的保存檔。
  3. 將 helm 二進位檔移至 PATH。
    sudo mv ./linux-amd64/helm /usr/local/bin/helm
  4. 使用下列項目驗證安裝:
    helm version

Terraform

  1. 從 https://developer.hashicorp.com/terraform/downloads下載 terraform。
  2. 解壓縮下載的保存檔。
  3. 將 terraform 二進位檔移至 PATH。
    sudo mv ./terraform /usr/local/bin/terraform
  4. 使用下列項目驗證安裝:
    terraform version

若要使用 Terraform 管理 IBM Cloud 資源，您還需要安裝 IBM Cloud 提供者。 從 Terraform 0.13開始，可以從 Terraform 外掛程式登錄自動下載提供者。 遵循 提供者說明文件 中的指示，在 Terraform 範本中配置 required_providers 內容。

jq

  1. 使用下列指令來安裝 jq :
    sudo apt install jq
  2. 使用下列項目驗證安裝:
    jq --version

Git

  1. 使用下列指令來安裝 git :
    sudo apt install git
  2. 使用下列項目驗證安裝:
    git --version

繼續 所有作業系統共用 配置。

所有作業系統共用

下列各節適用於所有作業系統。

IBM Cloud CLI 外掛程式

外掛程式使用特定於服務的指令來延伸 IBM Cloud CLI 的功能。

  1. 安裝下列外掛程式:
    ibmcloud plugin install container-registry
ibmcloud plugin install cloud-object-storage
ibmcloud plugin install kubernetes-service
ibmcloud plugin install vpc-infrastructure
ibmcloud plugin install code-engine
    若要查看所有可用的外掛程式，請執行 ibmcloud plugin repo-plugins 並安裝外掛程式 ibmcloud plugin install <PLUGIN_NAME>

GitHub 帳戶

  1. 在 https://github.com/註冊免費帳戶。
  2. 在 https://github.com/new 建立新的公用儲存庫，以熟悉 GitHub。

IBM Cloud GitLab

IBM Cloud 提供您在 GitLab Community Edition 上建置並可使用用來登入 IBM Cloud的相同認證來存取的代管 Git 儲存庫。 建議配置 SSH 公開金鑰，以簡化與 Git 儲存庫的指令行互動。

  1. 如果您沒有 SSH 金鑰組，請 使用這些指示 來產生新的 SSH 金鑰組。
  2. 新增 SSH 公開金鑰 至您計劃管理 Git 儲存庫之地區中的 Git 設定，例如 達拉斯(us-south.git.cloud.ibm.com)、倫敦(eu-gb.git.cloud.ibm.com) 或 法蘭克福(eu-de.git.cloud.ibm.com)。

若要驗證配置，請執行下列動作:

  1. 在 GitLab中建立新的專用專案，選取選項以使用 README 來起始設定儲存庫。
  2. 透過使用 SSH 鏈結進行複製，從指令行移出專案。
  3. 更新 README 檔。
  4. 確定並推送變更。

Cloud Shell

OC

如果您需要使用 OpenShift CLI 的另一個版本，而不是預先安裝的版本，請遵循下列步驟:

  1. 下載最新穩定的 4.x OpenShift CLI (oc)
    curl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
  2. 擷取 oc.tar.gz:
    tar zxvf oc.tar.gz oc
  3. 將現行目錄新增至 PATH
    export PATH=$PWD:$PATH
  4. 使用下列項目驗證安裝:
    oc version