כיצד להתקין ולהגדיר redmine ב- debian 9

Redmine הוא יישום בחינם וניהול פרויקטים של קוד פתוח ומעקב אחר בעיות. זהו פלטפורמה חוצה מסדי נתונים ונבנה על גבי מסגרת ה- Ruby on Rails.

Redmine כולל תמיכה בפרויקטים מרובים, וויקי, מערכת מעקב אחר בעיות, פורומים, לוחות שנה, התראות בדוא"ל ועוד ועוד.

במדריך זה, נראה לך כיצד להתקין ולהגדיר את הגירסה האחרונה של Redmine בשרת Debian 9 באמצעות MySQL כבסיסת בסיס נתונים ו- Passenger + Nginx כשרת יישומי Ruby.

תנאים מוקדמים

וודא כי עמדת בתנאים המוקדמים הבאים לפני שתמשיך במדריך זה:

• ציין שם דומיין שמצביע על ה- IP הציבורי של השרת שלך. אנו נשתמש ב- example.com מחובר כמשתמש עם הרשאות sudo. הותקן Nginx. יש אישור SSL המותקן עבור התחום שלך.

יצירת בסיס נתונים של MySQL

Redmine תומך ב- MySQL / MariaDB, Microsoft SQL Server, SQLite 3 ו- PostgreSQL. אנו נשתמש ב- MariaDB כמאגר בסיס של מסד נתונים. וודא כי התקנת במחשב שלך לפחות את MySQL 5.7 או MariaDB 10.3.

אם MariaDB או MySQL אינם מותקנים בשרת Debian שלך, אתה יכול להתקין אותם באמצעות הוראות אלה.

התחל על ידי כניסה למסוף MySQL על ידי הקלדת:

sudo mysql

הרץ את הצהרת SQL הבאה כדי ליצור בסיס נתונים חדש:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

צור חשבון משתמש חדש ב- MySQL והעניק גישה למסד הנתונים:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; אל תשכח לשנות change-with-strong-password חזקה.

לאחר סיום היציאה ממסוף ה- MariaDB על ידי הקלדת:

EXIT;

מתקין רובי

הדרך הקלה ביותר להתקין את רובי על דביאן היא באמצעות מנהל החבילות apt :

התקן את רובי על ידי הקלדה:

sudo apt install ruby-full

בזמן הכתיבה הגרסה במאגרי Debian היא 2.3.3p222 הנתמכת על ידי הגרסה האחרונה של Redmine.

התקנת נוסע ו- Nginx

Passenger הוא שרת יישומי אינטרנט מהיר וקל משקל עבור Ruby, Node.js ו- Python הניתן לשילוב עם Apache ו- Nginx. אנו נתקין את Passenger כמודול Nginx.

וודא כי Nginx מותקן לפני שתמשיך בצעדים הבאים.

התקנת החבילות הדרושות כדי לאפשר מאגר

sudo apt install dirmngr gnupg apt-transport-https ca-certificates software-properties-common

ייבא את מפתח ה- GPG של המאגר והפעל את מאגר ה- Phusion Passenger:

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7 sudo add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger stretch main' sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7 sudo add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger stretch main'

עדכן את רשימת החבילות והתקן את מודול Passenger Nginx באמצעות:

sudo apt update sudo apt install libnginx-mod-http-passenger

התקנת Redmine ב- Debian

התחל בהתקנת התלות הנחוצה לבניית Redmine:

sudo apt install build-essential libmariadbclient-dev imagemagick libmagickwand-dev curl ruby-dev libxslt-dev libxml2-dev zlib1g-dev

בעת כתיבת מאמר זה, הגרסה האחרונה של Redmine היציבה היא גרסה 4.0.4.

לפני שתמשיכו עם השלב הבא, עליכם לבדוק בעמוד ההורדה של Redmine גרסה חדשה יותר.

1. הורדת Redmine

הורד את ארכיב Redmine באמצעות הפקודה התלתל הבאה:

sudo curl -L http://www.redmine.org/releases/redmine-4.0.4.tar.gz -o /tmp/redmine.tar.gz

לאחר סיום ההורדה, חלץ את הארכיון והעבר אותו /opt :

cd /tmp sudo tar zxf /tmp/redmine.tar.gz sudo mv /tmp/redmine-4.0.4 /opt/redmine

2. הגדרת מסד נתונים Redmine

העתק את קובץ התצורה לדוגמה Redmine:

sudo cp /opt/redmine/config/database.yml.example /opt/redmine/config/database.yml

פתח את הקובץ עם עורך הטקסט שלך:

sudo nano /opt/redmine/config/database.yml

חפש את מדור production והזן למסד הנתונים MySQL ומידע המשתמש שיצרנו קודם:

/opt/redmine/config/database.yml

production: adapter: mysql2 database: redmine host: localhost username: redmine password: "change-with-strong-password" encoding: utf8

לאחר סיום, שמור את הקובץ וצא מהעורך.

3. התקנת תלות רובי

נווט אל ספריית ה- redmine והתקן את bundler ותלות רובי אחרות:

cd /opt/redmine/ sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite

4. צור מפתחות והעבר את מסד הנתונים

הפעל את הפקודה הבאה כדי ליצור מפתחות ולהעברת בסיס הנתונים:

cd /opt/redmine/ sudo bundle exec rake generate_secret_token cd /opt/redmine/ sudo bundle exec rake generate_secret_token sudo RAILS_ENV=production bundle exec rake db:migrate

5. הגדר את ההרשאות הנכונות

Nginx פועל כמשתמש www-data וקבוצה. הגדר את ההרשאות הנכונות על ידי הנפקה הבאה של פקודה:

sudo chown -R www-data: /opt/redmine/

קבע את התצורה של Nginx

בשלב זה, עליך להתקין Nginx עם אישור SSL במערכת שלך, אם לא לבדוק את התנאים המוקדמים להדרכה זו.

פתח את עורך הטקסט שלך וצור את קובץ החסימה הבא של שרת Nginx:

sudo nano /etc/nginx/sites-available/example.com /etc/nginx/sites-available/example.com

# Redirect HTTP -> HTTPS server { listen 80; server_name www.example.com example.com; include snippets/letsencrypt.conf; return 301 https://example.com$request_uri; } # Redirect WWW -> NON WWW server { listen 443 ssl http2; server_name www.example.com; ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; return 301 https://example.com$request_uri; } server { listen 443 ssl http2; server_name example.com; root /opt/redmine/public; # SSL parameters ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; include snippets/letsencrypt.conf; # log files access_log /var/log/nginx/example.com.access.log; error_log /var/log/nginx/example.com.error.log; passenger_enabled on; passenger_min_instances 1; client_max_body_size 10m; } אל תשכח להחליף example.com בדומיין Redmine ולהגדיר את הנתיב הנכון לקבצי אישור SSL. כל בקשות HTTP יופנו ל- HTTPS. הקטעים המשמשים בתצורה זו נוצרים במדריך זה.

אפשר את חסימת השרת על ידי יצירת קישור סמלי לתיקיה המאפשרת sites-enabled :

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

לפני שתתחיל מחדש את שירות Nginx, בדוק כי אין שגיאות תחביר:

sudo nginx -t

אם אין שגיאות, הפלט אמור להיראות כך:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful

לבסוף, הפעל מחדש את שירות Nginx על ידי הקלדת:

sudo systemctl restart nginx

ניגש לרדמיין

פתח את הדפדפן שלך, הקלד את הדומיין שלך והנחה שההתקנה תצליח, יופיע מסך הדומה לזה הבא:

לאחר שתשנה את הסיסמה תנותב לדף חשבון המשתמש.

סיכום

התקנת בהצלחה את Redmine במערכת ה- Debian שלך. כעת עליך לבדוק את התיעוד Redmine וללמוד עוד כיצד להגדיר Redmine ולהשתמש בו.

דביאן redmine אודם