Ana içeriğe geç

Düğüm Yapılandırması

Düğüm Yapılandırması, tüm sunucu çiftliği yerine tek bir Emakin aracı düğümüne uygulanan ayarları kapsar. Yürütme modunu denetlemeniz, yapılandırma değerlerini geçersiz kılmanız veya hassas yerel yapılandırmayı korumanız gerektiğinde kullanın.

Düğüm yapılandırması yalnızca yerel düğüme uygulanır ve uzak düğümleri otomatik olarak etkilemez.

Yürütme Modları

Mevcut belgelerde üç yürütme modu açıklanmaktadır:

  • Tam Mod: web sunucusu ve arka plan görevi işleme
  • Web Sunucusu Modu: yalnızca web sayfaları ve API uç noktaları
  • Aracı Modu: yalnızca arka plan görevi işleme

Komut düzeyindeki davranış için bkz. Komut Satırı Arayüzü.

Yapılandırma Önceliği

Emakin katmanlı yapılandırma kullanır. Belgelerde belirtilen öncelik sırası şöyledir:

  1. <installdir>/appsettings.json
  2. <configuration-data-path>/appsettings.json
  3. şu önekle başlayan ortam değişkenleri: AK_
  4. <configuration-data-path>/protectedsettings.json

<configuration-data-path> varsayılan olarak Configuration/Data İsteğe bağlı AK_CONFIGURATION_DATA_PATH ortam değişkeni, düğüme özgü verilerin başka bir konumda saklanması gerektiğinde kullanılabilir. Bu ayara normalde ihtiyaç duyulmaz; yalnızca ayrı bir depolama konumu gerektiğinde tanımlanmalıdır.

Değer, mutlak veya göreli bir yol olabilir. Göreli değer, kurulumun Configuration dizininin altında çözümlenir; mutlak değer doğrudan kullanılır. Seçilen yol, düğüme özgü özel yapılandırma, günlükler ve FullText kataloğu için kullanılır. Dizin, aracı hesabı tarafından yazılabilir olmalı ve bu verilerin hizmet veya kapsayıcı yeniden başlatmalarından sonra korunması gerekiyorsa kalıcı depolama üzerinde bulunmalıdır.

Ortam Değişkeni Geçersiz Kılmaları

Şununla başlayan ortam değişkenleri: AK_ JSON ayarlarını geçersiz kılar. İç içe ayarlar çift alt çizgi kullanır.

Mevcut sayfadan korunan örnekler:

1
2
AK_DbProvider=Postgres
AK_DbConnStr="Host=myserver;Database=emakin;Username=emakin;Password=mypassword;"

1
AK_WEB__KESTREL__ENDPOINTS__HTTP__URL=http://*:81

İsteğe bağlı veri yolu geçersiz kılması:

1
AK_CONFIGURATION_DATA_PATH=/var/lib/emakin/data

Bu değişken tanımlanmadığında Emakin, kullanmaya devam eder: <installdir>/Configuration/Data.

Komut Satırı Geçersiz Kılmaları

Komut satırı bağımsız değişkenleri diğer tüm yapılandırma katmanlarını geçersiz kılar.

Örnek:

1
.\AltiKare.Workflow.Agent.exe DBConnStr="Host=myserver;Database=emakin;Username=emakin;Password=mypassword;"

Korumalı Ayarlar

Hassas değerler, düz metin olarak saklanmak yerine protectedsettings.json içinde şifrelenebilir.

Uyarı: Korunan belgelerde şifrelenmiş ayarların yalnızca yazılabilir olduğu belirtiliyor. Eğer protectedsettings.json kaybolursa depolanan değerler tekrar okunamaz.

Şunu kullanan örnek: setconfig:

1
.\AltiKare.Workflow.Agent.exe setconfig DbConnStr 'Host=myserver;Database=emakin;Username=emakin;Password=mypassword;'

Şifreleme Anahtarı Depolama Konumu

Korunan belgelerde şifreleme anahtarlarının varsayılan olarak aracı kullanıcısının ana dizininde saklandığı belirtiliyor. Kapsayıcılarda kullanıcı bu konuma yazamıyorsa işlem sessizce başarısız olabilir.

Korunan belgelerde önerilen örnek:

1
LOCALAPPDATA=/app/home

Korumalı ayarların kapsayıcı yeniden başlatmalarından sonra da korunması gerekiyorsa bu konumu Docker veya Kubernetes'te kalıcı depolamaya bağlayın.

Tanılama İzleri

İş adımı tanılama izleri, düğüme özgü Diagnostics ayarlarla denetlenir. İzlerin yalnızca test modundaki iş akışları için mi, tüm iş akışları için mi yakalanacağını yoksa hiç yakalanmayacağını seçmek için bu ayarları kullanın.

İzleme modu, saklama süresi ve yapılandırma örnekleri için bkz. Tanılama İzleme Yapılandırması.