Nesne Depolama kovasını sunucuya klasör olarak bağlama

1. Ne işe yarar?

Kovanız sunucuda /mnt/yedekler gibi bir klasör olarak görünür. Bu klasöre yazılan dosyalar kovaya, kovadaki dosyalar klasöre gelir; uygulamanızın S3 bilmesi gerekmez.

• Ücretsizdir. Okuma ve yazma trafiği depolama hizmetinizin trafiğinden sayılır.
• Gyro Bulut İstanbul sunucularında otomatik kurulur. Diğer sunucularda panelin verdiği tek satırlık komutu bir kez çalıştırırsınız.
• Her bağlantının kendi erişim anahtarı vardır. Anahtar yalnız seçtiğiniz kovaya yetkilidir (salt okuma ya da okuma/yazma), anahtar sınırınızdan düşmez ve bağlantıyı kaldırınca silinir. Sunucu ele geçirilse bile diğer kovalarınıza erişilemez.
• Kalıcıdır: sunucu yeniden başladığında bağlantı kendiliğinden gelir, bağlantı koparsa yeniden bağlanır.
• Kovanın adını değiştirmeniz bağlantıyı bozmaz.

2. Panelden bağlama

1. Sunucunuzun hizmet sayfasında Depolama bağla sekmesini açın.
2. Depolama hizmeti ve Kova seçin.
3. Bağlama noktası'nı yazın ya da boş bırakın (varsayılan /mnt/<kova adı>). Yol /mnt, /srv, /data, /media, /opt, /home ya da /var/www altında olmalıdır; klasör yoksa oluşturulur, dolu bir klasöre bağlanmaz (içindekiler görünmez olmasın diye).
4. Sunucu yalnız okuyacaksa Salt okuma'yı işaretleyin (ör. yedek geri yükleme, web varlıkları).
5. Bağla'ya basın.

Gyro Bulut İstanbul sunucularında bağlantı birkaç saniye içinde kendiliğinden kurulur ve durum Bağlı olur (sunucu açık olmalı).

Diğer sunucularda panel tek satırlık bir kurulum komutu gösterir. Sunucunuza SSH ile bağlanıp komutu root ya da sudo yetkili bir kullanıcıyla bir kez çalıştırın:

curl -fsSL https://www.gyrohosting.com/.../gyro-s3mount.sh -o /tmp/gyro-s3mount.sh && echo "<özet>  /tmp/gyro-s3mount.sh" | sha256sum -c --quiet && sudo bash /tmp/gyro-s3mount.sh install <tek-kullanımlık-belirteç> https://www.gyrohosting.com

Komut 60 dakika geçerlidir ve yalnız bir kez kullanılabilir. Betik çalışmadan önce SHA-256 özeti doğrulanır; betik gerekli paketleri (FUSE, rclone) kurar, kimlik bilgisini panelden bir kez alır ve bağlantıyı başlatır. Birkaç saniye sonra panelde durum Bağlı olur.

3. Sunucuda kullanım

ls /mnt/yedekler                          # kovadaki dosyalar
cp yedek-2026-11-13.tar.gz /mnt/yedekler/  # kovaya yükler
gyro-s3mount list                          # bu sunucudaki bağlantılar ve durumları
systemctl status gyro-s3mount@yedekler     # ayrıntılı durum

Bağlantı gyro-s3mount@<ad> adlı bir systemd hizmetidir. Dosyalar root'a aittir, diğer kullanıcılar okuyabilir (0755 / 0644). Kimlik bilgisi /etc/gyro-s3mount/<ad>.conf dosyasında yalnız root'un okuyabileceği şekilde durur; panelde gösterilmez.

4. Bağlantıyı kaldırma

Panelde ilgili satırdaki Kaldır'a basın. Bağlantının erişim anahtarı hemen silinir; kovadaki dosyalar silinmez.

• Gyro Bulut İstanbul sunucularında sunucudaki hizmet ve klasör de kendiliğinden kaldırılır.
• Diğer sunucularda sunucuyu temizlemek için panelin gösterdiği komutu çalıştırın: sudo gyro-s3mount remove <ad>. Bu komutu sunucuda kendiniz çalıştırırsanız panelde de kaldırılmış görünür.

5. Depolama hizmeti askıya alınırsa ya da sona ererse

• Askı: bağlantı kovaya erişemez (klasörde giriş/çıkış hatası görürsünüz). Hizmet yeniden açıldığında bağlantı kendiliğinden döner.
• İptal / sona erme: bağlantı anahtarı silinir, bağlantı panelde Sona erdi olur. Sunucunuz iptal edildiğinde de o sunucunun bağlantıları kapatılır.

5a. Korumalı Depolama kovaları

Korumalı Depolama (sürümlü, kilitlenebilir) kovaları da bağlanabilir. Farklar:

• Varsayılan salt okuma. Panelde Korumalı bir depolama hizmeti seçtiğinizde Salt okuma işaretli gelir. Yedeklerinizi sunucuda okuyup geri yüklemek için en güvenli kullanım budur.
• Okuma-yazma seçerseniz panel bir uyarı gösterir ve onayınızı ister (API'de accept_versioning: true):
  • Sunucuda bir dosyayı her kaydetmeniz ya da üzerine yazmanız yeni bir sürüm oluşturur.
  • Silme dosyayı kalıcı silmez, yalnız silme işareti koyar; önceki sürüm durur ve Sürümler sayfasından geri getirilebilir.
  • Kilitli dosyalar kilit süresi dolmadan silinemez.
  • Bu yüzden kullanılan alan ve ücret zamanla büyür. Eski sürümleri Yaşam döngüsü ("eski sürümleri N gün sonra sil") ile sınırlayın; sık değişen dosyaları (log, veritabanı, önbellek) Standart Nesne Depolama'da tutun.
• Gereksiz sürüm oluşmaması için bağlantı dosyaların değiştirilme zamanını kovaya yazmaz ve yazmaları yaklaşık 30 saniye toplayıp tek seferde yükler.
• Kovanın adını değiştirmek bağlantıyı bozmaz: bağlantı her zaman kovanın değişmeyen S3 adını kullanır.

6. Komut satırı, API ve Terraform

gyro server storage-mount list 12345
gyro server storage-mount create 12345 --storage-service-id 6789 --bucket yedekler --mount-point /mnt/yedekler
gyro server storage-mount command 12345 3        # yeni tek kullanımlık komut
gyro server storage-mount remove 12345 3 --yes

API: GET/POST /cloud/servers/{id}/storage-mounts, GET/DELETE /cloud/servers/{id}/storage-mounts/{mid}, POST .../{mid}/command. Yanıttaki automatic: true bağlantının otomatik uygulandığını, install_command sunucuda çalıştırılacak komutu gösterir.

resource "gyro_server_storage_mount" "yedek" {
  server_id          = gyro_server.web.id
  storage_service_id = 6789
  bucket             = "yedekler"
  mount_point        = "/mnt/yedekler"
}

7. Sık sorulan sorular