Forem: Mustafa AKBEL

Ansible Yönetim Eklentisi

Mustafa AKBEL — Thu, 07 Jan 2021 14:44:21 +0000

Eklenti Liman MYS üzerinden ansible platformunu yönetmenizi sağlamaktadır.

Kurulum

Kurulum için Liman MYS üzerinden sunucunuza eklentiyi ekleyip "Paketleri depodan kur." butonunu kullanmanız yeterlidir.

Resim 1 : Paket İndirme Ekranı

Kurulacak olan paketler ;

ansible
sshpass
unzip

Açılış Ekranı

Eklentinin açılış ekranın da ansible hakkında genel bilgiler verilmektedir.

Resim 2 : Anasayfa

Host Ekranı

Bu kısımda grup ekleme işlemini yapabilmektesiniz.

Resim 3 : Grup Ekleme

Grup içerisine client ekleyebilmektesiniz. Client eklerken ssh password veya ssh key ile ekleme yapabilmektesiniz. Client silme ve grup silme işlemleri de mevcuttur.

Resim 4 : Client Ekleme

Resim 5 : Ssh Key Ekleme

Dosyalar

Bu kısım dosya arşivi görevi görmektedir. Zip, tar veya tar.gz formatında dosyalarınızı yükleyebilmektesiniz.

Resim 6 : Dosya Yükleme

Dosyalarınız tree formatında gözükmektedir. İstediğiniz zaman görüntüleyip düzenleyebilmektesiniz.

Resim 7 : Dosya Görünümü

Playbook

Playbook dosyası oluşturup çalıştırma işlemini bu kısımda yapmaktasınız. Dosya oluştur butonu ile dosya adını ve içeriğini girip playbook oluşturabilmektesiniz. Dosyanızı görüntüleyip güncelleyebilirsiniz.

Resim 8 : Playbook Oluştur

Oluşturduğunuz playbook'a sağ tık ile çalıştır diyerek grup seçmektesiniz. Ardından playbook client makinelerde çalışmaya başlamaktadır. Playbook çıktısını log olarak isteğe bağlı şekilde kaydedebilirsiniz.

Resim 9 : Grup Seçimi

Resim 10 : Playbook Çıktısı

Resim 11 : Log Kaydetme

Loglar

Kaydedilen loglar bu kısımda listelenmektedir. Log'a sağ tık yaparak görüntüleme işlemi gerçekleştirilmektedir.

Resim 12 : Log Görüntüleme

Eklenti 6 Ocak 2021 tarihinde açık kaynak olarak sunulmuştur. Aşağıdaki linkten kaynak kodlarına erişebilirsiniz.

https://github.com/limanmys/liman-ansible

Python Betiği İle Eklenti Geliştirme

Mustafa AKBEL — Wed, 02 Sep 2020 12:46:32 +0000

Liman MYS üzerinde python, bash veya powershell betikleri çalıştırabilmekteyiz.

1.İlk olarak Sistem Ayarları > Eklenti > Yeni yolunu izleyerek eklenti oluşturuyoruz. Yaptığımız işlem bize varsayılan olarak views klasör altında index.php ve functions.php olmak üzere iki dosya oluşturmaktaydı.

Visual Studio Code ile Liman sunucusuna bağlanıp eklenti dosyalarına erişebiliyoruz. Bu konu hakkında Mert Çelen'in yazdığı yazıya buradan ulaşabilirsiniz.

2.Scripts klasörü içine liman sunucusunda liman user'ı ile aşağıdaki kod yardımıyla devtopython adında python dosyası oluşturulur.

touch /liman/extensions/devtopython/scripts/devtopython.py

Veya Visual Studio Code arayüzü ile scripts klasörüne sağ tıklayıp new file diyerek oluşturabilirsiniz.

3.index.blade.php dosyasına gerekli kod parçacıkları yazılır. Aşağıdan erişebilirsiniz.

<button class="btn btn-primary mb-2" onclick="runScript()">Python scriptini çalıştır</button>
<div id="devtoPython"></div>

<script>
    function runScript(){
        var form = new FormData();
        request("{{API('runPythonScript')}}", form, function(response) {
            message = JSON.parse(response)["message"];
            $('#devtoPython').html(message);
        }, function(error) {
            $('#devtoPython').html("Hata oluştu");
        });
    }
</script>

Butona tıklandığında anda javascript fonksiyonu çalışıp backend de runPythonScript php fonksiyonuna gidecek.

4.functions.php sayfasının içeriği ise aşağıdaki gibidir.

<?php 

    function index(){
        return view('index');
    }

    function runPythonScript(){
        $output = runScript("devtopython.py","",false);
        return respond($output,200);
    }

?>

runScript helperı Liman üzerinden betik çalıştırmamızı sağlamaktadır. 3 parametre almaktadır. Birinci parametre betik adı, ikinci parametre betiğe gönderilmek istenen parametrelerdir, üçüncüsü ise betiğin sudo veya normal çalışacağını belirtmektedir. Üçüncü parametre false verilir ise normal, true verilir ise betik sudo ile çalıştırılmaktadır.

5.devtopython.py içerisinde istediğiniz python komutlarını kullanabilirsiniz. Örnek amaçlı kullanılan betiğin içeriği aşağıdadır.

#!/usr/bin/python3
print("Merhaba Dünya !!")

Eklentinin görsel çıktıları aşağıdadır.
Butona basılmadan önceki görsel ;

Butona basıldıktan sonraki görsel ;

Eklentinin koduna buradan ulaşabilirsiniz.

Liman MYS'de Eklenti Geliştirilmesi (Tab'lı Yapı)

Mustafa AKBEL — Wed, 02 Sep 2020 10:51:27 +0000

Merhabalar önceki yazımda Liman MYS için basit de olsa nasıl eklenti geliştirebileceğimizi anlatmıştım. Şimdi ise biraz daha karmaşık yapılı bir eklenti geliştirilmesini sizlerle paylaşacağım.

Visual Studio Code ile Liman sunucusuna bağlanıp eklenti dosyalarına erişebiliyoruz. Bu konu hakkında Mert Çelen'in yazdığı yazıya buradan ulaşabilirsiniz.

2.index.php dosyasına gelerek gerekli düzenlemeler yapılır. Tab yapısı ile sekmeler oluşturulur. Her bir sekmeye onclick vererek javascript(JS) ile back-end kısmını bağlarız. Sekmeye tıklandığı anda JS fonksiyonu çalışmaktadır. JS fonksiyonu request atarak back-end ile iletişime geçip dönen cevabı almaktadır. Aşağıdan direkt olarak dosya içeriğine ulaşabilirsiniz.

<ul class="nav nav-tabs" role="tablist" style="margin-bottom: 15px;">
    <li class="nav-item">
        <a class="nav-link active"  onclick="tab1()" href="#tab1" data-toggle="tab">Tab1</a>
    </li>
    <li class="nav-item">
        <a class="nav-link "  onclick="tab2()" href="#tab2" data-toggle="tab">Tab2</a>
    </li>
</ul>

<div class="tab-content">
    <div id="tab1" class="tab-pane active">
    </div>

    <div id="tab2" class="tab-pane">
    </div>
</div>

<script>

   if(location.hash === ""){
        tab1();
    }

    function tab1(){
        var form = new FormData();
        request("{{API('tab1')}}", form, function(response) {
            message = JSON.parse(response)["message"];
            $('#tab1').html(message);
        }, function(error) {
            $('#tab1').html("Hata oluştu");
        });
    }

    function tab2(){
        var form = new FormData();
        request("{{API('tab2')}}", form, function(response) {
            message = JSON.parse(response)["message"];
            $('#tab2').html(message);
        }, function(error) {
            $('#tab2').html("Hata oluştu");
        });
    }
</script>

Aşağıdaki kod bloğu eklentiye ilk girildiğinde bir sekmeye tıklanmamış durumda olduğundan istediğimiz fonksiyonun çalışmasını biz sağlamaktadır.

if(location.hash === ""){
    tab1();
}

3.functions.php dosyasında da gerekli fonksiyonlar oluşturulur. index fonksiyonu index.blade.php dosyasını döndürmektedir. tab1 ve tab2 fonksiyonlarında istediğimiz işlemleri gerçekleştirerek(bu örnekte direkt metin döndürdük) gerekli cevabı döndürdük. Dosya içeriğine aşağıdan ulaşabilirsiniz.

<?php 
    function index(){
        return view('index');
    }

    function tab1(){
        return respond("Merhaba Dünya !!",200);
    }

    function tab2(){
        return respond("Merhaba Uzaylı !!",200);
    }
?>

Aşağıda eklentinin ekran çıktılarını görmektesiniz.

Kodlara buradan erişebilirsiniz.

Liman MYS'de Samba DNS Yönetimi

Mustafa AKBEL — Tue, 18 Aug 2020 14:56:26 +0000

Liman MYS'de bulunan DNS eklentisi bind9, samba dns ve windows DNS'i yönetmeyi sağlayan bir eklentidir. DNS, makine adlarını ip adreslerine çevirerek makineler arasında iletişim kurulmasını sağlamaktadır. Kullanım amacı ise ip adresi gibi karmaşık yapı ile kolay anlaşılabilir ve kullanabilir makine isimleri arasında çift taraflı dönüşüm sağlamaktır.

1. Kurulu sistemler üzerinde DNS eklentisi yükleme

Liman MYS'de Sistem Ayarları > Eklentiler > Yükle yolunu izleyerek eklenti yükleyebiliriz. Ardından Sunucular kısmından DNS yönetimini yapacağımız sunucuyu buluruz. Sunucuda Eklentiler sekmesinden eklentimizi sunucuya ekleriz.

2. Zone Listeleme

DNS eklentisinde Samba DNS, bind9 servisi ve Windows DNS olmak üzere 3 temel DNS yönetimi bulunmaktadır. Eklenti otomatik olarak sunucuda kullanılan DNS yönetimini algılayarak gerekli arayüzü açmaktadır. Şu anki örneklerde Samba DNS kullanılmıştır.

Aşağıda karşımıza ilk gelecek ekran gözükmektedir. Tablo yapısında primary zone listesi bulunmaktadır.

3. Zone Ekleme, Düzenleme ve Silme

Yeni bir zone eklemek için Primary Zone > Zone Ekle butonu ile zone ekleme modalına ulaşırız. Oluşturulmak istenen zone ismi girilerek oluşturma işlemi gerçekleştirilir.

Eklediğimiz zone ismine tıkladığımızda zone hakkında detaylar karşımıza gelmektedir. Bu ekranda zone tipi, Zone DN, Fqdn, Allow Update ve kayıtların türleri hakkında bilgiler bulunmaktadır.

4. Kayıt Listeleme

Kayıtlar sekmesi ise kayıt ekleme, silme ve güncelleme işlemleri yapabildiğimiz kısımdır. Aşağıdaki ekran kayıtlar sekmesine aittir.

5. Kayıt Ekleme, Düzenleme ve Silme

Yeni kayıt eklemek için Kayıtlar > Kayıt Ekle modalından kayıt tipi, hostlabel ve recor datasını girerek kayıt oluşturulur. Kayıt tipinde A, AAAA, NS, MX, CNAME ve TXT seçilebilir.

İstenen kayıta sağ tıklayarak silebilir veya güncelleyebiliriz.

Bir A kayıtı ekledikten sonra zone detaylar sekmesindeki chart da değişmektedir.

Liman için eklenti geliştirme

Mustafa AKBEL — Mon, 17 Aug 2020 05:45:59 +0000

Önceki yazılarımızda Liman'da bulunan eklentilerin genel yapısını anlatmıştık. Buradan ulaşabilirsiniz. Bu yazımızda ise eklenti içerisinde nasıl geliştirmeler yapacağımızı anlatacağım.

Örnek olarak sunucu adını veren bir eklenti yazalım.

İlk olarak yeni bir eklenti oluşturalım. Sistem Ayarları > Eklenti > Yeni diyerek eklenti oluşturma modal'ına ulaşabilirsiniz. Ardından eklenti ismini belirleyerek eklentiyi oluştururuz.

Bu eklentide iki adet dosya kullanılacaktır. Bunlardan biri index.blade.php front-end kodlarını içerecek. Diğer dosya ise back-end kodlarını içerecek olan functions.php dosyasıdır.

Aşağıda index.blade.php dosyasının içeriğini görmektesiniz.

<div id="hostname"></div>

<script>
    showSwal('{{(__("Yükleniyor"))}}','info',2000);
    let form = new FormData();
    request('{{API('hostname')}}',form,function (response) {
        json = JSON.parse(response),
        $('#hostname').html(json.message);
    },function(error){
        $('#hostname').innerHTML = "Hata oluştu";
    });
</script>

İlk olarak oluşturulan div hostname'in yazdırılacağı yerdir. Javascript kodlarında ise bulunan showSwal Limanın hazır fonksiyonlarından biridir. Gerekli parametreleri verip istediğimiz swalı oluşturmamızı sağlamaktadır. Ardından bir form oluşturulmaktadır. Eğer back-end kısmına bir veri yollamak istersek form.append("deger",deger); şeklinde veriyi back-end'e form ile yollayabiliriz. Şimdilik biz boş yollayacağız.

Sonrasında bir request gönderilir. Bu request back-end de bulunan hostname adlı fonksiyona gidip oradaki işlemler sonucu döndürülen cevabı response değişkeni olarak geri almaktadır. Değişken json olarak geldiğinden önce parse edilmektedir. Sonrasında gelen sonuç hostname adlı div'e yazdırılmaktadır.

Aşağıda functions.php dosyasının içeriğini görmektesiniz.

<?php 
    function index(){
        return view('index');
    }

    function hostname(){
        return respond(runCommand("hostname"),200);
    }
?>

index fonksiyonu index.blade.php'yi döndüren bir fonsiyondur. hostname fonksiyonu ise runCommand fonksiyonu ile sunucunun hostname'ni öğrenip döndürmektedir. runCommand fonksiyonu Limanın fonksiyonlarındandır. Bu fonksiyon sayesinde sunucuda linux komutlarını çalıştırabilmekteyiz.

Sonuç olarak aşağıdaki çıktıyı vermektedir.

Özel Depo Kurulumu

Mustafa AKBEL — Wed, 12 Aug 2020 08:30:32 +0000

Önceki yazımızda sizlere yerel Pardus deposunun nasıl kurulacağını anlatmıştık. Buradan yazıya ulaşabilirsiniz. Bugün ise özel bir depo kurulumunu anlatacağım. Özel depo kurulma amacı istediğimiz paketler ile bir depo oluşturup client bilgisayarlara eklenebilir hale getirebilmektir. Bunun için yine Liman MYS'de bulunan Repository eklentisini kullanacağız.

İlk olarak eklentimizi özel depoyu kuracağımız sunucuya ekliyoruz. Ardından eklentiye gelip Yerel Depo sekmesine geçiyoruz. Ekrana aşağıdaki gibi bir görüntü gelmektedir.

Yerel Depo Ekle butonuna tıklayarak modaldaki alanlara depo için gerekli bilgileri giriyoruz.
Depo Adresi : Depoda bulunan paketlerin sunucuda bulunacağı dosya anlamına gelmektedir. Örnek olarak /opt verilebilir.
Codename : Deponun yapısını belirlemek için kullanılır. Örnek olarak debian, trusty veya xenial verilebilir.
Architectures : Depoda bulunacak paketlerin hangi mimariler olacağını belirler.Tek bir mimaride olabilir istenirse birden çok mimaride desteklenebilir. Örnek kullanım olarak "amd64,i386" gibi yazılabilir.
Components : Paketlerin içe aktarılabileceği bileşenlerin adları. Bileşenleri, bir depodaki paketleri bölümlere ayırmanın bir yolu olarak düşünebiliriz. Örnek kullanım olarak "main contrib non-free" verilebilir.
Description : Depo hakkında açıklama kısmıdır.

Modal görüntüsü aşağıdaki gibidir.

Ekle butonuna tıklayıp depoyu oluştururuz. Depo oluşturulurken arkaplanda her özel depo için bir gpg key oluşturulup depoya SignWith olarak eklenmektedir. Gpg key, oluşturulan özel depoyu Client bilgisayarlara eklemek istediğimizde o depoya güvenilmesi için gerekmektedir.

Özel depo oluşturulduktan sonra karşımıza aşağıdaki gibi bir ekran gelmektedir.

Listeyi Gör dedikten sonra karşımıza aşağıdaki ekran gelmektedir. Bu ekranda depomuz hakkında bilgiler gözükmektedir.

Ardından bizim bilgilerimizin bulunduğu satıra tıklayarak depomuzun detay sayfasına ulaşırız. Detay sayfasının görüntüsü aşağıdaki gibidir.

Gözat tıklayıp eklemek istediğimiz paketi seçerek depomuza ekleyebilmekteyiz. Yükleme kısmı aşağıdaki gibi progress bar'dan takip edilmektedir.

Eklendikten sonra tabloda paket hakkında bilgiler gözükmektedir.

Depoyu başka client bilgisayara eklemek istediğimizde Gpg Key Export butonuna tıklayarak gpg keyi ftp sunucusuna koyarak erişilebilir hale getirmekteyiz. Bilgi olarak verilen alert aşağıdaki gibidir.

Sadece key eklemek yeterli değildir. /etc/apt/sources.list dosyasına giderek

deb http://XXX.XXX.XXX.XXX/Devto debian main contrib non-free

özel depomuzu bu şekilde eklemeliyiz. Ardından

sudo apt update; sudo apt upgrade

diyerek depoda bulunan paketleri kullabiliriz.

Yerel Pardus deposu nasıl oluşturulur ?

Mustafa AKBEL — Tue, 11 Aug 2020 18:25:14 +0000

Yerel Pardus deposunun amacı internete erişimin olmadığı yerlerde Pardus paketlerine erişim sağlamak istenmesi ile yerel Pardus deposuna ihtiyaç duyulmaktadır. Liman eklentisi olarak Repository eklentisi ile bu ihtiyacı karşılamak çok kolaydır.

Deponun kurulacağı sunucuya eklentiyi yükledikten sonra eklentiye girilir. Girildiğinde aşağıdaki ekran gelmektedir. Otomatik olarak gerekli paketler yüklenmektedir.

Paketlerin kurulumunda sonra eklentide sağlık durumuna gelip sistemi yapılandır diyoruz.

Bu işlemlerden sonra eklenti kullanılabilir hale gelmektedir. Ardından Ayna Depo Listesi > Depo Listesi > Depo Ekle işlemlerini takip ederek depo ekleme modal'ına ulaşılır. Depo ismi ve deponun kurulacağı dizin belirlenerek depo dosyaları oluşturulur.

Oluşan görsel aşağıdaki gibidir.

Ardından *Listeyi Gör > Kayıt Ekle * diyerek deponun içerisine indirilecek depo adresi eklenir.

Adres aktif veya pasif olarak eklenebilmektedir.
Depo kısmına indirilecek depo adresi yazılır.
Link Adı kısmına ise sunucuda apache üzerinden hangi uzantı ile erişim sağlanacağı belirlenir.

Bu işlemlerin ardından anasayfaya gelerek eklenen depoda indirme ikonlu butona basılarak deponun indirilmesine başlanır. Arayüzden indirilen boyut, indirme durumu ve son çalıştırma zamanı görülebilmektedir. Ayrıca cron tanımlanarak istenilen zamanda indirme işlemi yaptırılabilmektedir.

Liman eklenti yapısı

Mustafa AKBEL — Tue, 21 Jul 2020 16:12:25 +0000

Bu yazıda Liman'da kullanılan eklentilerin genel yapısı hakkında bilgiler verilecektir.

İlk olarak Liman'a eklenti geliştirmek için Liman'ın dosya yapısında bulunan /liman/server/.env dosyasındaki EXTENSION_DEVELOPER_MODE kısmı true yapılmalıdır.

EXTENSION_DEVELOPER_MODE = true

Bu işlemden sonra Sistem Ayarları > Eklentiler sekmesinden yeni butonunu kullanarak eklenti ismini belirledikten sonra oluştur diyebiliriz. Liman eklenti dosyalarını otomatik olarak /liman/extensions/eklenti_adı dizinine oluşturmaktadır.

Klasör yapısında bulunan scripts klasöründe eklentide çalıştırabileceğimiz Python betikleri veya Windows betikleri tutulur. Views klasöründe ise varsayılan olarak index.blade.php ve functions.php dosyaları bulunmaktadır. Bu dosyalardan index.blade.php dosyası aslında eklentinin front-end kısmıdır. Eklentinin ana sayfasını oluşturmaktadır. Eklentinin back-end kısmı için ise functions.php dosyası kullanılır. Eklentinin bilgileri ve ayarları db.json dosyasında tutulmaktadır. Örnek db.json içeriği aşağıda verilmiştir.

{
    "name": "Devto",
    "publisher": "Administrator",
    "version": "0.0.1",
    "database": [],
    "widgets": [],
    "views": [
        {
            "name": "index",
            "scripts": ""
        }
    ],
    "language": "php",
    "status": 0,
    "service": "",
    "supportedLiman": "1.1.7a",
    "support": "administrator@liman.app",
    "icon": ""
}

Genel anlamda yeni bir eklentinin klasör yapısı bu şekildedir.

Liman üzerinde sunucular sayfasına yeni sekme eklenmesi

Mustafa AKBEL — Tue, 21 Jul 2020 16:12:01 +0000

Bu yazıda Liman MYS'de bulunan bir Linux sunucu üzerindeki kullanıcının, sudo yetkisinin kontrolü nasıl yapılır onu anlatacağım.

İlk olarak sunucular sayfasına yeni bir tab sekmesi eklenir. Ancak eklerken dikkat edilmesi gereken nokta sunucu tipinin Linux olduğu kontrol edilmelidir. Liman'da bu kontrol aşağıdaki gibi yapılmaktadır.

@if(server()->type == "linux_ssh" || server()->type == "linux_certificate")

Ardından if içeriğine tab sekmesi oluşturulur. Onclick özelliğine javascript fonksiyon ismi yazılır.

Bu javascript fonksiyonunda bir request gönderilir. Request'in gönderimi aşağıda verilmiştir.

let data = new FormData();
request('{{route('server_user_permission')}}', data, function (response) { }

Bu request isteği aşağıdaki gibi sunuculara ait route işlemi ile kullanacağımız controller sayfası ve fonksiyonu belirterek gerekli fonksiyona yönlendirme yapılır. Aşağıda route işlemi gösterilmiştir.

Route::post('/sunucu/userpermission', 'Server\OneController@getUserPermission')->name(
    'server_user_permission'
);

Gerekli controller sayfasına giderek kullanacağımız fonksiyonu oluştururuz. Fonksiyon aşağıda verilmiştir.

public function getUserPermission(){

    $output = server()->run(
        sudo() . "-v"
    ); 
    if(empty($output)){
        $output =  true;
    }else{
        $output = false;
    }

    return [
        "result" => 200,
        "data" => $output,
    ];
}

Aldığımız sonucu javascript'te işleyerek kullanıcının sudo yetkisinin olup olmadığını arayüze aktarırız.

let output = JSON.parse(response);
if(output.data){
    result = "Server kullanıcısının sudo yetkisi vardır"
    classname = "alert alert-success"
}else{
    result = "Server kullanıcısının sudo yetkisi yoktur"
    classname = "alert alert-danger"
}
$('#serverUserPermissionDiv').html(result);
$('#serverUserPermissionDiv').addClass(classname);

Sonuç olarak aşağıdaki çıktı elde edilir.