跳到主要内容

初始化软件事件代理容器

当您初始化一个容器时,您需要将容器的配置信息传递给运行时引擎。根据您的运行环境,执行此操作的机制不同。例如,对于Podman,您可以通过命令行参数向podman create命令传递参数来设置容器名称、端口分配等。

您可以设置容器的配置项之一是其环境变量(对于docker createpodman create命令,您使用-env参数)。您可以通过设置相应的环境变量将配置键传递给软件事件代理。配置键仅在软件事件代理容器初始启动或重新加载到默认配置后评估。

将配置键作为环境变量传递

您可以通过将配置键作为环境变量来指定代理特定的配置。配置键仅在容器首次启动且数据库不存在时生效。

要将配置键作为环境变量传递,将变量名称设置为配置键层次结构与下划线字符连接。例如,要设置username/<name>/globalaccesslevel配置键的值,请使用以下环境变量:

username_<name>_globalaccesslevel

要设置username/<name>/globalaccesslevelusername/<name>/password配置键,为admin用户分配密码admin,请在docker createpodman create命令中添加以下行:

--env 'username_admin_globalaccesslevel=admin'
--env 'username_admin_password=admin'

对于部分键传递给容器的配置键,这些部分不能包含下划线。例如,包含<name>作为键的配置键(例如redundancy/group/node/<name>/connectvia)不能在<name>中包含下划线字符。

软件事件代理的配置键

要了解您可以与软件事件代理一起使用的配置键,请参阅配置键。

<name>键的可接受值

对于指定<name>值的配置键,例如usernamemessagevpnredundancy配置键,名称必须仅由小写字母和数字组成。

分配端口号

在为配置键分配端口号之前,请参考软件事件代理的默认配置,了解各种软件事件代理服务的默认端口分配,以帮助防止端口分配冲突。

其他环境变量

除了配置键之外,还可以设置其他环境变量。这些环境变量由容器的操作系统处理。与配置键不同,这些环境变量在容器重新启动时生效。在以下示例中,使用--env参数(对于docker createpodman create)设置了UMASK和TZ(时区)环境变量。此配置将在每次容器重新启动时生效。

--env 'TZ=Canada/Eastern'
--env 'umask=0022'

下表列出了可用的环境变量。

环境变量

环境变量描述
TZ=<timezone>软件事件代理的时区配置。<timezone>有关更多信息,请参见设置时区。
UMASK应用程序创建的所有文件和目录的Umask。<umask>默认umask为077。umask仅影响新创建文件的权限;卷中现有文件的权限保持不变。