docker-init-container

前言

在Senzing，我们致力于以“别让我思考”的风格创建GitHub文档。大多数情况下，指令都是可直接复制粘贴的。当需要思考时，会标记“思考”图标 :thinking:；当需要自定义时，会标记“铅笔”图标 :pencil2:。如果指令不清晰，请通过创建新的文档问题告诉我们需要改进的地方。现在进入正题...

概述

senzing/init-container执行Senzing初始化操作。

概要：

1. 在需要时，将*.template文件复制为实际文件。
2. 更改特定文件的权限和所有权。
3. 修改特定ini文件的内容。
4. 如需，向Senzing数据库SYS_CFG表填充默认配置。
5. 初始化由init-container.py脚本执行。

目录

1. 预期
2. 使用命令行界面演示
   1. CLI前提条件
   2. 下载
   3. CLI环境变量
   4. 运行命令
3. 使用Docker演示
   1. Docker前提条件
   2. 数据库支持
   3. 外部数据库
   4. 运行Docker容器
4. 配置
5. 参考

图标说明

1. :thinking: - “思考”图标表示可能需要一些额外思考。可能需要做出选择，也可能是可选步骤。
2. :pencil2: - “铅笔”图标表示执行前可能需要修改指令。
3. :warning: - “警告”图标表示有需要注意的复杂情况。

预期

• 空间： 本仓库和演示需要6 GB可用磁盘空间。
• 时间： 根据CPU和网络速度，预计需要40分钟使演示正常运行。
• 背景知识： 本仓库假设用户具备以下软件的使用知识：
  • Docker

使用命令行界面演示

CLI前提条件

:thinking: 继续之前需要完成以下任务。这些是“一次性任务”，可能已完成。

1. 安装系统依赖：
   1. 对于Debian、Ubuntu和其他基于apt的发行版：
      1. 参见apt-packages.txt获取列表
   2. 对于Red Hat、CentOS、openSuse和其他基于yum的发行版：
      1. 参见yum-packages.txt获取列表
2. 安装Python依赖：
   1. 参见requirements.txt获取列表
      1. 安装提示
3. 需要安装以下软件：
   1. senzingapi
4. :thinking: 可选： 某些数据库需要额外支持。其他数据库可跳过此步骤。
   1. Db2： 参见支持Db2。
   2. MS SQL： 参见支持MS SQL。
5. 配置Senzing数据库

下载

1. 获取init-container.py的本地副本。示例：

   1. :pencil2: 指定文件下载位置。示例：

      console
      export SENZING_DOWNLOAD_FILE=~/init-container.py
      

   2. 下载文件。示例：

      console
      curl -X GET \
        --output ${SENZING_DOWNLOAD_FILE} \
        [***]
      

   3. 使文件可执行。示例：

      console
      chmod +x ${SENZING_DOWNLOAD_FILE}
      

2. :thinking: 替代方案： 可通过克隆仓库下载整个git仓库。

CLI环境变量

1. :pencil2: 指定Senzing g2目录。示例：

   console
   export SENZING_G2_DIR=/opt/senzing/g2
   

   1. 可通过以下命令测试SENZING_G2_DIR是否正确。该命令应返回文件内容。示例：

      console
      cat ${SENZING_G2_DIR}/g2BuildVersion.json
      

2. 设置通用环境变量。示例：

   console
   export PYTHONPATH=${SENZING_G2_DIR}/sdk/python
   

3. :thinking: 设置操作系统特定环境变量。选择以下选项之一。

   1. 选项#1： 适用于Debian、Ubuntu和其他基于Debian的发行版。示例：

      console
      export LD_LIBRARY_PATH=${SENZING_G2_DIR}/lib:${SENZING_G2_DIR}/lib/debian:$LD_LIBRARY_PATH
      

   2. 选项#2： 适用于Red Hat、CentOS、openSuse和其他基于RPM的发行版。示例：

      console
      export LD_LIBRARY_PATH=${SENZING_G2_DIR}/lib:$LD_LIBRARY_PATH
      

运行命令

1. 运行命令。示例：

   console
   sudo \
     PYTHONPATH=${PYTHONPATH} \
     LD_LIBRARY_PATH=${LD_LIBRARY_PATH} \
     ${SENZING_DOWNLOAD_FILE} --help
   

2. 更多使用示例，参见CLI示例。

使用Docker演示

Docker前提条件

:thinking: 继续之前需要完成以下任务。这些是“一次性任务”，可能已完成。

1. 需要安装以下软件：
   1. docker
2. 使用Docker安装Senzing
3. 使用Docker配置Senzing数据库

数据库支持

:thinking: 可选： 某些数据库需要额外支持。其他数据库可跳过此步骤。

1. Db2： 参见支持Db2说明设置SENZING_OPT_IBM_DIR_PARAMETER。
2. MS SQL： 参见支持MS SQL说明设置SENZING_OPT_MICROSOFT_DIR_PARAMETER。

外部数据库

:thinking: 可选： 用于在外部数据库存储数据。如未指定，将使用内部SQLite数据库。

1. :pencil2: 指定数据库。示例：

   console
   export DATABASE_PROTOCOL=postgresql
   export DATABASE_USERNAME=postgres
   export DATABASE_PASSWORD=postgres
   export DATABASE_HOST=senzing-postgresql
   export DATABASE_PORT=5432
   export DATABASE_DATABASE=G2
   

2. 构建数据库URL。示例：

   console
   export SENZING_DATABASE_URL="${DATABASE_PROTOCOL}://${DATABASE_USERNAME}:${DATABASE_PASSWORD}@${DATABASE_HOST}:${DATABASE_PORT}/${DATABASE_DATABASE}"
   

3. 构建docker run参数。示例：

   console
   export SENZING_DATABASE_URL_PARAMETER="--env SENZING_DATABASE_URL=${SENZING_DATABASE_URL}"
   

运行Docker容器

尽管Docker run命令看起来复杂，但它考虑了上述所有可选变体。未设置的环境变量对docker run命令无影响，可删除或保留。

1. 运行Docker容器。示例：

   console
   sudo docker run \
     --rm \
     ${SENZING_DATABASE_URL_PARAMETER} \
     ${SENZING_OPT_IBM_DIR_PARAMETER} \
     ${SENZING_OPT_MICROSOFT_DIR_PARAMETER} \
     senzing/init-container
   

2. 更多使用示例，参见Docker示例。

配置

通过环境变量或命令行参数指定的配置值。

• SENZING_DATABASE_URL
• SENZING_DEBUG

参考

1. 开发
2. 错误
3. 示例
4. 相关制品：
   1. DockerHub
   2. Helm Chart