Hangi compose profilinin neyi başlattığı, hangi katman dosyasının neyi değiştirdiği ve doğrudan kurulumda işletmecinin çalıştırdığı make hedefleri ile güncelleme bayrakları.

Bu sayfadaki komutlar doğrudan kurulum için geçerlidir — yani CID222'nin, yönettiğiniz bir ana makinede compose dosyalarından çalıştırılması.

Warning

Bir cihaz, imzalı sürümün yerleştirdiği işlenmiş bir sürüm compose dosyasını çalıştırır ve yaşam döngüsü kendi ana makinesindeki güncelleyiciye aittir. Bu komutları bir cihazda çalıştırmayın: onun yerine Ayarlar → System Updates (sistem güncellemeleri) ekranını kullanın. Bkz. Cihazı güncelleme.

Profiller

Profili olmayan bir hizmet, düz bir docker compose up -d ile başlar. Profil eklemelidir — hizmetlerini varsayılanların yerine değil yanında başlatır. Hangi hizmetin hangi profile ait olduğu hizmetler, portlar ve profiller sayfasında üretilir.

Profil	Başlattığı	Ne zaman kullanılır
(hiçbiri)	Ürünü oluşturan 19 hizmet	Her zaman
`llm-analyst`	`risk-analyst`, `mcp-server`	LLM Risk Analisti'ni çalıştırdığınızda. Enterprise katmanı
`inline-proxy`	`cid-inline-proxy`	CID222, istemci tarayıcıları için iletme vekili olduğunda
`userid-agent`	`cid-userid-agent`	Denetlenen trafiği Active Directory kullanıcılarına bağladığınızda
`routing`	`cost-analyzer`	Maliyet temelli model yönlendirmesi çalıştırdığınızda
`llm`	`llm-inference`	Analistin model motoru ayrı bir GPU makinesinde değil bu ana makinede çalıştığında
`tools`	`pgadmin`, `redis-commander`	Yalnızca geliştirmede. İkisi de bir veritabanı konsolu açar
`ldap-test`	`openldap-test`	Yalnızca geliştirmede — LDAP'ı sınamak için tek kullanımlık bir dizin
`mailtest`	`mailpit`	Yalnızca geliştirmede — giden postayı göndermek yerine yakalar

Danger

tools, ldap-test veya mailtest profillerini bir üretim ana makinesinde asla başlatmayın. pgadmin ve redis-commander, ürünün kendi verisine açılan kimlik doğrulamasız konsollardır ve bir sürüm compose dosyası bilinçli olarak mailpit içermez.

Compose dosyaları

Temel dosya her zaman ilk sıradadır; katman dosyası ikinci bir -f ile eklenir.

Dosya	Neyi değiştirir
`docker-compose.yml`	Temel yığın. Her gizli değer bir `${VAR:-default}` yer tutucusudur; bu yüzden ortam dosyası olmadan da başlar
`docker-compose.dev.yml`	Geliştirme katmanı: birim bağlamaları, izleme kipi ve şema otomatik eşitlemesine geri dönen tek yer
`docker-compose.prod.yml`	Üretim katmanı: panel için nginx, iç hizmetlerde ana makine port eşlemesi yok, TLS için Caddy. Docker Compose 2.20 veya üstünü gerektirir
`docker-compose.gpu.yml`	`ocr-service`'i PaddleOCR'ı CUDA üzerinde çalıştıracak biçimde yeniden derler
`docker-compose.llm-gpu.yml`	Analist model motorunu bir GPU ana makinesinde çalıştırır

Make hedefleri

make help tam listeyi yazdırır. Bunlar bir işletmecinin kullandıklarıdır.

Hedef	Yaptığı
`make first-run`	Her imajı derler, sonra yığını başlatır
`make up` / `make down`	Başlatır / durdurur
`make restart`	Yeniden başlatır, ardından sağlığı bildirir
`make status`	Konteyner durumu
`make health`	Konteyner başına sağlık durumu
`make stats`	Anlık kaynak kullanımı
`make logs` / `make logs-api`	Tüm günlükleri / ağ geçidinin günlüklerini izler
`make shell-api`	Ağ geçidi konteyneri içinde bir kabuk
`make update-smart`	Yalnızca kodu değişen hizmetleri yeniden derler
`make update-api` / `make update-dashboard` / `make update-ml`	Tek bir hizmeti yeniden derler
`make rebuild`	Her imajı önbelleksiz yeniden derler
`make update-db`	Bekleyen veritabanı geçişlerini uygular
`make migration-status`	Uygulanmış ve bekleyen geçişleri listeler
`make migration-verify`	Tüm zinciri boş bir veritabanının ve bu makinenin şemasının tek kullanımlık kopyalarına uygular ve hiçbir şeyin kaybolmadığını doğrular
`make migration-baseline`	Geçişlerden önce oluşmuş bir veritabanına ilk şemayı damgalar
`make seed`	Veritabanı tohumlayıcısını çalıştırır
`make sbom`	Gönderilen imaj başına CycloneDX yazılım malzeme listesi
`make airgap-verify`	Modellerin imajın içinde olduğunu kanıtlamak için ağ kapalıyken gerçek OCR çalıştırır

Warning

make seed ve make update-db-reseed, tohumlanmış hesap parolalarını sıfırlayan tam tohumlayıcıyı çalıştırır. Bunlar bir geliştirme ya da merkez makinesi içindir. Hiçbirini bir üretim kurulumuna karşı asla çalıştırmayın.

Doğrudan kurulumu güncelleme

./update.sh, desteklenen yerinde güncellemedir. Kirli bir git çalışma ağacını reddeder, izlenen dalı çeker, değişen yolları compose hizmetlerine eşler, bir pg_dump alır, yalnızca değişeni yeniden derler, o konteynerleri yeniden oluşturur ve sağlık denetimlerini bekler.

Bayrak	Etkisi
(hiçbiri)	Çeker, sonra yalnızca kaynağı değişen hizmetleri yeniden derler
`--full`	Her hizmeti yeniden derler. Büyük bir altyapı değişikliğinden sonra kullanın
`--no-pull`	Çekmeden, mevcut çalışma kopyasından yeniden derler
`--branch <name>`	Önce o dalı kullanıma alır
`--skip-backup`	Veritabanı dökümünü atlar. Daha hızlıdır ve arıza yolunun geri yükleyebileceği tek şeyi ortadan kaldırır

Çıkış kodu	Anlamı
`0`	Başarılı
`2`	Çalışma ağacı kirli; hiçbir şey yapılmadı
`3`	Çekme başarısız oldu
`4`	Bir derleme başarısız oldu
`5`	Sağlık beklemesi zaman aşımına uğradı. Veritabanı dökümden geri yüklendi; günlükleri kalsın diye yeni konteynerler çalışır bırakıldı

Yedekler ./backups dizinine yazılır ve son 14 tanesi saklanır. Konum, bir ürün ayarı değil betiğin bir kabuk değişkenidir: geçersiz kılmak için ./update.sh betiğini çalıştırdığınız ortamda bir yedek dizini ayarlayın.

Notlar

Üretilmiş tablodaki portlar ana makine tarafındadır. Compose ağının içinde hizmetler birbirini hizmet adıyla, her zaman aynı olmayan bir port üzerinden adresler.
Profil tercihe bağlıdır, asla dışlamalı değildir. Varsayılan bir hizmeti kaldıran bir profil yoktur; onsuz çalıştırmak için o hizmeti durdurun.
OCR için tek bir GPU yolu var. docker-compose.gpu.yml, ocr-service'i CUDA üzerinde çalışacak biçimde yeniden derler. Önceki sürümlerde ayrıca farklı bir motor taşıyan ocr-service-gpu konteynerli bir gpu profili vardı; ikisi de kaldırıldı, dolayısıyla aralarında seçim yapmak gerekmiyor. Bkz. kaynak boyutlandırma.

İlgili

Hizmetler, portlar ve profiller — üretilmiş hizmet tablosu.
Ortam değişkenleri — bu komutların okuduğu ayarlar.
Gereksinimler ve boyutlandırma — bunların hiçbiri çalışmadan önce ana makinenin ihtiyaç duyduğu şeyler.

Compose profilleri ve komut satırı