ONLYOFFICE Apps'i Docker'da çalıştırma

Giriş

ONLYOFFICE Apps, iş birliğini artırmak için kullanıcıları ve belgeleri tek bir yerde buluşturabileceğiniz bir belge merkezidir.

Bu kılavuz, ONLYOFFICE Apps'i makinenizde Docker ile nasıl çalıştıracağınızı gösterir.

not

Bu kılavuz, ONLYOFFICE Apps'in geliştirme/test sürümünü dağıtır ve üretim ortamında kullanım için tasarlanmamıştır. Bu sürüm yalnızca düz HTTP üzerinden hizmet verir, kimlik/OAuth hizmetleri içermez ve sınırlı bir özellik kümesiyle çalışır. Üretim ortamı dağıtımları için ONLYOFFICE Apps'in üretim sürümünü kullanın.

Genel bakış

Standart çok kapsayıcılı dağıtımın aksine bu sürüm, tüm ONLYOFFICE Apps hizmetlerini hizmet başına ayrı kapsayıcılar yerine tek bir kapsayıcıda çalıştırır. Tam yığın şu kapsayıcılardan oluşur:

Kapsayıcı	Görevi
onlyoffice-apps	Tüm ONLYOFFICE Apps hizmetleri (birleştirilmiş)
onlyoffice-document-server	Document Server (düzenleyiciler)
onlyoffice-mysql-server	MySQL veritabanı
onlyoffice-opensearch	OpenSearch

Standart çok kapsayıcılı dağıtımla karşılaştırıldığında bu sürümün farkları şunlardır:

• Tüm ONLYOFFICE Apps hizmetleri tek bir kapsayıcıda birleştirilmiştir.
• Arama basitleştirilmiştir.
• Küçük resim oluşturma yoktur.
• Yalnızca HTTP vardır, hazır olarak TLS/HTTPS desteği yoktur.
• Kimlik/OAuth hizmetleri yoktur.

Sistem gereksinimleri

• CPU: en az 6 çekirdek (8 çekirdek önerilir)
• RAM: en az 12 GB (16 GB önerilir)
• HDD: en az 40 GB boş alan
• İşletim sistemi: çekirdek sürümü 3.10 veya üzeri olan amd64 Linux dağıtımı
• Ek gereksinimler:
  • en az 6 GB takas alanı (swap)
  • Compose eklentisi (docker compose komutu) bulunan Docker Engine

Depoyu klonlama

DocSpace-buildtools deposunu aşağıdaki komutla klonlayın:

git clone https://github.com/ONLYOFFICE/DocSpace-buildtools.git

Depo klonlandıktan sonra Compose dizinine geçin:

cd DocSpace-buildtools/install/docker/community

Hazır imajları çalıştırma

ONLYOFFICE Apps'i hazır imajlarla ayrık modda başlatmak için aşağıdaki komutu çalıştırın:

docker compose up -d

Kapsayıcılar çalışmaya başladıktan sonra bir tarayıcı açın ve ONLYOFFICE Apps'e erişmek için adres çubuğuna http://localhost veya http://your-ip-address yazın.

İmajları kaynaktan oluşturma

ONLYOFFICE Apps imajlarını kendiniz oluşturmak veya belirli bir daldaki değişiklikleri test etmek istiyorsanız bu seçeneği kullanın.

Kapsayıcıları aşağıdaki komutla oluşturup başlatın:

docker compose up -d --build

not

İmajlar varsayılan olarak master dalından oluşturulur. Başka bir daldan oluşturmak için GIT_BRANCH derleme bağımsız değişkenini belirtin: GIT_BRANCH=your-branch docker compose up -d --build.

Derleme tamamlanıp kapsayıcılar çalışmaya başladıktan sonra ONLYOFFICE Apps'e erişmek için tarayıcınızda http://localhost veya http://your-ip-address adresini açın.

SSL ile çalıştırma

ONLYOFFICE Apps, hem Let's Encrypt hem de özel SSL sertifikalarını destekler.

Let's Encrypt sertifikası kullanma

ONLYOFFICE Apps'i Let's Encrypt sertifikasıyla çalıştırmak için kendi alan adınızı, e-posta adresinizi ve çalışma alanı URL'nizi belirterek aşağıdaki komutu çalıştırın:

SSL_MODE="letsencrypt" \
SSL_DOMAIN="example.com,portal.example.com,api.example.com" \
SSL_EMAIL="admin@example.com" \
APP_URL_PORTAL="https://example.com/" \
docker compose \
  -f docker-compose.yml \
  -f ssl.yml \
  up -d

Aşağıdaki parametreler kullanılır:

• SSL_MODE – SSL sertifikası modu.
• SSL_DOMAIN – virgülle ayrılmış bir veya daha fazla alan adı.
• SSL_EMAIL – Let's Encrypt kaydı için kullanılan e-posta adresi.
• APP_URL_PORTAL – çalışma alanınızın herkese açık HTTPS URL'si.

Özel veya özel CA sertifikası kullanma

Otomatik imzalı bir sertifika veya özel bir sertifika yetkilisi (CA) tarafından verilmiş bir sertifika kullanıyorsanız ONLYOFFICE Document Server'ın da bu sertifikaya güvenmesi gerekir.

docker-compose.yml dosyasında aşağıdaki birim satırlarının açıklama işaretini kaldırın:

services:
   onlyoffice-document-server:
     volumes:
       - ${CERTIFICATE_PATH}:/var/www/onlyoffice/Data/certs/extra-ca-certs.pem

Ardından sertifikanın ana bilgisayardaki yolunu belirtin ve aşağıdaki komutu çalıştırın:

SSL_MODE="custom" \
SSL_DOMAIN="example.com" \
SSL_CERT_PATH="/etc/nginx/certs/fullchain.crt" \
SSL_KEY_PATH="/etc/nginx/certs/private.key" \
CERTIFICATE_PATH="./config/nginx/certs/fullchain.crt" \
APP_URL_PORTAL="https://example.com/" \
docker compose \
  -f docker-compose.yml \
  -f ssl.yml \
  up -d

not

CERTIFICATE_PATH, kapsayıcı içindeki yolu değil, sertifika dosyasının Docker ana bilgisayarındaki yolunu göstermelidir. Bu seçenek genellikle yalnızca otomatik imzalı sertifikalar veya özel bir CA tarafından verilmiş sertifikalar için gerekir. Genel CA'ların (örneğin Let's Encrypt, DigiCert veya GoDaddy) verdiği sertifikalar genellikle bu ek yapılandırmayı gerektirmez.

Aşağıdaki parametreler kullanılır:

• SSL_MODE – SSL sertifikası modu (custom).
• SSL_DOMAIN – çalışma alanının alan adı.
• SSL_CERT_PATH – SSL sertifikasının yolu.
• SSL_KEY_PATH – özel anahtarın yolu.
• APP_URL_PORTAL – çalışma alanınızın herkese açık HTTPS URL'si.

not

ssl.yml yapılandırması varsayılan olarak yerel ./config/nginx/certs dizinini kapsayıcı içindeki /etc/nginx/certs dizinine bağlar.

Kapsayıcılar çalışmaya başladıktan sonra ONLYOFFICE Apps'e erişmek için tarayıcıda çalışma alanı adresinizi, örneğin https://example.com/ adresini açın.