Quels sont les notions qui vont être abordés lors cet atelier ? Cet atelier a pour objectif de vous apprendre à créer des graphiques (métriques) grace à Python et la construction d'API. Vous allez utiliser et mettre en oeuvre, au travers de cet atelier, un serveur Python utilisant le frameworks Flask. Vous allez créer des API, découvrir les actions et les secrets de GitHUB pour au final la mise en services des bibliothèques graphiques. Large programme mais tout à fait accessible et ne nécessitant pas de base technique particulière. Juste de l'observation et de la rigueur.
Objectif : Création d'un repository GitHUB pour travailler avec son code
Difficulté : Très faible (~5 minutes)
GitHUB est une plateforme en ligne utilisée pour stocker le code de son programme. GitHUB est organisé en "Repository", c'est à dire en répertoire (contenant lui même des sous répertoires et des fichiers). Chaque Repository sera indépendant des autres. Un Repository peu être vu comme un projet unique.
Procedure à suivre :
1° - Créer vous un compte sur GitHub : https://github.com/
Si besoin, un vidéo pour vous aider à créer votre propre compte GitHUB : Créer un compte GitHUB
A noter que si vous possédez déjà un compte GitHUB vous pouvez le conserver pour réaliser cet atelier. Pas besion d'en créer un nouveau.
2° - Faites un Fork du Repository suivant : https://github.com/OpenRSI/5MCSI_Metriques.git
Si besoin, voici une vidéo d'accompagnement pour vous aider : Forker ce projet
Travail demandé : Créé votre compte, faites le fork de ce projet et copier l'URL de votre repository GitHUB dans la discussion public.
Notion acquise lors de cette séquence :
Vous avez appris lors de cette séquence à créer des repository pour stocker et travailler avec votre code informatique. Vous pourez par la suite travailler en groupe sur un projet. Vous avez également appris à faire des forks. C'est à dire, faire des copies de projets déjà existant dans GitHUB que vous pourrez ensuite adapter à vos besions.
Rendez-vous sur https://www.alwaysdata.com/fr/
Remarque : Attention à bien vous rappeler vos Login/Password lors de la création de votre compte car vous en aurez besoin plus tard pour la création de vos "Secrets GitHUB".
Procédure :
1° - Créez votre compte (gratuit jusqu'à 100Mo).
2° - Depuis la console d'administration (Panel d'administration) :
. 2.1 - Cliquez sur "Sites" (Colonne de gauche) puis supprimer votre site PHP (avec la Poubelle).
. 2.2 - Installer ensuite une application Flask (Bouton + Installer une application).
. . 2.2.1 Adresses = utilisez le sous-domaine qui vous appartient que vous trouverez dans l'information " Les sous-domaines suivants vous appartiennent et sont actuellement inutilisés : {Site}.alwaysdata.net
. . 2.2.2 Répertoire d'installation = /www/flask
. 2.2.3 N'oubliez pas d'Accepter les conditions.
3° - Autoriser les connexions SSH :
. 3.1 - Cliquez sur SSH (Accès distant)
. 3.2 - Modifier les paramètres de votre utilisateur
. 3.3 - Définissez si besion un nouveau mot de passe
. 3.4 - Cliquez sur Activer la connexion par mot de passe
Si besoin, voici une vidéo d'accompagnement pour vous aider dans cette séquence de création d'une site sur Alwaysdata : Vidéo Alwaysdata
Travail demandé : Mettre en ligne votre application Flask "Hello World !" et copier l'URL de votre site dans la discussion Discord.
Notion acquise lors de cette séquence :
Vous avez créer un hébergement (gratuit) et découvert que vous auriez pu installer bien d'autres applications.
Objectif : Automatiser la mise à jour de votre hébergement Alwaysdata Difficulté : Moyenne (~15 minutes)
Dans le repository GitHUB que vous venez de créer lors de la séquence 1, vous avez un fichier intitulé CICD.yml et qui est déposé dans le répertoire .github/workflows. Ce fichier a pour objectif d'automatiser le déploiement de votre code sur votre site Alwaysdata. Pour information, c'est ce que l'on appel des actions GitHUB. Ce sont des scripts qui s'exécutent automatiquement lors de chaque Commit (modification de code) dans votre projet. Ces scripts (actions) sont au format yml.
Pour utiliser cette action (CICD.yml), vous avez besoin de créer des secrets dans GitHUB afin de ne pas divulguer des informations sensibles aux internautes de passage dans votre Repository (vos login/password par exemple).
Pour ce projet vous avez 4 secrets à créer dans votre Repository que vous devez créer :
USERNAME = Le login qui sera utilisé pour la connexion SSH.
PASSWORD = Le mot de passe qui sera utilisé pour la connexion SSH.
ALWAYSDATA_TOKEN = Le token est à créer depuis l'interface d'administration Alwaysdata. Cliquez sur votre profil en haut à droite, puis sur 'Profil' puis sur 'Gérer les tokens'. Laissez le champ "Adresses IP autorisées" vide. Dans le cas contraire vous limiteriez les connexions seulement une adresse IP. Pour le champ Application* mettez "flask" par exemple.
ALWAYSDATA_SITE_ID = Vous trouverez l'ID de votre site depuis l'interface d'administration Alwaysdata dans les paramètres de votre site (dans le titre #XXXXX) XXXXX étant l'ID de votre site. Ne prenez pas le # mais juste les chiffres.
Ci-dessous une vidéo pour vous expliquer le processus de création des secrets dans GitHUB.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent