Cách cài đặt công cụ quản lý dự án GitScrum Agile trên Ubuntu 20.04 LTS

[theanh]

GitScrum là một công cụ quản lý dự án nguồn mở dựa trên nền tảng Laravel và được thiết kế để giúp các nhóm phát triển sử dụng Git và Scrum để quản lý tác vụ giúp họ trở nên linh hoạt hơn. Công cụ này có thể tích hợp với Github hoặc Gitlab hoặc Bitbucket. Công cụ này được thiết kế cho các công ty khởi nghiệp, công ty bán hàng, công ty tiếp thị, nhà phát triển và người làm việc tự do để quản lý dự án của họ một cách dễ dàng. Công cụ này cung cấp các tính năng rất hữu ích bao gồm Product Backlog, User Story, Sprint Backlog, Issues, v.v.

Trong hướng dẫn này, chúng tôi sẽ giải thích cách cài đặt GitScrum trên máy chủ Ubuntu 20.04.

Điều kiện tiên quyết​

• Một máy chủ chạy Ubuntu 20.04.
• Một tên miền hợp lệ được trỏ đến VPS của bạn.
• Một mật khẩu gốc được thiết lập trên máy chủ của bạn.

Bắt đầu​

Trước tiên, bạn sẽ cần cập nhật các gói hệ thống của mình lên phiên bản mới nhất. Bạn có thể cập nhật chúng bằng lệnh sau:

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

Sau khi hệ thống của bạn được cập nhật, hãy khởi động lại để áp dụng các thay đổi.

Cài đặt Apache, MariaDB và PHP​

GitScrum chạy trên máy chủ web, sử dụng MariaDB/MySQL làm cơ sở dữ liệu phụ trợ và dựa trên nền tảng Laravel. Vì vậy, bạn sẽ cần cài đặt máy chủ web Apache, MariaDB, PHP và các tiện ích mở rộng PHP cần thiết trong hệ thống của mình. Bạn có thể cài đặt tất cả chúng bằng cách chạy lệnh sau:

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

Sau khi tất cả các gói được cài đặt, hãy chỉnh sửa tệp php.ini và thay đổi nó bằng một số giá trị mong muốn:

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

Thay đổi các dòng sau:

memory_limit = 256Mupload_max_filesize = 100Mmax_execution_time = 360date.timezone = America/Chicago

Lưu và đóng tệp khi bạn hoàn tất. Sau đó, khởi động dịch vụ Apache và MariaDB và cho phép chúng khởi động khi khởi động lại hệ thống bằng lệnh sau:

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

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cấu hình Cơ sở dữ liệu cho GitScrum​

Trước tiên, bạn sẽ cần bảo mật cài đặt MariaDB và đặt mật khẩu gốc MariaDB. Bạn có thể thực hiện bằng cách chạy tập lệnh sau:

mysql_secure_installation

Tập lệnh này sẽ đặt mật khẩu gốc MariaDB, xóa người dùng ẩn danh, không cho phép đăng nhập gốc từ xa và xóa cơ sở dữ liệu thử nghiệm như được hiển thị bên dưới:

Nhập mật khẩu hiện tại cho root (nhập nếu không có):OK, mật khẩu đã sử dụng thành công, tiếp tục...Đặt mật khẩu gốc? [Y/n] YXóa người dùng ẩn danh? [Y/n] YKhông cho phép đăng nhập gốc từ xa? [Y/n] YXóa cơ sở dữ liệu thử nghiệm và quyền truy cập vào cơ sở dữ liệu đó? [Y/n] YTải lại bảng đặc quyền ngay bây giờ? [Y/n] Y

Sau khi MariaDB được bảo mật, hãy đăng nhập vào shell MariaDB bằng lệnh sau:

mysql -u root -p

Cung cấp mật khẩu gốc MariaDB của bạn khi được nhắc, sau đó tạo cơ sở dữ liệu và người dùng cho GitScrum bằng lệnh sau:

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

Tiếp theo, cấp tất cả các quyền cho gitscrum bằng lệnh sau:

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

Tiếp theo, flush các quyền và thoát khỏi shell MariaDB bằng lệnh sau:

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

Sau khi cấu hình xong cơ sở dữ liệu, bạn có thể tiến hành bước tiếp theo.

Cài đặt Composer​

Tiếp theo, bạn sẽ cần cài đặt Composer vào hệ thống của mình. Composer là trình quản lý phụ thuộc cho PHP và được sử dụng để cài đặt các phụ thuộc PHP cần thiết cho dự án của bạn.

Bạn có thể cài đặt Composer bằng lệnh sau:

apt-get install composer -y

Sau khi cài đặt, bạn có thể xác minh phiên bản Composer đã cài đặt bằng lệnh sau:

composer --version

Bạn sẽ thấy đầu ra sau:

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

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Tải xuống GitScrum​

Trước tiên, hãy thay đổi thư mục thành thư mục gốc web Apache và tải xuống phiên bản GitScrum mới nhất từ kho lưu trữ Git bằng lệnh sau:

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

Sau khi tải xuống hoàn tất, hãy thay đổi thư mục thành laravel-gitscrum và cập nhật các gói GitScrum bằng lệnh sau:

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

Bạn sẽ thấy đầu ra sau:

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

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cấu hình GitScrum​

Để tích hợp GitScrum với GitLab, bạn sẽ cần đăng nhập vào GitLab và tạo một ứng dụng.

Bạn có thể tạo ứng dụng bằng cách truy cập URL https://gitlab.com/profile/applications. Bạn sẽ thấy màn hình đăng nhập GitLab:



Cung cấp tên người dùng và mật khẩu GitLab của bạn, rồi nhấp vào nút Đăng nhập vào. Bạn sẽ thấy màn hình sau:





Cung cấp tên ứng dụng của bạn, chuyển hướng URL, chọn phạm vi và nhấp vào nút Lưu ứng dụng. Bạn sẽ thấy ID ứng dụng và Bí mật của mình trong màn hình sau.



Tiếp theo, bạn sẽ cần định nghĩa ID ứng dụng và Bí mật của mình trong tệp .env.

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

Định nghĩa thông tin chi tiết về cơ sở dữ liệu, URL ứng dụng, ID GitLab và Bí mật như được hiển thị bên dưới:

DB_CONNECTION=mysqlDB_HOST=localhostDB_PORT=3306DB_DATABASE=gitscrumDB_USERNAME=gitscrumDB_PASSWORD=passwordAPP_URL=http://gitscrum.linuxbuz.comGITLAB_KEY=19ed6d8500710c32049e703c537e0c2251f41bdaedb6ca3f9d3276a0ea2fe484GITLAB_SECRET=efe24736031571d59a5994d860f561c69d7c3bb46ab4a4fdae6406972df21565GITLAB_INSTANCE_URI=https://gitlab.com/

Lưu và đóng tệp khi bạn hoàn tất. Sau đó, di chuyển cơ sở dữ liệu bằng lệnh sau:

php artisan migrate
php artisan db:seed

Bạn sẽ thấy kết quả sau:

Seeding: ConfigIssueEffortsTableSeederSeeding: ConfigPrioritiesTableSeederSeding: IssueTypesTableSeederSeding: ConfigStatusesTableSeeder

Tiếp theo, thay đổi quyền sở hữu và quyền của laravel-gitscrum bằng lệnh sau:

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

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cấu hình Apache cho GitScrum​

Tiếp theo, bạn sẽ cần tạo một máy chủ ảo Apache tệp cấu hình máy chủ cho GitScrum. Bạn có thể tạo tệp này bằng lệnh sau:

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

Thêm các dòng sau:

 ServerAdmin [emailprotected] 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  Options +FollowSymlinks AllowOverride All Require all granted

Lưu và đóng tệp khi bạn hoàn tất. Sau đó, hãy xác minh Apache xem có lỗi cấu hình nào không bằng lệnh sau:

apachectl configtest

Nếu mọi thứ đều ổn, bạn sẽ thấy kết quả sau:

Cú pháp OK

Tiếp theo, hãy bật máy chủ ảo GitScrum bằng lệnh sau:

a2ensite gitscrum.conf

Tiếp theo, hãy bật mô-đun ghi đè Apache và khởi động lại dịch vụ Apache để áp dụng các thay đổi:

a2enmod rewrite
systemctl restart apache2

Bạn cũng có thể xác minh trạng thái dịch vụ Apache bằng lệnh sau:

systemctl status apache2

Bạn sẽ nhận được kết quả sau:

? apache2.service - Máy chủ HTTP Apache Đã tải: đã tải (/lib/systemd/system/apache2.service; đã bật; cài đặt trước của nhà cung cấp: đã bật) Đang hoạt động: đang hoạt động (đang chạy) kể từ Thu 2020-07-03 07:42:29 UTC; 4 phút 35 giây trước Tài liệu: https://httpd.apache.org/docs/2.4/ Tiến trình: 16070 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS) PID chính: 13697 (apache2) Nhiệm vụ: 6 (giới hạn: 2353) Bộ nhớ: 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 start03 tháng 7 07:42:29 ubuntu20 systemd[1]: Đang khởi động Máy chủ HTTP Apache...

Tại thời điểm này, máy chủ web Apache được cấu hình để phục vụ GitScrum. Bây giờ bạn có thể tiến hành bước tiếp theo.

Truy cập Giao diện web GitScrum​

Bây giờ, hãy mở trình duyệt web của bạn và nhập URL http://gitscrum.linuxbuz.com. Bạn sẽ được chuyển hướng đến trang sau:



Nhấp vào nút GitLab để đăng nhập bằng GitLab. Bạn sẽ thấy màn hình sau:



Cung cấp tên người dùng, mật khẩu GitLab của bạn và nhấp vào nút Đăng nhập vào. Bạn sẽ thấy màn hình sau:



Bây giờ, hãy nhấp vào nút Ủy quyền để Ủy quyền cho GitScrum sử dụng tài khoản của bạn. Bạn sẽ thấy màn hình sau:



Bây giờ, bạn có thể nhập kho lưu trữ của mình vào GitScrum và bắt đầu làm việc.

Kết luận​

Xin chúc mừng! Bạn đã cài đặt thành công GitScrum và tích hợp nó với GitLab trên máy chủ Ubuntu 20.04. Bây giờ bạn có thể triển khai GitScrum trong môi trường phát triển và bắt đầu sử dụng Git với Scrum để quản lý tác vụ. Để biết thêm thông tin, hãy truy cập GitScrum tài liệu chính thức. Hãy thoải mái hỏi tôi nếu bạn có bất kỳ câu hỏi nào.