irc – Send a message to an IRC channel

From Get docs
Ansible/docs/2.7/modules/irc module


irc – Send a message to an IRC channel

Synopsis

  • Send a message to an IRC channel. This is a very simplistic implementation.

Requirements

The below requirements are needed on the host that executes this module.

  • socket

Parameters

Parameter Choices/Defaults Comments

channel

- / required

Channel name. One of nick_to or channel needs to be set. When both are set, the message will be sent to both of them.

color

-

  • none

  • white
  • black
  • blue
  • green
  • red
  • brown
  • purple
  • orange
  • yellow
  • light_green
  • teal
  • light_cyan
  • light_blue
  • pink
  • gray
  • light_gray

Text color for the message. ("none" is a valid option in 1.6 or later, in 1.6 and prior, the default color is black, not "none"). Added 11 more colors in version 2.0.

key

-

added in 1.7

Channel key

msg

- / required

The message body.

nick

-

Default:

"ansible"

Nickname to send the message from. May be shortened, depending on server's NICKLEN setting.

nick_to

-

added in 2.0

A list of nicknames to send the message to. One of nick_to or channel needs to be set. When both are defined, the message will be sent to both of them.

part

boolean

added in 2.0

  • no
  • yes

Designates whether user should part from channel after sending message or not. Useful for when using a faux bot and not wanting join/parts between messages.

passwd

-

Server password

port

-

Default:

6667

IRC server port number

server

-

Default:

"localhost"

IRC server name/address

style

-

added in 2.0

  • bold
  • underline
  • reverse
  • italic

Text style for the message. Note italic does not work on some clients

timeout

-

added in 1.5

Default:

30

Timeout to use while waiting for successful registration and join messages, this is to prevent an endless loop

topic

-

added in 2.0

Set the channel topic

use_ssl

boolean

added in 1.8

  • no

  • yes

Designates whether TLS/SSL should be used when connecting to the IRC server



Examples

- irc:
    server: irc.example.net
    channel: #t1
    msg: Hello world

- local_action:
    module: irc
    port: 6669
    server: irc.example.net
    channel: #t1
    msg: 'All finished at {{ ansible_date_time.iso8601 }}'
    color: red
    nick: ansibleIRC

- local_action:
    module: irc
    port: 6669
    server: irc.example.net
    channel: #t1
    nick_to:
      - nick1
      - nick2
    msg: 'All finished at {{ ansible_date_time.iso8601 }}'
    color: red
    nick: ansibleIRC

Status

Authors

  • “Jan-Piet Mens (@jpmens)”
  • “Matt Martz (@sivel)”

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/irc_module.html