解决方案教程入门
解决方案教程提供了有关如何使用 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
-
从 https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest下载并安装 IBM Cloud CLI。
-
使用以下命令验证安装:
ibmcloud version
您可能需要在安装后重新启动机器。
Docker
-
Docker Desktop on Windows 是在 Windows 上运行容器映像的一个选项。 在继续安装之前,请确保复审 许可协议 的条款。
-
如果您没有免费帐户,请在 https://hub.docker.com/signup上注册免费帐户。
-
在 Windows 上从 https://docs.docker.com/docker-for-windows/install/下载并安装 Docker Desktop。
-
使用以下命令验证安装:
docker --version docker run hello-world
您可能需要注销并等待 Docker 守护程序启动。
kubectl
- 从 https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windows下载
kubectl
。 - 将
kubectl.exe
二进制文件移至 PATH。 - 使用以下命令验证安装:
kubectl version --client=true
oc
- 从 https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/下载最新的 4.x OpenShift CLI (
oc
)。 - 将
oc.exe
二进制文件移至 PATH。 - 使用以下命令验证安装:
oc version
Helm 3
- 从 https://github.com/helm/helm/releases/latest下载
helm
。 - 解压缩下载的归档。
- 将
helm.exe
二进制文件移至 PATH。 - 使用以下命令验证安装:
helm version
Terraform
- 从 https://developer.hashicorp.com/terraform/downloads下载
terraform
。 - 解压缩下载的归档。
- 将
terraform.exe
二进制文件移至 PATH。 - 使用以下命令验证安装:
terraform version
要使用 Terraform 管理 IBM Cloud 资源,还需要安装 IBM Cloud 提供程序。 从 Terraform 0.13开始,可以从 Terraform 插件注册表自动下载提供程序。 遵循 提供者文档 中的指示信息来配置
Terraform 模板中的 required_providers
属性。
jq
- 从 https://jqlang.github.io/jq/下载 jq。
- 将
jq-win64.exe
重命名为jq.exe
。 - 将
jq.exe
二进制文件移至 PATH。 - 使用以下命令验证安装:
jq --version
Git
- 从 https://github.com/git-for-windows/git/releases/latest下载并安装
git
。 - 使用以下命令验证安装:
git --version
继续执行 所有操作系统通用 的配置。
Apple macOS
以下部分假定您正在具有管理员特权的用户下运行 macOS High Sierra 或更高版本。 完成特定部分后,请继续执行 所有操作系统的公共配置。
IBM Cloud CLI
- 从 https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest下载并安装 IBM Cloud CLI。
- 使用以下命令验证安装:
ibmcloud version
Docker
- Docker Desktop on Mac 是在 macOS上运行容器映像的一个选项。 在继续安装之前,请确保复审 许可协议 的条款。 其他选项包括 Podman。
- 如果您没有免费帐户,请在 https://hub.docker.com/signup上注册免费帐户。
- 从 https://docs.docker.com/docker-for-mac/install/下载并安装 Docker Desktop on Mac。
- 使用以下命令验证安装:
docker --version docker run hello-world
kubectl
- 从 https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macos下载
kubectl
。 - 使
kubectl
二进制文件可执行。chmod +x ./kubectl
- 将二进制文件移至 PATH。
sudo mv ./kubectl /usr/local/bin/kubectl
- 使用以下命令验证安装:
kubectl version --client=true
oc
- 从 https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/下载最新的 4.x OpenShift CLI (
oc
)。 - 抽取
openshift-client-mac.tar.gz
(Intel) 或openshift-install-mac-arm64.tar.gz
(Apple Silicon):tar zxvf openshift-client-mac*.tar.gz oc
- 将
oc
二进制文件移至 PATH。sudo mv ./oc /usr/local/bin/oc
- 使用以下命令验证安装:
macOS Catalina 和更高版本可能会向您提示一条消息,指出无法验证开发者。 要允许始终执行oc version
oc
,请运行sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc
。
Helm 3
- 从 https://github.com/helm/helm/releases/latest下载
helm
。 - 解压缩下载的归档。
- 将
helm
二进制文件移至 PATH。sudo mv ./darwin-amd64/helm /usr/local/bin/helm
- 使用以下命令验证安装:
macOS Catalina 和更高版本可能会向您提示一条消息,指出无法验证开发者。 要允许始终执行helm version
helm
,请运行sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm
。
Terraform
- 从 https://developer.hashicorp.com/terraform/downloads下载
terraform
。 - 解压缩下载的归档。
- 将
terraform
二进制文件移至 PATH。sudo mv ./terraform /usr/local/bin/terraform
- 使用以下命令验证安装:
terraform version
要使用 Terraform 管理 IBM Cloud 资源,还需要安装 IBM Cloud 提供程序。 从 Terraform 0.13开始,可以从 Terraform 插件注册表自动下载提供程序。 遵循 提供者文档 中的指示信息来配置
Terraform 模板中的 required_providers
属性。
jq
- 从 https://jqlang.github.io/jq/下载
jq
。 - 将下载的文件重命名为
jq
。 - 使
jq
二进制文件可执行。chmod +x ./jq
- 将
jq
二进制文件移至 PATH。sudo mv ./jq /usr/local/bin/jq
- 使用以下命令验证安装:
macOS Catalina 和更高版本可能会向您提示一条消息,指出无法验证开发者。 要允许始终执行jq --version
jq
,请运行sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq
。
Git
- 检查
git
是否已安装:
macOS 可能会提示您安装开发者工具。 这些工具包括git --version
git
命令行。
继续执行 所有操作系统通用 的配置。
Ubuntu Linux
以下部分假定您以具有 root 用户特权访问权的非 root 用户身份运行 Ubuntu Linux。 完成特定部分后,请继续执行 所有操作系统的公共配置。 如果您正在使用基于 Linux的 Cloud Shell,请继续 Cloud Shell上的部分。
IBM Cloud CLI
- 从 https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest下载并安装 IBM Cloud CLI。
- 使用以下命令验证安装:
ibmcloud version
Docker
- 如果您没有免费帐户,请在 https://hub.docker.com/signup上注册免费帐户。
- 遵循 https://docs.docker.com/engine/install/ubuntu/中的指示信息在 Ubuntu 上安装 Docker Engine。
- 使用以下命令验证安装:
要以您自己的用户而不是 root 用户身份运行 Docker,请执行 安装后 步骤。docker --version sudo docker run hello-world
kubectl
- 从 https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linux下载
kubectl
。 - 使
kubectl
二进制文件可执行。chmod +x ./kubectl
- 将二进制文件移至 PATH。
sudo mv ./kubectl /usr/local/bin/kubectl
- 使用以下命令验证安装:
kubectl version --client=true
oc
- 从 https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/下载最新的 4.x OpenShift CLI (
oc
)。 - 抽取
openshift-client-linux.tar.gz
:tar zxvf openshift-client-linux.tar.gz oc
- 将
oc
二进制文件移至 PATH。sudo mv ./oc /usr/local/bin/oc
- 使用以下命令验证安装:
oc version
Helm 3
- 从 https://github.com/helm/helm/releases/latest下载
helm
。 - 解压缩下载的归档。
- 将
helm
二进制文件移至 PATH。sudo mv ./linux-amd64/helm /usr/local/bin/helm
- 使用以下命令验证安装:
helm version
Terraform
- 从 https://developer.hashicorp.com/terraform/downloads下载
terraform
。 - 解压缩下载的归档。
- 将
terraform
二进制文件移至 PATH。sudo mv ./terraform /usr/local/bin/terraform
- 使用以下命令验证安装:
terraform version
要使用 Terraform 管理 IBM Cloud 资源,还需要安装 IBM Cloud 提供程序。 从 Terraform 0.13开始,可以从 Terraform 插件注册表自动下载提供程序。 遵循 提供者文档 中的指示信息来配置
Terraform 模板中的 required_providers
属性。
jq
- 使用以下命令安装
jq
:sudo apt install jq
- 使用以下命令验证安装:
jq --version
Git
- 使用以下命令安装
git
:sudo apt install git
- 使用以下命令验证安装:
git --version
继续执行 所有操作系统通用 的配置。
所有操作系统通用
以下部分是所有操作系统的公共部分。
IBM Cloud CLI 插件
插件使用特定于服务的命令扩展 IBM Cloud CLI 的功能。
- 安装以下插件:
要查看所有可用插件,请运行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 帐户
- 在 https://github.com/上注册免费帐户。
- 在 https://github.com/new 上创建新的公共存储库,以熟悉 GitHub。
IBM Cloud GitLab
IBM Cloud 为您提供了托管的 Git 存储库,这些存储库基于 GitLab Community Edition,并可使用用于登录 IBM Cloud的相同凭证进行访问。 建议配置 SSH 公用密钥以简化与 Git 存储库的命令行交互。
- 使用这些指示信息 以生成新的 SSH 密钥对 (如果没有)。
- 将 SSH 公用密钥 添加到您计划托管 Git 存储库的区域中的 Git 设置,例如 达拉斯(us-south.git.cloud.ibm.com),伦敦(eu-gb.git.cloud.ibm.com) 或 法兰克福(eu-de.git.cloud.ibm.com)。
要验证配置:
- 在 GitLab中创建新的专用项目,选择使用自述文件初始化存储库的选项。
- 通过使用 SSH 链接进行克隆,从命令行检出项目。
- 更新自述文件。
- 落实并推送更改。
Cloud Shell
oc
如果需要使用预安装的 OpenShift CLI 以外的其他版本,请执行以下步骤:
- 下载最新稳定的 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
- 抽取
oc.tar.gz
:tar zxvf oc.tar.gz oc
- 将当前目录添加到
PATH
export PATH=$PWD:$PATH
- 使用以下命令验证安装:
oc version