Ana içeriğe atla

S3 geçişi

v6.0.0’dan itibaren Ayakaleaf Pro artık eski user_files depolamasını kullanmamaktadır; bu nedenle yalnızca şablon dosyalarının ve geçmişin taşınması gerekir.
Sizden haber almak isteriz! Kaç dosya taşıdığınızı, toplam hacimlerini ve geçişin ne kadar sürdüğünü bizimle paylaşmak isterseniz ayaka@outlook.in adresine e-posta gönderin.
Bu kılavuz, disk üzerindeki depolamadan S3 uyumlu bir nesne depolamaya geçişte size yol gösterecektir. S3 Kurulumu giriş belgesinin bölümlerine atıfta bulunur.

Gereksinimler

  • İletişim kurulacak S3 uyumlu bir nesne depolama; seçenekler için #s3-setup bölümüne bakın
  • Mevcut verileri taşımak için, yaklaşık olarak diskteki mevcut boyut kadar boş disk alanı
  • Asıl geçişi yapmak için bir bakım penceresi
  • Geri yükleme yapabilmek için yapılandırma dahil tam bir yedek

Geçiş için gereken disk boyutunu tahmin etme

Mevcut disk kullanımını hesaplamak için du kullanabiliriz:
Mevcut sunucuda yeterli disk alanınız yoksa sunucuya başka bir disk bağlamayı deneyin.
Geçmiş dizinleri zaten doğru düzene sahiptir. Ek disk alanı gerektirmeyen bind-mount edilmiş kaynak klasörden doğrudan yükleme yapabilirsiniz.

Geçiş adımları

Adım 0: örneği kapatın

Tüm kullanıcı/şablon dosyalarının taşınacağından emin olmamız gerekir. Yeni yüklenen dosyaların gözden kaçmasını önlemek için örneği kapatmak en iyisidir. Kapatma prosedürü için lütfen tutarlı bir yedekleme yapma kılavuzumuza bakın.

Adım 1: dizin düzenini yeniden yazın

Şablon dosyalarını S3’e yüklemek için dizin düzenlerini yeniden yazmamız gerekir. Filestore şablon dosyalarını tek bir düz dizinde tutar, örneğin <template-id>_v_1_pdf; S3 ise <template-id>/v/1/pdf kullanır. Aşağıda, dosyaları yeni dizin düzeninde saklamak için /srv/overleaf-s3-migration kullanılmaktadır. /srv/overleaf-bind-mount değerini /var/lib/overleaf konumuna bağlanan ana makine diziniyle değiştirin. Kopyalama komutlarını, bu dizinleri okuma ve yazma iznine sahip olarak ana makinede çalıştırın; konteyner durdurulmuş olarak kalır. Düzeni yeniden yazmak için tar kullanabiliriz:

Adım 2: dosyaları yükleyin

Tercihinize bağlı olarak, dosyaları S3 uyumlu nesne depolamanıza yüklemek için minio mc S3 istemcisini veya aws cli’yi kullanabilirsiniz. aws cli
  • Burada overleaf-template-files, overleaf-project-blobs ve overleaf-chunks değerlerini S3 bucket’larınızın adlarıyla değiştirmelisiniz.
  • Ayrıca /srv/overleaf-bind-mount değerini /var/lib/overleaf bind-mount’unun yerel yoluyla değiştirin. Varsayılan olarak bu, docker-compose.yml kurulumunda ~/overleaf_data, Toolkit kullanıldığında ise <toolkit-checkout>/data/overleaf olur.
minio mc Burada “s3” sunucu takma adını kullanıyoruz; siz başka bir ad seçmiş olabilirsiniz.

Adım 3: örneği S3’e yönlendirilmiş olarak başlatın

S3 kurulum kılavuzundaki Değişkenlere genel bakış bölümünde ayrıntılı olarak açıklandığı gibi, S3 ile ilgili tüm değişkenleri yapılandırmanıza ekleyin. Veri dizini bind-mount’unu yerinde tutun: S3’e taşınmayan Zotero veya Mendeley şifreleme anahtarlarını da içerebilir.
Lütfen geçici dosyalar için ayrılmış disk bind-mount’unu yerinde tutun; bkz. Sorun Giderme sayfasındaki Overleaf’i bir NFS dosya sistemiyle çalıştırma bölümü.
Artık örneği başlatabilir ve geçişi doğrulayabilirsiniz:
  • editörde ikili dosyaları önizleyebiliyor musunuz
  • görseller içeren bir PDF derleyebiliyor musunuz
  • yeni dosyalar yükleyebiliyor musunuz

Geri alma

Adımları tersine çevirerek geçişi sorunsuz şekilde geri alabilirsiniz:
  1. Örneği kapatın
  2. Kaynak/hedef sırasını ters çevirerek dosyaları geri yansıtın
  3. Ters bir transform kullanarak yeni dosyaları yerel dizine geri yazın
  4. Örneği eski yapılandırmayla yeniden başlatın
İlk transform üst düzey klasörü kaldırır. İkinci transform dizin düzenini düz bir düzene dönüştürür. Joker karakterler, üst (proje) klasörlerinin değil yalnızca dosyaların çıkarılmasını sağlar.
Son değiştirilme tarihi 21 Kasım 2026