Docker

Bu kılavuzu tamamladığınızda Proxus merkez sunucusu tek makinede Docker Compose ile, tesisin saat dilimi ve ayarlarıyla çalışır; her ayarın ve kendi değişikliklerinizin nerede durduğunu bilirsiniz. Kurulum betiği bunların hepsini kurar ve güncel tutar; bu sayfa, onu çalıştırmak ve ayarlamak için betiğin ne kurduğunu anlatır.

Başlamadan önce

• Sistem gereksinimlerini karşılayan bir Linux makinesi gerekir. Docker Desktop yüklü bir Windows ya da macOS makinesi de kullanılabilir.
• Docker Engine ve Docker Compose eklentisi kurulu olmalıdır. docker compose version komutu bir sürüm numarası yazdırmalıdır.
• Kurulum betiğiyle yapılmış bir kurulum ya da bir Proxus sürümünün docker-compose.yml dosyası, kendi klasöründe, örneğin /opt/proxus-platform. Her sürümün dosyası o sürümün imajlarını kullanır.
• proxusplatform/proxus-ui ve proxusplatform/proxus-server imajları Docker Hub'da yayımlanır. Makinenin Docker Hub'a erişimi olmalı ya da imajlar önceden docker load ile yüklenmiş olmalıdır. Bkz. İnternet erişimi olmadan kurulum.

Compose dosyası neleri çalıştırır

Duran her hizmet kendiliğinden yeniden başlar (restart: always). Merkez sunucu, Edge Gateway ve veritabanları için çalışma durumu denetimi tanımlıdır.

config birimini merkez sunucu, Edge Gateway ve NATS sunucusu birlikte kullanır. Bu birimde yapılandırma dosyası, NATS kimlik bilgileri ve TLS sertifikası, oturum açmayı koruyan anahtarlar ve sertifika deposu anahtarı (keys/STORE/certificate-store.key) bulunur. Sertifika deposu anahtarı olmadan veritabanındaki sertifikalar okunamaz. Bu yüzden config birimini her zaman veritabanıyla birlikte yedekleyin. Ayrıntılar için Yedekleme ve geri yükleme sayfasına bakın.

proxus-ui konteynerine Docker soketi (/var/run/docker.sock) de bağlanır. Merkez sunucu, yapılandırma değiştiğinde yığını bu soket üzerinden yeniden başlatır.

Bir kurulumun dosyaları

COMPOSE_PROJECT_NAME yığının ve onunla birlikte birimlerinin (proxus_config gibi) adını belirler: yeni kurulumlarda proxus, önceki bir kurulum betiğiyle yapılmış kurulumlarda proxus-platform. İlk başlatmadan sonra asla değiştirmeyin: başka bir adla Compose verilerin hiçbirini bulamaz. Konteyner adları sabit olduğundan bir makinede yalnızca bir Proxus merkez sunucu yığını çalışır.

Yığını başlatın

Her komutu kurulum klasöründe çalıştırın: Compose oradaki .env dosyasını okur, böylece yığın adı, sürüm ve compose dosyaları her zaman doğru olur. Yapılandırma düzenleyici ekranındaki Yeniden başlat düğmesi, merkez sunucunun ait olduğu yığını yeniden başlatır.

cd /opt/proxus-platform
docker compose up -d

İlk başlatmada merkez sunucu, NATS kimlik bilgilerini config birimine yazar. Bu iş bitene kadar hub-server iki saniyede bir "Waiting for Proxus UI to create the NATS trust" mesajını yazar. Bu mesaj normaldir.

Tüm hizmetlerin çalıştığını kontrol edin:

docker compose ps

proxus-ui, proxus-server ve postgresql hazır olduğunda durumları healthy olur. Ardından https://<host>:8443 adresini açın ve oturum açın. HTTPS varsayılan olarak açıktır. Sertifikayı platformun kendi sertifika yetkilisi verir. http://<host>:8080 adresi yerel erişim için açık kalır. Ayrıntılar için Güvenlik sayfasına bakın.

Sık kullanılan komutlar

Kurulum klasöründe:

Güncelleme, yedekleme ve geri yüklemeyi kurulum betiği yapar.

Yığını tesise göre ayarlayın

Değişikliklerinizi docker-compose.yml dosyasının yanındaki docker-compose.override.yml dosyasına yazın (kurulum betiği boş bir tane oluşturur), ardından docker compose up -d ile uygulayın. Compose yalnızca ayarı değişen konteynerleri yeniden oluşturur.

Saat dilimi, kültür, adres. Bunlar .env dosyasındadır (TZ, PROXUS_CULTURE, PROXUS_PUBLIC_ADDRESS). Betiği çalıştırıp Change culture, time zone or addresses seçeneğini seçin ya da .env dosyasını düzenleyip docker compose up -d komutunu çalıştırın.

Ortam değişkeniyle ayar. Yapılandırma dosyasındaki her anahtar, environment: altında Section__Key biçiminde de verilebilir. Burada verilen değerler dosyadaki değerlerin yerine geçer ve yükseltmelerde kaybolmaz:

services:
  proxus-ui:
    environment:
      Security__Lockout__MaxFailedAccessAttempts: "5"

Portlar. Override dosyasındaki bir ports listesi, sürümün listesine eklenir. Listeyi değiştirmek için onu !override ile işaretleyin (Docker Compose 2.24 ya da sonrası); örneğin web arayüzünü 80 portundan açmak ve veritabanına yalnızca makinenin kendisinden erişilmesini sağlamak için:

services:
  proxus-ui:
    ports: !override ["80:8080", "8443:8443"]
  postgresql:
    ports: !override ["127.0.0.1:5442:5442"]

Hizmetler birbirine iç proxus ağı üzerinden ulaşır, dışa açılan portlara ihtiyaç duymaz. Hangi portların açık kalması gerektiğini Güvenlik sayfasında bulabilirsiniz.

HTTPS. Merkez sunucu HTTPS'i 8443 portundan sunar. HTTPS'i makinenin başka bir portundan açarsanız, örneğin "443:8443", Service__PublicHttpsPort: "443" değerini de ekleyin. Kullanıcıların merkez sunucuya ulaşmak için yazdığı adları Service__PublicHostNames ile tanımlayın. Merkez sunucunun sertifikaları bu adları da kapsar.

TLS ile MQTT. SYSTEM Edge Gateway'inin MQTT sunucusu, TLS bağlantıları için 8883 portunu da dinler. Hazır dosya bu portu 1883 ile birlikte dışa açar.

ClickHouse belleği. clickhouse hizmeti en fazla 8 GB bellek kullanabilir. Küçük bir makinede bu sınırı düşürün, büyük bir kurulumda yükseltin:

services:
  clickhouse:
    deploy:
      resources:
        limits:
          memory: 4g

2.0.0'a yükselttikten sonra

Kurulum betiği bunu kendisi yapar. Betik olmadan, merkez sunucu başladıktan sonra NATS sunucusunu bir kez yeniden başlatın. Böylece NATS sunucusu TLS sertifikasını yükler:

docker restart hub-server

Ardından her uzak Edge Gateway'in kurulum komutunu yeniden çalıştırın. Ayrıntılar için Yükseltme sayfasına bakın.

Sonraki adımlar

• Yükseltme: yığını yeni bir Proxus sürümüne geçirme adımları.
• Yedekleme ve geri yükleme: birimlerin ve veritabanlarının yedeğini alma.
• Güvenlik: portları, parolaları ve HTTPS'i üretime hazırlama.
• Edge Gateway kurma: başka bir makineye Edge Gateway kurma.