nuxeoapbcatalog/nuxeo-apb

Nuxeo Ansible剧本捆绑包目录

本仓库包含用于部署Nuxeo内容服务平台容器及其依赖后端服务容器的Ansible剧本捆绑包（APB）。详情参见https://github.com/ansibleplaybookbundle/ansible-playbook-bundle%E6%96%87%E6%A1%A3%E5%92%8CAutomation Broker文档。

APB已发布至DockerHub的https://hub.docker.com/r/nuxeoapbcatalog/%E7%BB%84%E7%BB%87%E3%80%82

镜像概述和主要用途

该镜像集合提供了自动化部署Nuxeo内容服务平台及其依赖服务（如MongoDB、Elasticsearch、Kafka等）的Ansible剧本捆绑包。通过集成Ansible服务代理（ASB），可将这些APB添加到服务目录，实现Nuxeo平台及相关服务的自动化部署与管理。

核心功能和特性

• 提供Nuxeo平台及依赖服务的完整部署剧本
• 支持DockerHub和本地OpenShift注册表集成
• 兼容Ansible服务代理和自动化代理
• 支持OpenShift环境下的服务部署与权限配置
• 包含开发环境构建与更新机制

使用场景和适用范围

适用于需要通过Ansible自动化部署Nuxeo内容服务平台的场景，特别是在OpenShift容器平台环境中，需要快速部署Nuxeo及其依赖服务（数据库、搜索引擎、消息队列等）的企业级应用场景。

使用方法和配置说明

激活APB

在Ansible服务代理配置中添加以下片段以激活Nuxeo APB：

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

权限配置

注意sandbox_role设置为cluster-admin，因为部分APB（如Elasticsearch）需要指定安全上下文约束（SCC）。需为APB服务账户授予cluster-admin角色：

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

异步绑定配置

由于使用异步绑定，需将launch_apb_on_bind设置为true。同时需按照OpenShift异步绑定文档进行相应配置。

应用配置并刷新服务

应用新配置并重启ASB服务：

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

更新集群服务代理以重新列出服务：

bash
oc edit clusterservicebroker ansible-service-broker

在编辑界面中增加relistRequests值并保存。

开发指南

创建构建

在指定项目中创建以下构建：

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

添加构建的APB到注册表

编辑openshift-ansible-service-broker配置映射：

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

为方便开发，可调整代理配置：

yaml
...
openshift:
  ...
  image_pull_policy: Always
  ...
broker:
  ...
  refresh_interval: 60s
  ...
...

重建APB

重建前需删除旧镜像：

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许可。

详情参见/licenses和文档页面许可。

关于Nuxeo

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