# MySQL

MySQL est l’une des bases de données relationnelles libres les plus déployées au monde. Cette image fournit une version à support à long terme destinée aux charges de travail de production.

MySQL est publié sous forme d’une image par ligne LTS maintenue. Choisissez la version voulue au moment du déploiement. Les lignes 8.4 et 9.7 sont toutes deux des LTS actuelles, et 9.7 est la suite logique de 8.4.

## Logiciels inclus

| Composant | Version |
| --- | --- |
| MySQL Server | 8.4.x ou 9.7.x (LTS, selon le modèle) |
| Ubuntu | 24.04 LTS |

## Variables d’environnement

Vous pouvez définir ces valeurs lors du déploiement de MySQL depuis la marketplace. Laissez un champ vide pour générer automatiquement une valeur aléatoire sécurisée.

| Variable | Description |
| --- | --- |
| `MYSQL_ROOT_PASSWORD` | Mot de passe `root` de la base de données |
| `MYSQL_DATABASE` | Nom de la base de données applicative à créer |
| `MYSQL_USER` | Nom d’utilisateur de la base de données applicative |
| `MYSQL_PASSWORD` | Mot de passe de l’utilisateur de la base de données applicative |

## Bien démarrer

### 1. Connectez-vous à votre VM

```bash
ssh ubuntu@<your-vm-ip>
```

### 2. Attendez la configuration au premier démarrage

Au premier démarrage, un script de configuration s’exécute automatiquement. Il génère un mot de passe `root` aléatoire et l’enregistre dans `/etc/mysql/mysql-root-password.txt`. Cela prend moins de 30 secondes.

Suivez la progression:

```bash
journalctl -u mysql-first-boot.service -f
```

### 3. Récupérez les identifiants

```bash
sudo cat /etc/mysql/mysql-root-password.txt
```

Ce fichier contient le mot de passe `root`. Il est lisible uniquement par `root`.

### 4. Connectez-vous à MySQL

```bash
ROOT_PASS=$(sudo cat /etc/mysql/mysql-root-password.txt)
mysql -u root -p"$ROOT_PASS"
```

## Gérer MySQL

```bash
# Vérifier l'état du service
systemctl status mysql


# Redémarrer
sudo systemctl restart mysql


# Consulter les journaux
sudo journalctl -u mysql -f
```

Répertoire de configuration: `/etc/mysql/mysql.conf.d/`

Pour autoriser les connexions distantes, modifiez `/etc/mysql/mysql.conf.d/mysqld.cnf` et changez `bind-address` de `127.0.0.1` à `0.0.0.0`, puis redémarrez MySQL. Ouvrez le pare-feu seulement pour des adresses IP précises (voir [Sécurité](https://docs.zcp.zsoftly.ca/fr/public-cloud/marketplace/mysql/#s%C3%A9curit%C3%A9)).

## Sécurité

Le port 3306 n’est pas ouvert vers l’extérieur par défaut. UFW est activé et n’autorise que SSH (port 22).

Pour autoriser l’accès depuis une adresse IP précise:

```bash
sudo ufw allow from <trusted-ip> to any port 3306
```

Pour vous connecter sans ouvrir le pare-feu (recommandé), utilisez un tunnel SSH:

```bash
# Exécutez ceci sur votre poste local
ssh -L 3306:localhost:3306 ubuntu@<your-vm-ip>


# Connectez-vous ensuite localement
mysql -u root -p"<root-password>"
```

Évitez d’exposer le port 3306 à `0.0.0.0`. Limitez l’accès à des adresses IP connues ou utilisez un tunnel SSH.

## Prochaines étapes

- [Documentation MySQL 9.7](https://dev.mysql.com/doc/refman/9.7/en/)
- [Documentation MySQL 8.4](https://dev.mysql.com/doc/refman/8.4/en/)
- [Guide de sécurité MySQL](https://dev.mysql.com/doc/refman/9.7/en/security.html)