Skip to content

Commit b6ebf35

Browse files
authored
PHRAS-4134 release 4.1.16 (#4587)
* bump Phraseanet version to 4.1.16 * changelog clean
1 parent 3495492 commit b6ebf35

File tree

3 files changed

+35
-26
lines changed

3 files changed

+35
-26
lines changed

.env

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ PHRASEANET_DOCKER_REGISTRY=alchemyfr
154154

155155
# Docker images tag.
156156
# @run
157-
PHRASEANET_DOCKER_TAG=4.1.15
157+
PHRASEANET_DOCKER_TAG=4.1.16
158158

159159
# Stack Name
160160
# An optionnal Name for the stack
@@ -484,6 +484,7 @@ FPM_MAX_REQUESTS=1000
484484
# --- MySQL settings ---------------------------------------------------------------------------------------------------
485485

486486
# MySQL root password.
487+
# A change is mandatory for security reasons.
487488
# @build
488489
MYSQL_ROOT_PASSWORD=root
489490

@@ -531,6 +532,7 @@ MYSQL_CONNECT_TIMEOUT=60
531532
MYSQL_WAIT_TIMEOUT=600
532533

533534
# This Environment variable will run mariadb-upgrade is essential when mariadb version changes.
535+
# https://mariadb.com/kb/en/mariadb-upgrade/
534536
# @run
535537
MARIADB_AUTO_UPGRADE=1
536538

CHANGELOG.md

Lines changed: 31 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -4,45 +4,48 @@
44

55
### Update Instructions
66

7-
The ```docker compose``` stack bump version of the provided MariaDB.
7+
**Update: Docker Compose Stack Version Bump for MariaDB**
88

9-
Docker Compose does not cleanly stop MySQL by default.
10-
Therefore, an error can occur when restarting the DB after an update.
11-
see:https://github.com/MariaDB/mariadb-docker/issues/185
9+
This update includes a version bump for MariaDB within our Docker Compose stack to incorporate the latest improvements and fixes.
1210

13-
To cleanly stop MariaDB with docker compose, you can use the following command:
14-
```dc exec db /usr/bin/mysqladmin -uroot -p shutdown```
11+
**Issue:**
12+
Docker Compose does not cleanly stop MySQL by default, which can lead to errors when restarting the database after an update. Reference: [MariaDB Docker Issue #185](https://github.com/MariaDB/mariadb-docker/issues/185).
1513

16-
Performing a DB backup is recommended before starting the update procedure.
17-
You can use the db-backup profile included in the docker-compose.tools.yml file to perform the backup.
14+
**Solution:**
15+
To cleanly stop MariaDB with Docker Compose, use the following command:
16+
```bash
17+
dc exec db /usr/bin/mysqladmin -uroot -p shutdown
18+
```
1819

19-
Added environement variable
20-
MARIADB_AUTO_UPGRADE variable is set to 1 (activated) by default and used to automate the upgrade of the mariadb system tables.
21-
When this environment variable is set, this will run the mariadb-upgrade⁠ (https://mariadb.com/kb/en/mariadb-upgrade/), if needed, so any changes in the MariaDB system tables required to expose new features will be made. This may impeed some downgrade options⁠. Unless the environment variable MARIADB_DISABLE_UPGRADE_BACKUP is set, there will be a backup of the system tables created as system_mysql_backup_*.sql.zst in the top level of the data directory to assist in the downgrade if needed.
20+
**Recommendation:**
21+
Performing a database backup is recommended before starting the update procedure. Utilize the `db-backup` profile included in the `docker-compose.tools.yml` file for this purpose.
2222

23-
Keep in mind, the provided MariaDB container in ```docker compose``` and stack is not ready for production as-is and requires adjustments.
24-
It is recommended to use an external, redundant service for the primary datastore.
23+
**New Feature:**
24+
An environment variable `MARIADB_AUTO_UPGRADE` is now set to `1` (activated) by default to automate the upgrade of the MariaDB system tables. This upgrade process, executed via [mariadb-upgrade](https://mariadb.com/kb/en/mariadb-upgrade/), updates system tables to enable new features but may restrict some downgrade options. Unless the environment variable `MARIADB_DISABLE_UPGRADE_BACKUP` is set, a backup of the system tables will be created as `system_mysql_backup_*.sql.zst` in the top level of the data directory to assist in any required downgrades.
2525

26-
#### Steps to Follow for Update docker compose stack
26+
**Caution:**
27+
The provided MariaDB container in the Docker Compose stack is not ready for production as-is and requires adjustments. It is recommended to use an external, redundant service for the primary datastore.
2728

29+
#### Steps to Follow for Updating Docker Compose Stack:
2830

29-
1. Perform a backup of the application box and all databoxes published on your MariaDB server (the MariaDB database).
30-
2. Stop the MariaDB server with (adapt it with your credentials):
31-
```sh
31+
1. Perform a backup of the application box and all databases published on your MariaDB server.
32+
2. Stop the MariaDB server using the command (adapt it with your credentials):
33+
```bash
3234
dc exec db /usr/bin/mysqladmin -uroot -p shutdown
3335
```
3436
3. Take down the Docker stack with:
35-
```sh
37+
```bash
3638
dc down
3739
```
3840
4. Deploy the new Docker stack version.
39-
5. Bring up your stack with:
40-
```sh
41+
5. Start your stack with:
42+
```bash
4143
dc up -d
4244
```
4345

4446
**Note:** `dc` is a bash function aliasing `docker compose` with `.env` and `.env.local` values merged. See the [README.md](https://github.com/alchemy-fr/Phraseanet/blob/master/README.md#using-a-envlocal-method-for-custom-env-values) for more details.
4547

48+
#### Phraseanet Upgrade
4649

4750
- **Phraseanet Migration Patch**:
4851
- A migration script for the configuration file is available. Run the following command in the setup container with Docker if the environment variable `PHRASEANET_UPGRADE=1` is set:
@@ -58,14 +61,18 @@ It is recommended to use an external, redundant service for the primary datastor
5861
### Version Summary
5962
6063
- Bump MariaDB
61-
- todo
64+
- Fix issue on CSRF
65+
- Fix issue on export title choice in pusher case
6266
67+
## What's Changed
68+
* PHRAS-4129 : account page - collections request - CSRF error by @aynsix in https://github.com/alchemy-fr/Phraseanet/pull/4585
69+
* PHRAS-4130 : upgrade mariadb to 5.11.11 by @moctardiouf in https://github.com/alchemy-fr/Phraseanet/pull/4586
70+
* PHRAS-4115 Export window - Save File name choice case download_async by @aynsix in https://github.com/alchemy-fr/Phraseanet/pull/4583
71+
* PHRAS-4127 add mysql timeout env by @aynsix in https://github.com/alchemy-fr/Phraseanet/pull/4584
6372
64-
### What's Changed
6573
66-
- WIP
74+
**Full Changelog**: https://github.com/alchemy-fr/Phraseanet/compare/4.1.15...4.1.16
6775
68-
__
6976
## 4.1.15
7077
7178
### Update Instructions

lib/Alchemy/Phrasea/Core/Version.php

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ class Version
1717
* @var string
1818
*/
1919

20-
private $number = '4.1.15';
20+
private $number = '4.1.16';
2121

2222
/**
2323
* @var string

0 commit comments

Comments
 (0)