Ricerca nel sito web

Come installare GitScrum Agile Project Management Tool su Ubuntu 20.04 LTS

Su questa pagina

  1. Prerequisiti
  2. Per iniziare
  3. Installa Apache, MariaDB e PHP
  4. Configura il database per GitScrum
  5. Installa Compositore
  6. Scarica GitScrum
  7. Configura GitScrum
  8. Configura Apache per GitScrum
  9. Accedi all'interfaccia Web di GitScrum
  10. Conclusione

GitScrum è uno strumento di gestione dei progetti open source basato sul framework Laravel e progettato per aiutare i team di sviluppo a utilizzare Git e Scrum per la gestione delle attività affinché siano più agili. Può essere integrato con Github o Gitlab o Bitbucket. È progettato per startup, vendite, agenzie di marketing, sviluppatori e liberi professionisti per gestire facilmente il proprio progetto. Offre funzionalità molto utili tra cui Product Backlog, User Story, Sprint Backlog, Problemi e altro.

In questo tutorial, spiegheremo come installare GitScrum sul server Ubuntu 20.04.

Prerequisiti

  • Un server che esegue Ubuntu 20.04.
  • Un nome di dominio valido indicato con il tuo VPS.
  • Una password di root è impostata sul tuo server.

Iniziare

Innanzitutto, dovrai aggiornare i tuoi pacchetti di sistema all'ultima versione. Puoi aggiornarli con il seguente comando:

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

Una volta aggiornato il sistema, riavvialo per applicare le modifiche.

Installa Apache, MariaDB e PHP

GitScrum viene eseguito sul server Web, utilizza MariaDB/MySQL per il backend del database e si basa sul framework Laravel. Quindi dovrai installare il server web Apache, MariaDB, PHP e le estensioni PHP richieste nel tuo sistema. Puoi installarli tutti eseguendo il seguente comando:

apt-get install apache2 mariadb-server libapache2-mod-php7.4 php7.4 php7.4-cli php7.4-mysql php7.4-zip php7.4-json php7.4-gd php7.4-mbstring php7.4-curl php7.4-xml php-pear php7.4-bcmath php7.4-common git openssl unzip -y

Una volta installati tutti i pacchetti, modifica il file php.ini e modificalo con alcuni valori desiderati:

nano /etc/php/7.4/apache2/php.ini

Modifica le seguenti righe:

memory_limit = 256M
upload_max_filesize = 100M
max_execution_time = 360
date.timezone = America/Chicago

Salva e chiudi il file quando hai finito. Quindi, avvia il servizio Apache e MariaDB e abilitali all'avvio al riavvio del sistema con il seguente comando:

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

Una volta terminato, puoi procedere al passaggio successivo.

Configura il database per GitScrum

Innanzitutto, dovrai proteggere l'installazione di MariaDB e impostare una password di root MariaDB. Puoi farlo eseguendo il seguente script:

mysql_secure_installation

Questo script imposterà la password root di MariaDB, rimuoverà gli utenti anonimi, non consentirà l'accesso root da remoto e rimuoverà il database di test come mostrato di seguito:

Enter current password for root (enter for none):
OK, successfully used password, moving on...
Set root password? [Y/n] Y
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Una volta che MariaDB è protetto, accedi alla shell MariaDB con il seguente comando:

mysql -u root -p

Fornisci la tua password di root MariaDB quando richiesto, quindi crea un database e un utente per GitScrum con il seguente comando:

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

Quindi, concedi tutti i privilegi a gitscrum con il seguente comando:

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

Successivamente, svuota i privilegi ed esci dalla shell MariaDB con il seguente comando:

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

Una volta configurato il database, puoi procedere al passaggio successivo.

Installa Compositore

Successivamente, dovrai installare Composer nel tuo sistema. Composer è un gestore delle dipendenze per PHP e utilizzato per installare le dipendenze PHP richieste per il tuo progetto.

È possibile installare Composer con il seguente comando:

apt-get install composer -y

Una volta installato, puoi verificare la versione installata di Composer con il seguente comando:

composer --version

Dovresti vedere il seguente output:

Composer 1.10.1 2020-03-13 20:34:27

Una volta terminato, puoi procedere al passaggio successivo.

Scarica GitScrum

Innanzitutto, modifica la directory nella directory root web di Apache e scarica l'ultima versione di GitScrum dal repository Git con il seguente comando:

cd /var/www/html
git clone https://github.com/GitScrum-Community/laravel-gitscrum.git

Una volta completato il download, cambia la directory in laravel-gitscrum e aggiorna i pacchetti GitScrum con il seguente comando:

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

Dovresti vedere il seguente output:

> @php -r "file_exists('.env') || copy('.env.example', '.env');"

Una volta terminato, puoi procedere al passaggio successivo.

Configura GitScrum

Per integrare GitScrum con GitLab, dovrai accedere a GitLab e creare un'app.

Puoi crearlo visitando l'URL https://gitlab.com/profile/applications. Dovresti vedere la schermata di accesso a GitLab:

Fornisci il nome utente e la password GitLab e fai clic sul pulsante Accedi. Dovresti vedere la seguente schermata:

Fornisci il nome dell'applicazione, l'URL di reindirizzamento, seleziona gli ambiti e fai clic sul pulsante Salva applicazione. Dovresti vedere l'ID e il segreto dell'applicazione nella schermata seguente.

Successivamente, dovrai definire l'ID e il segreto dell'applicazione nel file .env.

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

Definisci i dettagli del database, l'URL dell'app, l'ID GitLab e il segreto come mostrato di seguito:

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=gitscrum
DB_USERNAME=gitscrum
DB_PASSWORD=password
APP_URL=http://gitscrum.linuxbuz.com
GITLAB_KEY=19ed6d8500710c32049e703c537e0c2251f41bdaedb6ca3f9d3276a0ea2fe484
GITLAB_SECRET=efe24736031571d59a5994d860f561c69d7c3bb46ab4a4fdae6406972df21565
GITLAB_INSTANCE_URI=https://gitlab.com/

Salva e chiudi il file quando hai finito. Quindi, migra il database con il seguente comando:

php artisan migrate
php artisan db:seed

Dovresti vedere il seguente output:

Seeding: ConfigIssueEffortsTableSeeder
Seeding: ConfigPrioritiesTableSeeder
Seeding: IssueTypesTableSeeder
Seeding: ConfigStatusesTableSeeder

Successivamente, modifica la proprietà e l'autorizzazione di laravel-gitscrum con il seguente comando:

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

Una volta terminato, puoi procedere al passaggio successivo.

Configura Apache per GitScrum

Successivamente, dovrai creare un file di configurazione dell'host virtuale Apache per GitScrum. Puoi crearlo con il seguente comando:

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

Aggiungi le seguenti righe:

<VirtualHost *:80>
     ServerAdmin 
     DocumentRoot /var/www/html/laravel-gitscrum/public/
     ServerName gitscrum.linuxbuz.com
     ErrorLog /var/log/apache2/gitscrum-error.log
     CustomLog /var/log/apache2/gitscrum-access.log combined
 
     <Directory /var/www/html/laravel-gitscrum/public/>
        Options +FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

</VirtualHost>

Salva e chiudi il file quando hai finito. Quindi, verifica Apache per qualsiasi errore di configurazione con il seguente comando:

apachectl configtest

Se tutto va bene, dovresti vedere il seguente output:

Syntax OK

Successivamente, abilita l'host virtuale GitScrum con il seguente comando:

a2ensite gitscrum.conf

Successivamente, abilita il modulo di riscrittura Apache e riavvia il servizio Apache per applicare le modifiche:

a2enmod rewrite
systemctl restart apache2

Puoi anche verificare lo stato del servizio Apache usando il seguente comando:

systemctl status apache2

Dovresti ottenere il seguente output:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2020-07-03 07:42:29 UTC; 4min 35s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 16070 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
   Main PID: 13697 (apache2)
      Tasks: 6 (limit: 2353)
     Memory: 23.5M
     CGroup: /system.slice/apache2.service
             ??13697 /usr/sbin/apache2 -k start
             ??16074 /usr/sbin/apache2 -k start
             ??16075 /usr/sbin/apache2 -k start
             ??16076 /usr/sbin/apache2 -k start
             ??16077 /usr/sbin/apache2 -k start
             ??16078 /usr/sbin/apache2 -k start

July 03 07:42:29 ubuntu20 systemd[1]: Starting The Apache HTTP Server...

A questo punto, il web server Apache è configurato per servire GitScrum. Ora puoi procedere al passaggio successivo.

Accedi all'interfaccia Web di GitScrum

Ora apri il tuo browser web e digita l'URL http://gitscrum.linuxbuz.com. Verrai reindirizzato alla seguente pagina:

Fare clic sul pulsante GitLab per accedere con GitLab. Dovresti vedere la seguente schermata:

Fornisci il tuo nome utente e password GitLab e fai clic sul pulsante Accedi. Dovresti vedere la seguente schermata:

Ora, fai clic sul pulsante Autorizza per autorizzare GitScrum a utilizzare il tuo account. Dovresti vedere la seguente schermata:

Ora puoi importare il tuo repository in GitScrum e iniziare a lavorare.

Conclusione

Congratulazioni! hai installato con successo GitScrum e lo hai integrato con GitLab sul server Ubuntu 20.04. Ora puoi distribuire GitScrum nell'ambiente di sviluppo e iniziare a utilizzare Git con Scrum per la gestione delle attività. Per maggiori informazioni visita la documentazione ufficiale di GitScrum. Non esitate a chiedermi se avete domande.