Yandex Object Storage + Python: загружаем файл в S3 через boto3

Object Storage можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. S3-совместимый API позволяет использовать boto3, меняя endpoint и учётные данные, а не переписывая работу с файлами. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.

Публичный бакет кажется самым простым решением, но раскрывает файлы; ключи в коде и неверный endpoint приводят к отдельным рискам и ошибкам. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте скрипт загрузки файла, проверки metadata и создания presigned URL на пять минут. Проверка: объект появляется под ожидаемым ключом, head_object показывает размер, временная ссылка открывается и затем истекает.

Как устроен учебный проект Object Storage

Object Storage разделяет подготовку, основное действие, проверку ответа и сохранение результата. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.

Контрольные точки: клиент, загрузка, проверка и ссылка. Следующий шаг начинается после совпадения с ожидаемым результатом.

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

Собираем рабочий пример шаг за шагом

Материал сверялся с официальной документацией сервиса 21 октября 2026 года. Установите boto3, задайте AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, YC_BUCKET и не печатайте секреты. Проверьте текущую папку через pwd или Get-Location. Вставьте пример целиком, выполните один раз, затем разбирайте по частям.

import os
from pathlib import Path
import boto3

BUCKET = os.environ["YC_BUCKET"]
s3 = boto3.client(
    "s3",
    endpoint_url="https://storage.yandexcloud.net",
    region_name="ru-central1",
)

def upload(filename: str, key: str) -> str:
    path = Path(filename)
    s3.upload_file(str(path), BUCKET, key, ExtraArgs={"ContentType": "text/plain"})
    metadata = s3.head_object(Bucket=BUCKET, Key=key)
    if metadata["ContentLength"] != path.stat().st_size:
        raise RuntimeError("Размер объекта не совпал")
    return s3.generate_presigned_url(
        "get_object", Params={"Bucket": BUCKET, "Key": key}, ExpiresIn=300
    )

print(upload("hello.txt", "demo/hello.txt"))

Код держит подготовку отдельно от внешнего действия, поэтому ошибку можно найти на конкретном шаге. Найдите в примере вход, проверку и место формирования результата.

Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.

Что происходит внутри и почему это работает

Bucket является контейнером, key задаёт имя объекта, endpoint направляет S3-клиент в нужное облако. Подпись запроса формируется из ключей окружения. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Секреты и персональные данные не должны попадать в репозиторий, журнал или публичный скриншот.

Object Storage не является обычной файловой системой: папки существуют как префиксы key, а переименование обычно означает копирование и удаление. Проектируйте ключи заранее. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.

Проверяем проект и добавляем свою функцию

Добавьте вычисление SHA-256 локального файла и сохраните хеш в metadata для последующей проверки. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.

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

Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.

Что запомнить и куда двигаться дальше

Для production выдавайте сервисному аккаунту минимальные роли, включите жизненный цикл и не делайте бакет публичным без необходимости. Для закрепления откройте в GitHub Actions для Python, в Docker Compose проекте и в публикации проекта на GitHub.

Как изучить тему в Кодике

Сначала разберите входные данные и один успешный вызов, затем изучайте дополнительные параметры. Сначала восстановите главную функцию и проверьте её на трёх значениях.

Перепишите ключевую функцию по памяти и проверьте её на корректном, пустом и ошибочном вводе. Базовый синтаксис закрепите через курс Python.

Что получится в итоге

Финальный экран показывает результат, состояние запроса и понятное сообщение об ошибке без раскрытия секретов.