Proxus'u Docker ile kurun

Bu kılavuzu bitirdiğinizde Proxus, Docker Compose ile tek bir makinede çalışır durumda olur ve merkez sunucuda oturum açmış olursunuz. Bu kurulum deneme, demo ya da küçük bir tesis için yeterlidir. Canlı kullanıma geçecekseniz Proxus'u Docker ile çalıştırın sayfasını da okuyun.

Başlamadan önce

Şunlar hazır olmalı:

• Docker Engine ve Docker Compose eklentisi (docker compose komutu) kurulu bir makine. Ayrıntılar için sistem gereksinimleri sayfasına bakın.
• Kurulum betiği için proxus.io adresine internet erişimi. Kurulumu Proxus teslimatıyla gelen bir compose dosyasından yapacaksanız o docker-compose.yml dosyası hazır olmalı.
• Docker Hub erişimi. Proxus imajları (proxusplatform/proxus-ui ve proxusplatform/proxus-server) ile veritabanı ve mesaj sunucusu imajları Docker Hub'da yayınlanır. İnternet erişimi olmayan bir ağda bunun yerine İnternet erişimi olmadan kurulum sayfasını izleyin.
• Makinede şu portların boş olması: 8080, 8443, 8083, 1883, 8883, 4222, 8222, 7422, 5442, 8123, 9000, 9004 ve 9005. Her portun ne için kullanıldığı Ağ portları sayfasında yazar.
• Proxus'tan ya da distribütörünüzden aldığınız lisans anahtarı. Anahtarınız yoksa kuruluma yine başlayabilirsiniz. Merkez sunucu ilk açılışta bir Lisans kimliği gösterir. Bu kimliği lisans için gönderin.

Compose dosyası hangi servisleri başlatır

Her servis, verisini adı belli bir Docker biriminde tutar (proxus-db-volume, clickhouse_data, nats, config, proxus_modules). Bu sayede veri, yeniden başlatmada ya da imaj güncellemesinde kaybolmaz.

Kurulum betiğiyle kurun

En hızlı yol kurulum betiğidir; aynı komut daha sonra kurulumu günceller, yedekler ve değiştirir. Betik, Docker ve Docker Compose'un hazır olduğunu kontrol eder, birkaç soru sorar, en son Proxus sürümünün dosyalarını (sürümün sağlama toplamlarıyla doğrulayarak) yeni bir proxus-platform klasörüne indirir ve onay verirseniz servisleri başlatır.

1. Makinede bir terminal açın, Proxus'un duracağı klasöre geçin (örneğin /opt) ve işletim sistemine uygun komutu çalıştırın:

   curl -fsSL https://proxus.io/install.sh | bash

   irm https://proxus.io/install.ps1 | iex

   Docker kurulumunuz gerektiriyorsa komutu Linux'ta sudo ile çalıştırın ya da Windows'ta PowerShell'i yönetici olarak açın.

2. Betiğin sorularını yanıtlayın:

   • Culture sayıların ve tarihlerin nasıl gösterileceğini belirler, örneğin tr-TR ya da en-US. Betik makinenin kendi ayarını önerir.
   • Time zone konteynerlerdeki ve günlük dosyalarındaki saati belirler, örneğin Europe/Istanbul.
   • Addresses edge gateways reach this machine on: betik bulduğu adresleri önerir. Merkez sunucu, bir Edge Gateway kurarken bu adresleri önerir. Bkz. Merkez sunucunun adresini sabit tutun.
   • Install Keycloak next to Proxus? Birden çok uygulama için tek şirket hesabına ya da parola yazmadan Windows ile girişe ihtiyacınız yoksa N yanıtlayın. Proxus, Active Directory, LDAP, Microsoft Entra ID ya da Okta ile girişi Keycloak olmadan yapar. Bkz. Giriş yöntemini seçin. Keycloak'ı sonra da ekleyebilirsiniz.
   • Start Proxus now? İmajları indirip servisleri hemen başlatmak için Y yanıtlayın. İlk indirme yaklaşık 2-3 GB'dır. Betik bütün servisler sağlıklı olana kadar bekler.

3. Proxus'u İlk kez oturum açın bölümündeki gibi açın.

Betik yanıtları proxus-platform/.env dosyasında tutar ve her çalıştırmanın kaydını proxus-platform/logs/ klasörüne yazar. Docker yoksa, Docker servisi çalışmıyorsa ya da Docker Compose v2 kurulu değilse açık bir mesajla durur ve hiçbir şey yazmaz.

Proxus her makinede bir merkez sunucu çalıştırır: konteynerlerinin adları sabittir. Proxus makinede başka bir klasörden çalışıyorsa betik o klasörü söyler ve hiçbir şeyi değiştirmeden durur.

Bir betikten sorusuz kurmak için --yes (her soru varsayılanını alır) ve gerekirse sürümü ekleyin:

curl -fsSL https://proxus.io/install.sh | bash -s -- install --version 2.1.0 --yes

Güncelleyin, yedekleyin ve değiştirin

Aynı komutu, proxus-platform klasörünü içeren klasörde yeniden çalıştırın. Betik kurulumu tanır ve şunları sunar:

Önceki bir betikle yapılmış kurulumlar olduğu gibi devralınır: yığın adları, birimleri, verileri ve merkez sunucunun yayınlandığı portlar korunur.

Compose dosyasından kurun

Makine proxus.io adresine erişemiyorsa ya da dosyaları kendiniz yönetiyorsanız bu yolu kullanın. Makine Docker Hub'a da erişemiyorsa imajları önce İnternet erişimi olmadan kurulum sayfasındaki gibi yükleyin.

1. docker-compose.yml dosyasını Proxus sürümünden (ya da teslimatınızdaki proxus-docker_<sürüm>.zip paketinden) alın ve yeni bir klasöre kopyalayın, örneğin /opt/proxus-platform.

2. Yanına, bu kurulumun ayarlarını içeren bir .env dosyası oluşturun:

   .env

   COMPOSE_PROJECT_NAME=proxus
   TZ=Europe/Istanbul
   PROXUS_CULTURE=tr-TR
   PROXUS_PUBLIC_ADDRESS=192.168.10.20

   TZ konteynerlerdeki ve günlük dosyalarındaki saati belirler. PROXUS_PUBLIC_ADDRESS, Edge Gateway'lerin bu makineye ulaştığı adrestir (birden çoksa virgülle ayırın). Compose dosyası zaten kendi sürümünün imajlarını kullanır.

3. Klasörün içindeyken servisleri başlatın:

   docker compose up -d

   Docker ilk çalıştırmada imajları indirir, ardından beş servisi başlatır.

4. Bütün servislerin çalışmasını ve durumlarının healthy olmasını bekleyin:

   docker compose ps

   Merkez sunucu ilk açılışta veritabanı tablolarını, mesaj sunucusunun güvenlik ayarlarını ve platformun sertifika otoritesini (Proxus Platform CA) oluşturur. Bu nedenle ilk açılış sonrakilerden uzun sürer. Bu işlem bitene kadar hub-server günlüğünde Waiting for Proxus UI to create the NATS trust satırı tekrar tekrar görünür. Bu normaldir.

5. Merkez sunucunun yanıt verip vermediğini kontrol edin. Sunucu hazır olduğunda komut Healthy yazar:

   curl http://localhost:8080/healthz

Yığında yaptığınız kendi değişikliklerinizi docker-compose.yml dosyasına değil, yanındaki docker-compose.override.yml dosyasına yazın: betik ve sonraki sürümler docker-compose.yml dosyasını değiştirir, override dosyasına hiç dokunmaz.

İlk kez oturum açın

1. Tarayıcıda https://<host>:8443 adresini açın. <host> yerine makinenin adını ya da IP adresini yazın (makinenin kendisinde https://localhost:8443). Merkez sunucunun sertifikası Proxus Platform CA tarafından imzalanmıştır. Tarayıcınız bu CA'yı henüz tanımadığı için ilk açılışta uyarı gösterir. Uyarıyı geçip sayfaya devam edebilir ya da http://<host>:8080 adresini kullanabilirsiniz. Uyarının bir daha çıkmaması için platform CA'sını bilgisayarınıza yükleyin (Sertifikalar sayfasına bakın).

2. Form kendi dilinizde değilse sağ üstteki listeden dilinizi seçin.

3. Kullanıcı adına Admin yazın, Parola alanını boş bırakın. Oturum aç düğmesini seçin.

4. Yeni kurulan merkez sunucunun henüz lisansı olmadığı için Lisans etkinleştirme penceresi açılır. Size verilen anahtarı yapıştırın ve lisansı etkinleştirin. Anahtar yalnızca bu kurulumda çalışır. Lisans siparişinde iletmeniz gereken Lisans kimliği de bu pencerede yazar.

   Pencereyi lisansı etkinleştirmeden kapatırsanız oturumunuz kapanır. Lisanslarla ilgili ayrıntılar Lisans sayfasındadır.

5. Ekranda Anlık durum sayfası açılır.

İlk hesapları güvenceye alın

İlk açılışta parolası boş olan tek bir yönetici hesabı oluşturulur: Admin. Merkez sunucuya başkaları erişmeden önce bu hesaba güçlü bir parola verin. Bunun için sağ üstteki kullanıcı menüsünü açın, önce Bilgilerim'i, ardından Parolamı değiştir'i seçin. API erişimi için Güvenlik > Kullanıcılar ekranında ayrı bir kullanıcı tanımlayın.

Ekip arkadaşlarınız için hesap açmayı Kullanıcılar ve roller sayfası anlatır.

Merkez sunucunun adresini sabit tutun

Her Edge Gateway, kurulum sihirbazında seçtiğiniz merkez sunucu adresiyle kurulur ve yalnızca o adrese bağlanır. Merkez sunucunun makinesi sonradan yeni bir IP adresi alırsa (örneğin DHCP'den) Edge Gateway'lerin bağlantısı kopar ve her birinin yeniden kurulması gerekir.

• Üretimde merkez sunucuya sabit bir adres verin: DHCP rezervasyonu ya da sabit IP, daha iyisi proxus.fabrika.local gibi bir DNS adı. DNS adı kullanırsanız IP değişikliği hiçbir Edge Gateway'i etkilemez.
• Kurulum sihirbazı önce merkez sunucuyu açtığınız adresi, ardından betiğin bulduğu adresi önerir. Doğru adresin ilk sırada gelmesi için merkez sunucuyu Edge Gateway'lerin kullanacağı adresle açın.
• Merkez sunucunun önerdiği adresi değiştirmek için betiği yeniden çalıştırın ve Change culture, time zone or addresses seçeneğini seçin. Ya da proxus-platform/.env dosyasında PROXUS_PUBLIC_ADDRESS değerini ayarlayın (birden çok adres ya da DNS adını virgülle ayırın) ve o klasörde docker compose up -d komutunu çalıştırın.

Sertifika anahtarını kaybetmeyin

Merkez sunucu, sertifikalarının özel anahtarlarını şifreli olarak saklar. Bu şifrelemenin anahtarı config birimindedir (keys/STORE/certificate-store.key). Her yedeğe config birimini de ekleyin. Bu anahtar olmadan geri yüklemeden sonra sertifikalar okunamaz. Ayrıntılar için Yedekleme ve geri yükleme sayfasına bakın.

Sonraki adımlar

• İlk makinenizi bağlayın: yerleşik simülatörle ilk cihazı ekleyin.
• Merkez sunucuda kısa bir tur: her ekranın ne işe yaradığını görün.
• Proxus'u Docker ile çalıştırın: canlı kullanım ayarları, güncellemeler ve yedekleme.
• Yapılandırma: yapılandırma dosyasının ayarları. Docker kurulumunda bu dosya config birimindedir. Merkez sunucu dosyayı ilk açılışta varsayılan değerlerle buraya yazar.