AHTAPOT |
GitLab Kurulumu
Bu dökümanda, Ahtapot projesi, Güvenlik Duvarı ve Güvenik Duvarı Yönetim Sistemine ait bir bileşen olarak kullanılmak üzere bir gitlab sunucusu kurulumu ve ilgili gitlab sunucusu merkezi yönetim sisteminin ihtiyaçlarına cevap verecek şekilde yapılandırma anlatılıyor.
Gereken :
1. Pardus Temel ISO’ dan kurulumu tamamlanmış bir sunucu.
İçerik
Bu döküman izlenerek yapılan işlemlerin sonucunda, kurulum ve yapılandırma otomatizasyonu için ansible kurulacak ve bağlı olarak temel sunucu sıkılaştırma işlemleri ile gitlab kurulumu otomatik olarak yapılacaktır. Kurulumların ardından yapılandırma işlemleri olarak gitlab üzerinde gerekli kullanıcılara açılacak ve ilgili depolar proje olarak sisteme eklenecektir.
Yukarıda özeti verilen ve işlem adımları aşağıda maddelendirilmiş olan tüm işlemler için gerekli olan ek dökümantasyonlara erişim bilgileri ilgili başlıklarda NOT olarak ifade edilmişlerdir.
Kurulum İşlemleri
1. Pardus Temel ISO dosyasından Pardus kurulumu tamamlandıktan sonra sisteme
“ahtapotops” kullanıcısı ile giriş yapılır. ahtapotops kullanıcısının parolası “ahtapotops”
olarak öntanımlıdır.
NOT: Pardus Temel ISO dosyasından Pardus kurulumu adımları için “AHTAPOT Pardus Temel ISO Kurulumu” dökümanına bakınız.
2. Sisteme giriş sağlandıktan sonra, aşağıdaki komut ile root kullanıcısına geçiş yapılır. root kullanıcısı, ISO kurulumda belirlenen parola kullanılır.
$ sudo su -
3. Sisteme root kullanıcısı ile bağlantı sağlandıktan sonra aşağıdaki komut ile ansible ve git kurulumları yapılır:
# apt-get install -y ansible
# apt-get install -y git
4. Bu adımda, BilgiO A.Ş tarafından geliştirilen ve kurulum, sıkılaştırma vb. gibi işleri otomatize etmeyi sağlayan ansible playbook’ları Pardus Ahtapot deposunda paketlenmiş olarak bulunmaktadır.
# apt-get install -y ahtapot-mys
# cp -rf /ahtapotmys/* /etc/ansible/
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.32 /36
5. Ahtapot projesi kapsamında oluşacak tüm loglar “/var/log/ahtapot/” dizinine
yazılmaktadır. Bu dizinin sahipliğini “ahtapotops” kullanıcısına vermek için aşağıdaki komut çalıştırılır.
# chown ahtapotops:ahtapotops -R /var/log/ahtapot
6. Tercih ettiğimiz metin düzenleyicisini kullanarak hosts dosyasını düzenliyoruz. Aşağıdaki örnekte vi kullanılır. Açılan dosyada [gitlab] kısmı altına gitlab makinasının tam ismi (FQDN) girilir.
# su - ahtapotops
$ cd /etc/ansible/
$ sudo vi hosts [gitlab]
gitlab.alan.adi
7. “roles/base/vars” klasörü altında değişkenleri barındıran “main.yml” dosyası üzerinde
“ntp server bilgileri girilmektedir.” başlığı altındaki “FirstNtpServerHost” ve
“SecondNtpServerHost” satırları karşısına NTP sunucu bilgileri girilmelidir. “# rsyslog yapilandirmasini belirtmektedir.” başlığı altındaki “Server1” ve “Server2” satırları Rsyslog sunucusunun FQDN bilgisi ile doldurulmalıdır. Sistemde bir Rsyslog sunucu olduğu durumlarda “Server2”, bir NTP sunucu olduğu durumda ise
“SecondNtpServerHost” satırının başına “#” işareti konularak o satırın işlem dışı kalması sağlanmalıdır. Sunucularda ssh portunun varsayılan değer dışında bir değere atanması istendiği durumda, “ssh” fonksiyonu altında bulunan “Port” değişkenine istenen yeni değer yazılmalıdır.
$ cd roles/base/vars/
$ sudo vi main.yml
destination: /etc/rsyslog.conf owner: root
group: root mode: 0644 service:
name: rsyslog state: started enabled: yes ConnectionType: tcp
Server1: rsyslog01.domain_adı #Server2: rsyslog02.domain_adı Port: 514
ActionQueueMaxDiskSpace: 1g ActionQueueSaveOnShutdown: on ActionQueueType: LinkedList ActionResumeRetryCount: -1
WorkDirectory: "/var/spool/rsyslog"
IncludeConfig: "/etc/rsyslog.d/*"
ssh:
# ssh yapilandirmasini belirtmektedir.
conf:
source: sshd_config.j2
destination: /etc/ssh/sshd_config owner: root
group: root mode: 0644 service:
name: ssh state: started enabled: yes TrustedUserCAKeys:
source: ahtapot_ca.pub.j2
destination: /etc/ssh/ahtapot_ca.pub owner: root
group: root mode: 0644 LocalBanner:
source: issue.j2
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.34 /36
destination: /etc/issue owner: root
group: root mode: 0644 RemoteBanner:
source: issue.net.j2
destination: /etc/issue.net owner: root
group: root mode: 0644 Port: 22
8. “roles/gitlab/vars” klasörü altında değişkenleri barındıran “main.yml” dosyası üzerinde
“# Git yapılandırması belirtilmektedir.” başlığı altındaki “external_url” satırında bulunan “yerel_gitlab_URL” bölümüne GitLab sunucusunu browser üzerinden çağırırken kullanılması istenilen URL girilmelidir. GitLab SMTP ayarları için
“gitlab_email_from:” satırına GitLab tarafından atılacak bilgilendirme postalarının hangi adres tarafından atılacağı belirtilmelidir. “gitlab_email_display_name:” satırında gönderilen postalarda görünmesi istenilen isim belirlenir. “gitlab_email_reply_to:”
satırında GitLab tarafından gönderilen postalara cevap verilmesi durumunda cevabın hangi adrese yönlendirilmesi istendiği belirtilir. “smtp_address:” satırında smtp sunucusunun FQDN ve ya IP adres bilgileri girilir. “smtp_port:” satırında smtp
sunucusunun kullandığı port yazılır. “smtp_domain:” satırında ise stmp alan adı bilgisi girilir. Yedekli kullanılacak Gitlab ortamında, git fonksiyonu altındaki “Server” satırına yedek gitlab sunucusunun FQDN bilgileri “Port” satırına ise ssh port bilgisi girilmelidir.
Ansible fonksiyonu altındaki “Server” satırına ansible makinasının FQDN bilgileri “Port”
satırına ise ssh port bilgisi girilmelidir.
$ cd roles/gitlab/vars/
$ sudo vi main.yml
# Git yapılandırması belirtilmektedir.
gitlab_email_reply_to: no-reply@Domain_Adi gitlab_default_theme: 2
gitlab_shell_ssh_port: 22 smtp_enable: "true"
smtp_address: smtp_sunucu_adı smtp_port: 25
smtp_domain: domain_adi smtp_tls: "false"
Server: gitlab.domain.adi Port: 22
ansible:
Server: ansible.domain.adi Port: 22
9. “Ansible Playbookları” dökümanında detaylı anlatımı bulunan, sunucu üzerinde gerekli sıkılaştırma işlemleri ve GitLab kurulumu yapacak olan “gitlab.yml” playbook’u
çalıştırılır.
$ ansible-playbook playbooks/gitlab.yml --connection=local
10.Git kurulumdan sonra parolasız git işemlerini yapabilmek için git kullanıcısına ait anahtar bilgileri AHTAPOT CA KURULUM dökümanına uygun bir şekilde oluşturulmuş anahtalar, sunucu üzerinde ilgili yerlere kopyalama işlemi yapılmalıdır. Bu işlem için gerekli adımlar aşağıdaki gibidir;
a. git kullanıcısı için oluşturulmuş anahtarları, sunucu üzerinde /home/ahtapotops dizinine belirlenen yöntem ile kopyalanır.
b. Kopyalanan anahtarlar aşağıdaki şekilde ilgili dizinlere taşınır.
$ cd /home/ahtapotops/
$ sudo cp /home/ahtapotops/git /var/opt/gitlab/.ssh/id_rsa
$ sudo cp /home/ahtapotops/git-cert.pub /var/opt/gitlab/.ssh/id_rsa-cert.pub
$ sudo cp /home/ahtapotops/git.pub /var/opt/gitlab/.ssh/id_rsa.pub
$ sudo cp /home/ahtapotops/myshook /var/opt/gitlab/.ssh/myshook
$ sudo cp /home/ahtapotops/myshook-cert.pub /var/opt/gitlab/.ssh/myshook- cert.pub
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.36 /36
$ sudo cp /home/ahtapotops/myshook.pub /var/opt/gitlab/.ssh/myshook.pub
$ sudo cp /home/ahtapotops/gdyshook /var/opt/gitlab/.ssh/gdyshook
$ sudo cp /home/ahtapotops/gdyshook-cert.pub /var/opt/gitlab/.ssh/gdyshook- cert.pub
$ sudo cp /home/ahtapotops/gdyshook.pub /var/opt/gitlab/.ssh/gdyshook.pub c. Kopyalanan anahtarların git kullanıcısı yetkilerine sahip olması için aşağıdaki
komutlar çalıştırılır.
# sudo su -
# chown git:git /var/opt/gitlab/.ssh/*
# su - git
$ chmod 700 ~/.ssh
$ cd ~/.ssh/
$ chmod 600 id_rsa gdyshook myshook
$ exit
11.GitLab kurulumu tamamlandıktan sonra sunucu MYS ile yönetileceğinden, sunucu üzerindeki ansible paketi kaldırılır.
# dpkg -r ansible
12.GitLab kurulumu tamamlanmış olacak ve kullanıcı tanımlama, depo oluşturma gibi yapılandırma işlemleri için hazır hale gelmiş olacaktır.
Yapılandırma İşlemleri
1. Yapılandırma işlemlerine geçmek üzere, adresine bir web tarayıcı vasıtası ile girilerek Gitlab web arayüzüne erişilir.
Gitlab, öntanımlı kullanıcı adı “root” ve öntanımlı parola “5iveL!fe” olacak şekilde
2. GitLab web arayüzüne erişim sağlandıktan sonra, ilk adım olarak root kullanıcısının parolasının değiştirilmesi gerekmektedir.
En az 8 karakterden oluşacak yeni şifre belirlenerek, “SET NEW PASSWORD” butonuna basılır. Şifre değiştirme işleminin ardından web arayüz açılış sayfasına otomatik geri döner. Yeni şifre ile giriş yapılır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.38 /36
3. Root kullanıcısı ile giriş yapıldıktan sonra sağ üst köşede bulunan “Admin Area”
simgesine basılarak sisteme tanımlanması gereken kullanıcıları oluşturmak için
“Yönetici Bölümüne” geçiş yapılır.
4. Yönetici bölümünde “Users” bölümünde yer alan “NEW USER” butonuna basılır.
5. Öncelikli olarak FirewallBuilder kontrol paneli ile iletişimi sağlayarak onay mekanizması yapısı kapsamında Onay Kontrol, Son Onaylanmış Commit ID gibi özelliklerini
çalıştıracak API kullanıcısı oluşturulur. Oluşturulacak kullanıcının isminin “gdysapi”
olması zaruridir. Kullanıcıyı oluşturmak için “Name”, “Username” ve “Email” alanları doldurularak “CREATE USER” butonuna basılır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.310 /36
6. Kullanıcı oluşturulduktan sonra, ilgili kullanıcıya ait bilgilendirme sayfası açılmaktadır. Bu sayfada kullanıcıya şifre oluşturmak için “EDIT” butonuna basılır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.312 /36
7. Açılan ekranda “Password” bölümünden “gdysapi” kullanıcı için parola belirlenir ve sayfanın en altında bulunan “SAVE CHANGES” butonuna basılır.
8. 3, 4 ve 5. adımlar tekrar uygulanarak bir adet kullanıcı daha oluşturulur. “gydsapi”
kullanıcısından farklı olarak bu kullanıcı için şifre oluşturulmaz. (6 ve 7. adımlar uygulanmadan geçilecektir.)
Oluşturulacak kullanıcının isminin “ahtapotops” olması zaruridir. Bu kullanıcı
FirewallBuilder ile Ansible entegrasyonunu ve Ansible ile yöneteceği sunucular arasında iletişimi sağlamaktadır. Otomatizasyon yapısının çalışabilmesi için yapıyı oluşturacak sunucular arasında parolasız erişim kullanılmalıdır. Bu neden ile kullanıcı
oluşturulduktan sonra aşağıdaki adımları takip ederek kullanıcıya ait açık anahtar GitLab sistemine eklenmelidir.
9. Oluşturulan “ahtapotops” kullanıcısına SSH-Key belirtme işlemini yapmak için sağ tarafta görünen “IMPERSONATE” butonuna basılarak, uygulamanın bu kullanıcı gibi davranması sağlanır.
10.Impersonate işleminin başarılı gerçekleştiği sağ üstte bulanan “Impersonate” simgesi ile teyit edildikten sonra gelen ekranda sol taraftan “Profile Settings” seçeneğine tıklanır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.314 /36
11.Açılan kullanıcı ayarlarında solda bulunan menüden “SSH Keys” seçeneği seçilir ve gelen sayfada SSH Key işlemi gerçekleştirilebilir haldedir.
12.https :// git . pardus . org . tr adresinde bulunan “gereksinimler” deposu altından “Keys”
dosyası seçilir.
13.Keys deposunda bulunan “ahtapotops.pub” dosyasının içereği kopyalanır. “RAW”
olarak açılarak kopyalanır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.316 /36
14.Ekranda “Key” kısmına kopyalanan anahtar, “Title” kısmına kullanıcı oluştururken belirttiğimiz posta adresi girilir. “ADD KEY” butonuna basılarak sisteme eklenir.
15.FirewallBuilder ve Ansible entegrasyonunu sağlıklı olarak gerçekleştirmek için iki adet proje oluşturulması gerekmektedir. FirewallBuilder tarafı için “gdys” Ansible tarafı için ise
“mys” projeleri oluşturulacaktır. Proje oluşturmak için “Go to dashboard” butonuna basılır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.318 /36
16.Ekranda bulunan “NEW PROJECT” butonuna basarak yeni proje oluşturma işlemi gerçekleştirilir.
17.“NEW PROJECT” butonuna basıldığında gelen ekranda “Project path” satırında “/”
ibaresinden sonra proje ismi olan “gdys” yazılır. İsteğe bağlı olarak “Description”
bölümüne tanımlama yazılarak “Private” olacak şekilde “CREATE PROJECT” butonuna basılır.
NOT: GDYS kapsamında açılan tüm GitLab projelerinin “Private” olması zaruridir.
18.Proje oluşturulduktan sonra, açılan ekran proje anasayfası olup; “gdys” deposuna erişim hakkı olacak kullanıcıları belirtlemek için sol ağaç yapısından “Members” seçeneği seçilir.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.320 /36
19.GitLab üzerinde oluşturulmuş “gdys” projesi için “gdysapi” ve “ahtapotops” kullanıcıları
“People” bölümüne eklenerek yetkilendirilir. Yetki seviyesini belirlemek amacı ile
“Project Access” bölümünden bu kullancılara “Master” yetkisi verilerek “ADD USERS TO PROJECT” butonuna basılır.
20.“Go to dashboard” butonuna basılarak, ana ekrana gidilerek 16. ve 17. adımlar Geçici Kural Tanımla Sistemi için “gkts” deposun için tekrar uygulanır. “gkts” deposuna ait anasayfa geldikten sonra “Go to dashboard” seçeneği seçilerek GitLab sayfasına gidilir.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.322 /36
21.Öncelikli olarak “master” dalını oluşturmak için “adding README” satırına basılırak, bir dosya oluşturulur. Açılan dosya ekranında, ilk satıra yorum olmasını sağlacak şekilde
“#” simgesi konularak açıklama yazılır. Akabinde “Commit message” bölümüne yapılan işlem yazılarak “COMMIT CHANGES” butonuna basılır.
22.Oluşturulan “master” dalı aşağıdaki ekranda olduğu gibi gözükmektedir. “Files”
butonuna basılarak, projeye ait dosyaların bulunduğu “gkts” dizinine gidilir. Açılan sayfada “+” tuşuna basılarak, “New File” seçeneği seçilir.
23.“New File” sayfasında dosya adı olarak “gkts.csv” yazılır. Dosyasının ilk satırına
“adres,durum,hedef adres,zaman” yazılarak, “Commit Changes” butonuna basılır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.324 /36
24.“Go to dashboard” butonuna basılarak, ana ekrana gidilerek 16. ve 17. adımlar “mys”
deposun için tekrar uygulanır. “mys” deposuna ait anasayfa geldikten sonra “Go to dashboard” seçeneği seçilerek GitLab sayfasına gidilir.
25.Onay mekanizmasının yapısı oluşturmak adına GitLab sayfasından, “ahtapotops / gdys” projesine gidilir.Bu yapıyı oluşturmak için projede iki adet dal oluşturulmalıdır.
“master” ve “onay” dalları bu yapıyı sağlamaktadır. Öncelikli olarak “master” dalını oluşturmak için “adding README” satırına basılırak, bir dosya oluşturulur. Böylelikle master dal oluşmuş olur.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.326 /36
26.Açılan dosya ekranında, ilk satıra yorum olmasını sağlacak şekilde “#” simgesi konularak açıklama yazılır. Akabinde “Commit message” bölümüne yapılan işlem yazılarak “COMMIT CHANGES” butonuna basılır.
27.Oluşturulan “master” dalı aşağıdaki ekranda olduğu gibi gözükmektedir. “Files”
butonuna basılarak, projeye ait dosyaların bulunduğu “gdys” dizinine gidilir.
28.https :// git . pardus . org . tr adresinde bulunan “gereksinimler” deposu altında bulunan
“Files” dizininden “gdys.fwb” dosyası açılır. Sağda bulunan “RAW” butonuna basılarak yeni bir tarayıcı sekmesinde kopyalanabilir şekilde açılır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.328 /36
29. “Files” sayfasında “+” işaretine basılarak “New file” seçeneği seçilir.
30.28. adımda kopyalanan “gdys.fwb” dosyasının içeriği buraya yapıştırılır. “master/”
ibaresinden sonraki alana “gdys.fwb” ve “Commit message” alanına yapılan işlem yazılarak “COMMIT CHANGES” butonuna basılır.
31.“Files” butonuna basılarak, projeye ait dosyaların bulunduğu “gdys” dizinine gidilir.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.330 /36
32.“Files” sayfasında “+” işaretine basılarak “New directory” seçeneği seçilir.
33.Açılan ekranda “Directory name” kısmında “files” yazılması zaruridir. “Commit message” bölümüne bilgi yazıldıktan sonra “Target branch”, “master” seçilir ve
“CREATE DIRECTORY” butonuna basılır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.332 /36
34.Dosyayı oluşturduktan sonra sol ağaç menüsünden “Project” seçilerek “gdys” deposu anasayfaya gidilir. Anasayfasında bulunan “+” işaretine basılarak “New branch” ile onay dalı oluşturulur.
35.Açılan yeni ekranda “Branch name” bölümüne “onay” yazılarak “CREATE BRANCH”
seçeneği seçilir.
36.Ansible’a ait playbookları “mys” deposuna aktarmak için Ansible makinasına ssh ile bağlanılarak aşağıdaki adımlar takip edilir.
a. mys projesini yerele indirme işlemi için bulunulan dizin geçici dizin ile değiştirilir.
$ cd /tmp
b. GitLab üzerinde açılan proje aşağıdaki komut ile GitLab makinasının yereline alınır. (“mys_proje_URL” bilgisi GitLab arayüzünde “Projects” altından “mys”
projesi seçildiğinde, mys projesine ait anasayfada “http :// gitlab / root / mys”
şeklinde görüntülenmektedir.) Komutun girilmesi ile birlikte, kullanıcı adı ve parola sormaktadır. Kullanıcı adı olarak GitLab tarafında öntanımlı gelen yetkili kullanıcı “root”, parola olarak 11. adımda belirlenen parola girilmelidir.
$ git clone ssh://git@gitlab_sunucuadı:ssh_port/ahtapotops/mys.git
c. Beşinci adımda GitLab üzerinden yerele indirilen playbooklar bulunduğu dizin içerisinden alınırak geçici dizin altında oluşmuş olan “mys” klasörüne kopyalanır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.334 /36
$ sudo cp -rf /etc/ansible/* /tmp/mys/
d. Dosyaların kopyalandığını teyit etmek amacı ile ilgili dizine gidilir.
$ cd /mys
$ ls -ltr
e. “mys” klasörüne kopyalanmış playbookların kopyalandığı teyit edildikten sonra, GitLab arayüzüne gönderilir.
$ git add --all
$ git config --global user.email “ansible@ test . com”
$ git config --global user.name “Ansible Makinasi”
$ git commit -m “MYS ana dosyalari eklendi.”
$ git push origin master
37.GitLab kurulumunun tamamlanmasının ardından Ansible sunucusunun bu makinaya erişimini kontrol etmek adına, Ansible sunucusuna SSH bağlantısı yapılarak; SSH bağlantı linki üzerinden deponun yerele alınması test edilir. “Gitlab_sunucuadı” bölüme kurulmuş gitlab sunucusunun adresi, “ssh_port” bölümüne ise sunucusunun ayarlanan sunucunun ssh port bilgisi yazılır.
$ cd /tmp
$ git clone ssh://git@gitlab_sunucuadı:ssh_port/ahtapotops/gdys.git
$ rm -rf gdys
38. Erişimin sağlandığından emin olduktan sonra, Ansible makinası üzerine ilk kurulum için koyduğumuz playbookların, MYS reposudan çalışmasını sağlamak için yerel gitlab sunucusu üzerindeki MYS reposu ansible makinasına clonelanarak, “.git” dosyası
“/etc/ansible” dosyasına taşınır. Bu dizin altındaki tüm dosyaların sahiplik hakları
“ahtapotops” kullanıcısına verilir.
NOT: Bu aşamadan sonra playbooklar üzerinde yapılacak tüm değişiklikler GitLab MYS reposunda arayüzden yapılacaktır. “Ansible Playbookları” dökümanında yapılacak değişiklikler bu alana yansıtıldıktan sonra, MYS sistemi playbookları GitLab üzerinden okuyarak ilgili sistemlerde oynatacaktır.
secops @ bilgio . com
Son Güncelleme : 29 Nisan 2016
Ahtapot GitLab Dökümantasyon v1.336 /36
