nuxeoapbcatalog/nuxeo-arender-monitoring-apb

Nuxeo ARender Monitor APB

镜像概述和主要用途

该Ansible Playbook Bundle (APB) 用于在OpenShift环境中部署ARender监控栈，提供ARender监控实例的生命周期管理，包括部署（provision）和卸载（deprovision）操作。

核心功能和特性

• 基于Ansible Playbook实现ARender监控实例的自动化部署与卸载
• 通过配置文件和变量管理实现灵活的部署参数自定义
• 采用模板化资源定义，避免硬编码资源名称，便于维护和扩展
• 支持OpenShift项目上下文切换，适配不同环境需求

使用场景和适用范围

适用于需要在OpenShift集群中部署和管理ARender监控栈的场景，主要面向系统管理员或DevOps工程师，用于监控ARender服务的运行状态。

前提条件

构建该镜像包需先安装https://github.com/ansibleplaybookbundle/ansible-playbook-bundle/blob/master/docs/apb_cli.md#installing-the-apb-tool%E3%80%82

构建Docker镜像

使用以下命令构建Docker镜像：

console
# make build
apb prepare
Running APB image: docker.io/ansibleplaybookbundle/apb-tools:canary
Finished writing dockerfile.
docker build -t docker.io/nuxeo-arender-previewer-apb/nuxeo-arender-previewer:latest .
Sending build context to Docker daemon   89.6kB
Step 1/7 : FROM ansibleplaybookbundle/apb-base
 ---> 1f7ea01fe3a0
Step 2/7 : LABEL "com.redhat.apb.spec"="LS0tCnZlcnNpb246IDEuMApuYW1lOiBudXhlby1hcmVuZGVyLXJlbmRpdGlvbi1hcGIKZGVzY3JpcHRpb246IEFSZW5kZXIgUmVuZGl0aW9uIGRlcGxveW1lbnQgaW4gT3BlbnNoaWZ0IGZvciBOdXhlbwpiaW5kYWJsZTogVHJ1ZQphc3luYzogb3B0aW9uYWwKdGFnczoKICAtIG51eGVv
...
CiAgLSBudXhlby1hcmVuZGVyLXJlbmRpdGlvbgptZXRhZGF0YToKICBkaXNwbGF5TmFtZTogQVJlbmJXWCkKICAgICAgZGlzcGxheV9ncm91cDogQ29udGFpbmVyIFNwZWNzCgogICAgLSBuYW1lOiBhcmVuZGVyX2RlYnVnX3BvZAogICAgICBkZWZhdWx0OiBmYWxzZQogICAgICB0eXBlOiBib29sZWFuCiAgICAgIGRpc3BsYXlfdHlwZTogY2hlY2tib3gKICAgICAgdGl0bGU6IERlcGxveSBhIGRlYnVnIHBvZAogICAgICBkaXNwbGF5X2dyb3VwOiBPdGhlcnMKCg=="
 ---> Using cache
 ---> 8008090e4108
Step 3/7 : ADD playbooks /opt/apb/actions
 ---> Using cache
 ---> 9a56432a5881
Step 4/7 : ADD . /opt/ansible/roles/nuxeo-arender-apb/
 ---> c75b0dd320fe
Step 5/7 : ADD . /opt/ansible/roles/nuxeo-arender-previewer-apb/
 ---> eaea3b7000a4
Step 6/7 : RUN chmod -R g=u /opt/{ansible,apb}
 ---> Running in aab9559a7e51
Removing intermediate container aab9559a7e51
 ---> abc3866aa64a
Step 7/7 : USER apb
 ---> Running in a2a1f8062f40
Removing intermediate container a2a1f8062f40
 ---> ebf9108618ef
Successfully built ebf9108618ef
Successfully tagged nuxeo-arender-previewer-apb/nuxeo-arender-previewer:latest

部署ARender监控实例

1. 查看并调整config.json文件中的配置参数，参数定义与apb.yaml一致，默认值可在apb.yaml或defaults/main.yml中找到。

2. 切换到目标OpenShift项目：

   console
   # oc project int-arender-dev
   Now using project "int-arender-dev" on server "https://myserver:443".
   

3. 执行部署命令：

   console
   # make provision
   DEPRECATED: APB playbooks should be stored at /opt/apb/project
    [WARNING]: Found variable using reserved name: name
   
   
   PLAY [Playbook to provision an ARender Previewer service] **********************
   
   
   ...
   
   
   
   PLAY RECAP *********************************************************************
   localhost                  : ok=6    changed=5    unreachable=0    failed=0
   

卸载ARender监控实例

使用以下命令卸载ARender监控实例：

console
make deprovision

工作原理

该APB通过在OpenShift项目上下文中执行Ansible playbook实现功能，支持provision（部署）和deprovision（卸载）两种操作。

• 执行入口为tasks/main.yml文件，该文件通过迭代规则渲染templates目录下的文件，并将渲染结果传递给Kubernetes客户端。
• 变量默认值存储在defaults/main.yml中。
• 资源名称等关键信息定义在vars/main.yml中，通过变量引用实现资源名称的统一管理，避免硬编码。