Liman Geliştirme Ortamı Hazırlığı
Published: 2024-03-22 12:46:51

# Liman Geliştirme Kullanıcısını Yapılandırmak

## Kullanıcıya Parola Eklemek

Liman geliştirme ortamınızda, izin problemleriyle karşılaşmamak için Liman'ın işletim sistemi üzerinde önceden oluşturulmuş bir kullanıcı hesabını kullanmanız önemlidir. Bu hesap, genellikle **"liman"** olarak adlandırılır ve sistem üzerindeki işlemleri sorunsuz bir şekilde gerçekleştirmenizi sağlar. 

* Bir terminal açın ve aşağıdaki komutu girerek "liman" kullanıcısına bir şifre atayın:

```bash
sudo passwd liman
```
* Sistem sizden yeni şifreyi girip tekrar onaylamanızı isteyecektir. İstenilen adımları takip ederek şifre atama işlemini tamamlayın.

### Varsayılan Kabuğu Bash Olarak Ayarlama

Bu işlemin ardından liman kullanıcısını kullanabilmemiz için varsayılan shell ayarını bash olarak seçmeliyiz.

1. Bir terminal penceresi açın.
2. Aşağıda belirtilen komutu girerek "liman" kullanıcısının varsayılan kabuğunu Bash olarak ayarlayın:

```bash
sudo usermod --shell /bin/bash liman
```
Bu komut, sistem üzerindeki "liman" kullanıcısına ait varsayılan kabuğu, Bash olarak değiştirecektir. İşlem tamamlandığında, "liman" kullanıcısı ile oturum açtığınızda otomatik olarak Bash kabuğunu kullanmaya başlayacaksınız.

## Eklenti İndirme ve Liman MYS'ye Ekleme İşlemleri
Liman MYS'ye yeni bir eklenti eklemek istiyorsanız, aşağıdaki adımları takip ederek bu işlemi kolayca gerçekleştirebilirsiniz. Örnek olarak, Liman'ın envanter keşif eklentisini kullanacağız.

###Adım 1: Eklentinin Repo'dan İndirilmesi
İlk olarak, eklentinin GitHub reposuna gidin. Örnek eklentimiz Liman Inventory, GitHub üzerinde bulunmaktadır. Eklentiyi aşağıdaki linkten .zip uzantılı dosya olarak indirebilirsiniz:

_[Liman Inventory GitHub Sayfası](https://github.com/limanmys/liman-inventory)_

###Adım 2: Eklentinin Liman MYS'ye Eklenmesi

- Liman MYS arayüzünü açın ve sağ üst köşede bulunan ayarlar ikonuna tıklayın.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/hlvbp76rtbez8bksvaqs.png)

- Açılan menüden "Sistem Ayarları" seçeneğine ve ardından "Eklentiler" sekmesine gidin.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/k7458g97zos9hhrmw20f.png)

- "Eklentiler" sekmesinde, "Yükle" butonuna tıklayarak indirdiğiniz .zip uzantılı eklenti dosyasını seçin ve yüklemeyi başlatın.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/izd2a34c4c0mk8sr3pja.png)

- Eklenti başarıyla yüklendikten sonra, eklentinizin Liman MYS'de listelendiğini görebilirsiniz.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/1ea8ru3k612i624mvabv.png)

Bu adımları takip ederek, Liman MYS'ye yeni bir eklenti başarıyla eklemiş olursunuz. Artık bu eklenti üzerinde geliştirme yapmak için Liman ortamınıza bağlanabilir ve çalışmalarınıza devam edebilirsiniz.


# VS Code İle Liman Ortamına SSH Bağlantısı Kurma

Bu kılavuz, Visual Studio Code (VS Code) kullanarak Liman geliştirme ortamınıza SSH üzerinden nasıl bağlanabileceğinizi adım adım anlatır. İşlemleri başlatmadan önce, bilgisayarınıza VS Code'un yanı sıra SSH-Remote eklentisinin kurulu olduğunu varsayıyoruz.

### Adım 1: SSH Bağlantı Menüsünü Açma

1. VS Code'u açın.
2. Ekranın sol alt köşesinde yer alan SSH bağlantı simgesine tıklayarak SSH bağlantı menüsünü açın.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/h9lzprycfamatgw8r49k.png)

### Adım 2: Host'a Bağlanma

SSH bağlantı menüsünden "Connect to Host..." seçeneğini tıklayarak bağlantı kurma işlemine başlayın.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/bbs9vem2dn02f9pjhwod.png)

### Adım 3: Yeni SSH Host Ekleme

"Connect to Host" seçeneğini seçtikten sonra, karşınıza çıkan ekranda "+ Add New SSH Host..." seçeneğine tıklayarak yeni bir SSH host ekleyin. Bu adım, VS Code'un Liman ortamınıza bağlanması için gerekli olan SSH bağlantı detaylarını eklemenizi sağlar.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/vj5m34d2kq0qll077mma.png)

###SSH Bağlantı Detaylarını Girme

Yeni bir SSH Host ekledikten sonra, bağlantı detaylarını doğru bir şekilde girmeniz gerekmektedir. Bu, VS Code'un Liman geliştirme ortamınıza sorunsuz bir şekilde bağlanabilmesi için kritik bir adımdır.

- SSH bağlantı bilgilerinizi girerken aşağıdaki formatı kullanın:
```bash
ssh liman@<SUNUCU_IP_ADRESINIZ>
```
Bu format, ssh komutunu, Liman ortamınızın kullanıcı adını (liman) ve sunucunuzun IP adresini içermelidir.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/to8xpwpdmli64k51v6qc.png)

###Ayar Dosyası Seçme ve Bağlantıyı Tamamlama

1. Bağlantı bilgilerinizi girdikten sonra, karşınıza çıkan listeden herhangi bir SSH ayar dosyası seçebilirsiniz.
2. "Connect to Host..." seçeneğini tekrar seçtiğinizde, daha önce eklediğiniz sunucu IP adresi listelenir. Bu adres üzerine tıklayarak bağlantıyı başlatın.
3. Sunucu şifrenizi girdikten sonra, bağlantı başarılı bir şekilde kurulmuş olacak ve Liman ortamınıza erişim sağlayabileceksiniz.

###Liman Ortamında Klasör Açma

1. Bağlantı kurduktan sonra, VS Code içinde "Open Folder" düğmesine tıklayarak bir klasör açma işlemi başlatın.
2. Açılan diyalog kutusuna **/liman/extensions/** yazarak, Liman MYS'de eklenti geliştirme ve düzenleme işlemlerini gerçekleştirebileceğiniz klasörü açın. Ardından "OK" düğmesine tıklayarak işlemi tamamlayın.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/82cmynrjfj995uarj5id.png)


#Eklenti Geliştirme
Liman MYS için eklenti geliştirmeye yönelik bu rehber, projelerinizin bağımlılıklarını yönetme ve derleme işlemleri için izlenecek adımları içerir. Bu rehber, özellikle Liman Inventory gibi bir projenin frontend kısmı için gerekli olan geliştirme ortamının nasıl hazırlanacağını adım adım açıklar.

###Adım 1: Eklenti Dizinine Geçiş
Geliştirme sürecinize başlarken, ilk olarak eklentinizin bulunduğu dizine erişmeniz gerekiyor. Bu, VS Code üzerinden SSH bağlantısı ile kolaylıkla yapılabilir:

1. VS Code'da, daha önce kurduğunuz SSH bağlantısını kullanarak Liman sunucusuna bağlanın.
2. Terminali açın ve eklentinizin bulunduğu dizine gitmek için aşağıdaki komutu kullanın, burada <eklenti_ismi> eklentinizin klasör adıyla değiştirilmelidir:

```bash
cd /liman/extensions/<eklenti_ismi>
```
Bu komut, sizi doğrudan eklentinizin bulunduğu dizine götürecektir.

###Adım 2: Frontend Dizinine Geçiş

1. Geliştirme sürecinize başlamak için ilk olarak bir terminal veya komut istemcisi açın.
2. Eklentinizin frontend kodlarının bulunduğu dizine geçmek için aşağıdaki komutu girin:

```bash
cd frontend/
```
Bu komut, sizi projenin frontend kısmında çalışmak üzere doğru dizine yönlendirir.

###Adım 3: Bağımlılıkları Yükleme
Projede kullanılan paket ve kütüphaneleri yüklemek için aşağıdaki komutu çalıştırın:

```bash
npm install
```
Bu komut, package.json dosyasında belirtilen tüm bağımlılıkları yükleyerek node_modules adında bir klasör oluşturur.

###Adım 4: SSL Sertifika Hatalarıyla Karşılaşıldığında
Eğer npm komutları çalıştırılırken SSL sertifika hataları alınıyorsa, npm'nin SSL sıkı denetimini devre dışı bırakarak bu sorunu çözebilirsiniz:

```bash
npm set strict-ssl false
```
Bu adım, ağ bağlantısı sırasında karşılaşılabilecek SSL sertifika hatalarını önlemek için gereklidir.

###Adım 5: Proje Derleme
Bağımlılıklar yüklendikten sonra, projenizi derlemek için aşağıdaki komutu kullanın:

```bash
npm run build-only
```
Bu komut, eklentinizin üretim için gerekli olan statik dosyalarını oluşturur. Derleme işlemi tamamlandığında, derlenmiş dosyalar **/public/vite/assets** dizini altında bulunacak şekilde bir üst dizine yerleştirilir.

Bu adımları tamamladıktan sonra, Liman Inventory veya benzeri bir proje için geliştirdiğiniz frontend eklentisinin geliştirme ortamını başarıyla hazırlamış olursunuz. Artık eklentinizi Liman MYS içerisinde kullanıma sunabilir ve geliştirme işlemlerinize devam edebilirsiniz.