Cara Menginstal Gitea di Ubuntu 20.04

Gitea adalah server git self-hosted yang cepat dan mudah digunakan yang ditulis dalam Go. Ini termasuk editor file repositori, pelacakan masalah proyek, manajemen pengguna, pemberitahuan, wiki bawaan, dan banyak lagi.

Gitea adalah aplikasi ringan dan dapat diinstal pada sistem berdaya rendah. Jika Anda mencari alternatif untuk Gitlab dengan jejak memori yang jauh lebih kecil dan Anda tidak membutuhkan semua fitur yang ditawarkan Gitlab, maka Anda harus mencoba Gitea.

Artikel ini menjelaskan cara menginstal dan mengkonfigurasi Gitea di Ubuntu 20.04.

Prasyarat #

Gitea mendukung SQLite, PostgreSQL , dan MySQL /MariaDB sebagai backend database.

SQLite hanya direkomendasikan untuk instalasi kecil. Instalasi yang lebih besar harus menggunakan MySQL atau PostgreSQL.

Kami akan menggunakan SQLite sebagai database untuk Gitea. Jika SQLite tidak diinstal pada sistem Ubuntu Anda, instal dengan memasukkan perintah berikut sebagai sudo user :

sudo apt updatesudo apt install sqlite3

Menginstal Gitea#

Gitea menyediakan gambar Docker dan dapat diinstal dari sumber, biner, dan sebagai paket. Kami akan menginstal Gitea dari biner.

Instal Git#

Langkah pertama adalah menginstal Git di server Anda:

sudo apt updatesudo apt install git

Verifikasi instalasi dengan menampilkan versi Git:

git --versi

git versi 2.25.1 

Buat pengguna Git #

Buat pengguna sistem baru yang akan menjalankan aplikasi Gitea dengan mengetik:

sudo adduser \ --sistem \ --shell /bin/bash\ --gecos 'Kontrol Versi Git' \ --kelompok \ --dinonaktifkan-kata sandi \ --rumah /home/git \ git

Perintah di atas membuat pengguna dan grup baru bernama git, dan atur direktori home ke /rumah/git. Outputnya akan terlihat seperti di bawah ini:

Menambahkan pengguna sistem 'git' (UID 112)… Menambahkan grup baru 'git' (GID 118)… Menambahkan pengguna baru 'git' (UID 112) dengan grup 'git'… Membuat direktori home '/home/git'… 

Unduh Gitea biner #

Buka halaman Unduh Gitea dan unduh biner terbaru untuk arsitektur Anda. Pada saat penulisan, versi terbaru adalah 1.10.2. Jika ada versi baru yang tersedia, ubah VERSI: KAPAN variabel dalam perintah di bawah ini.

Menggunakan wget untuk mengunduh biner Gitea di /tmp direktori:

VERSI=1.14.1sudo wget -O /tmp/gitea https://dl.gitea.io/gitea/$VERSION/gitea-$VERSION-linux-amd64

Anda dapat menjalankan gitea biner dari lokasi manapun. Kami akan mengikuti konvensi dan memindahkan biner ke /usr/local/bin direktori:

sudo mv /tmp/gitea /usr/local/bin

Jadikan biner dapat dieksekusi:

sudo chmod +x /usr/local/bin/gitea

Jalankan perintah di bawah ini untuk membuat direktori dan mengatur izin dan kepemilikan yang diperlukan:

sudo mkdir -p /var/lib/gitea/custom,data,logsudo chown -R git:git /var/lib/gitea/sudo chmod -R 750 /var/lib/gitea/sudo mkdir /etc/giteasudo chown root:git /etc/giteasudo chmod 770 /etc/gitea

Struktur direktori di atas direkomendasikan oleh dokumentasi resmi Gitea.

Izin dari /etc/gitea direktori disetel ke 770 sehingga wizard penginstalan dapat membuat file konfigurasi. Setelah penginstalan selesai, kami akan menetapkan izin yang lebih ketat.

Buat File Unit Systemd #

Kami akan menjalankan Gitea sebagai layanan systemd.

Unduh contoh file unit systemd ke /etc/systemd/system direktori dengan mengetik:

sudo wget https://raw.githubusercontent.com/go-gitea/gitea/main/contrib/systemd/gitea.layanan -P /etc/systemd/system/

Anda tidak perlu mengedit file, itu dikonfigurasi agar sesuai dengan pengaturan kami.

Aktifkan dan mulai layanan Gitea:

sudo systemctl daemon-reloadsudo systemctl aktifkan --sekarang gitea

Verifikasi bahwa Gitea sedang berjalan:

sudo systemctl status gitea

● gitea.service - Gitea (Git dengan secangkir teh) Dimuat: dimuat (/etc/systemd/system/gitea.layanan; diaktifkan; vendor preset: diaktifkan) Aktif: aktif (berjalan) sejak Kam 2021-05-06 05:32:04 UTC; 7 detik yang lalu PID Utama: 77781 (gitea) Tugas: 6 (batas: 470) Memori: 130.Grup 6M: /sistem.irisan/gitea.service 77781 /usr/local/bin/gitea web --config /etc/gitea/app.ini… 

Konfigurasi Gitea #

Sekarang setelah Gitea diunduh dan dijalankan, kita dapat menyelesaikan penginstalan melalui antarmuka web.

Secara default, Gitea mendengarkan koneksi pada port 3000 di semua antarmuka jaringan.

Jika Anda memiliki firewall UFW yang berjalan di server Anda, Anda harus membuka port Gitea. Untuk mengizinkan lalu lintas di pelabuhan 3000, masukkan perintah berikut:

sudo ufw izinkan 3000/tcp

Buka browser Anda, ketik http://YOUR_DOMAIN_IR_IP:3000, dan akan muncul tampilan seperti berikut :

Pengaturan Basis Data:

• Tipe Basis Data: SQLite3
• Jalur: Gunakan jalur absolut, /var/lib/gitea/data/gitea.db

Pengaturan Umum Aplikasi:

• Judul Situs: Masukkan nama organisasi Anda.
• Jalur Root Repositori: Biarkan default var/lib/gitea/data/gitea-repositori.
• Jalur Akar Git LFS: Biarkan default /var/lib/gitea/data/lfs.
• Jalankan Sebagai Nama Pengguna: git
• Domain Server SSH: Masukkan domain atau alamat IP server Anda.
• Port SSH: 22, ubah jika SSH mendengarkan di Port lain
• Port Dengarkan HTTP Gitea: 3000
• URL Basis Gitea: Gunakan http dan alamat IP domain atau server Anda.
• Jalur Log: Biarkan default /var/lib/gitea/log

Anda dapat mengubah pengaturan kapan saja dengan mengedit file konfigurasi Gitea.

Untuk memulai instalasi, tekan tombol “Install Gitea”.

Instalasinya instan. Setelah selesai, Anda akan diarahkan ke halaman login.

Klik pada "Perlu akun"? Daftar sekarang." tautan. Pengguna terdaftar pertama secara otomatis ditambahkan ke grup Admin.

Ubah izin file konfigurasi Gitea menjadi hanya-baca menggunakan:

sudo chmod 750 /etc/giteasudo chmod 640/etc/gitea/app.ini

Itu dia. Gitea telah diinstal pada mesin Ubuntu Anda.

Mengonfigurasi Nginx sebagai Proksi Penghentian SSL #

Langkah ini opsional, tetapi sangat disarankan. Terminasi SSL berarti Nginx akan bertindak sebagai titik perantara antara aplikasi Gitea dan klien web sehingga Anda dapat mengakses Gitea melalui HTTPS.

Untuk menggunakan Nginx sebagai proxy terbalik, Anda harus memiliki domain atau subdomain yang menunjuk ke IP publik server Anda. Dalam contoh ini, kita akan menggunakan git.contoh.com.

Pertama, instal Nginx dan buat sertifikat SSL Let's Encrypt gratis menggunakan panduan di bawah ini:

• Cara Menginstal Nginx di Ubuntu 20.04
• Amankan Nginx dengan Let's Encrypt di Ubuntu 20.04

Setelah selesai, buka editor teks Anda dan edit file blok server domain:

sudo nano /etc/nginx/sites-enabled/git.contoh.com

/etc/nginx/sites-enabled/git.contoh.com

server  dengarkan 80; nama_server git.contoh.com; sertakan cuplikan/letsencrypt.konf; kembali 301 https://git.contoh.com$request_uri;  server  dengarkan 443 ssl http2; nama_server git.contoh.com; proxy_read_timeout 720 detik; proxy_connect_timeout 720 detik; proxy_send_timeout 720 detik; client_max_body_size 50m; # Header proxy proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Diteruskan-Untuk $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $skema; proxy_set_header X-Real-IP $remote_addr; # Parameter SSL ssl_certificate /etc/letsencrypt/live/git.contoh.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/git.contoh.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/git.contoh.com/rantai.pem; sertakan cuplikan/letsencrypt.konf; sertakan cuplikan/ssl.konf; # file log access_log /var/log/nginx/git.contoh.com.mengakses.catatan; error_log /var/log/nginx/git.contoh.com.kesalahan.catatan; # Menangani / meminta lokasi /  proxy_redirect off; proxy_pass http://127.0.0.1:3000;   

Jangan lupa ganti git.contoh.com dengan domain Gitea Anda dan atur jalur yang benar ke file sertifikat SSL. Lalu lintas HTTP dialihkan ke HTTPS

Mulai ulang layanan Nginx agar perubahan diterapkan:

sudo systemctl restart nginx

Selanjutnya, ubah domain Gitea dan url root. Untuk melakukannya, buka file konfigurasi dan edit baris berikut:

sudo nano /etc/gitea/app.ini

/etc/gitea/app.ini

[server] DOMAIN = git.contoh.com ROOT_URL = https://git.contoh.com/ 

Mulai ulang layanan Gitea dengan mengetik:

sudo systemctl restart gitea

Pada titik ini, proxy Gitea telah dikonfigurasi, dan Anda dapat mengaksesnya di: https://git.contoh.com

Mengonfigurasi Notifikasi Email #

Jika Anda ingin instans Gitea Anda mengirim email pemberitahuan, Anda dapat menginstal Postfix atau menggunakan beberapa layanan surat transaksional seperti SendGrid, MailChimp, MailGun, atau SES.

Untuk mengaktifkan pemberitahuan email, buka file konfigurasi dan edit baris berikut:

sudo nano /etc/gitea/app.ini

/etc/gitea/app.ini

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

Pastikan Anda memasukkan informasi server SMTP yang benar.

Mulai ulang layanan Gitea agar perubahan diterapkan:

sudo systemctl restart gitea

Untuk memverifikasi pengaturan dan mengirim email percobaan, masuk ke Gitea, dan buka: Administrasi Situs > Konfigurasi > Konfigurasi Mailer SMTP.

Gitea juga memungkinkan Anda terhubung ke Slack dengan membuat webhook web dan mengirim pemberitahuan ke saluran Slack Anda .

Memutakhirkan Gitea#

Untuk meningkatkan ke versi Gitea terbaru, cukup unduh dan ganti biner.

1. Hentikan layanan Gitea:

   sudo systemctl stop gitea

2. Unduh versi Gitea terbaru dan pindahkan ke /usr/local/bin direktori:

   VERSI=wget -O /tmp/gitea https://dl.gitea.io/gitea/$VERSION/gitea-$VERSION-linux-amd64sudo mv /tmp/gitea /usr/local/bin

3. Jadikan biner dapat dieksekusi:

   sudo chmod +x /usr/local/bin/gitea

4. Mulai ulang layanan Gitea:

   sudo systemctl restart gitea

Itu dia.

Kesimpulan #

Tutorial ini memandu Anda melalui instalasi Gitea di Ubuntu 20.04. Untuk informasi lebih lanjut tentang cara mengonfigurasi instance Gitea Anda dan membuat proyek pertama Anda, kunjungi halaman dokumentasi Gitea .

Jika Anda memiliki pertanyaan, jangan ragu untuk meninggalkan komentar di bawah ini.