senzing/init-container

docker-init-container

前言

在Senzing，我们致力于以“https://github.com/Senzing/knowledge-base/blob/main/WHATIS/dont-make-me-think.md%E2%80%9D%E7%9A%84%E9%A3%8E%E6%A0%BC%E5%88%9B%E5%BB%BAGitHub%E6%96%87%E6%A1%A3%E3%80%82%E5%A4%A7%E5%A4%9A%E6%95%B0%E6%83%85%E5%86%B5%E4%B8%8B%EF%BC%8C%E6%8C%87%E4%BB%A4%E9%83%BD%E6%98%AF%E5%8F%AF%E7%9B%B4%E6%8E%A5%E5%A4%8D%E5%88%B6%E7%B2%98%E8%B4%B4%E7%9A%84%E3%80%82%E5%BD%93%E9%9C%80%E8%A6%81%E6%80%9D%E8%80%83%E6%97%B6%EF%BC%8C%E4%BC%9A%E6%A0%87%E8%AE%B0%E2%80%9C%E6%80%9D%E8%80%83%E2%80%9D%E5%9B%BE%E6%A0%87 :thinking:；当需要自定义时，会标记“铅笔”图标 :pencil2:。如果指令不清晰，请通过创建新的https://github.com/Senzing/docker-init-container/issues/new?template=documentation_request.md%E5%91%8A%E8%AF%89%E6%88%91%E4%BB%AC%E9%9C%80%E8%A6%81%E6%94%B9%E8%BF%9B%E7%9A%84%E5%9C%B0%E6%96%B9%E3%80%82%E7%8E%B0%E5%9C%A8%E8%BF%9B%E5%85%A5%E6%AD%A3%E9%A2%98...

概述

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分钟使演示正常运行。
• 背景知识： 本仓库假设用户具备以下软件的使用知识：
  • https://github.com/Senzing/knowledge-base/blob/main/WHATIS/docker.md

使用命令行界面演示

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. https://github.com/Senzing/knowledge-base/blob/main/HOWTO/install-python-dependencies.md
3. 需要安装以下软件：
   1. https://github.com/Senzing/knowledge-base/blob/main/HOWTO/install-senzing-api.md
4. :thinking: 可选： 某些数据库需要额外支持。其他数据库可跳过此步骤。
   1. Db2： 参见https://github.com/Senzing/knowledge-base/blob/main/HOWTO/support-db2.md%E3%80%82
   2. MS SQL： 参见https://github.com/Senzing/knowledge-base/blob/main/HOWTO/support-mssql.md%E3%80%82
5. https://github.com/Senzing/knowledge-base/blob/main/HOWTO/configure-senzing-database.md

下载

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

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

      console
      export SENZING_DOWNLOAD_FILE=~/init-container.py
      

   2. 下载文件。示例：

      console
      curl -X GET \
        --output ${SENZING_DOWNLOAD_FILE} \
        https://raw.githubusercontent.com/Senzing/docker-init-container/main/init-container.py
      

   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. https://github.com/Senzing/knowledge-base/blob/main/WHATIS/docker.md
2. https://github.com/Senzing/knowledge-base/blob/main/HOWTO/install-senzing-using-docker.md
3. https://github.com/Senzing/knowledge-base/blob/main/HOWTO/configure-senzing-database-using-docker.md

数据库支持

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

1. Db2： 参见https://github.com/Senzing/knowledge-base/blob/main/HOWTO/support-db2.md%E8%AF%B4%E6%98%8E%E8%AE%BE%E7%BD%AE%60SENZING_OPT_IBM_DIR_PARAMETER%60%E3%80%82
2. MS SQL： 参见https://github.com/Senzing/knowledge-base/blob/main/HOWTO/support-mssql.md%E8%AF%B4%E6%98%8E%E8%AE%BE%E7%BD%AE%60SENZING_OPT_MICROSOFT_DIR_PARAMETER%60%E3%80%82

外部数据库

: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示例。

配置

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

• https://github.com/Senzing/knowledge-base/blob/main/lists/environment-variables.md#senzing_database_url
• https://github.com/Senzing/knowledge-base/blob/main/lists/environment-variables.md#senzing_debug

参考

1. 开发
2. 错误
3. 示例
4. 相关制品：
   1. https://hub.docker.com/r/senzing/init-container
   2. https://github.com/Senzing/charts/tree/main/charts/senzing-init-container