Forem: AtillaAk

Debian paketi ile Liman üzerinde çalışacak envanter sunucusu kurulumu

AtillaAk — Mon, 18 Mar 2024 06:13:59 +0000

İlk olarak Inventory Server Releases adresinden envanter sunucumuzun, Report Engine Releases adresinden report engine'in son versiyonunu indiriyoruz. Yazım itibari ile en son sürüm envanter-29 ve report-engine-54 olduğundan bu dokümanda bu 2 paket kullanılacaktır.

wget https://github.com/limanmys/inventory-server/releases/download/release.29/inventory-server-29-x64.deb 
wget https://github.com/limanmys/fastapi-report-engine/releases/download/release.54/report-engine-54-x64.deb

Paketlerimizi indirdikten sonra ilk olarak postgres veritabanı sistemimizde bir kullanıcı ve veritabanı oluşturmamız gerekli. Kullanıcı oluşturmak ile başlayalım.

sudo -u postgres createuser adinventory -P

komutu girildiğinde oluşturulacak kullanıcı için bir şifre istenecek. Güvenli ve kaybetmeyeceğimiz bir şifre oluşturup girelim. Bu dokümanda örnek olarak "limanenvanter" şifresi kullanılacak.

Enter password for new role: limanenvanter
Enter it again: limanenvanter

Kullanıcımızı oluşturduktan sonra bu kullanıcın üzerine bir de veritabanı oluşturalım.

sudo -u postgres createdb dbinventory -O adinventory

Daha sonra indirdiğimiz report engine ve envanter sunucusu paketlerini kuralım.

sudo apt update
sudo apt install ./report-engine-54-x64.deb ./inventory-server-29-x64.deb

Envanter sunucumuz kurulduğunda "/opt/inventory-server/" dizinine bir .env dosyası oluşturacak. Bu .env dosyasısının ilk satırında da bir APP_KEY değişkeni olacak. Bu değişkene dokunmadan daha önce girdiğimiz kullanıcı bilgileri ile aşağıdaki komudu girip şekildeki gibi doldurabiliriz:

sudo nano /opt/inventory-server/.env

APP_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
DB_DRIVER=postgres
DB_HOST=127.0.0.1 
DB_PORT=5432
DB_USER=adinventory
DB_PASS=limanenvanter
DB_NAME=dbinventory
REPORT_ENGINE_URL=localhost:8001

Envanter sunucumuzu artık çalıştırabiliriz.

sudo systemctl restart inventory-server@admin

Sunucunun çalışıp çalışmadığını aşağıdaki komut ile görebiliriz:

journalctl -u inventory-server@admin

Eğer sunucu doğru bir biçimde çalışıyorsa çıktı aşağıdakine benzer olacaktır:

Şimdi envanter eklentimizin limana kurulumu kısmına geçelim.

Öncelikle envanter eklentisinin son sürümünü https://github.com/limanmys/liman-inventory/releases adresinden indiriyoruz. Ayarlar -> Eklentiler -> Yükle aracılığı ile eklentimizi Limana ekliyoruz. Ardından sunucumuzu Limana ekleyerek devam ediyoruz.

Şekilde 1 ile gösterilen boşluğa envanterin kurulu olduğu sunucunun IP adresini giriyoruz (Eğer envanter, Liman ile aynı sunucuya kurulu ise localhost olan 127.0.0.1 adresi girilmelidir). Sunucu bağlantımız olarak ssh ve ssh'ın varsayılan 22 portunu seçip ilerliyoruz.

1 ile gösterilen yerde Sunucuya uygun bir ad veriyoruz ve 2'de GNU Linux seçerek devam ediyoruz.

Bu aşamada sunucumuza ssh ile bağlanmak için gerekli kullanıcı adı ve şifreyi giriyoruz. İlerleyerek sunucumuzu limana eklemiş oluyoruz.

Daha sonra 1 ile işaretlenmiş yerden sunucunun eklentileri kısmına gelip 2 ile işaretlenmiş yere basıyoruz.

Açılan pencereden "Envanter Keşif" eklentisini seçip ekliyoruz. Eğer eklenti başarılı bir şekilde eklendiyse aşağıdaki gibi bir menü, sunucu sayfasında görülecektir.

Docker Imajı ile Liman üzerine Envanter Sunucusu kurma

AtillaAk — Mon, 18 Mar 2024 06:13:49 +0000

Kurulumu yapmamız için sistemde dockerın kurulu olması gerekiyor.

Dockerı indirmek için bu linke tıklayabilirsiniz

Dockerı yükledikten sonra dockerhub'da hazır halde bulunan liman, envanter gibi imajları çekip kurulumumuzu yapacağız.

Kullanacağımız docker compose dosyası şu şekilde:

docker-compose.yaml:

version: '3.8'
services:
  limancore:
    image: aciklab/liman:latest
    depends_on:
      db:
        condition: service_healthy
    restart: always
    environment:
      # Redis settings
      - REDIS_HOST=liman-redis
      - REDIS_PASS=${DB_PASS}
      - REDIS_PORT=6379
      # DB settings
      # For using Patroni or another Postgresql Cluster
      - DB_HOST=liman-db
      - DB_DATABASE=liman
      - DB_USERNAME=liman
      - DB_PORT=5432
      - DB_PASS=${DB_PASS}
      # Nginx settings
      - NGINX_PORT=443
    container_name: liman-core
    tty: true
    ports:
      - '443:443'
      - '3000:3000'
    volumes: 
      - core:/liman
      - certs:/usr/local/share/ca-certificates
    networks:
      - liman-net
      - internal-net
    dns:
      - 127.0.0.1
      - ${DNS}
      # Add active directory DNS(s) for using Domain extension and LDAP on Liman
  db:
    image: postgres:15
    container_name: liman-db
    restart: always
    environment:
      - POSTGRES_USER=liman
      - POSTGRES_PASSWORD=${DB_PASS}
      - POSTGRES_DB=liman
    volumes: 
      - db:/var/lib/postgresql/data
    healthcheck :
      test: [ "CMD", "pg_isready", "-q", "-d", "liman", "-U", "liman" ]
      interval : 5s
      timeout : 5s
      retries : 5
    networks:
      - liman-net
  redis:
    image: redis
    container_name: liman-redis
    environment:
      - REDIS_PASSWORD=${DB_PASS}
      - REDIS_DISABLE_COMMANDS=CONFIG
    command: > 
      --requirepass ${DB_PASS} --protected-mode yes
    networks:
      - liman-net
  webssh:
    image: limanmys/webssh:latest
    restart: always
    container_name: liman-webssh
    networks:
      - liman-net
  inventory_server:
    image: aciklab/inventory-server:latest
    depends_on:
      inventory_db:
        condition: service_healthy
    restart: always
    env_file:
      - .env
    environment:
      # DB settings
      # For using Patroni or another Postgresql Cluster
      - DB_HOST=inventory-db
      - DB_NAME=inventory
      - DB_USERNAME=inventory
      - DB_PORT=5432
      - DB_PASS=${DB_PASS}
      - DB_DRIVER=postgres
      - REPORT_ENGINE_URL=http://report-engine:8001
    container_name: inventory-server
    tty: true
    volumes: 
      - core:/liman
      - certs:/usr/local/share/ca-certificates
    networks:
      - internal-net
      - liman-net
    dns:
      - 127.0.0.1
      - ${DNS}
      # Add active directory DNS(s) for using Domain extension and LDAP on Liman
  report_engine: 
    image: aciklab/report-engine:latest
    restart: always
    container_name: report-engine
    tty: true
    networks:
      - internal-net
      - liman-net
  inventory_db:
    image: postgres:15
    container_name: inventory-db
    restart: always
    environment:
      - POSTGRES_USER=inventory
      - POSTGRES_PASSWORD=${DB_PASS}
      - POSTGRES_DB=inventory
    volumes: 
      - inventory_db:/var/lib/postgresql/data
    healthcheck :
      test: [ "CMD", "pg_isready", "-q", "-d", "inventory", "-U", "inventory" ]
      interval : 5s
      timeout : 5s
      retries : 5
    networks:
      - liman-net
volumes:
  # Persistent Postgresql Database
  db:
    driver: local
  inventory_db: 
    driver: local
  # Persist Core Files
  core:
    driver: local
  # Persist Linux System Certificates
  certs:
    driver: local
networks:
  internal-net:
    name: internal-net
    driver: overlay
    internal: true
    attachable: true
  liman-net:
    name: liman-net
    driver: bridge

docker compose dosyamızın yanında bir de aynı dizinde ortam değişkenlerinin tutulacağı .env dosyası gerekiyor. Örnek bir .env dosyası aşağıda verilmiştir.

.env:

APP_KEY="93610254060735082929523103547063"
DB_DRIVER="postgres"
DB_HOST="inventory-db"
DB_PORT="5432"
DB_USER="inventory"
DB_PASS="ChangeMe"
DB_NAME="inventory"
DNS=""
REPORT_ENGINE_URL="http://report-engine:8001"

Buraya kadarki kısımları düzgün yaptıysak sistemi ayağa kaldırabiliriz. Dosyaların bulunduğu dizinden:

docker compose up -d

komutunu kullanıyoruz. İmajların dockerhubdan çekilmesi ve sistemin ilk kurulumu biraz zaman alacaktır. Bütün containerlar ayağa kalktıysa "localhost" adresinden limana erişebiliyor olmamız gerekli. Limana giriş yapmak için ise bir şifreye ihtiyacımız var. Onu da

docker exec -it liman-core limanctl administrator

komutu ile elde edebiliriz. Limana erişimi sağladıktan sonra envanter eklentimizi kuralım. Eklentiyi kurduktan sonra ise sunucumuzu ekleyelim.

Öncelikle yeni bir sunucu ekleme sayfasına gidiyoruz

Daha sonra kırmızı ile gösterilen yerlere sunucumuzun adresini (yani docker ağında çalıştığı için containerın ismini) ve 7825 portunu giriyor ve ilerliyoruz.

Bu adımda Sunucumuza koymak istediğimiz ismi giriyor işletim sistemini GNU/LINUX seçip devam ediyoruz.

Son adımda ise Anahtarsız girişi seçiyoruz ve ilerleyip eklemeyi sonlandırıyoruz.
Şimdi eklentiyi sunucumuza eklememiz gerekiyor.

Kırmızı ile işaretlenen yere basıp sunucumuzun menüsünü açıyoruz.

Daha sonra 1 ile işaretlenmiş yerden sunucunun eklentileri kısmına gelip 2 ile işaretlenmiş yere basıyoruz.

Açılan pencereden "Envanter Keşif" eklentisini seçip ekliyoruz. Eğer eklenti başarılı bir şekilde eklendiyse aşağıdaki gibi bir menü, sunucu sayfasında görülecektir.

Şimdi eklentinin ayarlarını yapmamız gerekiyor. Tekrardan eklentiler kısmına gelelim.

Kırmızı ile belirtilen kısma basarak eklenti ayarları sekmesine girelim.

API Adresini şekildeki gibi girdikten sonra kaydederek kurulumu tamamlayabiliriz.