Ubuntu 18.04 üzerine gogs nasıl kurulur ve yapılandırılır

Gogs, Go ile yazılmış, kendi kendine barındırılan açık kaynaklı bir git sunucusudur. Bir depo dosya düzenleyicisi, proje sorunu izleme ve yerleşik bir wiki içerir.

Gogs hafif bir uygulamadır ve düşük güçlü sistemlere kurulabilir. Çok daha küçük bir bellek alanına sahip Gitlab'a alternatif arıyorsanız ve Gitlab'ın sunduğu tüm zil ve ıslıklara ihtiyacınız yoksa kesinlikle Gogs'u denemelisiniz.

Bu eğitici, Ubuntu 18.04'te Gogs kurulum ve yapılandırma adımlarını kapsar. Aynı talimatlar Ubuntu 16.04 ve diğer Ubuntu tabanlı dağıtımlar için de geçerlidir.

Sen başlamadan önce

Gogs, tüm verilerini depolamak için SQLite, PostgreSQL veya MySQL / MariaDB veritabanını kullanabilir.

Bu derste, SQLite'ı tercih edilen veritabanı olarak kullanacağız. SQLite sisteminizde yüklü değilse, aşağıdakini yazarak yükleyebilirsiniz:

sudo apt install sqlite3

Ek bir güvenlik katmanı için temel bir güvenlik duvarı ayarlamanız önerilir. Ubuntu 18.04'te UFW ile Güvenlik Duvarı Ayarlama kılavuzumuzdaki adımları takip edebilirsiniz.

Gogs Kurulumu

Gogs'i ikili dosyadan yükleyeceğiz. Kurulum oldukça basit bir işlemdir.

Git'i yükle

İlk adım Git'i sunucunuza yüklemektir. Bunu yapmak için, yerel paket dizinini yenileyin ve sudo kullanıcısı olarak aşağıdaki komutları çalıştırarak git paketini yükleyin:

sudo apt update sudo apt install git

Git sürümünü görüntüleyerek kurulumu doğrulayın:

git --version

git version 2.17.1

Git kullanıcısı oluşturma

Aşağıdakileri yazarak Gogs hizmetini çalıştırmak için yeni bir sistem kullanıcısı oluşturun:

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

Komut kullanıcıyı oluşturur ve giriş dizinini /home/git ayarlar. Çıktı aşağıdaki gibi görünecektir:

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'…

Gogs ikili dosyasını indir

Gogs Download sayfasını ziyaret edin ve mimariniz için en son ikili dosyayı indirin. Yazma sırasında, en son sürüm 0.11.86'dır, yeni bir sürüm varsa, aşağıdaki komutta VERSION değişkenini değiştirin.

Aşağıdaki wget komutunu kullanarak /tmp dizinindeki Gogs arşivini indirin:

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

İndirme işlemi tamamlandıktan sonra Gogs tar.gz dosyasını ayıklayın ve /home/git dizinine taşıyın:

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

Gogs kurulum dizininin sahipliğini kullanıcı ve grup git olarak değiştirmek için aşağıdaki komutu çalıştırın:

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

Systemd Birim Dosyası oluşturma

Gogs, kurulumumuza uyacak şekilde yapılandırılmış bir Systemd birim dosyasıyla birlikte gelir.

/etc/systemd/system/ komutu yazarak /etc/systemd/system/ dizinine dosya kopyalayın:

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

İşiniz bittiğinde, Gogs hizmetini başlatın ve etkinleştirin:

sudo systemctl start gogs sudo systemctl enable gogs

Hizmetin başarıyla başlatıldığını doğrulayın:

* 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

Web yükleyiciyi kullanarak Gogs'u yükleyin

Şimdi Gogs indirildi ve çalışıyor, kurulumu web arayüzü üzerinden tamamlamanın zamanı geldi.

Tarayıcınızı açın, http://YOUR_DOMAIN_IR_IP:3000 yazın, aşağıdakine benzer bir ekran görünecektir:

İlk kayıtlı kullanıcı otomatik olarak Yönetici grubuna eklenir.

Bu kadar. Gogs, Ubuntu makinenize kuruldu.

Nginx'i SSL Sonlandırma Proxy'si olarak yapılandırma

Bu adım isteğe bağlıdır, ancak şiddetle tavsiye edilir. Nginx'i ters proxy olarak kullanmak için, sunucunuzun genel IP'sini işaret eden bir alanınızın veya alt alanınızın olması gerekir. Bu öğreticide, gogs.example.com .

İlk olarak, aşağıdaki kılavuzları izleyerek Nginx'i yükleyin ve ücretsiz Let's Encrypt SSL sertifikası oluşturun:

İşiniz bittiğinde, metin düzenleyicinizi açın ve alan adı sunucusu blok dosyasını düzenleyin:

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; } } Gogs.example.com'u Gogs alan adınızla değiştirmeyi ve SSL sertifika dosyalarına doğru yolu ayarlamayı unutmayın. Tüm HTTP istekleri HTTPS'ye yönlendirilecek

Değişikliklerin etkili olması için Nginx hizmetini yeniden başlatın:

sudo systemctl restart nginx

Ardından, Gogs alan adını ve kök URL'sini değiştirmemiz gerekiyor. Bunu yapmak için yapılandırma dosyasını açın ve aşağıdaki satırları düzenleyin:

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

DOMAIN = gogs.example.com ROOT_URL =

Gogs hizmetini şunu yazarak yeniden başlatın:

sudo systemctl restart gogs

Bu noktada, Gogs yapılandırılır ve buna şu adresten erişebilirsiniz: https://gogs.example.com

E-posta Bildirimlerini Yapılandırma

Gogs'un bildirim e-postaları gönderebilmesi için Postfix'i yükleyebilir veya SendGrid, MailChimp, MailGun veya SES gibi bazı işlemsel posta hizmetlerini kullanabilirsiniz.

E-posta bildirimlerini etkinleştirmek için yapılandırma dosyasını açın ve aşağıdaki satırları düzenleyin:

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

Doğru SMTP sunucusu bilgilerini girdiğinizden emin olun.

Değişikliklerin etkili olması için Gogs hizmetini yeniden başlatın:

sudo systemctl restart gogs

Gogs ayrıca, web web kancası oluşturarak Slack'e bağlanmanıza ve Slack kanallarınıza bildirim göndermenize olanak tanır.

Gogg'ları Yükseltme

Gogs'u yükseltmek için birkaç manuel adım gereklidir.

1. İlk önce Gogs hizmetini durdurun:

   sudo systemctl stop gogs

   Gogs kurulum dizinini yeniden adlandırın.

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

   En son Gogs sürümünü indirin ve /home/git dizinine taşıyın:

   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 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

   VERSION sürümünü gerçek Gogs sürümüyle değiştirdiğinizden emin olun.

   Aşağıdaki rsync komutunu kullanarak custom , data , log dizinlerini ayıklanan dizine kopyalayın:

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

   Son olarak, Gogs hizmetini başlatın:

   sudo systemctl restart gogs

Bu kadar.

Sonuç

Bu eğitici, Ubuntu 18.04'te Gogs kurulum ve yapılandırmasında size yol gösterdi. Artık ilk projenizi oluşturabilir ve yeni Gogs sunucunuzu kullanmaya başlayabilirsiniz.

Ubuntu gogs