# kio-s3

## Вступ

KIO S3 — це засіб обробки даних KIO, який надає змогу переглядати файли та керувати файлами, що зберігаються в Amazon S3 та сумісних з S3 службах зберігання даних (зокрема Cloudflare R2, DigitalOcean Spaces, MinIO та інші), безпосередньо з Dolphin та інших програм KDE.

З KIO S3 ви можете:

- Здійснювати навігацію кошиками та теками

- Вивантажувати і отримувати файли

- Копіювати, перейменовувати та вилучати файли і теки

- Створювати теки у кошиках

- Встановлювати з'єднання з декількома сумісними з S3 службами одночасно з використанням іменованих профілів

## Налаштовування профілів

У KIO S3 передбачено підтримку встановлення з'єднання із сумісними з S3 службами зберігання даних з використанням іменованих профілів. Кожен профіль зберігає параметри з'єднання для однієї служби. Ви можете керувати профілями на сторінці Системні параметри Мережа Модулі S3.

### Додавання профілю

Натисніть кнопку Додати профіль... і заповніть такі поля:

Назва

- Описова назва профілю (обов'язкова), наприклад `Моє сховище у хмарі`.

Адреса кінцевої точки

- Адреса сумісної із S3 служби, наприклад `https://s3.example.com`. Не заповнюйте, якщо хочете скористатися типовою кінцевою точкою S3 Amazon.

Область

- Область сховища, наприклад `us-east-1` або `auto`. Не заповнюйте, якщо хочете скористатися областю з ваших налаштувань AWS.

Профіль AWS

- Назва профілю реєстраційних даних з `~/.aws/credentials`. Якщо не заповнювати, як назву профілю реєстраційних даних буде використано ідентифікатор профілю.

Використовувати адреси S3 у стилі шляхів

- Увімкніть це для служб, у яких не передбачено підтримки адресації у стилі віртуального розміщення, зокрема MinIO або деяких розгортань Ceph. Більшість служб, зокрема Amazon S3 та Cloudflare R2, цього не потребують.

Після додавання профілю натисніть кнопку Застосувати, щоб зберегти зміни. Новий профіль буде показано як пункт на панелі «Місця» Dolphin.

### Редагування і вилучення профілів

Для кожного профілю у списку передбачено кнопки редагування та вилучення. Кнопка редагування відкриває те саме діалогове вікно з попередньо заповненими поточними значеннями. У відповідь на натискання кнопки вилучення програма попросить підтвердити дію перед вилученням профілю. Не забудьте натиснути кнопку Застосувати, щоб зберегти зміни.

## Реєстраційні дані AWS

У KIO S3 для розпізнавання у службах S3 використано стандартний ланцюжок облікових даних AWS. Облікові дані зчитуються з файла `~/.aws/credentials`, де може зберігатися декілька іменованих профілів:

    [default]
    aws_access_key_id = ВАШ_КЛЮЧ
    aws_secret_access_key = ВАШІ_РЕЄСТРАЦІЙНІ_ДАНІ

    [mycloud]
    aws_access_key_id = ВАШ_КЛЮЧ_ДО_ХМАРИ
    aws_secret_access_key = ВАШІ_РЕЄСТРАЦІЙНІ_ДАНІ_ДО_ХМАРИ

У кожному профілі KIO S3 для вибору використаного розділу реєстраційних даних використано поле Профіль AWS. Наприклад, профіль, у якому для Профіль AWS встановлено значення `mycloud`, використовуватиме облікові дані з розділу `[mycloud]` вище.

Якщо профілі не налаштовано, у KIO S3 буде використано типовий ланцюжок облікових даних AWS, зокрема змінні середовища (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`), розділ `[default]` у `~/.aws/credentials` та ролі екземпляра EC2.

Ви можете, не обов'язково, встановити область за допомогою `~/.aws/config`:

    [default]
    region = eu-west-1

    [profile mycloud]
    region = auto

У `~/.aws/config` для іменованих профілів використовують префікс `profile` (наприклад, `[profile mycloud]`), тоді як у `~/.aws/credentials` префікс не використовується (наприклад, `[mycloud]`). Це узгоджені правила AWS SDK.

## Схема адрес

У KIO S3 використано схему адрес `s3://`. Ви можете вводити такі адреси безпосередньо до рядка адреси Dolphin або використовувати їх за допомогою інструментів командного рядка, таких як `kioclient`.

`s3://`

- Виводить список усіх кошиків, які доступні за типовими реєстраційними даними AWS.

`s3://`мій_кошик`/`

- Виводить список вмісту `мій_кошик`.

`s3://`мій_кошик`/`шлях/до/файл.txt``

- Надає доступ до певного файла у кошику.

`s3://@`профіль`/`

- Виводить список усіх кошиків, які доступні для іменованого профілю.

`s3://`мій_кошик`@`профіль`/`

- Виводить список вмісту `мій_кошик` на іменованому профілі.

`s3://`мій_кошик`@`профіль`/`шлях/до/файл.txt``

- Надає доступ до вказаного файла у іменованому профілі.

Після додавання профілю у Системних параметрах буде автоматично створено пункт на панелі «Місця» Dolphin. Ви можете просто натиснути цей пункт, щоб перейти до навігації кошиками профілю.

## Навігація файлами

Відкрийте Dolphin та введіть `s3://` до рядка адреси, щоб побачити ваші кошики S3. Натисніть пункт кошика, щоб переглянути його вміст. Кошики та файли буде показано так само, як і в локальній файловій системі.

Щоб перейти до навігації певним профілем, введіть `s3://@`профіль`/` або натисніть пункт профілю на панелі «Місця».

Навігація працює типовим чином: ви можете використовувати панель навігації, кнопки «Назад» та «Вперед», а також панель адреси. Ви також можете відкривати місця S3 у нових вкладках.

## Дії над файлами

### Вивантаження файлів

Перетягніть файли з вашої локальної файлової системи та помістіть їх до теки S3 у Dolphin. Ви також можете використовувати копіювання та вставлення. Великі файли автоматично завантажуються за допомогою частинного завантаження, щоб уникнути надмірного використання пам’яті.

### Отримання файлів

Перетягніть файли з теки S3 до локальної теки або скористайтеся копіюванням зі вставленням. Ви також можете відкривати файли S3 безпосередньо в програмах — файл буде завантажено до тимчасової теки, а потім відкрито.

### Копіювання

Ви можете копіювати файли в межах однієї служби S3 за допомогою копіювання зі вставленням або перетягування. Копіювання виконується на боці сервера, тому не потрібно отримувати файл, а потім повторно вивантажувати його.

### Перейменування

Натисніть F2 у Dolphin, щоб перейменувати файл або теку. Оскільки у S3 не передбачено вбудованої дій з перейменування, KIO S3 виконує копіювання на боці сервера з новою назвою, а потім вилучає оригінал. Для тек усі файли всередині теки буде скопійовано і вилучено окремо.

### Вилучення

Позначте файли або теки та натисніть клавішу Delete. Під час вилучення теки всі файли та підтеки всередині неї буде вилучено рекурсивно.

### Створення тек

Натисніть клавішу F10 або скористайтеся пунктом меню Створити Тека..., щоб створити теку у кошику.

## Робота з декількома профілями

Якщо ви використовуєте декілька сумісних із S3 служб (наприклад, одну для резервних копій, а іншу для ресурсів сайта), ви можете налаштувати профіль для кожної з них і перемикатися між ними, не змінюючи жодних файлів налаштувань чи змінних середовища.

Кожен профіль буде показано як окремий пункт на панелі «Місця» програми Dolphin. У відповідь на натискання пункту профілю програма покаже доступні у цій службі кошики. Усі дії (вивантаження, отримання, копіювання, перейменування, вилучення) працюють незалежно в кожному профілі.

Підтримки копіювання або перейменовування файлів між різними профілями не передбачено. Копіювання на боці сервера S3 працює лише в межах однієї служби. Щоб перемістити файли між профілями, спочатку скопіюйте їх до локальної теки, а потім вивантажте до іншого профілю.

## Відомі обмеження

- Підтримки створення і вилучення кошиків не передбачено. Для керування кошиками скористайтеся вебконсоллю або інструментами командного рядка надавача послуг.

- Права доступу до файлів, які буде показано у Dolphin, є косметичними. S3 використовує власну модель керування доступом (правила IAM та правила кошика), яка не збігається із правилами доступу у Unix.