# kio-s3

## Giriş

KIO S3; Amazon S3 ve S3 uyumlu depolama hizmetlerinde (Cloudflare R2, DigitalOcean Spaces, MinIO ve diğerleri gibi) depolanan dosyaları Dolphin ve diğer KDE uygulamalarından doğrudan taramanıza ve yönetmenize olanak tanıyan bir KIO çalışanıdır.

KIO S3 ile şunları yapabilirsiniz:

- Kovalara ve klasörlere göz atabilir;

- Dosyalar indirebilir ve karşıya yükleyebilir;

- Dosyaları ve klasörleri kopyalayabilir, yeniden adlandırabilir ve silebilir;

- Kovalar içinde klasörler oluşturabilir;

- Adlandırılmış profiller kullanarak aynı anda birden fazla S3 uyumlu hizmete bağlanabilirsiniz.

## Profilleri Yapılandırmak

KIO S3, adlandırılmış profiller aracılığıyla birden fazla S3 uyumlu depolama hizmetine bağlanmayı destekler. Her profil, bir hizmet için bağlantı ayarlarını saklar. Profilleri Sistem Ayarları Ağ S3 Arka Uçları bölümünden yönetebilirsiniz.

### Profil Eklemek

Profil Ekle… düğmesine tıklayın ve aşağıdaki alanları doldurun:

Ad

- Bu profil için açıklayıcı bir ad gereklidir (örneğin, `Bulut Depolama Alanım`).

Bitiş ucu URL’si

- S3 uyumlu hizmetin URL’si, örneğin, `https://s3.example.com`. Öntanımlı Amazon S3 uç noktasını kullanmak için boş bırakın.

Bölge

- Depolama bölgesi, örneğin, `us-east-1` veya `auto`. AWS yapılandırmanızdaki bölgeyi kullanmak için boş bırakın.

AWS profili

- `~/.aws/credentials` dosyasındaki kimlik bilgileri profilinin adı. Boş bırakılırsa profil tanımlayıcısı kimlik bilgileri profil adı olarak kullanılır.

Yol olarak biçimli S3 URL’leri kullan

- MinIO veya bazı Ceph dağıtımları gibi sanal barındırma tarzı adreslemeyi desteklemeyen hizmetler için bunu etkinleştirin. Amazon S3 ve Cloudflare R2 içerilmek üzere çoğu hizmetin buna gereksinimi yoktur.

Profil ekledikten sonra kaydetmek için Uygula düğmesine tıklayın. Yeni profil, Dolphin Yerler panelinde bir kısayol olarak görünecektir.

### Profilleri Düzenlemek ve Silmek

Listedeki her profilin bir düzenleme ve bir silme işlemi vardır. Düzenleme, geçerli değerler önceden doldurulmuş olarak aynı iletişim kutusunu açar. Silme işlemi, profili kaldırmadan önce onay ister. Değişikliklerinizi kaydetmek için Uygula düğmesine tıklamayı unutmayın.

## AWS Kimlik Bilgileri

KIO S3, S3 hizmetleriyle kimlik doğrulaması yapmak için standart AWS kimlik bilgileri zincirini kullanır. Kimlik bilgileri, birden fazla adlandırılmış profil içerebilen `~/.aws/credentials` dosyasından okunur:

    [default]
    aws_access_key_id = ANAHTAR_KİMLİĞİNİZ
    aws_secret_access_key = GİZLİ_ERİŞİM_ANAHTARINIZ

    [bulutum]
    aws_access_key_id = BULUT_KİMLİĞİNİZ
    aws_secret_access_key = BULUT_ERİŞİMİ_ANAHTARINIZ

Her KIO S3 profili, hangi kimlik bilgileri bölümünün kullanılacağını seçmek için AWS profili alanını kullanır. Örneğin, AWS profili değeri `mycloud` olarak ayarlanmış bir profil, yukarıdaki `[bulutum]` bölümündeki kimlik bilgilerini kullanacaktır.

Hiçbir profil yapılandırılmamışsa KIO S3, çevre değişkenlerini (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`), `~/.aws/credentials` dosyasındaki `[default]` bölümünü ve EC2 örnek rollerini içeren öntanımlı AWS kimlik bilgileri zincirini kullanır.

İsteğe bağlı olarak, `~/.aws/config` dosyasını kullanarak bölgeyi ayarlayabilirsiniz:

    [default]
    region = eu-west-1

    [profile bulutum]
    region = auto

`~/.aws/config` dosyasında, adlandırılmış profiller `profile` önekini kullanır (örneğin, `[profile bulutum]`); ancak `~/.aws/credentials` dosyasında önek kullanılmaz (örneğin, `[mycloud]`). Bu, AWS SDK’sının (yazılım geliştirme kitinin) bir kuralıdır.

## URL Şeması

KIO S3, `s3://` URL şemasını kullanır. Bu URL’leri doğrudan Dolphin adres çubuğuna yazabilir veya `kioclient` gibi komut satırı araçlarıyla kullanabilirsiniz.

`s3://`

- Öntanımlı AWS kimlik bilgileriyle kullanılabilen tüm kovaları listeler.

`s3://`kovam`/`

- `kovam` içeriğini listeler.

`s3://`kovam`/`dosyaya/olan/yol/dosya.txt``

- Depolama alanındaki belirli bir dosyaya erişir.

`s3://@`profil`/`

- Belirtilen profilde bulunan tüm kovaları listeler.

`s3://`kovam`@`profil`/`

- Belirtilen profildeki `kovam` içeriğini listeler.

`s3://`kovam`@`profil`/`dosyaya/olan/yol/dosya.txt``

- Belirtilen profildeki belirli bir dosyaya erişir.

Sistem Ayarları bölümünde bir profil eklediğinizde, Dolphin Yerler panelinde kendiliğinden bir kısayol oluşturulur. Bu kısayola tıklayarak profilin kovalarını kolayca görüntüleyebilirsiniz.

## Dosyalara Göz Atmak

Dolphin uygulamasını açın ve adres çubuğuna `s3://` yazarak S3 kovalarınızı görüntüleyin. İçeriğine göz atmak için bir kovaya tıklayın. Klasörler ve dosyalar tıpkı yerel bir dosya sisteminde olduğu gibi görünür.

Belirli bir profili görüntülemek için `s3://@`profil`/` yazın veya Yerler panelindeki profil kısayoluna tıklayın.

Dolaşma beklendiği gibi çalışır: Yol gösterici çubuğu, geri ve ileri düğmelerini ve konum çubuğunu kullanabilirsiniz. Ayrıca S3 konumlarını yeni sekmelerde açabilirsiniz.

## Dosya İşlemleri

### Dosyaları Karşıya Yüklemek

Yerel dosya sisteminizden dosyaları sürükleyip Dolphin içindeki bir S3 klasörüne bırakabilirsiniz. Kopyala–Yapıştır yöntemini de kullanabilirsiniz. Büyük dosyalar, aşırı bellek kullanımını önlemek için çok parçalı yükleme yöntemiyle kendiliğinden yüklenir.

### Dosyalar İndirmek

S3 klasöründeki dosyaları yerel bir klasöre sürükleyin veya kopyala–yapıştır yöntemini kullanın. Ayrıca S3 dosyalarını doğrudan uygulamalarda da açabilirsiniz; dosya geçici bir konuma indirilecek ve orada açılacaktır.

### Kopyalamak

Aynı S3 hizmeti içindeki dosyaları kopyala–yapıştır veya sürükle–bırak yöntemleriyle kopyalayabilirsiniz. Kopyalama işlemi sunucu tarafında gerçekleştirildiğinden, dosyayı indirip yeniden yüklemenize gerek yoktur.

### Yeniden Adlandırmak

Dolphin uygulamasında bir dosya veya klasörü yeniden adlandırmak için F2 düğmesine basın. S3’ün yerleşik bir yeniden adlandırma işlemi olmadığından, KIO S3 sunucu tarafında yeni adla bir kopyalama işlemi gerçekleştirir ve ardından özgün dosyayı siler. Klasörler için, klasör içindeki tüm dosyalar tek tek kopyalanır ve silinir.

### Silmek

Dosyaları veya klasörleri seçin ve Sil düğmesine basın. Bir klasörü sildiğinizde, içindeki tüm dosyalar ve alt klasörler de kendiliğinden silinir.

### Klasörler Oluşturmak

Bir kova içinde yeni bir klasör oluşturmak için F10 düğmesine basın veya Yeni Oluştur Klasör… seçeneğini kullanın.

## Birden Çok Profille Çalışmak

Birden fazla S3 uyumlu hizmet kullanıyorsanız (örneğin, biri yedeklemeler için, diğeri web sitesi varlıkları için), her biri için bir profil yapılandırabilir ve herhangi bir yapılandırma dosyasını veya çevre değişkenini değiştirmeden bunlar arasında geçiş yapabilirsiniz.

Her profil, Dolphin Yerler panelinde ayrı bir kısayol olarak görünür. Bir profil kısayoluna tıklamak, o hizmette bulunan kovaları gösterir. Tüm işlemler (yükleme, indirme, kopyalama, yeniden adlandırma, silme) her profil içinde bağımsız olarak çalışır.

Farklı profiller arasında dosya kopyalama veya yeniden adlandırma desteklenmemektedir. S3 sunucu tarafı kopyalama yalnızca tek bir hizmet içinde çalışır. Dosyaları profiller arasında taşımak için önce yerel bir klasöre kopyalayın, ardından diğer profile yükleyin.

## Bilinen Sınırlamalar

- Kova oluşturma ve silme işlemleri desteklenmemektedir. Kovaları yönetmek için sağlayıcının web konsolunu veya komut satırı arayüzü araçlarını kullanın.

- Dolphin uygulamasında gösterilen dosya izinleri kozmetiktir. S3, UNIX izinleriyle eşleşmeyen kendi erişim denetim modelini (IAM politikaları ve kova politikaları) kullanır.