ansibleplaybookbundle/eclipse-che-apb

Eclipse Che APB

![构建状态]([***]

概述

该镜像通过Ansible Playbook Bundle（APB）将Eclipse Che部署到OpenShift项目中，帮助用户快速搭建统一的云端开发环境，支持容器化开发工具链的自动化管理。

核心功能

• 在OpenShift集群中一键部署Eclipse Che开发平台
• 集成Kubernetes服务目录与Ansible服务Broker实现自动化部署
• 支持持久卷存储确保开发数据不丢失
• 提供完整的部署故障排查、卸载与清理流程
• 支持本地镜像构建与测试的开发工作流

使用场景

• 开发团队需要快速搭建标准化的云端开发环境
• DevOps工程师在OpenShift平台上自动化部署开发工具链
• 测试人员验证Eclipse Che在容器化环境中的运行稳定性
• 技术人员学习APB与OpenShift集成的实践案例

配置说明

前提条件

• 集群需支持持久卷（Persistent Volumes）
• 已安装Kubernetes服务目录和Ansible服务Broker
  Minishift（OpenShift 3.10）环境配置示例：

  bash
  ## minishift with OpenShift 3.10
  export MINISHIFT_ENABLE_EXPERIMENTAL=y && \
  minishift config set iso-url centos && \
  minishift start --memory=8gb --cpus=4 --disk-size=50g \
                  --network-nameserver 8.8.8.8 \
                  --openshift-version 3.10.0-rc.0 \
                  --extra-clusterup-flags "--enable=service-catalog,router,registry,web-console,persistent-volumes,rhel-imagestreams,automation-service-broker"
  

关键配置修改

ASB默认配置需调整以确保部署成功：

1. 将OpenShift的sandbox_role设置为admin（默认edit）
2. 将DockerHub registry标签设置为canary（默认latest）

修改步骤：

bash
# 编辑ASB配置文件
oc edit cm/broker-config -n openshift-automation-service-broker --as system:admin

# 重启ASB使配置生效
oc rollout latest dc/openshift-automation-service-broker -n openshift-automation-service-broker --as system:admin

# 重新加载APB资源
apb bootstrap

使用方法

故障排查

bash
# 获取部署日志
oc get po --all-namespaces --as system:admin | grep eclipse-che-apb-prov | grep Running | awk '{print "oc logs --as system:admin -f -n "$1" "$2}' | bash -

# 查看ASB服务日志
oc logs -f dc/openshift-automation-service-broker -n openshift-automation-service-broker --as system:admin

卸载Eclipse Che

bash
# 删除服务实例
oc get serviceinstance -n eclipse-che-apb | grep apb | awk '{ print $1 }' | xargs oc delete -n eclipse-che-apb serviceinstance 

# 查看卸载日志
oc get po --all-namespaces --as system:admin | grep eclipse-che-apb-dep | grep Running | awk '{print "oc logs --as system:admin -f -n "$1" "$2}' | bash -

开发与测试

安装APB CLI

bash
# 下载并安装APB CLI脚本
APB_URL=https://raw.githubusercontent.com/ansibleplaybookbundle/ansible-playbook-bundle/master/scripts/apb-docker-run.sh
curl -sSL "${APB_URL}" > /usr/local/bin/apb && chmod +x /usr/local/bin/apb

# 赋予用户集群管理员权限
OS_USER=developer
oc adm policy add-cluster-role-to-user cluster-admin "${OS_USER}"

# 配置Minishift Docker环境变量
eval $(minishift docker-env)

构建并推送镜像

bash
git clone git@github.com:ansibleplaybookbundle/eclipse-che-apb.git
cd eclipse-che-apb
apb build
apb push

参考资源

• https://github.com/ansibleplaybookbundle/ansible-playbook-bundle/blob/master/docs/getting_started.md
• https://github.com/openshift/ansible-service-broker
• https://github.com/ansibleplaybookbundle/ansible-playbook-bundle/blob/master/docs/apb_cli.md
• https://github.com/kubernetes-incubator/service-catalog/
• APB开发与测试博客