nuxeo/nuxeo-init-container

Nuxeo初始化容器

镜像概述和主要用途

该容器用作Kubernetes初始化容器（init container），基于挂载的卷在/etc/nuxeo/conf.d目录中生成绑定配置，为Nuxeo应用提供必要的配置文件。

核心功能和特性

• 作为Kubernetes初始化容器运行，在主应用容器启动前完成配置生成
• 基于卷挂载的内容动态生成Nuxeo绑定配置
• 配置文件输出到/etc/nuxeo/conf.d目录，供主应用容器使用

使用场景和适用范围

适用于在Kubernetes或OpenShift环境中部署Nuxeo应用时，需要在应用启动前基于外部凭证（如数据库、搜索引擎等服务的凭证）生成配置文件的场景。

构建方法

shell
$ docker build -t nuxeo-init .

测试方法

1. 安装shunit2（https://github.com/kward/shunit2%EF%BC%89
2. 运行测试脚本：

shell
$ ./test.sh

使用方法

以下是OpenShift DeploymentConfig的使用示例，展示了如何将该初始化容器集成到Nuxeo部署中：

yaml
apiVersion: apps.openshift.io/v1
kind: DeploymentConfig
metadata:
  component: nuxeo
  name: nuxeo
spec:
  replicas: 1
  selector:
    component: nuxeo
    deploymentconfig: nuxeo
  template:
    metadata:
      labels:
        component: nuxeo
        deploymentconfig: nuxeo
    spec:
      initContainers:
        - image: 'dmetzler/nuxeo-init-container:latest'
          name: bind
          volumeMounts:
            - mountPath: /etc/nuxeo/conf.d
              name: nuxeoconfd  # 配置文件输出目录
            - mountPath: /var/lib/nuxeo/data
              name: data  # 数据卷
            - mountPath: /opt/nuxeo/bindings/mongodb
              name: mongodb-credentials  # MongoDB凭证卷
            - mountPath: /opt/nuxeo/bindings/elasticsearch
              name: elasticsearch-credentials  # Elasticsearch凭证卷
      containers:
        - env:
            - name: JAVA_OPTS
              value: '-Djava.net.preferIPv4Stack=true'
            - name: NUXEO_BINARY_STORE
              value: /var/lib/nuxeo/binaries/binaries
            - name: NUXEO_URL
              value: nuxeo.mynuxeo.com
            - name: NUXEO_ENV_NAME
              value: nuxeo
            - name: NUXEO_CLID
              value: >-
                XXXXXXX
          image: nuxeo11
          livenessProbe:
            failureThreshold: 5
            httpGet:
              path: /nuxeo/runningstatus
              port: 8080
              scheme: HTTP
            initialDelaySeconds: 60
            periodSeconds: 10
            successThreshold: 1
            timeoutSeconds: 5
          name: nuxeo
          ports:
            - containerPort: 8080
              protocol: TCP
          readinessProbe:
            failureThreshold: 5
            httpGet:
              path: /nuxeo/runningstatus
              port: 8080
              scheme: HTTP
            initialDelaySeconds: 60
            periodSeconds: 10
            successThreshold: 1
            timeoutSeconds: 5
          volumeMounts:
            - mountPath: /etc/nuxeo/conf.d
              name: nuxeoconfd  # 挂载初始化容器生成的配置
            - mountPath: /var/lib/nuxeo/binaries
              name: binaries
            - mountPath: /var/log/nuxeo
              name: logs
            - mountPath: /var/lib/nuxeo/data
              name: data
            - mountPath: /opt/nuxeo/server/tmp
              name: nuxeotmp
      volumes:
        - name: binaries
          persistentVolumeClaim:
            claimName: nuxeo11-sandbox-dev-binaries-pvc
        - emptyDir: {}
          name: logs
        - emptyDir: {}
          name: data
        - emptyDir: {}
          name: nuxeotmp
        - emptyDir: {}
          name: nuxeoconfd  # 共享卷，用于传递配置文件
        - name: mongodb-credentials
          secret:
            defaultMode: 420
            secretName: nuxeo11-sandbox-dev-mongodb-credentials
        - name: elasticsearch-credentials
          secret:
            defaultMode: 420
            secretName: nuxeo11-sandbox-dev-elasticsearch-credentials

配置说明

• 卷挂载要求：初始化容器需要挂载/etc/nuxeo/conf.d（配置输出目录）和相关服务凭证卷（如MongoDB、Elasticsearch等）
• 共享卷：nuxeoconfd卷需同时挂载到初始化容器和主应用容器，以实现配置文件的传递
• 凭证卷：外部服务凭证（如数据库密码等）通过secret挂载到/opt/nuxeo/bindings/下的对应目录，供初始化容器生成配置使用