covis/openshift-cli

OpenShift CLI CI/CD镜像

镜像概述

本镜像基于Alpine系统构建，包含OpenShift命令行工具（oc）及gettext工具（提供envsubst功能），旨在帮助用户在CI/CD流水线中高效完成OpenShift集群操作与配置文件的环境变量替换任务，适用于Jenkins、GitLab CI等主流CI/CD平台。

核心功能

1. 提供完整的OpenShift CLI（oc）工具，支持集群登录、资源创建/替换/删除等操作
2. 集成gettext工具，通过envsubst命令动态替换配置文件中的环境变量，避免敏感信息硬编码

使用场景

• GitLab CI流水线中执行OpenShift应用部署或资源更新任务
• Jenkins任务中与OpenShift集群交互，完成自动化运维操作
• 其他CI/CD平台中需要动态生成配置文件并操作OpenShift集群的场景

配置说明

在CI/CD系统中需提前配置以下关键环境变量（示例）：

• OPENSHIFT_SERVER：OpenShift集群服务器地址
• OPENSHIFT_TOKEN：集群认证令牌
• CI_PROJECT_NAME：CI/CD项目名称（需注意OpenShift项目名称不允许下划线）

示例

envsubst使用示例

假设配置模板app.yaml包含环境变量占位符：

yaml
...
- apiVersion: v1
  kind: DeploymentConfig
  metadata:
    labels:
      app: ${CI_PROJECT_NAME}
    name: sample
  spec:
    replicas: 1
    selector:
      app: ${CI_PROJECT_NAME}
      deployment: ${CI_BUILD_REF_SLUG}
...

执行命令替换变量：

bash
cat app.yaml | envsubst > app.yaml

替换后配置文件中的变量会被CI/CD系统的实际值填充（如CI_PROJECT_NAME=my_awesome_project）。

GitLab CI部署示例

在.gitlab-ci.yml中添加部署任务：

yaml
deploy:
  image: covis/openshift-cli
  stage: deploy
  script:
    - oc login "$OPENSHIFT_SERVER" --token="$OPENSHIFT_TOKEN"
    - cat app.yaml | envsubst > app.yaml
    - oc replace -f app.yaml -n ${CI_PROJECT_NAME/_/}

（注：OpenShift项目名称不允许下划线，需用${CI_PROJECT_NAME/_/}替换为横线）