pedantic/ibmcloud-cli

IBM Cloud CLI for K8s Docker镜像文档

镜像概述

本镜像为容器化的命令行工具环境，预装IBM Cloud CLI（ibmcloud）及Kubernetes相关插件（如ibmcloud ks），旨在提供隔离、便捷的操作环境，用于管理IBM Cloud上的Kubernetes集群及关联资源。无需在本地系统安装依赖，可直接通过容器运行IBM Cloud K8s相关命令，适用于开发、测试及CI/CD场景。

核心功能与特性

• 预装核心工具：包含ibmcloud CLI、kubectl（Kubernetes命令行工具）、ibmcloud ks（IBM Cloud Kubernetes Service插件）等，满足K8s资源全生命周期管理需求。
• 环境隔离：容器化运行，避免本地系统依赖冲突，保持开发/运维环境清洁。
• 版本一致性：固定工具版本，确保团队成员及自动化流程使用统一的CLI环境，减少版本差异导致的问题。
• 轻量便携：基于精简基础镜像构建，体积小巧，可在任何Docker兼容环境（Linux、macOS、Windows）快速启动。
• 即开即用：无需手动安装插件，启动容器即可直接执行IBM Cloud K8s命令。

使用场景

• 开发人员本地操作：快速管理IBM Cloud上的K8s集群（如创建/删除集群、节点管理、应用部署），无需配置本地CLI环境。
• CI/CD流程集成：在自动化流水线中嵌入容器命令，执行IBM Cloud K8s资源的部署、更新、回滚等操作。
• 临时测试环境：快速启动隔离环境，测试不同版本的K8s集群配置或CLI命令，不影响本地系统。
• 团队协作：统一团队工具版本，避免因本地CLI版本差异导致的操作不一致问题。

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）。
• 拥有IBM Cloud账号及K8s集群操作权限（需提前在IBM Cloud控制台获取API密钥或访问令牌）。

获取镜像

通过Docker命令拉取镜像（请替换<image-registry>为实际镜像仓库地址）：

bash
docker pull <image-registry>/ibmcloud-cli-k8s:latest

基本使用

1. 启动交互式终端

以交互模式启动容器，进入命令行环境：

bash
docker run -it --rm <image-registry>/ibmcloud-cli-k8s:latest /bin/bash

参数说明：

• -it：交互式终端模式，支持命令输入
• --rm：容器退出后自动删除，避免残留
• /bin/bash：启动bash shell，进入交互式环境

2. 登录IBM Cloud

在容器终端中执行登录命令，按提示输入认证信息：

bash
# 账号密码登录（本地交互场景）
ibmcloud login

# API密钥非交互式登录（CI/CD或脚本场景）
ibmcloud login --apikey <YOUR_IBM_CLOUD_API_KEY> -r <REGION>  # 例如 -r us-south

3. 管理K8s集群

登录后通过ibmcloud ks命令管理集群，示例操作：

bash
# 列出账号下的K8s集群
ibmcloud ks clusters

# 获取集群kubeconfig配置（用于kubectl操作）
ibmcloud ks cluster config --cluster <CLUSTER_NAME_OR_ID>

# 查看集群节点状态
kubectl get nodes

# 部署应用到集群
kubectl apply -f <DEPLOYMENT_YAML_FILE>

高级配置

持久化认证状态

挂载本地~/.bluemix目录（IBM Cloud CLI配置目录），实现登录状态持久化：

bash
docker run -it --rm -v ~/.bluemix:/root/.bluemix <image-registry>/ibmcloud-cli-k8s:latest /bin/bash

共享本地kubeconfig

挂载本地K8s配置文件，使用已有集群上下文：

bash
docker run -it --rm -v ~/.kube/config:/root/.kube/config <image-registry>/ibmcloud-cli-k8s:latest /bin/bash

CI/CD流程集成示例

在GitHub Actions中执行K8s部署：

yaml
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Pull image
        run: docker pull <image-registry>/ibmcloud-cli-k8s:latest
      
      - name: Deploy to IBM Cloud K8s
        run: |
          docker run --rm \
            -e IBM_CLOUD_API_KEY=${{ secrets.IBM_CLOUD_API_KEY }} \
            <image-registry>/ibmcloud-cli-k8s:latest \
            /bin/sh -c " \
              ibmcloud login --apikey \$IBM_CLOUD_API_KEY -r us-south && \
              ibmcloud ks cluster config --cluster my-k8s-cluster && \
              kubectl apply -f k8s/deployment.yaml \
            "

环境变量说明

注意事项

• 生产环境建议使用具体版本标签（如:v1.2.3）而非latest，确保版本稳定。
• 敏感信息（如API密钥）避免直接暴露在命令行，优先通过环境变量或文件挂载传入。
• 长时间运行的容器需定期更新镜像，以获取最新安全补丁和功能更新。