安装

这些说明将指导您在本地系统上安装 ansible-rulebook CLI。在开始安装过程之前,请确保您已安装**需求**部分中列出的所有组件。

需求

  • Python >= 3.9

  • Python 3 pip

  • Java 开发工具包 >= 17

    • Fedora:java-17-openjdk

    • Ubuntu:openjdk-17-jdk

通过 pip 安装

  1. 如果您有多个 Java 安装,请确保已设置 JAVA_HOME 环境变量。在 Fedora 类系统上,它应该是

    JAVA_HOME=/usr/lib/jvm/jre-17-openjdk
    
  2. 通过 pip 安装 ansible-rulebook 及其依赖项

    pip install ansible-rulebook ansible ansible-runner
    

注意

ansible-rulebook 依赖于 jpy Python 包来与 Java 运行时进行通信。此包为大多数常见平台提供了轮子,但并非所有平台都支持。如果您使用的平台不受 jpy 轮子支持,则需要自行编译。有关更多信息,请参阅编译 jpy 部分

3. 安装 ansible.eda 集合,该集合附带各种事件源插件和过滤器,可帮助您入门。请参阅集合存储库中的说明。

安装示例

在 Fedora 类系统上

dnf --assumeyes install java-17-openjdk python3-pip
export JAVA_HOME=/usr/lib/jvm/jre-17-openjdk
pip3 install ansible ansible-rulebook ansible-runner

在 Ubuntu 系统上

apt-get --assume-yes install openjdk-17-jdk python3-pip
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$PATH:~/.local/bin
pip3 install ansible ansible-rulebook ansible-runner

编译 jpy

要在安装时从源代码编译 jpy,您需要安装其他依赖项

  • maven

  • gcc

  • python-devel 包
    • Fedora:python3-devel

    • Ubuntu:python3-dev

  • 环境变量 JAVA_HOME 设置为 Java 安装路径

然后,您可以运行

pip install ansible-rulebook --no-binary jpy

有关更多信息,请参阅jpy 项目