[go: up one dir, main page]
Перейти к основному содержимому

s3fs

Последнее изменение:

s3fs — это программа с открытым исходным кодом для Linux и macOS. С помощью s3fs можно примонтировать бакет в папку на устройстве и работать с ним как с обычной папкой, пока он примонтирован.

Настроить s3fs
  1. Установите клиент.
  2. Настройте доступ к S3.
  3. Монтируйте бакет.
1. Установить клиент

Используйте инструкцию Installation в GitHub s3fs-fuse.

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

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

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

  2. Выдайте пользователю S3-ключ.

  3. Откройте CLI.

  4. В файле ~/.passwd-s3fs сохраните S3-ключ:

    echo <access_key>:<secret_key> > ~/.passwd-s3fs

    Укажите:

    • <access_key> — значение поля Access key из S3-ключа;
    • <secret_key> — значение поля Secret key из S3-ключа.

  5. Ограничьте доступ к файлу ~/.passwd-s3fs:

    chmod 600 ~/.passwd-s3fs
3. Монтировать бакет

Бакет будет монтирован в папку на вашем устройстве. При каждой перезагрузке системы бакет будет размонтирован.

Вы можете:

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

  1. Откройте CLI.

  2. Создайте пустую папку:

    mkdir ~/<local_folder>

    Укажите <local_folder> — имя папки.

  3. Монтируйте бакет:

    s3fs <bucket_name> <path> -o passwd_file=~/.passwd-s3fs -o allow_other -o use_path_request_style -o endpoint=<pool> -o url=https://<s3_domain>

    Укажите:

    • <bucket_name> — имя бакета;
    • <path> — путь до локальной папки, в которую будет монтирован бакет;
    • -o allow_other — опционально: параметр, который разрешает доступ к папке с бакетом другим пользователям на устройстве. Если не указать параметр, работать с папкой сможет только текущий пользователь;
    • -o use_path_request_style — опционально: параметр, который включает Path-style адресацию. Если не указать параметр, будет использована Virtual-Hosted адресация;
    • <pool> — пул, в котором находится S3;
    • <s3_domain> — домен S3 API, зависит от пула, в котором находится S3.