MinIO Client

MinIO Client — интерфейс командной строки, который поддерживает подключение к S3-совместимым облачным сервисам и предлагает современный аналог классических UNIX-команд для работы с файлами и папками.

Настроить MinIO Client

Настройте доступ к S3.
Установите клиент.
Настройте клиент.

1. Настроить доступ к S3

Настроить доступ может Владелец аккаунта или пользователь с ролью iam_admin.

Создайте сервисного пользователя с ролью с доступом в S3. Если вы используете сервисного пользователя с ролью object_storage_user или s3.bucket.user, в бакете должна быть настроена политика доступа.
Выдайте пользователю S3-ключ.

2. Установить клиент

Linux
Windows
macOS

Откройте CLI.

Установите клиент:

curl https://dl.min.io/client/mc/release/linux-amd64/mc \
    --create-dirs \
    -o $HOME/minio-binaries/mc

chmod +x $HOME/minio-binaries/mc
export PATH=$PATH:$HOME/minio-binaries/

На официальном сайте разработчика скачайте MinIO Client.
Добавьте папку MinIO Client в переменную PATH:

2.1. В поиске Windows введите Изменение системных переменных среды.

2.2. Нажмите Переменные среды.

2.3. Выберите параметр PATH.

2.4. Нажмите Изменить → Создать.

2.5. Добавьте путь к папке в список.

2.6. Нажмите OK → ОК.
Чтобы настройки переменных сред применились, перезагрузите устройство.
Убедитесь, что клиент установлен:

4.1. Откройте PowerShell.

4.2. Убедитесь, что клиент установлен:
```
mc --version
```
Если возникает ошибка с верификацией сертификата, для безопасного подключения:

5.1. В браузере перейдите по ссылке https://<s3_domain>. Укажите <s3_domain> — домен S3 API в зависимости от пула, в котором находится бакет.

5.2. В адресной строке нажмите и загрузите сертификат.

5.3. Скачайте сертификат и сохраните его на сервере.

5.4. Откройте файл сертификата.

5.5. Откройте вкладку Состав.

5.6. Нажмите Копировать в файл.

5.7. Сохраните файл в формате Base-64 encoded X.509 (.cer).

MinIO Client устанавливается с помощью менеджера пакетов Homebrew.

Откройте Terminal.
Установите клиент:
```
brew install minio/stable/mc
```

3. Настроить клиент

Добавьте алиас:
```
mc alias set <alias_name>  https://<s3_domain>
```
Укажите:
- <alias_name> — имя для алиаса (подключения);
- <s3_domain> — домен S3 API, зависит от пула, в котором находится S3.
В поле Enter Access Key укажите значение поля Access key из S3-ключа.
В поле Enter Secret Key укажите значение поля Secret key из S3-ключа.
Проверьте подключение:
```
mc ls <alias_name>
```
Укажите <alias_name> — имя алиаса.

В ответе появится список бакетов.

Работа с MinIO Client

Вывести список алиасов

Откройте CLI.
Выведите список алиасов:
```
mc alias list
```

Добавить алиас

Откройте CLI.
Добавьте алиас:
```
mc alias set <alias_name> https://<s3_domain>
```
Укажите:
- <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list;
- <s3_domain> — домен S3 API, зависит от пула, в котором находится S3.

Удалить алиас

Откройте CLI.
Удалите алиас:
```
mc alias remove <alias_name>
```
Укажите <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list.

Создать бакет

к сведению

Через MinIO Client можно создать бакет только со стандартным классом хранения.

Если вам нужен другой класс хранения, создайте бакет через другие инструменты или панель управления.

Откройте CLI.
Создайте бакет:
```
mc mb <alias_name>/<bucket_name>
```
Укажите:
- <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list;
- <bucket_name> — имя бакета.
Будет создан приватный бакет.
Опционально: измените тип бакета на публичный.

Вывести список бакетов

Откройте CLI.
Выведите список бакетов:
```
mc ls <alias_name>
```
Укажите <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list.

Включить версионирование

Откройте CLI.
Включите версионирование:
```
mc version enable <alias_name>/<bucket_name>
```
Укажите:
- <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list;
- <bucket_name> — имя бакета.

Приостановить версионирование

Откройте CLI.
Приостановите версионирование:
```
mc version suspend <alias_name>/<bucket_name>
```
Укажите:
- <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list;
- <bucket_name> — имя бакета.

Вывести список объектов в бакете

Откройте CLI.
Выведите список объектов в бакете:
```
mc ls <alias_name>/<bucket_name>
```
Укажите:
- <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list;
- <bucket_name> — имя бакета.

Загрузить объект

Откройте CLI.
Загрузите объект:
```
mc cp "/<local_path>" "<alias_name>/<bucket_name>/<object_name>"
```
Укажите:
- <local_path> — путь к файлу на устройстве;
- <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list;
- <bucket_name> — имя бакета;
- <object_name> — имя, с которым будет загружен объект.

Скачать объект или папку

Откройте CLI.
Скачайте объект или папку:
```
mc cp "<alias_name>/<bucket_name>/<path>" "/<download_path>"
```
Укажите:
- <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list;
- <bucket_name> — имя бакета;
- <path> — путь к объекту или папке в бакете S3;
- <download_path> — путь к папке на устройстве, куда будет скачан объект или папка.

Удалить объект или папку

Откройте CLI.
Удалите объект или папку:
```
mc rm "<alias_name>/<bucket_name>/<path>"
```
Укажите:
- <alias_name> — имя алиаса, можно посмотреть с помощью команды mc alias list;
- <bucket_name> — имя бакета;
- <path> — путь к объекту или папке в бакете S3.