Как установить GitScrum Agile Project Management Tool на Ubuntu 20.04 LTS
На этой странице
- Предпосылки
- Начало работы
- Установите Apache, MariaDB и PHP
- Настройка базы данных для GitScrum
- Установить Композитор
- Загрузить GitScrum
- Настройка GitScrum
- Настройка Apache для GitScrum
- Доступ к веб-интерфейсу GitScrum
- Заключение
GitScrum — это инструмент управления проектами с открытым исходным кодом, основанный на фреймворке Laravel и предназначенный для того, чтобы помочь командам разработчиков использовать Git и Scrum для управления задачами, чтобы они были более гибкими. Его можно интегрировать с Github, Gitlab или Bitbucket. Он предназначен для стартапов, продаж, маркетинговых агентств, разработчиков и фрилансеров, чтобы легко управлять своим проектом. Он предлагает очень полезные функции, включая Журнал Продукта, Пользовательскую Историю, Журнал Спринта, Проблемы и многое другое.
В этом руководстве мы объясним, как установить GitScrum на сервер Ubuntu 20.04.
Предпосылки
- Сервер под управлением Ubuntu 20.04.
- Действительное доменное имя, указанное с вашим VPS.
- На вашем сервере установлен пароль root.
Начиная
Во-первых, вам нужно будет обновить системные пакеты до последней версии. Вы можете обновить их с помощью следующей команды:
apt-get update -y
apt-get upgrade -y
Как только ваша система будет обновлена, перезапустите ее, чтобы изменения вступили в силу.
Установите Apache, MariaDB и PHP
GitScrum работает на веб-сервере, использует MariaDB/MySQL для серверной части базы данных и основан на фреймворке Laravel. Поэтому вам нужно будет установить веб-сервер Apache, MariaDB, PHP и необходимые расширения PHP в вашей системе. Вы можете установить их все, выполнив следующую команду:
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
После того, как все пакеты будут установлены, отредактируйте файл php.ini и измените его на нужные значения:
nano /etc/php/7.4/apache2/php.ini
Измените следующие строки:
memory_limit = 256M upload_max_filesize = 100M max_execution_time = 360 date.timezone = America/Chicago
Сохраните и закройте файл, когда закончите. Затем запустите службу Apache и MariaDB и включите их запуск при перезагрузке системы с помощью следующей команды:
systemctl start apache2
systemctl start mariadb
systemctl enable apache2
systemctl enable mariadb
Как только вы закончите, вы можете перейти к следующему шагу.
Настроить базу данных для GitScrum
Во-первых, вам нужно будет защитить установку MariaDB и установить пароль root для MariaDB. Вы можете сделать это, запустив следующий скрипт:
mysql_secure_installation
Этот скрипт установит корневой пароль MariaDB, удалит анонимных пользователей, запретит удаленный вход в систему root и удалит тестовую базу данных, как показано ниже:
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
Как только MariaDB будет защищена, войдите в оболочку MariaDB с помощью следующей команды:
mysql -u root -p
При появлении запроса укажите свой корневой пароль MariaDB, затем создайте базу данных и пользователя для GitScrum с помощью следующей команды:
MariaDB [(none)]> CREATE DATABASE gitscrum;
MariaDB [(none)]> CREATE USER 'gitscrum'@'localhost' IDENTIFIED BY 'password';
Затем предоставьте все привилегии gitscrum с помощью следующей команды:
MariaDB [(none)]> GRANT ALL ON gitscrum.* TO 'gitscrum'@'localhost' WITH GRANT OPTION;
Затем сбросьте привилегии и выйдите из оболочки MariaDB с помощью следующей команды:
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;
Как только ваша база данных настроена, вы можете перейти к следующему шагу.
Установить Композитор
Далее вам нужно будет установить Composer в вашей системе. Composer — это менеджер зависимостей для PHP, который используется для установки зависимостей PHP, необходимых для вашего проекта.
Вы можете установить Composer с помощью следующей команды:
apt-get install composer -y
После установки вы можете проверить установленную версию Composer с помощью следующей команды:
composer --version
Вы должны увидеть следующий вывод:
Composer 1.10.1 2020-03-13 20:34:27
Как только вы закончите, вы можете перейти к следующему шагу.
Скачать GitScrum
Сначала измените каталог на корневой веб-каталог Apache и загрузите последнюю версию GitScrum из репозитория Git с помощью следующей команды:
cd /var/www/html
git clone https://github.com/GitScrum-Community/laravel-gitscrum.git
После завершения загрузки измените каталог на laravel-gitscrum и обновите пакеты GitScrum с помощью следующей команды:
cd laravel-gitscrum
composer update
composer run-script post-root-package-install
Вы должны увидеть следующий вывод:
> @php -r "file_exists('.env') || copy('.env.example', '.env');"
Как только вы закончите, вы можете перейти к следующему шагу.
Настройка GitScrum
Чтобы интегрировать GitScrum с GitLab, вам нужно будет войти в GitLab и создать приложение.
Вы можете создать его, посетив URL-адрес https://gitlab.com/profile/applications. Вы должны увидеть экран входа в GitLab:
Укажите свое имя пользователя и пароль GitLab и нажмите кнопку «Войти». Вы должны увидеть следующий экран:
Укажите имя вашего приложения, URL-адрес перенаправления, выберите области и нажмите кнопку Сохранить приложение. Вы должны увидеть свой идентификатор приложения и секрет на следующем экране.
Затем вам нужно будет определить идентификатор приложения и секрет в файле .env.
nano /var/www/html/laravel-gitscrum/.env
Определите данные своей базы данных, URL-адрес приложения, идентификатор GitLab и секрет, как показано ниже:
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/
Сохраните и закройте файл, когда закончите. Затем перенесите базу данных с помощью следующей команды:
php artisan migrate
php artisan db:seed
Вы должны увидеть следующий вывод:
Seeding: ConfigIssueEffortsTableSeeder Seeding: ConfigPrioritiesTableSeeder Seeding: IssueTypesTableSeeder Seeding: ConfigStatusesTableSeeder
Затем измените владельца и разрешение laravel-gitscrum с помощью следующей команды:
chown -R www-data:www-data /var/www/html/laravel-gitscrum
chmod -R 775 /var/www/html/laravel-gitscrum
Как только вы закончите, вы можете перейти к следующему шагу.
Настроить Apache для GitScrum
Далее вам нужно будет создать файл конфигурации виртуального хоста Apache для GitScrum. Вы можете создать его с помощью следующей команды:
nano /etc/apache2/sites-available/gitscrum.conf
Добавьте следующие строки:
<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>
Сохраните и закройте файл, когда закончите. Затем проверьте Apache на наличие ошибок конфигурации с помощью следующей команды:
apachectl configtest
Если все в порядке, вы должны увидеть следующий вывод:
Syntax OK
Затем включите виртуальный хост GitScrum с помощью следующей команды:
a2ensite gitscrum.conf
Затем включите модуль перезаписи Apache и перезапустите службу Apache, чтобы применить изменения:
a2enmod rewrite
systemctl restart apache2
Вы также можете проверить статус службы Apache с помощью следующей команды:
systemctl status apache2
Вы должны получить следующий результат:
? 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...
На данный момент веб-сервер Apache настроен для обслуживания GitScrum. Теперь вы можете перейти к следующему шагу.
Доступ к веб-интерфейсу GitScrum
Теперь откройте веб-браузер и введите URL-адрес http://gitscrum.linuxbuz.com. Вы будете перенаправлены на следующую страницу:
Нажмите кнопку GitLab, чтобы войти в GitLab. Вы должны увидеть следующий экран:
Укажите свое имя пользователя и пароль GitLab и нажмите кнопку «Войти». Вы должны увидеть следующий экран:
Теперь нажмите кнопку «Авторизовать», чтобы авторизовать GitScrum для использования вашей учетной записи. Вы должны увидеть следующий экран:
Теперь вы можете импортировать свой репозиторий в GitScrum и начать работу.
Заключение
Поздравляем! вы успешно установили GitScrum и интегрировали его с GitLab на сервере Ubuntu 20.04. Теперь вы можете развернуть GitScrum в среде разработки и начать использовать Git со Scrum для управления задачами. Для получения дополнительной информации посетите официальную документацию GitScrum. Не стесняйтесь спрашивать меня, если у вас есть какие-либо вопросы.