Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/idealista/nextcloud_role
Nextcloud role
https://github.com/idealista/nextcloud_role
nextcloud nextcloud-installation nextcloud-server
Last synced: 11 days ago
JSON representation
Nextcloud role
- Host: GitHub
- URL: https://github.com/idealista/nextcloud_role
- Owner: idealista
- License: apache-2.0
- Created: 2021-10-14T15:38:43.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-01-04T17:56:29.000Z (almost 3 years ago)
- Last Synced: 2023-02-26T19:22:37.109Z (almost 2 years ago)
- Topics: nextcloud, nextcloud-installation, nextcloud-server
- Language: Jinja
- Homepage:
- Size: 97.7 KB
- Stars: 0
- Watchers: 8
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Nextcloud Ansible role
[](https://app.travis-ci.com/github/idealista/nextcloud_role)
[](https://galaxy.ansible.com/idealista/nextcloud_role)
This ansible role installs [Nextcloud](https://docs.nextcloud.com/) in a Debian environment. It has been tested for the following Debian versions:
* Buster
This role has been generated using the [cookiecutter](https://github.com/cookiecutter/cookiecutter) tool, you can generate a similar role that fits your needs using the this [cookiecutter template](https://github.com/idealista/cookiecutter-ansible-role).
- [Getting Started](#getting-started)
- [Prerequisities](#prerequisities)
- [Installing](#installing)
- [Usage](#usage)
- [Testing](#testing)
- [Built With](#built-with)
- [Versioning](#versioning)
- [Authors](#authors)
- [License](#license)
- [Contributing](#contributing)
## Getting Started
These instructions will get you a copy of the role for your Ansible playbook. Once launched, it will install Nextcloud in a Debian system.
### Prerequisities
Ansible 4.4.0 version installed.
Molecule 3.x.x version installed.
Inventory destination should be a Debian environment with [PHP](https://github.com/idealista/php_role) and [NGINX](https://github.com/idealista/nginx_role) installed.
You will also need an accessible database for nextcloud. This role supports [MariaDB, MySQL](https://github.com/idealista/mysql_role) and [PostgreSQL](https://github.com/idealista/postgresql_role) databases.
Do not forget to adjust variables such as ``database_type`` and ``database_hosts`` to your convenience.
For testing purposes, [Molecule](https://molecule.readthedocs.io/) with [Docker](https://www.docker.com/) as driver and [Goss](https://github.com/aelsabbahy/goss) as verifier.
### Installing
Create or add to your roles dependency file (e.g requirements.yml):
```
- src: idealista.nextcloud_role
version: 1.0.0
name: nextcloud_role
```
Install the role with ansible-galaxy command:
```
ansible-galaxy install -p roles -r requirements.yml -f
```
Use in a playbook:
```
---
- hosts: someserver
roles:
- role: nextcloud_role
```
## Usage
Look to the [defaults](defaults/main.yml) properties file to see the possible configuration properties, it is very likely that you will not need to override any variables.
## Testing
### Install dependencies
```sh
$ pipenv sync
```
For more information read the [pipenv docs](ipenv-fork.readthedocs.io/en/latest/).
### Testing
```sh
$ pipenv run molecule test
```
## Built With
## Versioning
For the versions available, see the [tags on this repository](https://github.com/idealista/nextcloud_role/tags).
Additionaly you can see what change in each version in the [CHANGELOG.md](CHANGELOG.md) file.
## Authors
* **Idealista** - *Work with* - [idealista](https://github.com/idealista)
See also the list of [contributors](https://github.com/idealista/nextcloud_role/contributors) who participated in this project.
## License
This project is licensed under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) license - see the [LICENSE](LICENSE) file for details.
## Contributing
Please read [CONTRIBUTING.md](.github/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.