Ansibullbot

Galaxy Build Status

Install Ansibullbot, your friendly neighborhood GitHub assistant.

Requirements

GitHub and Azure Pipelines credentials with appropriate permissions. This doesn't do much good unless the credentials have acces to the Ansible GitHub repository.

Role Variables

Name Default Value Description
ansibullbot_action install Set of tasks to run. Options are install and update.
ansibullbot_user ansibot User account that will run ansibullbot
ansibullbot_group {{ ansibullbot_user }} Group that ansibullbot_user belongs to.
ansibullbot_repo_url https://github.com/ansible/ansibullbot URL of the ansibullbot git repo.
ansibullbot_branch devel Branch of the ansibullbot git repo to checkout.
ansibullbot_home_dir /var/lib/{{ ansibullbot_user }} Where to create home directory for Ansibullbot user.
ansibullbot_clone_path {{ ansibullbot_home_dir }}/ansibullbot Where to clone the ansibullbot git repository.
ansibullbot_log_path /var/log/ansibullbot.log Path to log file.
ansibullbot_enable_receiver no Whether or not to enaable the ansibullbot_receiver service. Requires
ansibullbot_cache_days_to_keep 30 How many days wort of cache files to keep.
ansibullbot_debug True Whether or not to enable debugging.
ansibullbot_ci_provider azp CI platform the bot will interact with. Only azp is supported at this time.
ansibullbot_github_username ansibot GitHub account used for authenticating to the GitHub API.
ansibullbot_github_password '' Password for authenticating to the GitHub. This should be stored in an Ansible Vault.
ansibullbot_github_token '' GitHub API token used to talk to GitHub. This should be stored in an Ansible Vault.
ansibullbot_receiver_host `` Database where data is sent.
ansibullbot_receiver_port '' Database port.
ansibullbot_repos [undefined] List of repositories the bot will interact with.
ansibullbot_maintainers [undefined] List of GitHub groups in which repository maintainers are in.
ansibullbot_packages [see defaults/main.yml] List of packages to install.
ansibullbot_slack_message Updating Ansibullbot Message posted to Slack when updating Anisbullbot.
ansibullbot_slack_token [] Slack API toke. This should be stored in an Ansible Vault.
ansibullbot_sentry_url ~ URL of the Sentry server.
ansibullbot_sentry_env prod Sentry environment
ansibullbot_sentry_trace true Whether or not to collect trace information and send to Sentry.
ansibullbot_sentry_server_name ansibullbot Unique name used to identify this server in Sentry.
ansibullbot_azp [undefined] Dictionary of config options put in the azp section of ansibullbot.cfg.

Dependencies

  • samdoran.repo_epel
  • community.general collection

Example Playbook

- hosts: all
  roles:
      - samdoran.repo_epel
      - samdoran.firewall
      - samdoran.fail2ban
      - samdoran.ansibullbot

License

Apache 2.0