Bireysel paylaşım sitesi "mocal™

Selamlar uzun zamandır yeni bir paylaşımda bulunmamıştım. Gitlab paylaşımı ile bu araya son vermek istedim.

Günümüzün popüler source kontrol aracı olan git ile ilgili; kurulum, kullanım ve konfigürasyon tarzında bilgiler vermek istiyorum. İlk olarak git nedir konusuna değineyim. GIT; hız odaklı, dağıtık çalışan sürüm kontrol ve kaynak kod yönetim sistemi olarak tanımlanmakta. Daha fazla bilgi için;

https://tr.wikipedia.org/wiki/Git_(yaz%C4%B1l%C4%B1m)

Hız ve dağıtık yapı "GIT"i diğer merkezi yapıya sahip olan "SVN" gibi araçlardan bir adım öne çıkarıyor. Uzun bir süre merkezi yapıya sahip versiyon araçları kullanıp "GIT" ile tanışırsanız dağıtık yapısı sebebiyle biraz kafanız karışabilir, çalışma mantığını anladıktan sonra seveceğinizi düşünüyorum. Sözü fazla uzatmadan kurulum adımlarına geçiyorum, nasıl GITLAB kurulur?

NOT:Anlatımda Ubuntu 14.04.3 LTS sürüm üzerine "GitLab Community Edition (CE)" kurulumu yapılmaktadır.

Kurulum adımları:

useradd -d /home/mocal -s /bin/bash -m mocal -g sudo

passwd mocal

sudo apt-get install curl openssh-server ca-certificates postfix

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Bu adıma alternatif olarak "https://packages.gitlab.com/gitlab/gitlab-ce" adresinden işletim sistemine uygun "deb" paketinide indirebilirsiniz.

sudo apt-get install gitlab-ce

Deb paket ile kurulum için aşağıdaki yöntemi;

dpkg -i gitlab-ce-XXX.deb

Konfigurasyon ve GitLab'ı başlatmak için ;

sudo gitlab-ctl reconfigure

Browserdan oturum açmak için ;

http://hostname/users/sign_in
Username: root

Password: 5iveL!fe

Kurulumu tamamladığımıza göre oturum açıp basit bir "GIT" projesi oluşturalım. Bunun için ilk yapmamız gereken işlem ekranın sağ üst köşesinde sarı daire içine aldığım butona tıklamak, sonrasında açılan proje tanımlama ekranında bizden istediği alanları doldurarak projemizi oluşturuyoruz.

Önemli birkaç duruma değinmek istiyorum; yeni proje tanımlama ekranında kırmızı renkle alanları numaraladım. Bu alanlar hakkında kısa bilgiler vereyim.

Ekran görüntüsünde "root" olarak gelmekte, bunun sebebi Username: root Password: 5iveL!fe olarak oturum açmamız ve bu oturumla proje oluşturmamız. Admin rolüne sahip yeni bir kullanıcı ile oturum açarsanız "root" yerine o kullanıcı adı yazacaktır.

Bu alanda proje adını yazmalıyız.

Proje nereye aktarılacak ,repo dizin nerede barınacak seçeneği. Bu alanda kendi local reponuzu oluşturmak isterseniz "git Any repo by URL" ile ilerlemelisiniz.

Projenin görünüm ayarları, burada bulunan üç (3) seçeneğin çalışma prensipleri birbirinden farklı. Ben proje oluştururken "Private" özel-kişisel olanı tercih ediyorum. Diğerlerinden farklı olarak projeye erişmek isteyen kullanıcı ve bu kullanıcıların yetkileri konularında tanımlamalar yapmak gerekli. Güvenlik söz konusu.

Son olarak sol alt köşede bulunan "Create project" butonu ile projemizi tanımlamış oluyoruz.

Anlatımda kullanmak için GitLab yönetim ekranından bir kullanıcı oluşturalım. Kullanıcı oluşturmak için ;

Bir numaralı sarı renk ile belirtiğim butona tıklamalıyız.
İki numaralı "Users" butonuna tıklamalıyız.
Açılan ekranın sağ üst köşesinde bulunan "New User" butonu ile kullanıcı tanımını yapıp kaydetmeliyiz.

Bir grup oluşturma işlemi yapacaksak , bu işlem içinde tıpkı yeni kullanıcı oluşturma işleminde yaptığımız ;

Bir numaralı sarı renk ile belirtiğim butona tıklamalıyız.
Users'ın altında bulunan "Gruops" butonu tıklanmalı.
Açılan ekrandaki alanlar gereksinime göre doldurulmalıdır.

"Private" nitelikte olan projeye , bir kullanıcı eklemek için;

Bir numaralı sarı ile belirtiğim buton tıklanmalı.
Sol köşede bulunan "Project" butonuna basılmalı ve açılan ekrandan ilgili proje seçilmeli
Sağ köşede bulunan "ManageAcces" butonu ile oluşturulmuş kullanıcı seçilip projeye eklenmelidir.

Bu alana kadar GitLab kurulumu ve konfigürasyonunu anlatmaya çalıştım. Şimdi oluşturduğumuz repoyu kullanmaya sıra geldi. Bunun için bir client'a ihtiyacımız olacak. Anlatımda istemci "client" için windows bir sistem kullanılacaktır.

Windows sisteme "GIT CLIENT" kurulumu için;

https://git-scm.com/download/win adresinden işletim sistemine uygun olan paket indirilmeli (32-64bit). Varsayılan ayarlarla kurulumu tamamlayın.Portable pakette GitGui bulunmuyor bilginize.
Farklı bir istemci kurmak için https://tortoisegit.org/download/ adresinden tortoisegit client yazılımını da kullanabilirsiniz. Anlatımda git-scm clienttan faydalanılmıştır.

Client yazılımlara ulaşmak için mouse sağ tuş yeterli. Ekran görüntüsünde görüldüğü üzere istenilen cilent yazılımı kullanılabilir. İkisinin bir arada bulunmasında herhangi bir problem yok.

Client yazılımını kurduğumuza göre "GIT" sunucudan projeyi localimize almaya sıra geldi, yani artık git kullanımı söz konusu.

GIT nasıl kullanılır;

İlk olarak yapmamız gereken işlem GITLAB yönetim ekranında tanımladığımız kullanıcıya ait bir ssh-key oluşturmalıyız. Bu işlem öncelikli işimiz olmalı yoksa her defasında parola girmemiz gerekiyor, gereksiz zaman kaybı, işte bu ssh-key bizi bu durumdan kurtaracak çözüm.

Ssh-key nasıl oluşturulur;

İlk olarak Mouse sağ butonda gelen "Git Bash Here" e tıklayıp bash konsolü açıp, ekrana aşağıdaki komutu yazıyoruz.
ssh-keygen.exe -t rsa -C "mocal"

Burada id_rsa.PUB file olan bizim key dosyamız.Bu dosyayı notepad ile açıp içeriğini GITLAB sunucuya kaydetmeliyiz. Bunu yapabilmek için http://hostname/users/sign_in adresine gidip "mocal" kullanıcı ile oturum açmalıyız.

Oturum açtıktan sonra sol tarafta bulunan menü bölümünden "Profile Settings->SSH Keys" ile ilerliyoruz. Daha önce id_rsa.PUB file dosyasını notepad ile açıp içeriğini GITLAB sunucuya kaydetmeliyiz demiştim. Kaydetme işlemi aşağıdaki görüntüdeki gibi yapmalıyız.

Artık projeyi klonlayabiliriz. GIT komutları oldukça basit birkaç kez kullandıktan sonra akılda kalıcı oluyor. İlk olarak projeyi Windows makinaya indirelim. Bu işlemi yapabilmek için, windows ortamında "git bash here" e tıklayıp açılan konsola:

git config --global user.name "mocal"

git config --global user.email mehmetocal79@gmail.com

git clone git@hostname:xxx/proje_adı.git

Projeyi bu komutları kullanarak klonlamış oldu. Bu aşamadan sonra projeye commit yapıp bu yaptığımız geliştirmeyi GITLAB sunucuya push edelim.

ls -l

cd proje_adı

mkdir mocal

touch beni_oku

git add .

git commit -m "açıklama" -a

NOT: GITLAB entegre issue tracking modülü ve WiKİ barındırmakta açıklama alanına "#1" gibi bir not düşersek ilgili hata numarasında commitimiz görünecektir.

git push origin master