Başlangıç

Kurulum ve ilk adımlar

Battani’yi kendi altyapınıza kurun, ilk oturumu açın ve ücretsiz sürümle başlayın.

Kurulumdan önce

Battani, kendi sunucunuzda çalışan bir web konsoludur. Kurulum betikleri uygulamayı, PostgreSQL veritabanını ve isteğe bağlı Docker Registry servisini Docker Compose ile hazırlar. Kubernetes cluster’ınızın Battani ile aynı sunucuda olması gerekmez.

Linux için x86_64/amd64 sunucu, Docker Engine ve Compose eklentisi gerekir. Betik Docker kurulu değilse kurmayı teklif eder.
Windows için Linux container modunda çalışan Docker Desktop gerekir.
Varsayılan web portu 4000’dir. Cluster API adreslerinin ve veri servislerinin Battani sunucusundan erişilebilir olması gerekir.

Linux üzerinde kurulum

Resmî betik kurulum dosyalarını varsayılan olarak /opt/battani altına yazar; rastgele parolalar üretir, imajları indirir ve servislerin sağlığını kontrol eder.

curl -fsSL https://battani.dev/install.sh | sudo sh

Windows üzerinde kurulum

PowerShell komutunu Docker Desktop çalışırken yürütün. Varsayılan kurulum klasörü kullanıcı profilinizin altındaki Battani klasörüdür.

irm https://battani.dev/install.ps1 | iex

İlk oturum ve bağlantı

İmaj indirme ve çevrimiçi sürüm kontrolü internet erişimi kullanır. Kapalı ağ kurulumunda gerekli imajları önceden taşımanız ve ücretli kullanım için uygun offline lisansı hazırlamanız gerekir.

Betik sonunda gösterilen adrese gidin; admin kullanıcısı ve üretilen parola ile oturum açın.
İlk girişten sonra parolanızı değiştirin. Kurulum klasörünü ve .env dosyasını güvenli biçimde yedekleyin.
Şirket/kurulum bilgilerini tamamlayın. Ücretsiz kullanım için lisans anahtarı gerekmez; ücretli lisans ve deneme aktivasyonu ayrı bir adımdır.
Cluster’lar ekranından bir bağlantı ekleyin ve test edin. Ardından Genel Bakış sayfasını açın.

Sunucu, mimari ve Docker kontrolü

Resmî Linux kurucusu Linux ve x86_64/amd64 denetimi yapar. Docker servisine erişemiyorsa veya Compose eklentisi bulunmuyorsa kurulumu durdurur. Windows kurucusu Docker Desktop’ın Linux container modunu kullanır.

Linux’ta docker info ve docker compose version komutları kurulum yapacak hesapla çalışmalıdır.
Docker kurulu değilse Linux betiği kurulum teklif eder; bu adım yönetici yetkisi ister.
Battani web portu ve isteğe bağlı registry portu başka bir servis tarafından kullanılmamalıdır.

Linux kurucusunun seçenekleri

Seçenekli kurulum için betiği dosyaya indirin ve gerekli değerlerle çalıştırın. Aşağıdaki örnek varsayılan web portunu ve kurulum dizinini açıkça belirtir; --url değerini gerçek erişim adresinizle değiştirin.

--version: belirli yayımlanmış sürümü seçer; verilmezse en yeni sürüm aranır.
--dir: kurulum dizini; --port: web portu; --url: kullanıcıların eriştiği dış adres.
--no-registry: gömülü registry’yi kurmaz; --yes: sorular için varsayılan yanıtlarla devam eder.

curl -fsSL https://battani.dev/install.sh -o install.sh
sudo sh install.sh --dir /opt/battani --port 4000 --url https://battani.example.com

Windows kurucusunun alanları

PowerShell kurucusunda Linux’taki çift tireli seçenekler yerine -Version, -Dir, -Port, -Url, -NoRegistry ve -Yes parametreleri kullanılır. Dizin verilmezse kullanıcı profilindeki Battani klasörü seçilir.

-Dir değerindeki boşlukları tırnak içinde yazın.
-Url dış erişim adresidir; otomatik olarak DNS kaydı veya TLS sertifikası oluşturmaz.
Docker Desktop kapalıysa veya yanlış container modundaysa önce Docker ortamını düzeltin.

& ([scriptblock]::Create((irm https://battani.dev/install.ps1))) -Port 4000 -Url https://battani.example.com

İmaj kaynağı ve sürüm seçimi

Kurucu varsayılan olarak ghcr.io/buraksumer/battani imajını kullanır. Sürüm belirtilmediğinde registry etiketlerinden uygun sürümü bulmaya çalışır; erişim başarısızsa sürümü açıkça belirtmenizi ister.

BATTANI_VERSION sürüm seçimine, BATTANI_IMAGE imaj deposuna karşılık gelir.
BATTANI_PORTAL_URL betiklerin ve portal bağlantılarının kaynağını değiştirir.
Sürüm etiketi, uygulama lisansının izin verdiği sürüm aralığıyla da uyumlu olmalıdır.

Oluşturulan dosyalar ve kalıcı veriler

Kurulum dizininde docker-compose.yml ve .env oluşturulur. Compose uygulama, PostgreSQL ve seçildiyse registry servislerini başlatır. PostgreSQL verisi, registry image verisi ve uygulama yapılandırması ayrı kalıcı volume’lerde tutulur.

.env dosyasında üretilen yönetici parolası, veritabanı erişimi ve şifreleme anahtarları bulunur.
PostgreSQL servisi kurulumda dışarıya veritabanı portu yayımlamaz.
Sadece uygulama imajını saklamak, veritabanı ve registry verisinin yedeğini almak anlamına gelmez.

Kurulum kimliği ve şifreleme anahtarları

Linux betiği mümkünse sunucunun kalıcı machine-id bilgisini salt okunur biçimde container’a bağlar; uygun kimlik yoksa kurulum klasöründe kalıcı host-id üretir. Bu bilgi lisans kurulum kimliğinin bağlanmasında kullanılır.

JWT_SECRET, REGISTRY_SECRETS_KEY ve INTEGRATION_SECRETS_KEY rastgele üretilir.
Yeniden kurulumda mevcut şifreleme anahtarlarını gelişigüzel değiştirmeyin; kayıtlı şifreli bağlantı bilgilerinin okunmasını etkileyebilir.
Taşıma planında verileri, .env dosyasını ve lisans kimliğinin nasıl değişeceğini birlikte ele alın.

Web adresi, reverse proxy ve registry portu

--url/-Url kullanıcının tarayıcıdan göreceği adresi tanımlar. Varsayılan web portu 4000, gömülü registry portu 5000’dir. HTTPS kullanacaksanız dış proxy, DNS ve sertifikayı ayrıca yapılandırın.

BATTANI_REGISTRY_PORT gömülü registry’nin yayımlanan portunu belirler.
Registry’nin istemciye duyurduğu public host ve token realm adresi Ayarlar → Docker Registry altında incelenir.
Proxy kullanırken canlı log ve terminal bağlantılarının da erişebildiğini test edin.

İlk yöneticiyle oturum açma

Kurulum sonunda adres, admin kullanıcı adı ve üretilen parola gösterilir. Önce bu hesapla giriş yapın, profilinizden parolayı değiştirin ve şirket bilgisini tamamlayın. Ücretsiz kullanım bağlantısı lisans anahtarı satın almadan devam etmenizi sağlar.

Ücretsiz başlangıçta 1 aktif kullanıcı ve 1 aktif cluster limitini dikkate alın.
LDAP’ı etkinleştirmeden önce yerel yöneticiyle erişimin çalıştığını doğrulayın.
Bir cluster bağladıktan sonra yalnız liste görünümünü değil, bağlantı testini ve Genel Bakış verilerini de kontrol edin.

Kurulum sonucunu ve hataları kontrol etme

Betik uygulamanın sağlıklı olmasını bekler; yaklaşık beş dakika içinde sağlık durumu oluşmazsa son container loglarını göstererek hata verir. Kurulum başarısızken aynı klasöre yeniden kurulum çalıştırmak yerine mevcut servislerin neden açılmadığını araştırın.

Kurulum klasöründe docker compose ps ile servis durumlarını kontrol edin.
docker compose logs --tail 100 app ile uygulama açılış hatasını okuyun.
PostgreSQL sağlık durumunu, imaj indirme hatasını ve port çakışmasını ayrı ayrı inceleyin.

cd /opt/battani
docker compose ps
docker compose logs --tail 100 app

Kapalı ağ ve mevcut kurulum davranışı

BATTANI_SKIP_PULL=1 önceden yüklenmiş imajların yeniden indirilmesini engeller; tek başına tüm işlemleri çevrimdışı hale getirmez. Kurulum betiği, seçili Battani sürümü ve Compose dosyasındaki diğer imajlar önceden hazırlanmalıdır.

Kapalı ağda sürümü açıkça belirtin; otomatik sürüm araması internet gerektirebilir.
Ücretli kullanım için offline lisans ve kurum içinde erişilebilir hedef servisler hazırlayın.
Kurulum dizininde .env varsa kurucu mevcut kurulumu üzerine yazmaz; bakım için güncelleme betiğini kullanın.