Table of Contents

markuman.nextcloud

Install

requirements:
Authentication

ssl_mode

Modules
lookup plugins
callback plugins
Install Role

Developing / Testing / Hacking

markuman.nextcloud

markuman.nextcloud.nextcloud installation role
- install, maintain and administrate the nextcloud installation
- ssh required
markuman.nextcloud modules and lookup plugins
- bring up your nextcloud usage to the next level 🚀 - devops and automation
- ssh not required

Install

Latest release from galaxy.ansible.com

ansible-galaxy collection install markuman.nextcloud

Install from scm

ansible-galaxy collection install git+https://github.com/markuman/markuman.nextcloud

requirements:

ansible >= 2.9.10
python3
- requests
- pysodium (passwords E2EE)

Authentication

Every module and plugin supports the following parameters for authentication and communication with your nextcloud instance.

  module_defaults:
    markuman.nextcloud.file:
      host: localhost
      user: ansible
      api_token: nextcloud_collection
      ssl_mode: skip

Every parameter can also be set via an ENV variable.

Ansible Parameter	ENV Variable
`host`	`NEXTCLOUD_HOST`
`user`	`NEXTCLOUD_USER`
`api_token`	`NEXTCLOUD_TOKEN`
`ssl_mode`	`NEXTCLOUD_SSL_MODE`

ssl_mode

ssl_mode parameters default value is https.

Possible values https, http, skip (skips ssl verification)

Modules

file - download, upload and delete files
file_info - collect information about files and folders
talk - post messages in conversations
user - enable/disable users
user_info - list nextcloud users
password - create, update and delete passwords
password_info - read-out passwords details

lookup plugins

passwords - read-out passwords
generate_password - receive random generated random password from passwords

callback plugins

talk - writes playbook output to a nextcloud talk conversation

Install Role

Role markuman.nextcloud - to install nextcloud

Developing / Testing / Hacking

development