解决方案教程入门

解决方案教程提供了有关如何使用 IBM Cloud 基于最佳实践和经过验证的技术实现公共模式的逐步指示信息。

在完成教程集合之前，本指南将帮助您设置开发环境以成功遵循本集合中找到的指南的指示信息。

目标

安装必备工具以使用 IBM Cloud实现生产:

  • IBM Cloud CLI-用于与 IBM Cloud API 交互的命令行界面。
  • Docker-在称为容器的软件包中交付和运行软件。
  • kubectl-用于对 Kubernetes 集群运行命令的命令行界面。
  • oc-管理 OpenShift 应用程序，并提供用于与系统的每个组件交互的工具。
  • Helm 3-帮助您管理 Kubernetes 应用程序- Helm Chart 可帮助您定义，安装和升级最复杂的 Kubernetes 应用程序。
  • Terraform-自动执行资源供应。
  • jq-轻量级且灵活的命令行 JSON 处理器。
  • Git-免费的开放式源代码分布式版本控制系统。

为了避免安装这些工具，还可以从 IBM Cloud 控制台使用 Cloud Shell。

Microsoft Windows

以下部分假定您是在具有管理员特权的用户下运行 64 位 Microsoft Windows 10。 完成特定部分后，请继续执行 所有操作系统的公共配置。

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. 在 Windows 上从 https://docs.docker.com/docker-for-windows/install/下载并安装 Docker Desktop。

  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 为您提供了托管的 Git 存储库，这些存储库基于 GitLab Community Edition，并可使用用于登录 IBM Cloud的相同凭证进行访问。 建议配置 SSH 公用密钥以简化与 Git 存储库的命令行交互。

  1. 使用这些指示信息 以生成新的 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中创建新的专用项目，选择使用自述文件初始化存储库的选项。
  2. 通过使用 SSH 链接进行克隆，从命令行检出项目。
  3. 更新自述文件。
  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