Uygulama Parametreleri

Tam bir web arayüzü oluşturmadan kullanıcılara yapılandırılabilir parametreler sunun. env-template.yml kullanarak bir form tanımlayın; IronFlock bunu otomatik olarak render eder.

Parametreler Ne Zaman Kullanılır

Kullanıcıların cihaz veya grup başına ayarlaması gereken basit yapılandırmalar için parametreleri kullanın:

• Sensör kayıt aralıkları
• Veri uç nokta URL’leri
• Uyarı eşikleri
• Özellik geçişleri
• API anahtarları ve kimlik bilgileri

Daha karmaşık yapılandırmalar için (robot eğitimi, kamera AI kurulumu, donanım yapılandırması), özel bir Edge Kullanıcı Arayüzü oluşturun.

Parametreleri Tanımlama

.ironflock/ dizininde bir env-template.yml dosyası oluşturun:

RECORDING_INTERVAL:
    label: "Kayıt Aralığı (saniye)"
    defaultValue: 5
    type: numeric
    optional: true
 
ALERT_THRESHOLD:
    label: "Sıcaklık Uyarı Eşiği (°C)"
    defaultValue: 80
    type: numeric
    optional: true
 
API_ENDPOINT:
    label: "Veri API Uç Noktası"
    defaultValue: "https://api.example.com/data"
    type: text
    optional: true
 
ENABLE_DEMO:
    label: "Demo Verisi Etkinleştir"
    defaultValue: true
    type: boolean
    optional: true
 
DATA_FORMAT:
    label: "Çıktı Formatı"
    defaultValue: "json"
    type: select
    options:
        - json
        - csv
        - xml
    optional: true
 
SECRET_KEY:
    label: "API Gizli Anahtarı"
    defaultValue: ""
    type: text
    secret: true
    optional: true

Parametre Türleri

Parametreler Uygulamanıza Nasıl Ulaşır

Parametreler, container’ınızda Linux ortam değişkenleri olarak enjekte edilir:

import os
 
interval = int(os.environ.get("RECORDING_INTERVAL", 5))
threshold = float(os.environ.get("ALERT_THRESHOLD", 80))

const interval = parseInt(process.env.RECORDING_INTERVAL || "5");
const threshold = parseFloat(process.env.ALERT_THRESHOLD || "80");

Büyük Parametreler

Sistem sınırlamaları nedeniyle 20 KB’ı aşan parametreler ortam değişkenleri olarak ayarlanmaz. Bunun yerine, tüm parametreler (büyük olanlar dahil) her zaman dosya olarak kullanılabilir:

/data/env/PARAMETER_NAME.txt

Geliştirme Modu

env-template.yml içinde belirtilen defaultValue, uygulama geliştirme modunda çalışırken kullanılır. Bu, manuel parametre yapılandırması gerektirmeden tutarlı bir geliştirme deneyimi sağlar.

Toplu Parametrelendirme

Parametreler cihaz grubu düzeyinde ayarlandığında, gruptaki tüm cihazlara aynı anda uygulanır. Bu şunlar için idealdir:

• Tüm veri toplama cihazlarında ortak bir S3 kovası ayarlama
• Proje genelinde AI model parametrelerini güncelleme
• Tüm bir üretim hattı için sensör yapılandırmalarını değiştirme

Parametreler cihazlar çevrimdışıyken bile ayarlanabilir — cihaz yeniden bağlandığında uygulanırlar.