nuxeoapbcatalog/nuxeo-arender-apb

Nuxeo Ansible Playbook Bundles 目录

镜像概述和主要用途

本镜像包含用于部署Nuxeo内容服务平台容器及其依赖支持服务容器的Ansible Playbook Bundles（APBs）。这些APBs可通过Ansible Service Broker集成到OpenShift环境中，实现Nuxeo平台及其依赖服务（如MongoDB、Elasticsearch、Kafka等）的自动化部署。APBs托管在DockerHub的https://hub.docker.com/r/nuxeoapbcatalog/%E7%BB%84%E7%BB%87%E4%B8%AD%E3%80%82

核心功能和特性

• 提供Nuxeo平台及关键依赖服务（MongoDB、Elasticsearch、Kafka）的部署APBs
• 支持通过Ansible Service Broker在OpenShift环境中集成和管理
• 包含完整的部署配置和权限设置，确保服务间依赖关系正确配置
• 支持开发环境构建和自定义配置，便于APB的迭代和测试

使用场景和适用范围

适用于需要在OpenShift环境中快速部署Nuxeo内容服务平台及其依赖服务的场景，包括：

• 企业内容管理系统的开发、测试和生产环境部署
• 需要自动化管理Nuxeo及关联服务生命周期的场景
• 基于Ansible和OpenShift的容器化应用部署流程

详细使用方法和配置说明

Ansible Service Broker配置

1. 添加Nuxeo APB Catalog到配置

在Ansible Service Broker配置中添加以下片段：

yaml
registry:
  - type: dockerhub
    name: nuxeo-apb-catalog
    url:
    org: nuxeoapbcatalog
    tag: 2.0
    white_list:
      - ".*-apb$"
    auth_type: ""
    auth_name: ""

dao:
  etcd_host: asb-etcd.openshift-ansible-service-broker.svc
  etcd_port: 2379
  etcd_ca_file: /var/run/secrets/kubernetes.io/serviceaccount/service-ca.crt
  etcd_client_cert: /var/run/asb-etcd-auth/client.crt
  etcd_client_key: /var/run/asb-etcd-auth/client.key
log:
  stdout: true
  level: info
  color: true
openshift:
  host: ""
  ca_file: ""
  bearer_token_file: ""
  namespace: openshift-ansible-service-broker
  sandbox_role: cluster-admin
  image_pull_policy: IfNotPresent
  keep_namespace: false
  keep_namespace_on_error: true
broker:
  dev_broker: dev
  bootstrap_on_startup: true
  refresh_interval: 600s
  launch_apb_on_bind: true
  output_request: false
  recovery: true
  ssl_cert_key: /etc/tls/private/tls.key
  ssl_cert: /etc/tls/private/tls.crt
  auto_escalate: True
  auth:
    - type: basic
      enabled: false

2. 设置服务账户权限

由于部分APB（如Elasticsearch）需要指定SCC（安全上下文约束），需将APB服务账户设置为cluster-admin角色：

bash
oc adm policy add-cluster-role-to-user cluster-admin system:serviceaccount:openshift-ansible-service-broker:asb

3. 配置异步绑定

已设置launch_apb_on_bind: true以支持异步绑定，需按照OpenShift异步绑定指南进行相应配置。

4. 更新ASB服务

应用配置变更并重启ASB服务：

bash
oc rollout latest dc/asb -n openshift-ansible-service-broker

5. 刷新服务目录

编辑集群服务代理配置以刷新服务列表：

bash
oc edit clusterservicebroker ansible-service-broker

增加relistRequests值并保存配置。

开发指南

创建构建

在指定项目中创建APB构建：

bash
oc new-build https://github.com/nuxeo-sandbox/nuxeo-apb-catalog --context-dir=nuxeo-apb --name=nuxeo-apb
oc new-build https://github.com/nuxeo-sandbox/nuxeo-apb-catalog --context-dir=nuxeo-mongodb-apb --name=nuxeo-mongodb-apb
oc new-build https://github.com/nuxeo-sandbox/nuxeo-apb-catalog --context-dir=nuxeo-elasticsearch-apb --name=nuxeo-elasticsearch-apb
oc new-build https://github.com/nuxeo-sandbox/nuxeo-apb-catalog --context-dir=nuxeo-kafka-apb --name=nuxeo-kafka-apb

添加构建的APBs到Registry

编辑openshift-ansible-service-broker配置映射，添加本地OpenShift registry：

yaml
registry:
  ...
  - type: local_openshift
    name: nuxeo
    namespaces: ['int-apb-dev']
    white_list: [ ".*-apb"]
  ...

开发环境配置优化

为便于开发，可调整broker配置：

yaml
...
openshift:
  ...
  image_pull_policy: Always  # 始终拉取最新镜像
  ...
broker:
  ...
  refresh_interval: 60s  # 缩短刷新间隔
  ...
...

重建APBs

重建前需清理旧镜像：

bash
oc get images | grep nuxeo.*-apb | awk '{ print $1 }' | while read i; do oc delete image $i;done
oc start-build nuxeo-apb && oc start-build nuxeo-mongodb-apb && oc start-build nuxeo-elasticsearch-apb && oc start-build nuxeo-kafka-apb

许可信息

Nuxeo平台的大部分源代码版权归Nuxeo及其贡献者所有，并根据Apache License 2.0许可。

详情请参见https://github.com/nuxeo-sandbox/nuxeo-apb-catalog/tree/master/licenses%E5%92%8C%E6%96%87%E6%A1%A3%E9%A1%B5%E9%9D%A2%E8%AE%B8%E5%8F%AF%E8%AF%B4%E6%98%8E%E3%80%82

关于Nuxeo

Nuxeo显著改进了基于内容的应用程序的构建、管理和部署方式，帮助客户提高敏捷性、创新性和成功率。Nuxeo提供下一代企业级平台，用于构建传统和前沿的内容导向型应用程序。结合强大的应用开发环境、基于SaaS的工具和模块化架构，Nuxeo平台和产品为众多知名品牌（包括Verizon、Electronic Arts、Sharp、FICO、美国海军和波音公司）提供明确的业务价值。Nuxeo总部位于纽约和巴黎，更多信息请访问[***]