Support for TrueNAS' WebSocket APIs

lucasdillmann · lucasdillmann · commit 18163863ac31 · 2026-03-02T11:05:14.000-03:00
diff --git a/database/common/migrations/scripts/postgres/029_truenas_integrations_legacy_flag.up.sql b/database/common/migrations/scripts/postgres/029_truenas_integrations_legacy_flag.up.sql
@@ -0,0 +1 @@
+update integration set parameters = parameters::jsonb || '{"legacyApi": true}'::jsonb where driver = 'TRUENAS';
diff --git a/database/common/migrations/scripts/sqlite/029_truenas_integrations_legacy_flag.up.sql b/database/common/migrations/scripts/sqlite/029_truenas_integrations_legacy_flag.up.sql
@@ -0,0 +1 @@
+update integration set parameters = json_patch(parameters, '{"legacyApi": true}') where driver = 'TRUENAS';
diff --git a/frontend/src/core/i18n/I18nService.ts b/frontend/src/core/i18n/I18nService.ts
@@ -36,12 +36,12 @@ export default class I18nService {
         if (!languageTag) this.repository.clear()
         else this.repository.set(languageTag)
 
-        await this.loadDictionary(languageTag)
-
         I18nContext.replace({
             ...I18nContext.get(),
             currentLanguage: languageTag,
         })
+
+        await this.loadDictionary(languageTag)
     }
 
     private async loadDictionary(targetLanguage: string | null) {
diff --git a/i18n/messages_bn.properties b/i18n/messages_bn.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=ID ${id} সহ কন্টেইনা
 integration/docker/resolver/no-nodes-found=নোড IP সমাধান করতে অক্ষম: কোনো নোড পাওয়া যায়নি
 integration/docker/resolver/no-running-tasks=নোড IP সমাধান করতে অক্ষম: সার্ভিস ${id} এর জন্য কোনো চলমান টাস্ক পাওয়া যায়নি
 integration/truenas/description=TrueNAS, অন্যান্য অনেক কিছুর পাশাপাশি, Docker কন্টেইনারের অধীনে আপনার প্রিয় অ্যাপগুলো চালানোর অনুমতি দেয়। এই ইন্টিগ্রেশন সক্রিয় করে, আপনি সহজেই আপনার TrueNAS-এ একটি সার্ভিস এক্সপোজ করা যেকোনো অ্যাপকে আপনার nginx ignition-এর হোস্ট রাউটের টার্গেট হিসেবে বেছে নিতে সক্ষম হবেন।
+integration/truenas/legacy-api-help=সক্ষম হলে, WebSocket API-এর পরিবর্তে পুরানো REST API ব্যবহার করে। এটি শুধুমাত্র তখন সক্ষম করুন যদি আপনার TrueNAS সংস্করণ WebSocket API সমর্থন না করে।
+integration/truenas/legacy-api=লেগেসি REST API ব্যবহার করুন
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=TrueNAS অ্যাপে রিকোয়েস্ট প্রক্সি করার সময় ব্যবহৃত URL। এটি ব্যবহার করুন যদি অ্যাপগুলো অন্য অ্যাড্রেসে এক্সপোজ করা থাকে যা উপরের মেইন URL এর মতো নয়।
 integration/truenas/proxy-url-resolution-failed=${id} এর জন্য প্রক্সি URL সমাধান করতে অক্ষম: সার্ভিসটি সম্ভবত অফলাইন/বন্ধ আছে
diff --git a/i18n/messages_de.properties b/i18n/messages_de.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=Kein Netzwerk oder IP-Adresse für den Co
 integration/docker/resolver/no-nodes-found=Node-IPs konnten nicht aufgelöst werden: keine Nodes gefunden
 integration/docker/resolver/no-running-tasks=Node-IPs konnten nicht aufgelöst werden: keine laufenden Tasks für Service ${id} gefunden
 integration/truenas/description=TrueNAS ermöglicht es, neben vielen anderen Dingen, Ihre Lieblings-Apps unter Docker-Containern auszuführen. Mit dieser aktivierten Integration können Sie einfach jede App, die einen Dienst in Ihrem TrueNAS offenlegt, als Ziel für Ihre nginx ignition Host-Routen auswählen.
+integration/truenas/legacy-api-help=Bei Aktivierung wird die veraltete REST-API anstelle der WebSocket-API verwendet. Aktivieren Sie diese Option nur, wenn Ihre TrueNAS-Version die WebSocket-API nicht unterstützt.
+integration/truenas/legacy-api=Legacy-REST-API verwenden
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=Die URL, die verwendet werden soll, wenn eine Anfrage an eine TrueNAS-App weitergeleitet wird. Verwenden Sie dies, wenn die Apps unter einer anderen Adresse offengelegt werden, die nicht dieselbe wie die Haupt-URL oben ist.
 integration/truenas/proxy-url-resolution-failed=Proxy-URL für ${id} konnte nicht aufgelöst werden: Dienst ist wahrscheinlich offline/gestoppt
diff --git a/i18n/messages_en.properties b/i18n/messages_en.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=No network or IP address found for the co
 integration/docker/resolver/no-nodes-found=Unable to resolve node IPs: no nodes found
 integration/docker/resolver/no-running-tasks=Unable to resolve node IPs: no running tasks found for service ${id}
 integration/truenas/description=TrueNAS allows, alongside many other things, to run your favorite apps under Docker containers. With this integration enabled, you will be able to easily pick any app exposing a service in your TrueNAS as a target for your nginx ignition's host routes.
+integration/truenas/legacy-api-help=When enabled, uses the deprecated REST API instead of the WebSocket API. Enable this only if your TrueNAS version does not support the WebSocket API.
+integration/truenas/legacy-api=Use legacy REST API
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=The URL to be used when proxying a request to a TrueNAS app. Use this if the apps are exposed in another address that isn't the same as the main URL above.
 integration/truenas/proxy-url-resolution-failed=Unable to resolve proxy URL for ${id}: service is probably offline/stopped
diff --git a/i18n/messages_es.properties b/i18n/messages_es.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=No se encontró red o dirección IP para
 integration/docker/resolver/no-nodes-found=No se pudieron resolver las IPs de nodo: no se encontraron nodos
 integration/docker/resolver/no-running-tasks=No se pudieron resolver las IPs de nodo: no se encontraron tareas en ejecución para el servicio ${id}
 integration/truenas/description=TrueNAS permite, junto con muchas otras cosas, ejecutar sus aplicaciones favoritas bajo contenedores Docker. Con esta integración habilitada, podrá elegir fácilmente cualquier aplicación que exponga un servicio en su TrueNAS como destino para las rutas de host de nginx ignition.
+integration/truenas/legacy-api-help=Cuando está habilitada, usa la API REST obsoleta en lugar de la API WebSocket. Habilite esto solo si su versión de TrueNAS no admite la API WebSocket.
+integration/truenas/legacy-api=Usar API REST heredada
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=La URL que se utilizará al proxear una solicitud a una aplicación TrueNAS. Use esto si las aplicaciones están expuestas en otra dirección que no sea la misma que la URL principal anterior.
 integration/truenas/proxy-url-resolution-failed=No se pudo resolver la URL del proxy para ${id}: el servicio probablemente esté desconectado/detenido
diff --git a/i18n/messages_fr.properties b/i18n/messages_fr.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=Pas de réseau ou d'adresse IP trouvé po
 integration/docker/resolver/no-nodes-found=Impossible de résoudre les IPs des nœuds : aucun nœud trouvé
 integration/docker/resolver/no-running-tasks=Impossible de résoudre les IPs des nœuds : aucune tâche en cours trouvée pour le service ${id}
 integration/truenas/description=TrueNAS permet, à côté de beaucoup d'autres choses, de faire tourner vos apps favorites sous des conteneurs Docker. Avec cette intégration activée, vous pourrez facilement choisir n'importe quelle app exposant un service dans votre TrueNAS comme cible pour vos routes d'hôte nginx ignition.
+integration/truenas/legacy-api-help=Lorsqu'elle est activée, utilise l'API REST dépréciée à la place de l'API WebSocket. Activez ceci uniquement si votre version de TrueNAS ne prend pas en charge l'API WebSocket.
+integration/truenas/legacy-api=Utiliser l'API REST héritée
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=L'URL à utiliser lors de la procuration d'une requête vers une app TrueNAS. Utilisez ceci si les apps sont exposées à une autre adresse qui n'est pas la même que l'URL principale ci-dessus.
 integration/truenas/proxy-url-resolution-failed=Impossible de résoudre l'URL proxy pour ${id} : le service est probablement hors ligne/arrêté
diff --git a/i18n/messages_hi.properties b/i18n/messages_hi.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=ID ${id} वाले कंटेनर
 integration/docker/resolver/no-nodes-found=नोड IPs को हल करने में असमर्थ: कोई नोड नहीं मिला
 integration/docker/resolver/no-running-tasks=नोड IPs को हल करने में असमर्थ: सेवा ${id} के लिए कोई चल रहे कार्य नहीं मिले
 integration/truenas/description=TrueNAS, कई अन्य चीजों के साथ, आपको Docker कंटेनर के तहत अपने पसंदीदा ऐप्स चलाने की अनुमति देता है। इस इंटीग्रेशन के सक्षम होने के साथ, आप अपने nginx ignition के होस्ट रूट्स के लिए लक्ष्य के रूप में अपने TrueNAS में सेवा को उजागर करने वाले किसी भी ऐप को आसानी से चुन सकेंगे।
+integration/truenas/legacy-api-help=सक्षम होने पर, WebSocket API के बजाय पुरानी REST API का उपयोग करता है। इसे केवल तभी सक्षम करें जब आपका TrueNAS संस्करण WebSocket API का समर्थन नहीं करता हो।
+integration/truenas/legacy-api=लेगेसी REST API का उपयोग करें
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=TrueNAS ऐप के लिए अनुरोध को प्रॉक्सी करते समय उपयोग किया जाने वाला URL। इसका उपयोग तब करें जब ऐप्स किसी अन्य पते पर उजागर हों जो ऊपर दिए गए मुख्य URL के समान न हो।
 integration/truenas/proxy-url-resolution-failed=${id} के लिए प्रॉक्सी URL को हल करने में असमर्थ: सेवा शायद ऑफ़लाइन/रोकी गई है
diff --git a/i18n/messages_ja.properties b/i18n/messages_ja.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=ID ${id} のコンテナのネットワ
 integration/docker/resolver/no-nodes-found=ノードIPを解決できません: ノードが見つかりません
 integration/docker/resolver/no-running-tasks=ノードIPを解決できません: サービス ${id} の実行中のタスクが見つかりません
 integration/truenas/description=TrueNASを使用すると、他の多くの機能に加えて、Dockerコンテナでお気に入りのアプリを実行できます。この統合を有効にすると、TrueNASでサービスを公開しているアプリを、nginx ignitionのホストルートのターゲットとして簡単に選択できるようになります。
+integration/truenas/legacy-api-help=有効にすると、WebSocket APIの代わりに非推奨のREST APIを使用します。TrueNASのバージョンがWebSocket APIをサポートしていない場合にのみ有効にしてください。
+integration/truenas/legacy-api=レガシーREST APIを使用する
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=TrueNASアプリにリクエストをプロキシする際に使用されるURL。アプリが上記のメインURLとは異なる別のアドレスで公開されている場合はこれを使用します。
 integration/truenas/proxy-url-resolution-failed=${id} のプロキシURLを解決できません: サービスはおそらくオフライン/停止しています
diff --git a/i18n/messages_pt.properties b/i18n/messages_pt.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=Nenhuma rede ou endereço IP encontrado p
 integration/docker/resolver/no-nodes-found=Não foi possível resolver IPs dos nós: nenhum nó encontrado
 integration/docker/resolver/no-running-tasks=Não foi possível resolver IPs dos nós: nenhuma tarefa em execução encontrada para o serviço ${id}
 integration/truenas/description=O TrueNAS permite, junto com muitas outras coisas, rodar seus apps favoritos sob containers Docker. Com esta integração habilitada, você poderá facilmente escolher qualquer app expondo um serviço em seu TrueNAS como um alvo para as rotas do host do nginx ignition.
+integration/truenas/legacy-api-help=Quando habilitada, usa a API REST obsoleta em vez da API WebSocket. Habilite isso apenas se a sua versão do TrueNAS não suportar a API WebSocket.
+integration/truenas/legacy-api=Usar API REST legada
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=A URL a ser usada ao fazer proxy de uma requisição para um app TrueNAS. Use isto se os apps estão expostos em outro endereço que não é a mesma URL principal acima.
 integration/truenas/proxy-url-resolution-failed=Não foi possível resolver URL de proxy para ${id}: serviço provavelmente está offline/parado
diff --git a/i18n/messages_ru.properties b/i18n/messages_ru.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=Сеть или IP адрес не най
 integration/docker/resolver/no-nodes-found=Не удалось разрешить IP адреса узлов: узлы не найдены
 integration/docker/resolver/no-running-tasks=Не удалось разрешить IP адреса узлов: не найдено запущенных задач для сервиса ${id}
 integration/truenas/description=TrueNAS позволяет, наряду со многими другими вещами, запускать ваши любимые приложения в контейнерах Docker. С включенной этой интеграцией вы сможете легко выбрать любое приложение, предоставляющее сервис в вашем TrueNAS, в качестве цели для маршрутов хостов nginx ignition.
+integration/truenas/legacy-api-help=При включении использует устаревший REST API вместо WebSocket API. Включайте только если ваша версия TrueNAS не поддерживает WebSocket API.
+integration/truenas/legacy-api=Использовать устаревший REST API
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=URL, который будет использоваться при проксировании запроса к приложению TrueNAS. Используйте это, если приложения доступны по другому адресу, который не совпадает с основным URL выше.
 integration/truenas/proxy-url-resolution-failed=Не удалось разрешить URL прокси для ${id}: сервис, вероятно, оффлайн/остановлен
diff --git a/i18n/messages_vi.properties b/i18n/messages_vi.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=Không tìm thấy mạng hoặc địa c
 integration/docker/resolver/no-nodes-found=Không thể phân giải IP node: không tìm thấy node
 integration/docker/resolver/no-running-tasks=Không thể phân giải IP node: không tìm thấy task đang chạy cho dịch vụ ${id}
 integration/truenas/description=TrueNAS cho phép, bên cạnh nhiều thứ khác, chạy các ứng dụng yêu thích của bạn dưới dạng Docker container. Với tích hợp này được bật, bạn sẽ có thể dễ dàng chọn bất kỳ ứng dụng nào hiển thị dịch vụ trong TrueNAS của bạn làm đích cho các tuyến đường host của nginx ignition.
+integration/truenas/legacy-api-help=Khi được bật, sử dụng API REST cũ thay vì API WebSocket. Chỉ bật tùy chọn này nếu phiên bản TrueNAS của bạn không hỗ trợ API WebSocket.
+integration/truenas/legacy-api=Sử dụng API REST cũ
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=URL được sử dụng khi proxy một yêu cầu đến ứng dụng TrueNAS. Sử dụng điều này nếu các ứng dụng được hiển thị ở một địa chỉ khác không giống với URL chính ở trên.
 integration/truenas/proxy-url-resolution-failed=Không thể phân giải proxy URL cho ${id}: dịch vụ có thể đang ngoại tuyến/đã dừng
diff --git a/i18n/messages_zh.properties b/i18n/messages_zh.properties
@@ -1420,6 +1420,8 @@ integration/docker/resolver/no-network=未找到 ID 为 ${id} 的容器的网络
 integration/docker/resolver/no-nodes-found=无法解析节点 IP：未找到节点
 integration/docker/resolver/no-running-tasks=无法解析节点 IP：未找到服务 ${id} 的正在运行的任务
 integration/truenas/description=TrueNAS 允许在 Docker 容器下运行您喜爱的应用，此外还有许多其他功能。启用此集成后，您将能够轻松选择 TrueNAS 中暴露服务的任何应用作为 nginx ignition 主机路由的目标。
+integration/truenas/legacy-api-help=启用后，将使用已弃用的 REST API 而不是 WebSocket API。仅在您的 TrueNAS 版本不支持 WebSocket API 时才启用此选项。
+integration/truenas/legacy-api=使用旧版 REST API
 integration/truenas/name=TrueNAS
 integration/truenas/proxy-url-help=将请求代理到 TrueNAS 应用时使用的 URL。如果应用暴露在与上述主 URL 不同的地址中，请使用此选项。
 integration/truenas/proxy-url-resolution-failed=无法解析 ${id} 的代理 URL：服务可能离线/已停止
diff --git a/integration/truenas/client/cache.go b/integration/truenas/client/cache.go
@@ -5,32 +5,51 @@ import (
 	"time"
 
 	"github.com/patrickmn/go-cache"
+
+	"dillmann.com.br/nginx-ignition/core/common/configuration"
 )
 
-type apiCache[T any] struct {
-	delegate *cache.Cache
-	lock     sync.Mutex
-}
+var (
+	cacheDelegate *cache.Cache
+	cacheInitLock = &sync.Once{}
+	cacheMainLock = &sync.Mutex{}
+)
 
-func newCache[T any](timeoutSeconds int) *apiCache[T] {
-	return &apiCache[T]{
-		delegate: cache.New(
-			time.Duration(timeoutSeconds)*time.Second,
-			time.Duration(timeoutSeconds)*time.Second,
-		),
+func initCache(cfg *configuration.Configuration) error {
+	var err error
+
+	cacheInitLock.Do(func() {
+		cacheDuration, innerErr := cfg.GetInt(
+			"nginx-ignition.integration.truenas.api-cache-timeout-seconds",
+		)
+		if innerErr != nil {
+			err = innerErr
+			return
+		}
+
+		cacheDelegate = cache.New(
+			time.Duration(cacheDuration)*time.Second,
+			time.Duration(cacheDuration)*time.Second,
+		)
+	})
+
+	if err != nil {
+		cacheInitLock = &sync.Once{}
 	}
+
+	return err
 }
 
-func (c *apiCache[T]) get(key string, missProvider func() T) T {
-	c.lock.Lock()
-	defer c.lock.Unlock()
+func getFromCache[T any](key string, missProvider func() T) T {
+	cacheMainLock.Lock()
+	defer cacheMainLock.Unlock()
 
-	if value, found := c.delegate.Get(key); found {
+	if value, found := cacheDelegate.Get(key); found {
 		return value.(T)
 	}
 
 	value := missProvider()
-	c.delegate.Set(key, value, cache.DefaultExpiration)
+	cacheDelegate.Set(key, value, cache.DefaultExpiration)
 
 	return value
 }
diff --git a/integration/truenas/client/client.go b/integration/truenas/client/client.go
diff --git a/integration/truenas/client/rest_client.go b/integration/truenas/client/rest_client.go
diff --git a/integration/truenas/client/websocket_client.go b/integration/truenas/client/websocket_client.go
diff --git a/integration/truenas/driver.go b/integration/truenas/driver.go
diff --git a/integration/truenas/fields/dynamic_fields.go b/integration/truenas/fields/dynamic_fields.go
diff --git a/integration/truenas/go.mod b/integration/truenas/go.mod
diff --git a/integration/truenas/go.sum b/integration/truenas/go.sum

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+update integration set parameters = parameters::jsonb \|\| '{"legacyApi": true}'::jsonb where driver = 'TRUENAS';`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+update integration set parameters = json_patch(parameters, '{"legacyApi": true}') where driver = 'TRUENAS';`