Les pré-requis

• Un poste de développement (ou un serveur) avec MariaDB installé avec une base de données existante vide
• Un projet Django opérationnel sur le poste pour le tutoriel nous utiliserons le projet suivant : https://gitlab.com/julienanne/django-deploy-production-example

Configurons le projet Django avec le connecteur MySql

Pour cela rendez-vous dans le fichier djangoexample/settings.py, la configuration du connecteur de la base de données se trouve dans la variable DATABASES est ressemble à ça par défaut.

DATABASES = {
     'default': {
      'ENGINE': 'django.db.backends.sqlite3',
      'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

Il faut le remplacer par ceci.

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'OPTIONS': {
            'read_default_file': '/etc/mysql/my.cnf',
        },
    }
}

Quelques explications, déjà nous changeons de connecteur avec le paramètre ENGINE nous allons ici indiquer au connecteur mysql que toutes les informations de connexion seront dans le fichier /etc/mysql/my.cnf via le paramètre OPTIONS.

Éditons maintenant le fichier /etc/mysql/my.cnf et ajouter le contenu suivant à la fin du fichier

[client]
database = NOM_DE_VOTRE_BDD
user = UTILISATEUR_POUR_SE_CONNECTER
password = LEMOTDEPASSE
default-character-set = utf8

Sauver le fichier.

Nous repartons d’une base de données vide il faut donc exécuter les migrations, rendez-vous dans le dossier de votre projet django-deploy-production-example. Et lancer les commandes

./manage.py makemigrations
./manage.py migrate

Ok donc à ce moment là nous avons un projet Django connecté à votre base de données MySql / MariaDB qui tourne. Passons à la suite. Rendez-vous sur le sommaire du tutoriel pour continuer votre lecture.

Image par Johnson Martin de Pixabay

Sur ce premier article de la série, nous allons principalement retrouver les pré-requis avant de se lancer et le sommaire pointant sur chaque partie individuelle de ce tutoriel, ainsi qu’une courte description pour chaque partie. Les différentes parties de ce tutoriel sortiront au fur et à mesure, en commençant par les parties à plus fortes valeurs ajoutées pour les parties en constructions j’essaierai de trouver un tutoriel déjà présent sur Internet.

Les pré-requis

Il va nous falloir différents éléments pour mener à bien ce tutoriel :

• Un serveur avec une debian 10 installée, ou une vm où installer Debian 10 (https://www.it-connect.fr/installation-debian-10-buster-pas-a-pas/ tutoriel non testé)
• Un projet Django opérationnel et « stocké » sur Gitlab (Pour le tutoriel nous allons prendre ce projet https://gitlab.com/julienanne/django-deploy-production-example)

Sommaire

• Récupération du code source depuis Gitlab, dans ce tutoriel nous travaillerons avec un projet en public la récupération est donc faisable sans authentification. Pour des projets privés un article arrivera par la suite, en attendant voici la documentation pour ajouter une clé ssh à votre compte Gitlab et ainsi pouvoir s’authentifier à travers le protocole ssh : https://docs.gitlab.com/ee/ssh/, pour le moment un git clone https://gitlab.com/julienanne/django-deploy-production-example vous permettra de récupérer le code source pour la suite du tutoriel
• Installer le projet Django en local pour le faire évoluer
• Figer les dépendances (packages pip) de notre projet python Django pour les installer sur notre serveur de production
• Mise en place de l’environnement pour le projet django, dans cette partie du tutoriel nous allons voir comment à partir des sources du projets nous pouvons installer les dépendances nécessaires
• Installation de Maria DB sur le serveur debian 10 et création de la base de données de votre projet
• Configuration du projet Django avec un connecteur MySql
• Installation d’Apache2
• Installation du module WSGI et configuration
• Installation nécessaire pour Let’s encrypt puis génération et mise en place du certificat SSL et enfin renouvellement automatique

Chaque partie est indépendante mais le tout fera un tutoriel assez complet. Bonne lecture.

Image par Claire05 de Pixabay