bring up your nextcloud usage to the next level ????
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Markus Bergholz 7369ee1839 add envrc to gitignore 2 years ago
plugins add delete methode and change error handling for missing host, user or token 2 years ago
.gitignore add envrc to gitignore 2 years ago
.gitlab-ci.yml #2 test basic build 2 years ago
LICENSE Initial commit 2 years ago
Makefile update helper Makefile 2 years ago
README.md reorder sections 2 years ago
galaxy.yml add description 2 years ago

README.md

nextcloud_collection

Ansible Nextcloud Collection - is not meant to install nor to maintain your nextcloud itself.
It's meant to bring up your nextcloud usage to the next level

Features

  • 🔑 lookup plugin for passwords app
  • 💾 file module to download, upload and delete files
    • status: work in progress
  • 🗨 talk module to post messages in conversations
    • status: todo

Usage

Install

https://galaxy.ansible.com/markuman/nextcloud

ansible-galaxy collection install markuman.nextcloud

Auth

You must authenticate with an app token. (Settings -> Security -> "Create new app password")

The collection modules and plugins require the following parameter (the parameter can also be set via ENV variable).

Parameter ENV Variable
host NEXTCLOUD_HOST
user NEXTCLOUD_USER
api_token NEXTCLOUD_TOKEN

lookup passwords

- name: Retrieve Password with label "Stackoverflow"
  debug:
    var: lookup('markuman.nextcloud.passwords', 'Stackoverflow' , host='nextcloud.tld', user='ansible', api_token='some-token')

file module

work in progress

- name: fetch file from nextcloud
  markuman.nextcloud.file:
    mode: get
    src: anythingeverything.jpg
    dest: /tmp/anythingeverything.jpg
    host: nextcloud.tld
    user: myuser
    api_token: xxx

SCM

host category
https://git.osuv.de/m/nextcloud_collection origin
https://gitlab.com/markuman/nextcloud_collection pull mirror
https://github.com/markuman/nextcloud_collection push mirror