community.general.matrix 模块 – 发送通知到 Matrix

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您使用的是 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.general。您需要更多要求才能使用此模块，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定： community.general.matrix。

概要 

此模块将 HTML 格式的通知发送到 Matrix 房间。

要求 

执行此模块的主机需要以下要求。

matrix-client (Python 库)

参数 

参数	注释
hs_url 字符串 / 必需	homeserver 的 URL，CS-API 可在此处访问
msg_html 字符串 / 必需	要发送到 Matrix 的消息的 HTML 形式
msg_plain 字符串 / 必需	要发送到 Matrix 的消息的纯文本形式，通常是 Markdown
password 字符串	用于登录的密码
room_id 字符串 / 必需	要将通知发送到的房间的 ID
token 字符串	用于 API 调用的身份验证令牌。如果提供，则不需要 user_id 和 password
user_id 字符串	用户的用户 ID

属性 

属性	支持	描述
check_mode	支持: 完全支持	可以在 `check_mode` 中运行并返回已更改状态预测，而无需修改目标。
diff_mode	支持: 不支持	当处于差异模式时，将返回有关已更改的内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

示例 

- name: Send matrix notification with token
  community.general.matrix:
    msg_plain: "**hello world**"
    msg_html: "<b>hello world</b>"
    room_id: "!12345678:server.tld"
    hs_url: "https://matrix.org"
    token: "{{ matrix_auth_token }}"

- name: Send matrix notification with user_id and password
  community.general.matrix:
    msg_plain: "**hello world**"
    msg_html: "<b>hello world</b>"
    room_id: "!12345678:server.tld"
    hs_url: "https://matrix.org"
    user_id: "ansible_notification_bot"
    password: "{{ matrix_auth_password }}"

作者

Jan Christian Grünhage (@jcgruenhage)