Comment installer GitScrum sur Debian 10

GitScrum est une application de gestion des tâches Laravel gratuite et open-source qui t’aide à gérer tes projets facilement. Elle utilise Git et la méthodologie Scrum qui permet à ton équipe de gérer ses tâches plus efficacement. Avec GitScrum, tu peux facilement suivre le temps consommé sur les tâches et les sous-tâches sur lesquelles tu travailles. Il te permet de créer des projets et d’attribuer des utilisateurs et leurs niveaux de permission, et de discuter en temps réel.

Il est livré avec un riche ensemble de fonctionnalités, notamment : User Stories, Sprint, Workflow flexible, Suivi du temps, Roadmapping, Suivi des KPI, Gestion du Backlog, Tableau de collaboration, Effort des tâches, Performance de l’équipe, Stockage illimité, Collaboration et bien d’autres encore. GitScrum est l’un des meilleurs outils de gestion de projet, à part d’autres outils comme Microsoft Project, Kanban et Trello. C’est une solution parfaite pour toutes les startups, les ventes, le marketing, les agences, les développeurs et les freelances.

Dans ce tutoriel, nous allons te montrer comment installer le logiciel de gestion de projet GitScrum sur un serveur Debian 10.

Conditions préalables

  • Un serveur fonctionnant sous Debian 10.
  • Un nom de domaine valide est pointé avec l’adresse IP de ton serveur. Dans ce tutoriel, nous utiliserons test.linuxbuz.com.
  • Un mot de passe root est configuré sur le serveur.

Démarrage

Avant de commencer, c’est une bonne idée de mettre à jour ton système avec la dernière version. Tu peux mettre à jour ton système avec la commande suivante :

apt-get update -y
apt-get upgrade -y

Après avoir mis à jour le système, redémarre-le pour appliquer les modifications.

Installer le serveur LAMP

Tout d’abord, tu dois installer le serveur Web Apache, le serveur MariaDB, PHP et d’autres extensions PHP sur ton serveur. Tu peux les installer tous à l’aide de la commande suivante :

apt-get install apache2 mariadb-server libapache2-mod-php php php-cli php-common php-mailparse php-mysql php-gmp php-curl php-mbstring php-imap php-ldap php-gd php-xml php-cli php-zip php-yaml php-dev php-pear unzip curl git -y

Une fois que tous les paquets sont installés, ouvre le fichier php.ini et modifie certains paramètres :

nano /etc/php/7.3/apache2/php.ini

Change les valeurs suivantes :

memory_limit = 256M
upload_max_filesize = 100M
max_execution_time = 300
date.timezone = Asia/Kolkata

Enregistre et ferme le fichier lorsque tu as terminé. Ensuite, démarre le service Apache et MariaDB et active leur démarrage après le redémarrage du système à l’aide de la commande suivante :

systemctl start apache2
systemctl start mariadb
systemctl enable apache2
systemctl enable mariadb

Une fois que tu as terminé, tu peux passer à l’étape suivante.

Configurer la base de données MariaDB

Par défaut, le mot de passe de la racine MariaDB n’est pas configuré dans Debian 10. Tu devras donc d’abord le configurer.

Pour ce faire, connecte-toi au shell MariaDB avec la commande suivante :

mysql

Une fois connecté, configure ton mot de passe racine MariaDB avec la commande suivante :

MariaDB [(none)]> SET PASSWORD FOR 'root'@'localhost' = PASSWORD("rootpassword");

Ensuite, crée une base de données et un utilisateur pour GitScrum avec la commande suivante :

MariaDB [(none)]> CREATE DATABASE gitscrumdb;
MariaDB [(none)]> CREATE USER 'gitscrumuser'@'localhost' IDENTIFIED BY 'password';

Ensuite, accorde tous les privilèges sur la base de données GitScrum avec la commande suivante: :

MariaDB [(none)]> GRANT ALL ON gitscrumdb.* TO 'gitscrumuser'@'localhost' WITH GRANT OPTION;

Ensuite, vide les privilèges et quitte le shell MariaDB avec la commande suivante: :

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

À ce stade, la base de données MariaDB est configurée pour GitScrum. Tu peux maintenant passer à l’étape suivante.

Installer Composer

Le Composer est un gestionnaire de dépendances pour PHP. Il est utilisé pour installer les dépendances PHP nécessaires à la construction de ton projet.

Tout d’abord, télécharge le fichier d’installation de Composer avec la commande suivante :

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

Ensuite, tu devras vérifier l’intégrité des données du fichier téléchargé. Tu peux le vérifier avec la commande suivante :

HASH="$(wget -q -O - https://composer.github.io/installer.sig)"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Si tout va bien, tu devrais obtenir la sortie suivante :

Installer verified

Enfin, exécute la commande suivante pour installer le Composer dans ton système :

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

À ce stade, le Composer est installé dans ton système. Tu peux maintenant passer à l’étape suivante.

Installe GitScrum

Ensuite, change le répertoire pour le répertoire racine d’Apache et télécharge le GitScrum avec la commande suivante :

cd /var/www/html
composer create-project gitscrum-community-edition/laravel-gitscrum --stability=stable --keep-vcs

Tu devrais obtenir la sortie suivante :

Generating autoload files
> Illuminate\Foundation\ComposerScripts::postInstall
> php artisan optimize
Generating optimized class loader
The compiled class file has been removed.
> php artisan key:generate
Application key [base64:yWIVSUl6uHXpIcSt5wxsplPwGJjSj9uWKYjy/4q2XY0=] set successfully.

Ensuite, change le répertoire pour le répertoire téléchargé et mets à jour le GitScrum avec la commande suivante :

cd laravel-gitscrum
composer update
composer run-script post-root-package-install

Ensuite, tu devras intégrer GitScrum à Github. Pour ce faire, crée une nouvelle application dans Github en utilisant le lien suivant :

https://github.com/settings/applications/new

Tu devrais voir l’écran suivant :

Inscription à Git scrum

Indique ton nom d’utilisateur GitHub, ton mot de passe et clique sur le bouton Connexion. Tu devrais voir l’écran suivant :

Enregistrement OAuth

Indique le nom de ton application, l’URL de ta page d’accueil et clique sur le bouton Enregistrer l’ application. Tu devrais voir l’écran suivant :

Application GitScrum

Après avoir enregistré la nouvelle application, copie l’ID client et le secret client de la page ci-dessus. Ensuite, ouvre le fichier .env comme indiqué ci-dessous :

nano /var/www/html/laravel-gitscrum/.env

Ajoute les lignes suivantes avec ton nom de base de données, ton nom d’utilisateur, ton mot de passe, ton ID client et ton secret client :

APP_ENV=local
APP_KEY=base64:W2ToyfW8zHqtWfcZb1hp2kZgccbuy3XtERDyZywtVkE=
APP_DEBUG=true
APP_LOG_LEVEL=debug
APP_URL=http://test.linuxbuz.com
APP_TITLE=GitScrum

GITHUB_CLIENT_ID=39f148ce467544b487cb
GITHUB_CLIENT_SECRET=370f0cfc50c8fca9179fae3f74b229b6b69b05f6

GITLAB_KEY=
GITLAB_SECRET=
GITLAB_INSTANCE_URI=https://gitlab.com/

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=gitscrumdb
DB_USERNAME=gitscrumuser
DB_PASSWORD=password

APP_PAGINATE=10

PROXY_PORT=
PROXY_METHOD=
PROXY_SERVER=
PROXY_USER=
PROXY_PASS=

Sauvegarde et ferme le fichier lorsque tu as terminé. Ensuite, exécute la commande suivante pour migrer la base de données :

php artisan migrate
php artisan db:seed

Tu devrais voir la sortie suivante :

Seeded: ConfigIssueEffortsTableSeeder
Seeded: ConfigPrioritiesTableSeeder
Seeded: IssueTypesTableSeeder
Seeded: ConfigStatusesTableSeeder

Ensuite, donne les autorisations appropriées au répertoire GitScrum avec la commande suivante :

chown -R www-data:www-data /var/www/html/laravel-gitscrum/
chmod -R 775 /var/www/html/laravel-gitscrum/

Une fois que tu as terminé, tu peux passer à l’étape suivante.

Configurer Apache pour GitScrum

Ensuite, tu devras configurer l’hôte virtuel Apache pour GitScrum. Tu peux le configurer en créant le fichier suivant :

nano /etc/apache2/sites-available/gitscrum.conf

Ajoute les lignes suivantes :

<VirtualHost *:80>
     ServerAdmin [email protected]
     DocumentRoot /var/www/html/laravel-gitscrum/public
     ServerName test.linuxbuz.com

     <Directory /var/www/html/laravel-gitscrum/public>
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Sauvegarde et ferme le fichier lorsque tu as terminé. Ensuite, vérifie que le fichier de configuration Apache ne contient pas d’erreur de syntaxe avec la commande suivante :

apache2ctl configtest

Si tout va bien, tu devrais obtenir la sortie suivante :

Syntax OK

Ensuite, active l’hôte virtuel et le module de réécriture d’Apache avec la commande suivante :

a2ensite gitscrum.conf
a2enmod rewrite

Enfin, redémarre le service Web Apache pour appliquer les modifications :

systemctl restart apache2

Tu peux maintenant vérifier l’état du service Apache avec la commande suivante :

systemctl status apache2

Tu devrais obtenir la sortie suivante :

? apache2.service - The Apache HTTP Server
   Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
  Drop-In: /lib/systemd/system/apache2.service.d
           ??apache2-systemd.conf
   Active: active (running) since Sun 2020-02-02 12:41:30 UTC; 22min ago
  Process: 15407 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
 Main PID: 14417 (apache2)
    Tasks: 11 (limit: 1114)
   CGroup: /system.slice/apache2.service
           ??14417 /usr/sbin/apache2 -k start
           ??15412 /usr/sbin/apache2 -k start
           ??15413 /usr/sbin/apache2 -k start
           ??15414 /usr/sbin/apache2 -k start
           ??15416 /usr/sbin/apache2 -k start
           ??15417 /usr/sbin/apache2 -k start
           ??15418 /usr/sbin/apache2 -k start
           ??15419 /usr/sbin/apache2 -k start
           ??15420 /usr/sbin/apache2 -k start
           ??15422 /usr/sbin/apache2 -k start
           ??15429 /usr/sbin/apache2 -k start

Feb 02 12:41:29 debian10 systemd[1]: Starting The Apache HTTP Server...

Une fois que tu as terminé, tu peux passer à l’étape suivante.

Accède à GitScrum

Maintenant, ouvre ton navigateur Web et tape l’URL http://test.linuxbuz.com. Tu seras redirigé vers la page suivante :

Accéder à GitScrum

Clique sur Connexion avec GitHub. Tu devrais voir la page suivante :

Autorise GitScrum

Maintenant, autorise ton compte pour GitScrum. Tu devrais voir ton tableau de bord GitScrum sur la page suivante :

Tableau de bord GitScrum

Conclusion

Félicitations ! Tu as réussi à installer GitScrum sur le serveur Debian 10. Tu peux maintenant gérer ton projet facilement avec GitScrum. N’hésite pas à me demander si tu as des questions.

Vous aimerez aussi...