Atlassian Wiki ile Kurumsal BT Dokümantasyon Sistemi

Bu projeyi Sistem Kuşu kurulmadan önce, kurumun BT ekibinde çalıştığım dönemde ben yürüttüm.

Bir sunucunun neden o şekilde yapılandırıldığı, sadece bir kişinin hafızasında yaşıyordu. Yıllar içinde birikmiş bu dağınık bilgiyi, Atlassian Wiki üzerinde kurduğumuz merkezi bir dokümantasyon sistemine taşıdık.

Sorun

Sistemler yıllardır ayaktaydı, ama geçmişten kalan bilginin büyük kısmı kimsenin kafasında ya da dağınık notlarda duran bir “gölge bilgi” halindeydi: hangi sunucunun gerçekte ne işe yaradığı, bir cihazın neden o şekilde yapılandırıldığı, bir ayarın kim tarafından ve hangi gerekçeyle yapıldığı yazılı hiçbir yerde yoktu.

Bu, kurumun tamamını tek bir kişinin hafızasına bağlıyordu; belirli bir kişi olmadan hiçbir şeyin çalışmaması, aslında iyi kurulmuş bir BT altyapısının değil, kırılgan bir altyapının işaretidir.

Neden bu yol?

Bilgiyi toplamanın en kolay yolu, herkesin kendi notlarını ortak bir klasöre atmasıydı. Bu yol denenmiş sayılır: dağınık notlar zaten vardı, eksik olan bir disk alanı değil ortak bir yapıydı. Klasör, aynı dağınıklığı bir seviye derine taşımaktan başka bir şey yapmazdı.

Bu yüzden önce kategori kararı verdik, araç seçimini sonraya bıraktık: Sistem, Network ve Kurum Kültürü. Üçe bölmenin sebebi düzen kaygısı değildi; bir bilgi parçasının nereye yazılacağı belli değilse yazılmıyor ve yazılsa da bulunamıyordu.

İlk yazılan belgelerin isimlendirme standartları olması da bilinçliydi. Bir standart, kendisinden sonra yazılan her belgenin biçimini belirler; en başa konduğunda dokümantasyon büyüdükçe dağılmak yerine oturur.

Nasıl kurduk?

Atlassian Wiki’yi kurup (kurulumu oldukça hızlı tamamlanır) dokümantasyonu üç ana kategoriye ayırdık. İlk yazdığımız belgeler GPO, bilgisayar, lokasyon ve firewall policy isimlendirme standartlarıydı.

Buradan başlayarak her sunucunun rolünü ve önemini, kullanılan üçüncü parti yazılımları ve neden tercih edildiklerini, projelerin ilerleme durumunu, gelecekte ihtiyaç duyulacak kaynakları, yedekleme standartlarını ve kurumda tekrar eden kronik problemlerle çözümlerini tek tek kayıt altına aldık. Örneğin bir servisin yeniden başlatma sonrası elle müdahale istemesi ve bunun ilk bakışta genel bir arıza gibi görünmesi, tam da bu yüzden yazıya geçirilen türden bir bilgiydi.

Erişim bilgilerinin kendisi bu sisteme yazılmadı: dokümantasyon neyin nerede olduğunu değil, hangi prosedürle isteneceğini anlatır.

Devreye alındıktan sonra

Bir sunucunun neden o şekilde yapılandırıldığı sorusunun cevabı artık bir kişinin hatırlamasına bağlı değil. Ekibe yeni katılan biri, geçmişteki kararların gerekçesini kimseye sormadan okuyabiliyor.

Bu projede yazdığımız GPO ve firewall isimlendirme standartlarının kaynağı olan Active Directory modernizasyon ve firewall güvenlik sıkılaştırma vaka çalışmalarını, yedekleme standartlarının kaynağını ise Veeam yedekleme sistemi kurulumu vaka çalışmasında bulabilirsiniz. Kamera-lokasyon eşleştirmesinin işlendiği projeyi de kamera sistemi NTP ve KVKK uyum vaka çalışmasında anlatıyoruz.