Tek host (Docker Compose)

Tek makinede, tek komutla her şey — bu, Orbtrace'i tek bir host'ta çalıştırmanın önerilen yoludur ve onu denemenin en hızlı yoludur. docker compose up -d tüm yığını birbirine bağlı olarak ayağa kaldırır: Orbtrace uygulaması, Apache Doris (FE + BE), Postgres + pgvector ve Valkey — Kubernetes yolunun aksine kurulacak harici veri deposu yoktur. Tek sunucuda küçük-orta hacimler için sağlam bir üretim dağıtımıdır; yalnızca birden çok makineye ölçeklenmeniz gerektiğinde Kubernetes'e dağıtım'a geçin.

Önce donanım ve kernel ön-koşulları (8 GB RAM tabanı, vm.max_map_count, portlar) için Kurulum hazırlığı sayfasına bakın.

Sağlanacak harici veri deposu yoktur — Kubernetes yolundan farklı olarak Doris/Postgres/Valkey aynı komutla ayağa kalkar. Ayrı çalıştırdığınız tek parça, veriyi içeri gönderen Collector'dır (Entegrasyon desenleri).

1. 1

   Docker'ı kurun

   Resmi Docker Engine yükleyicisini kullanın. docker --version ve docker compose version ile doğrulayın. Docker Compose v2 gereklidir.

2. 2

   Erişiminizi ve bundle'ı alın

   Orbtrace özel bir imajdır. Dağıtım bundle'ı (compose/ dizininde Compose dosyaları, otelcol-config.yaml, .env.example bulunur) ücretsiz bir public indirmedir; Nivorbit imaj için müşteriye-özel pull token'ı verir. Bundle'ı indirin ve açın (olduğu gibi yapıştırmak güvenli):

   tar xzf orbtrace-2.1.0.tar.gz && cd orbtrace-2.1.0

   Sonra registry'ye giriş yapın — önce bu satırı düzenleyin, <token> ve <username>'i Nivorbit kimlik bilgilerinizle değiştirin:

   echo "<token>" | docker login ghcr.io -u <username> --password-stdin

   ghcr.io/nivorbit/images/orbtrace imajı docker compose up'ta çekilir. Air-gapped mı? Nivorbit size imajları içine gömülü bir air-gapped bundle verir — 4. adımdan önce bash images/LOAD.sh ile yükleyin, giriş gerekmez (bkz. Air-gapped kurulum).

3. 3

   Ayarları düzenleyin

   Dağıtım dosyaları bundle'ın compose/ dizinindedir:

   cd compose
   cp .env.example .env
   $EDITOR .env

   En azından şunları ayarlayın:

   • PGPASSWORD ve DORIS_PASSWORD — varsayılanlardan değiştirin.
   • ORBTRACE_BOOTSTRAP_ADMIN_USERNAME — admin olacak e-posta (bkz. Kimlik doğrulama).
   • ORBTRACE_BOOTSTRAP_ADMIN_PASSWORD — değerlendirme girişi için bunu ayarlayın. SSO yapılandırılmadan giriş formu olmaz, dolayısıyla bir eval makinesi buna ihtiyaç duyar: o admin olarak kullanıcı adı/parola girişini verir. (Üretim bunun yerine SSO kullanır.)
   • ORBTRACE_LICENSE_KEY — opsiyonel; ücretsiz COMMUNITY sürümü için boş bırakın (bkz. Lisanslama).

   Her değişken için bkz. Yapılandırma.

   Compose'da placeholder koruması yoktur

   Ansible yolunun aksine, docker compose up örnek sırlar değişmeden açılır (ör. change-me… Postgres parolası). Sizi durduran bir şey yoktur — bu yüzden makineyi açmadan önce onları gerçekten düzenlediğinizden emin olun.

4. 4

   Başlatın

   compose/ dizininden:

   docker compose up -d

   İlk açılış, Doris depolama node'larını kaydedip Orbtrace şemayı oluştururken iki-üç dakika sürer. docker compose ps ile izleyin; orbtrace healthy olduğunda hazırsınız.

5. 5

   UI'ı açın

   http://localhost:8080 (ya da http://<sunucu-ip>:8080) adresine gidin. Giriş sayfasını görmelisiniz. İlk giriş'e devam edin.

   Üretimde HTTPS için Orbtrace'i bir ters proxy'nin arkasına koyun: gömülü Caddy'yi docker compose --profile edge up -d ile etkinleştirin (80/443 yayınlar) ya da kendi Nginx/Traefik'inizi kullanın.

Orbtrace ayağa kalkınca Kurulum hazırlığı sayfasındaki kurulum-sonrası kontrol listesi ile bitirin — sırlar, veri gönderecek bir Collector (Entegrasyon desenleri), TLS ve yedekler.