Bagaimana untuk memasang dan mengkonfigurasi gogs pada ubuntu 18.04

Gogs adalah pelayan sumber terbuka yang menjadi tuan rumah sendiri yang ditulis dalam Go. Ia termasuk editor fail repositori, pengesanan isu projek, dan wiki terbina dalam.

Gogs adalah aplikasi yang ringan dan boleh dipasang pada sistem berkuasa rendah. Jika anda mencari alternatif untuk Gitlab dengan jejak memori yang lebih kecil dan anda tidak memerlukan semua loceng dan wisel yang ditawarkan Gitlab maka anda pasti akan cuba Gogs.

Tutorial ini merangkumi langkah-langkah untuk memasang dan mengkonfigurasi Gogs pada Ubuntu 18.04. Arahan yang sama berlaku untuk Ubuntu 16.04 dan mana-mana pengedaran berasaskan Ubuntu.

Sebelum awak bermula

Gog boleh menggunakan pangkalan data SQLite, PostgreSQL, atau MySQL / MariaDB untuk menyimpan semua datanya.

Dalam tutorial ini, kami akan menggunakan SQLite sebagai pangkalan data pilihan. Jika SQLite tidak dipasang pada sistem anda, anda boleh memasangnya dengan menaip:

sudo apt install sqlite3

Untuk lapisan keselamatan tambahan, disyorkan untuk menubuhkan firewall asas. Anda boleh mengikuti langkah-langkah dalam Cara Menyediakan Firewall dengan UFW pada panduan Ubuntu 18.04.

Memasang Gogs

Kami akan memasang Gogs dari binari. Pemasangan adalah proses yang cukup lurus ke hadapan.

Pasang Git

Langkah pertama ialah memasang Git pada pelayan anda. Untuk berbuat demikian, muat semula indeks pakej setempat dan pasangkan pakej git dengan menjalankan perintah berikut sebagai pengguna sudo:

sudo apt update sudo apt install git

Sahkan pemasangan dengan memaparkan versi Git:

git --version

git version 2.17.1

Buat pengguna Git

Buat pengguna sistem baru untuk menjalankan perkhidmatan Gogs dengan menaip:

sudo adduser --system --group --disabled-password --shell /bin/bash --home /home/git --gecos 'Git Version Control' git

Perintah akan membuat pengguna dan tetapkan direktori rumah ke /home/git . Output akan kelihatan seperti di bawah:

Adding system user `git' (UID 111)… Adding new group `git' (GID 116)… Adding new user `git' (UID 111) with group `git'… Creating home directory `/home/git'…

Muat turun binari Gogs

Lawati halaman Muat Gogs dan muat turun binary terkini untuk seni bina anda. Pada masa penulisan, versi terkini ialah 0.11.86, jika ada versi baru yang tersedia, ubah pemboleh ubah VERSION dalam arahan di bawah.

Muat turun arkib Gog di direktori /tmp menggunakan perintah wget berikut:

VERSION=0.11.86 wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp

Setelah muat turun selesai, ekstrak fail tar.gz Gogs dan pindahkannya ke direktori /home/git :

sudo tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git

Jalankan arahan berikut untuk menukar pemilikan direktori pemasangan Gog kepada pengguna dan kumpulan git:

sudo chown -R git: /home/git/gogs

Buat Fail Unit Sistem

Gogs dilengkapi dengan fail unit Systemd yang sudah dikonfigurasikan untuk sepadan dengan persediaan kami.

Salin fail ke direktori /etc/systemd/system/ dengan menaip:

sudo cp /home/git/gogs/scripts/systemd/gogs.service /etc/systemd/system/

Sebaik sahaja selesai, mulakan dan dayakan perkhidmatan Gogs:

sudo systemctl start gogs sudo systemctl enable gogs

Sahkan bahawa perkhidmatan bermula dengan jayanya:

* gogs.service - Gogs Loaded: loaded (/etc/systemd/system/gogs.service; enabled; vendor preset: enabled) Active: active (running) since Thu 2019-04-25 04:13:44 PDT; 9s ago Main PID: 14376 (gogs) Tasks: 8 (limit: 2319) CGroup: /system.slice/gogs.service `-14376 /home/git/gogs/gogs web

Pasang Gogs menggunakan pemasang web

Sekarang bahawa Gogs dimuat turun dan berjalan, tiba masanya untuk menyelesaikan pemasangan melalui antara muka web.

Buka pelayar anda, ketik http://YOUR_DOMAIN_IR_IP:3000 dan skrin yang serupa dengan yang berikut akan muncul:

Pengguna berdaftar yang pertama ditambah secara automatik kepada kumpulan Admin.

Itu sahaja. Gogs telah dipasang pada mesin Ubuntu anda.

Mengkonfigurasi Nginx sebagai Proksi Penamatan SSL

Langkah ini adalah pilihan tetapi amat disyorkan. Untuk menggunakan Nginx sebagai proksi terbalik, anda perlu mempunyai domain atau subdomain yang menunjuk ke IP awam pelayan anda. Dalam tutorial ini, kami akan menggunakan gogs.example.com .

Mula-mula, pasang Nginx dan buat percuma Let's Encrypt Sijil SSL dengan mengikuti panduan di bawah ini:

Sebaik sahaja selesai, buka editor teks anda dan edit fail blok pelayan domain:

sudo nano /etc/nginx/sites-enabled/gogs.example.com /etc/nginx/sites-enabled/gogs.example.com

server { listen 80; server_name gogs.example.com; include snippets/letsencrypt.conf; return 301 https://gogs.example.com$request_uri; } server { listen 443 ssl http2; server_name gogs.example.com; proxy_read_timeout 720s; proxy_connect_timeout 720s; proxy_send_timeout 720s; client_max_body_size 50m; # Proxy headers proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Real-IP $remote_addr; # SSL parameters ssl_certificate /etc/letsencrypt/live/gogs.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/gogs.example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/gogs.example.com/chain.pem; include snippets/letsencrypt.conf; include snippets/ssl.conf; # log files access_log /var/log/nginx/gogs.example.com.access.log; error_log /var/log/nginx/gogs.example.com.error.log; # Handle / requests location / { proxy_redirect off; proxy_pass http://127.0.0.1:3000; } }

Jangan lupa untuk mengganti gogs.example.com dengan domain Gogs anda dan tetapkan laluan yang betul ke fail sijil SSL. Semua permintaan HTTP akan diarahkan ke Mulakan semula perkhidmatan Nginx untuk melaksanakan perubahan:

sudo systemctl restart nginx

Seterusnya, kita perlu menukar domain dan url root domain Gogs. Untuk melakukannya, buka fail konfigurasi dan edit baris berikut:

sudo nano /home/git/gogs/custom/conf/app.ini /home/git/gogs/custom/conf/app.ini

DOMAIN = gogs.example.com ROOT_URL =

Mulakan semula perkhidmatan Gogs dengan menaip:

sudo systemctl restart gogs

Pada ketika ini, Gogs dikonfigurasikan dan anda boleh mengaksesnya di: https://gogs.example.com

Mengkonfigurasi Pemberitahuan E-mel

Agar Gog dapat menghantar e-mel pemberitahuan, anda sama ada boleh memasang Postfix atau menggunakan beberapa perkhidmatan mel transaksional seperti SendGrid, MailChimp, MailGun atau SES.

Untuk mendayakan pemberitahuan e-mel, buka fail konfigurasi dan edit baris berikut:

sudo nano /home/git/gogs/custom/conf/app.ini /home/git/gogs/custom/conf/app.ini

ENABLED = true HOST = SMTP_SERVER:SMTP_PORT FROM = SENDER_EMAIL USER = SMTP_USER PASSWD = YOUR_SMTP_PASSWORD

Pastikan anda meletakkan maklumat pelayan SMTP yang betul.

Mulakan semula perkhidmatan Gogs untuk melaksanakan perubahan:

sudo systemctl restart gogs

Gog juga membolehkan anda menyambung ke Slack dengan membuat webhook web dan menghantar pemberitahuan ke saluran Slack anda.

Meningkatkan Gogs

Untuk meningkatkan Gogs, beberapa langkah manual diperlukan.

1. Pertama hentikan perkhidmatan Gogs:

   sudo systemctl stop gogs

   Namakan semula direktori pemasangan Gogs.

   sudo mv /home/git/gogs{, _old}

   Muat turun versi terbaru Gogs dan gerakkannya ke direktori /home/git :

   VERSION= wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp sudo tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git

   Pastikan anda menukar VERSION dengan versi pelepas Gogs sebenar.

   Salin custom , data , direktori log ke direktori yang diekstrak menggunakan perintah rsync berikut:

   sudo rsync -a /home/git/gogs_old/{custom, data, log} /home/git/gogs/

   Akhir sekali, mulakan perkhidmatan Gogs:

   sudo systemctl restart gogs

Itu sahaja.

Kesimpulannya

Tutorial ini membimbing anda melalui pemasangan dan konfigurasi Gogs pada Ubuntu 18.04. Anda kini boleh membuat projek pertama anda dan mula menggunakan pelayan Gogs baru anda.

ubuntu ubuntu