AHTAPOT GitLab Kurulumu

Transkript

1 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 Kurulum İşlemleri Yapılandırma İşlemleri AHTAPOT GitLab Kurulumu

2 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/ Ahtapot GitLab Dökümantasyon v1.32

3 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 # ntp server bilgileri girilmektedir. FirstNtpServerHost: "0.debian.pool.ntp.org" SecondNtpServerHost: "1.debian.pool.ntp.org" # rsyslog yapilandirmasini belirtmektedir. conf: source: rsyslog.conf.j2 Ahtapot GitLab Dökümantasyon v1.33

4 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 Ahtapot GitLab Dökümantasyon v1.34

5 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: 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_ _from: satırına GitLab tarafından atılacak bilgilendirme postalarının hangi adres tarafından atılacağı belirtilmelidir. gitlab_ _display_name: satırında gönderilen postalarda görünmesi istenilen isim belirlenir. gitlab_ _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. external_url: firstrunpath: /var/opt/gitlab/bootstrapped gitlab_rails: gitlab_ _enabled: "true" gitlab_ _from: gitlab@domain_adi gitlab_ _display_name: GdysGitlab Ahtapot GitLab Dökümantasyon v1.35

6 gitlab_ _reply_to: 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: 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/myshookcert.pub Ahtapot GitLab Dökümantasyon v1.36

7 $ sudo cp $ sudo cp $ sudo cp cert.pub $ sudo cp /home/ahtapotops/myshook.pub /var/opt/gitlab/.ssh/myshook.pub /home/ahtapotops/gdyshook /var/opt/gitlab/.ssh/gdyshook /home/ahtapotops/gdyshook-cert.pub /var/opt/gitlab/.ssh/gdyshook/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 gelmektedir. Bu bilgiler kullanılarak sisteme giriş sağlanır. Ahtapot GitLab Dökümantasyon v1.37

8 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. Ahtapot GitLab Dökümantasyon v1.38

9 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. Ahtapot GitLab Dökümantasyon v1.39

10 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 alanları doldurularak CREATE USER butonuna basılır. Ahtapot GitLab Dökümantasyon v1.310

11 Ahtapot GitLab Dökümantasyon v1.311

12 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. Ahtapot GitLab Dökümantasyon v1.312

13 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. Ahtapot GitLab Dökümantasyon v1.313

14 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. Ahtapot GitLab Dökümantasyon v1.314

15 Ahtapot GitLab Dökümantasyon v1.315

16 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 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. Ahtapot GitLab Dökümantasyon v1.316

17 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. Ahtapot GitLab Dökümantasyon v1.317

18 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. Ahtapot GitLab Dökümantasyon v1.318

19 16. Ekranda bulunan NEW PROJECT butonuna basarak yeni proje oluşturma işlemi gerçekleştirilir. Ahtapot GitLab Dökümantasyon v1.319

20 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. Ahtapot GitLab Dökümantasyon v1.320

21 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. Ahtapot GitLab Dökümantasyon v1.321

22 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. Ahtapot GitLab Dökümantasyon v1.322

23 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. Ahtapot GitLab Dökümantasyon v1.323

24 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. Ahtapot GitLab Dökümantasyon v1.324

25 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. Ahtapot GitLab Dökümantasyon v1.325

26 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. Ahtapot GitLab Dökümantasyon v1.326

27 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. Ahtapot GitLab Dökümantasyon v1.327

28 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 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. Ahtapot GitLab Dökümantasyon v1.328

29 29. Files sayfasında + işaretine basılarak New file seçeneği seçilir 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. Ahtapot GitLab Dökümantasyon v1.329

30 31. Files butonuna basılarak, projeye ait dosyaların bulunduğu gdys dizinine gidilir. Ahtapot GitLab Dökümantasyon v1.330

31 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. Ahtapot GitLab Dökümantasyon v1.331

32 Ahtapot GitLab Dökümantasyon v1.332

33 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. Ahtapot GitLab Dökümantasyon v1.333

34 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 ş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. Ahtapot GitLab Dökümantasyon v1.334

35 $ 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 git git git git add --all config --global user. ansible@test.com config --global user.name Ansible Makinasi commit -m MYS ana dosyalari eklendi. 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. $ cd /tmp/mys $ sudo cp -rf.git /etc/ansible/ && sudo chown ahtapotops:ahtapotops /etc/ansible/.git $ rm -rf../mys $ sudo chown ahtapotops:ahtapotops /etc/ansible/* Ahtapot GitLab Dökümantasyon v1.335

36 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. Ahtapot GitLab Dökümantasyon v1.336