Compare commits
No commits in common. "main" and "v1.0.0" have entirely different histories.
@ -4,7 +4,6 @@ extends: default
|
||||
|
||||
ignore: |
|
||||
molecule/**/tests/
|
||||
.venv/
|
||||
.github
|
||||
.travis.yml
|
||||
|
||||
|
11
CHANGELOG.md
11
CHANGELOG.md
@ -2,17 +2,6 @@
|
||||
|
||||
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
|
||||
|
||||
### [1.1.2](https://git.laurivan.com/laur/ansible-role-mealie/compare/v1.1.1...v1.1.2) (2023-01-12)
|
||||
|
||||
### [1.1.1](https://git.laurivan.com/laur/ansible-role-mealie/compare/v1.1.0...v1.1.1) (2023-01-12)
|
||||
|
||||
## [1.1.0](https://git.laurivan.com/laur/ansible-role-mealie/compare/v1.0.0...v1.1.0) (2023-01-11)
|
||||
|
||||
|
||||
### Bug Fixes
|
||||
|
||||
* Update tags for ansible galaxy. ([632f196](https://git.laurivan.com/laur/ansible-role-mealie/commit/632f1969765b995bb4a693d0646e9397bb9f04a3))
|
||||
|
||||
## 1.0.0 (2023-01-09)
|
||||
|
||||
|
||||
|
@ -2,67 +2,4 @@
|
||||
|
||||
Contributions (pull requests, feature requests, and so on) are accepted on project Github.com page. Creating Issue before pull request is preffered. Acceptation is not automatic, project management can reject it, or request changes.
|
||||
|
||||
Issues (bugs and feature request) reports are accepted on project Github.
|
||||
|
||||
## Getting Started
|
||||
|
||||
These instructions will get you a copy of the role for your Ansible playbook. Once launched, it will install Mealie.
|
||||
|
||||
### Prerequisities
|
||||
|
||||
Ansible 5.2.0 version installed.
|
||||
|
||||
Molecule 3.x.x version installed.
|
||||
|
||||
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):
|
||||
|
||||
```yml
|
||||
- src: ansible-role-mealie
|
||||
version: 1.0.0
|
||||
name: laurivan.mealie
|
||||
```
|
||||
|
||||
Install the role with ansible-galaxy command:
|
||||
|
||||
```sh
|
||||
ansible-galaxy install -p roles -r requirements.yml -f
|
||||
```
|
||||
|
||||
Use in a playbook:
|
||||
|
||||
```yml
|
||||
---
|
||||
- hosts: someserver
|
||||
roles:
|
||||
- role: laurivan.mealie
|
||||
```
|
||||
|
||||
## 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](https://pipenv-fork.readthedocs.io/en/latest/).
|
||||
|
||||
### Run test
|
||||
|
||||
```sh
|
||||
pipenv run molecule test
|
||||
```
|
||||
|
||||
## Versioning
|
||||
|
||||
For the versions available, see the [tags on this repository](https://git.laurivan.com/Dev/ansible-role-mealie/tags).
|
||||
|
||||
Additionaly you can see what change in each version in the [CHANGELOG.md](CHANGELOG.md) file.
|
||||
Issues (bugs and feature request) reports are accepted on project Github.
|
92
README.md
92
README.md
@ -2,49 +2,75 @@
|
||||
|
||||
This role installs Mealie via Docker compose.
|
||||
|
||||
## Requirements
|
||||
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).
|
||||
|
||||
None
|
||||
- [Getting Started](#getting-started)
|
||||
- [Prerequisities](#prerequisities)
|
||||
- [Installing](#installing)
|
||||
- [Usage](#usage)
|
||||
- [Testing](#testing)
|
||||
- [Built With](#built-with)
|
||||
- [Versioning](#versioning)
|
||||
- [Authors](#authors)
|
||||
- [License](#license)
|
||||
- [Contributing](#contributing)
|
||||
|
||||
## Role Variables
|
||||
## Getting Started
|
||||
|
||||
All variables are listed below (see also `defaults/main.yml`).
|
||||
These instructions will get you a copy of the role for your Ansible playbook. Once launched, it will install Mealie.
|
||||
|
||||
### Prerequisities
|
||||
|
||||
Ansible 5.2.0 version installed.
|
||||
|
||||
Molecule 3.x.x version installed.
|
||||
|
||||
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):
|
||||
|
||||
```yml
|
||||
mealie_docker_version: "latest"
|
||||
mealie_port: "9925"
|
||||
mealie_timezone: "Europe/Brussels"
|
||||
|
||||
# Mealie paths
|
||||
mealie_root_path: /opt/mealie
|
||||
mealie_config_path: "{{ mealie_root_path }}/conf"
|
||||
mealie_data_path: "{{ mealie_root_path }}/data"
|
||||
mealie_skeleton_paths:
|
||||
- "{{ mealie_config_path }}"
|
||||
- "{{ mealie_data_path }}"
|
||||
- src: ansible-role-mealie
|
||||
version: 1.0.0
|
||||
name: laurivan.mealie
|
||||
```
|
||||
|
||||
## Dependencies
|
||||
Install the role with ansible-galaxy command:
|
||||
|
||||
You need a machine with docker and docker-compose installed.
|
||||
```sh
|
||||
ansible-galaxy install -p roles -r requirements.yml -f
|
||||
```
|
||||
|
||||
## Example Playbook
|
||||
Use in a playbook:
|
||||
|
||||
```yml
|
||||
- hosts: servers
|
||||
---
|
||||
- hosts: someserver
|
||||
roles:
|
||||
- 'laurivan.mealie'
|
||||
- role: laurivan.mealie
|
||||
```
|
||||
|
||||
## License
|
||||
## Usage
|
||||
|
||||
This project is licensed under the [MIT](https://opensource.org/licenses/MIT) license - see the [LICENSE](LICENSE) file for details.
|
||||
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
|
||||
|
||||
## Author Information
|
||||
### Install dependencies
|
||||
|
||||
This role was created in 2023 by [Laur Ivan](https://www.laurivan.com).
|
||||
```sh
|
||||
pipenv sync
|
||||
```
|
||||
|
||||
For more information read the [pipenv docs](https://pipenv-fork.readthedocs.io/en/latest/).
|
||||
|
||||
### Run test
|
||||
|
||||
```sh
|
||||
pipenv run molecule test
|
||||
```
|
||||
|
||||
## Built With
|
||||
|
||||
@ -52,6 +78,22 @@ This role was created in 2023 by [Laur Ivan](https://www.laurivan.com).
|
||||

|
||||

|
||||
|
||||
## Versioning
|
||||
|
||||
For the versions available, see the [tags on this repository](https://git.laurivan.com/Dev/ansible-role-mealie/tags).
|
||||
|
||||
Additionaly you can see what change in each version in the [CHANGELOG.md](CHANGELOG.md) file.
|
||||
|
||||
## Authors
|
||||
|
||||
- **Laur IVAN** - [web](https://www.laurivan.com)
|
||||
|
||||
## License
|
||||
|
||||

|
||||
|
||||
This project is licensed under the [MIT](https://opensource.org/licenses/MIT) license - see the [LICENSE](LICENSE) file for details.
|
||||
|
||||
## Contributing
|
||||
|
||||
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
|
||||
|
@ -14,3 +14,5 @@ mealie_skeleton_paths:
|
||||
|
||||
# Documentation
|
||||
mealie_documentation_link: "https://git.laurivan.com/Dev/ansible-role-mealie/src/branch/main/README.md"
|
||||
|
||||
|
||||
|
@ -3,22 +3,27 @@
|
||||
galaxy_info:
|
||||
author: Laur Ivan
|
||||
namespace: laurivan
|
||||
|
||||
role_name: mealie
|
||||
description: Install Mealie with SQLite via Docker
|
||||
description: Mealie Role
|
||||
min_ansible_version: 2.4
|
||||
min_ansible_container_version: 2.4
|
||||
license: MIT
|
||||
min_ansible_version: 2.4
|
||||
license: Apache 2.0
|
||||
galaxy_tags:
|
||||
- mealie
|
||||
- recipe
|
||||
- docker
|
||||
- tag1
|
||||
- tag2
|
||||
- tag3
|
||||
platforms:
|
||||
|
||||
- name: Debian
|
||||
versions:
|
||||
versions:
|
||||
- bullseye
|
||||
- buster
|
||||
|
||||
|
||||
- name: Ubuntu
|
||||
versions:
|
||||
versions:
|
||||
- bionic
|
||||
- focal
|
||||
- jammy
|
||||
|
||||
|
@ -20,4 +20,4 @@
|
||||
ansible.builtin.file:
|
||||
path: "{{ mealie_config_path | expanduser | realpath }}/docker-compose.yml"
|
||||
state: absent
|
||||
when: docker_compose_file.stat.exists
|
||||
when: docker_compose_file.stat.exists
|
@ -35,3 +35,4 @@ provisioner:
|
||||
converge: ${MOLECULE_PLAYBOOK:-converge.yml}
|
||||
verifier:
|
||||
name: ansible
|
||||
|
||||
|
@ -20,4 +20,4 @@
|
||||
loop:
|
||||
- "docker-compose.yml"
|
||||
tags:
|
||||
- mealie_configure
|
||||
- mealie_configure
|
@ -9,3 +9,4 @@
|
||||
import_tasks: install.yml
|
||||
tags:
|
||||
- mealie_install
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user