Improve doc and split/filter CI
This commit is contained in:
Faustin Lammler
parent
37d10f856d
commit
73ee37265b
|
|
@ -0,0 +1,69 @@
|
|||
---
|
||||
name: Default deployment
|
||||
|
||||
on:
|
||||
push:
|
||||
paths:
|
||||
- .github/workflows/test_default.yml
|
||||
- requirements.txt
|
||||
- "files/**"
|
||||
- "handlers/**"
|
||||
- "molecule/**"
|
||||
- "tasks/**"
|
||||
- "templates/**"
|
||||
- "vars/**"
|
||||
pull_request:
|
||||
paths:
|
||||
- .github/workflows/test_default.yml
|
||||
- requirements.txt
|
||||
- "files/**"
|
||||
- "handlers/**"
|
||||
- "molecule/**"
|
||||
- "tasks/**"
|
||||
- "templates/**"
|
||||
- "vars/**"
|
||||
schedule:
|
||||
- cron: "0 5 * * 2"
|
||||
|
||||
jobs:
|
||||
molecule-distrib-pkg:
|
||||
name: Default
|
||||
runs-on: ubuntu-latest
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
distro:
|
||||
- ubuntu-18.04
|
||||
- ubuntu-20.04
|
||||
- ubuntu-22.04
|
||||
- debian-10
|
||||
- debian-11
|
||||
- debian-sid
|
||||
- fedora-36
|
||||
- fedora-37
|
||||
- almalinux-8
|
||||
- almalinux-9
|
||||
- rockylinux-8
|
||||
- rockylinux-9
|
||||
playbook:
|
||||
- converge.yml
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- name: Install requirements
|
||||
run: |
|
||||
python3 -m pip install --upgrade pip
|
||||
python3 -m pip install -r requirements.txt
|
||||
# This is necessary on GH Actions to allow running systemd in rootless containers
|
||||
# see: https://github.com/actions/virtual-environments/issues/3536
|
||||
# see: https://github.com/ansible-community/molecule/discussions/3155
|
||||
- name: Start systemd user service
|
||||
run: |
|
||||
loginctl enable-linger $(whoami)
|
||||
sleep 1
|
||||
- name: Run molecule
|
||||
run: molecule test
|
||||
env:
|
||||
PY_COLORS: "1"
|
||||
ANSIBLE_FORCE_COLOR: "1"
|
||||
MOLECULE_DISTRO: ${{ matrix.distro }}
|
||||
MOLECULE_PLAYBOOK: ${{ matrix.playbook }}
|
||||
|
|
@ -1,55 +1,31 @@
|
|||
---
|
||||
name: molecule
|
||||
name: MDBF deployment
|
||||
|
||||
on:
|
||||
push:
|
||||
paths:
|
||||
- .github/workflows/test_mdbf.yml
|
||||
- requirements.txt
|
||||
- "files/**"
|
||||
- "handlers/**"
|
||||
- "molecule/**"
|
||||
- "tasks/**"
|
||||
- "templates/**"
|
||||
- "vars/**"
|
||||
pull_request:
|
||||
paths:
|
||||
- .github/workflows/test_mdbf.yml
|
||||
- requirements.txt
|
||||
- "files/**"
|
||||
- "handlers/**"
|
||||
- "molecule/**"
|
||||
- "tasks/**"
|
||||
- "templates/**"
|
||||
- "vars/**"
|
||||
schedule:
|
||||
- cron: "0 5 * * 2"
|
||||
|
||||
jobs:
|
||||
molecule-distrib-pkg:
|
||||
name: Default
|
||||
runs-on: ubuntu-latest
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
distro:
|
||||
- ubuntu-18.04
|
||||
- ubuntu-20.04
|
||||
- ubuntu-22.04
|
||||
- debian-10
|
||||
- debian-11
|
||||
- debian-sid
|
||||
- fedora-36
|
||||
- fedora-37
|
||||
- almalinux-8
|
||||
- almalinux-9
|
||||
- rockylinux-8
|
||||
- rockylinux-9
|
||||
playbook:
|
||||
- converge.yml
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- name: Install requirements
|
||||
run: |
|
||||
python3 -m pip install --upgrade pip
|
||||
python3 -m pip install -r requirements.txt
|
||||
# This is necessary on GH Actions to allow running systemd in rootless containers
|
||||
# see: https://github.com/actions/virtual-environments/issues/3536
|
||||
# see: https://github.com/ansible-community/molecule/discussions/3155
|
||||
- name: Start systemd user service
|
||||
run: |
|
||||
loginctl enable-linger $(whoami)
|
||||
sleep 1
|
||||
- name: Run molecule
|
||||
run: molecule test
|
||||
env:
|
||||
PY_COLORS: "1"
|
||||
ANSIBLE_FORCE_COLOR: "1"
|
||||
MOLECULE_DISTRO: ${{ matrix.distro }}
|
||||
MOLECULE_PLAYBOOK: ${{ matrix.playbook }}
|
||||
|
||||
molecule-mdbf-pkg:
|
||||
name: MDBF
|
||||
runs-on: ubuntu-latest
|
||||
47
README.md
47
README.md
|
|
@ -1,7 +1,8 @@
|
|||
# Ansible role: MariaDB
|
||||
|
||||
[](https://github.com/fauust/ansible-role-mariadb/actions/workflows/pre-commit.yml)
|
||||
[](https://github.com/fauust/ansible-role-mariadb/actions/workflows/molecule.yml)
|
||||
[](https://github.com/fauust/ansible-role-mariadb/actions/workflows/test_default.yml)
|
||||
[](https://github.com/fauust/ansible-role-mariadb/actions/workflows/test_mdbf.yml)
|
||||
|
||||
Install and configure MariaDB Server on Debian/Ubuntu.
|
||||
|
||||
|
|
@ -13,21 +14,37 @@ Optionally, this role also permits one to:
|
|||
## Requirements
|
||||
|
||||
The role uses
|
||||
[`mysql_user`](https://docs.ansible.com/ansible/latest/modules/mysql_user_module.html)
|
||||
[`community.mysql.mysql_user`](https://docs.ansible.com/ansible/latest/collections/community/mysql/mysql_user_module.html)
|
||||
and
|
||||
[`mysql_db`](https://docs.ansible.com/ansible/latest/modules/mysql_db_module.html)
|
||||
ansible modules that depend on [PyMySQL](https://github.com/PyMySQL/PyMySQL) so
|
||||
Python 2.7 or Python 3.X versions are needed.
|
||||
[`community.mysql.mysql_db`](https://docs.ansible.com/ansible/latest/collections/community/mysql/mysql_db_module.html)
|
||||
ansible modules that depend on [PyMySQL](https://github.com/PyMySQL/PyMySQL).
|
||||
Only Python 3.X versions are supported and tested. Python 2.7 is probalbly
|
||||
working but not tested.
|
||||
|
||||
For older Python versions, you may use
|
||||
[MySQLdb](http://mysql-python.sourceforge.net/MySQLdb.html) but then the role
|
||||
may not be idempotent (not tested).
|
||||
## Testing (Molecule)
|
||||
|
||||
The role is tested with the [Molecule
|
||||
project](https://molecule.readthedocs.io/en/latest/index.html). By default this
|
||||
role will be tested with the `podman` driver, but you can easily adapt it to use
|
||||
`docker` if you prefer.
|
||||
|
||||
Here is an example how you can test a deployment of MariaDB Server `10.6`
|
||||
packaged by the MariaDB Foundation (MDBF) on `Almalinux 9`:
|
||||
|
||||
```console
|
||||
❯ make install
|
||||
❯ source .venv/bin/activate
|
||||
.venv ❯ export MOLECULE_DISTRO=almalinux-9
|
||||
.venv ❯ export MOLECULE_PLAYBOOK=converge-mdbf.yml
|
||||
.venv ❯ export MARIADB_VERSION="10.6"
|
||||
.venv ❯ molecule test
|
||||
...
|
||||
```
|
||||
|
||||
## Fact gathering (performance)
|
||||
|
||||
Unless you want to use the MariaDB official repository (and then need
|
||||
`ansible_distribution_version`, see [`tasks/setup.yml`](./tasks/setup.yml#L18))
|
||||
this role does not require fact gathering.
|
||||
Fact gathering is only needed if you want to use the MariaDB official repository
|
||||
(<https://mariadb.org/download/?t=repo-config>)
|
||||
|
||||
## Role variables
|
||||
|
||||
|
|
@ -39,7 +56,7 @@ Available variables are listed below, along with default values (see
|
|||
```yaml
|
||||
mariadb_use_official_repo: false
|
||||
mariadb_use_official_repo_url: https://deb.mariadb.org
|
||||
mariadb_use_official_repo_version: 10.5
|
||||
mariadb_use_official_repo_version: "10.10"
|
||||
```
|
||||
|
||||
You may deploy the MariaDB Server version that comes with your distribution
|
||||
|
|
@ -66,8 +83,10 @@ variables. This permits more flexibility and a very simple
|
|||
[`templates/mariadb.cnf.j2`](./templates/mariadb.cnf.j2) file.
|
||||
|
||||
By default, some common and standard options are deployed based on the MariaDB
|
||||
Foundation package and it should be easy to change them all (see
|
||||
[`mariadb.cnf`](./mariadb.cnf)).
|
||||
Foundation package. Those default values are only ment as an example and for testing
|
||||
deployments and you are encouraged to use your own values. This should be
|
||||
facilitated by extensive use of `raw` variables (see
|
||||
[`templates/mariadb.cnf.j2`](./templates/mariadb.cnf.j2).
|
||||
|
||||
#### Basic settings
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue