Debian 10에 Kanboard 프로젝트 관리 소프트웨어를 설치하는 방법
이 페이지에서
- 요구 사항\n
- 시작하기\n
- LEMP 서버 설치
- Kanboard용 MariaDB 구성
- 칸보드 설치
- Kanboard용 Nginx 구성
- 칸보드 웹 인터페이스 액세스
Kanboard는 Kanban 방법론을 사용하여 프로젝트를 관리하는 데 사용할 수 있는 무료 오픈 소스 및 자체 호스팅 프로젝트 관리 소프트웨어입니다. 작업 흐름을 시각화하여 진행 중인 작업을 제한하고 Kanboard 웹 인터페이스에서 효율적으로 작업할 수 있습니다. Kanban을 사용하면 필요에 따라 보드를 사용자 정의할 수 있습니다. 플러그인 및 타사 서비스로 Kanbord의 기능을 확장할 수 있습니다.
이 튜토리얼에서는 Debian 10에서 Kanboard를 설치하고 구성하는 방법에 대한 단계별 지침을 안내합니다.
요구 사항
- Debian 10을 실행하는 서버.\n
- 서버에 루트 암호가 구성되어 있습니다.\n
시작하기
시스템을 최신 버전으로 업데이트하는 것이 좋습니다. 다음 명령을 사용하여 모든 패키지를 업데이트할 수 있습니다.
apt-get update -y
apt-get upgrade -y
모든 패키지가 업데이트되면 시스템을 다시 시작하여 구성 변경 사항을 적용하십시오.
LEMP 서버 설치
Kanboard는 PHP로 작성된 웹서버에서 실행되며 데이터베이스 백엔드로 MariaDB를 사용합니다. 따라서 시스템에 Nginx, MariaDB, PHP 및 기타 PHP 모듈을 설치해야 합니다.
apt-get install nginx mariadb-server php7.3 php7.3-common php7.3-cli php7.3-fpm php7.3-mbstring php7.3-json php7.3-opcache php7.3-zip php7.3-xml php7.3-gd php7.3-ldap php7.3-mysql php7.3-json php7.3-sqlite3
설치가 완료되면 Nginx 및 MariaDB 서비스를 시작하고 다음 명령을 사용하여 시스템 재부팅 후 시작할 수 있도록 활성화합니다.
systemctl start nginx
systemctl start mariadb
systemctl enable nginx
systemctl enable mariadb
Kanboard용 MariaDB 구성
기본적으로 MariaDB는 보안되지 않으므로 보안을 권장합니다. 다음 스크립트를 실행하여 보안을 설정할 수 있습니다.
mysql_secure_installation
아래와 같이 모든 질문에 답하십시오.
Enter current password for root (enter for none):
Set root password? [Y/n]: N
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
메시지가 표시되면 루트 비밀번호를 입력한 다음 Kanboard용 데이터베이스와 사용자를 생성합니다.
MariaDB [(none)]>CREATE DATABASE kanboard CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
다음으로 다음 명령을 사용하여 Kanboard 데이터베이스에 모든 권한을 부여합니다.
MariaDB [(none)]>GRANT ALL PRIVILEGES ON kanboard.* TO 'kanboard'@'localhost' IDENTIFIED BY 'mypassword';
위의 SQL 명령어에서 mypassword라는 단어를 선택한 보안 비밀번호로 바꿉니다. 그런 다음 다음 명령을 사용하여 권한을 플러시합니다.
MariaDB [(none)]>FLUSH PRIVILEGES;
마지막으로 다음 명령을 사용하여 MariaDB 셸을 종료합니다.
MariaDB [(none)]>\q
칸보드 설치
먼저 다음 명령을 사용하여 Git 리포지토리에서 Kanboard 최신 버전을 다운로드합니다.
wget https://github.com/kanboard/kanboard/archive/v1.2.10.tar.gz
다운로드가 완료되면 다음 명령을 사용하여 다운로드한 파일의 압축을 풉니다.
tar -xvf v1.2.10.tar.gz
다음으로 다음 명령을 사용하여 추출된 디렉터리를 Apache 웹 루트 디렉터리에 복사합니다.
cp -r kanboard-1.2.10 /var/www/html/kanboard
다음으로 다음 명령을 사용하여 Kanboard 샘플 구성 파일을 복사합니다.
cd /var/www/html/kanboard
cp config.default.php config.php
다음으로 원하는 편집기로 config.php 파일을 엽니다.
nano config.php
아래와 같이 데이터베이스 설정을 정의합니다.
// Database driver: sqlite, mysql or postgres (sqlite by default)
define('DB_DRIVER', 'mysql');
// Mysql/Postgres username
define('DB_USERNAME', 'kanboard');
// Mysql/Postgres password
define('DB_PASSWORD', 'password');
// Mysql/Postgres hostname
define('DB_HOSTNAME', 'localhost');
// Mysql/Postgres database name
define('DB_NAME', 'kanboard');
완료되면 파일을 저장하고 닫습니다. 그런 다음 다음 명령을 사용하여 적절한 권한을 설정합니다.
chown -R www-data:www-data /var/www/html/kanboard
완료되면 다음 단계로 진행할 수 있습니다.
Kanboard용 Nginx 구성
다음으로 Kanboard용 Nginx 가상 호스트 파일을 만들어야 합니다. 다음 명령으로 만들 수 있습니다.
nano /etc/nginx/conf.d/kanboard.conf
다음 줄을 추가합니다.
server {
listen 80;
server_name example.com;
index index.php;
root /var/www/html/kanboard;
client_max_body_size 32M;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_index index.php;
include fastcgi_params;
}
location ~* ^.+\.(log|sqlite)$ {
return 404;
}
location ~ /\.ht {
return 404;
}
location ~* ^.+\.(ico|jpg|gif|png|css|js|svg|eot|ttf|woff|woff2|otf)$ {
log_not_found off;
expires 7d;
etag on;
}
gzip on;
gzip_comp_level 3;
gzip_disable "msie6";
gzip_vary on;
gzip_types
text/javascript
application/javascript
application/json
text/xml
application/xml
application/rss+xml
text/css
text/plain;
}
완료되면 파일을 저장하고 닫습니다. 그런 다음 다음 명령을 사용하여 Nginx에서 구문 오류가 있는지 확인합니다.
nginx -t
다음 출력이 표시되어야 합니다.
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
마지막으로 다음 명령을 사용하여 Nginx 및 php-fpm 서비스를 다시 시작합니다.
systemctl restart nginx
systemctl restart php7.3-fpm
다음 명령을 사용하여 Nginx 서비스의 상태를 확인할 수 있습니다.
systemctl status nginx
다음 출력이 표시되어야 합니다.
? nginx.service - A high performance web server and a reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2019-07-13 06:05:09 EDT; 26s ago
Docs: man:nginx(8)
Process: 13412 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Process: 13413 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Main PID: 13414 (nginx)
Tasks: 2 (limit: 1138)
Memory: 2.9M
CGroup: /system.slice/nginx.service
??13414 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
??13415 nginx: worker process
Jul 13 06:05:09 debian systemd[1]: Starting A high performance web server and a reverse proxy server...
Jul 13 06:05:09 debian systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Jul 13 06:05:09 debian systemd[1]: Started A high performance web server and a reverse proxy server.
Kanboard 웹 인터페이스에 액세스
이제 Kanboard가 설치 및 구성되었으며 Kanboard 웹 인터페이스에 액세스할 시간입니다.
웹 브라우저를 열고 URL http://example.com을 입력합니다. 다음 페이지로 리디렉션됩니다.
기본 관리자 사용자 이름과 비밀번호를 admin/admin으로 입력하고 로그인 버튼을 클릭합니다. 다음 페이지에서 Kanboard 기본 대시보드를 볼 수 있습니다.
기본 관리자 암호를 변경하는 것이 좋습니다. 이렇게 하려면 관리자 > 사용자 관리 > 관리자로 이동합니다. 다음 페이지가 표시됩니다.
이제 비밀번호 변경 버튼을 클릭합니다. 다음 페이지가 표시됩니다.
새 비밀번호를 입력하고 저장 버튼을 클릭합니다.
축하합니다! Debian 10에 Kanboard를 성공적으로 설치하고 구성했습니다. 이제 Kanboard 웹 인터페이스에서 작업을 쉽게 관리할 수 있습니다. 궁금한 점이 있으면 언제든지 문의해 주세요.