Подключение к хранилищу S3

Вы можете управлять подключением к объектному хранилищу S3 в интерфейсе DataSphere на странице проекта с помощью ресурса Коннектор S3.

Чтобы подключиться к объектному хранилищу из кода ноутбука, воспользуйтесь инструкцией Подключение к S3 с помощью библиотеки boto3.

Перед началом работыПеред началом работы

Получите ключ доступа у вашего S3-провайдера. Чтобы сделать это в Yandex Object Storage:

1. Создайте сервисный аккаунт.
2. Назначьте созданному аккаунту роль, которая разрешит либо только чтение, либо чтение и запись.
3. Создайте ключ доступа для сервисного аккаунта.

Создать коннектор S3Создать коннектор S3

1. Выберите нужный проект в своем сообществе или на главной странице DataSphere во вкладке Недавние проекты.

2. (Опционально) В правом верхнем углу нажмите кнопку Создать ресурс. Во всплывающем окне выберите Секрет и создайте секрет с секретной частью статического ключа доступа для сервисного аккаунта. Вы также сможете создать секрет при создании подключения S3.
3. В правом верхнем углу нажмите кнопку Создать ресурс. Во всплывающем окне выберите Коннектор S3.
4. Заполните поля:

   • Имя — имя создаваемого коннектора. Требования к имени:

     • Длина — от 3 до 63 символов.
     • Может содержать строчные и заглавные буквы латинского и русского алфавита, цифры, дефисы, подчеркивания и пробелы.
     • Первый символ должен быть буквой. Последний символ не может быть дефисом, подчеркиванием или пробелом.

   • (Опционально) Описание создаваемого коннектора.

   • Эндпоинт — хост хранилища. Для Object Storage это https://storage.yandexcloud.net/.

   • Бакет — имя бакета в хранилище.

     Важно

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

   • Имя раздела при подключении — название тома при монтировании бакета в файловую систему проекта. Требования к названию:

     • длина — от 2 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • Идентификатор статического ключа доступа, который используется для подключения к хранилищу.

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

   • Режим работы — режим доступа к объектному хранилищу: Только чтение или Чтение и запись.

5. Нажмите кнопку Создать.

Подключить хранилище S3 к проектуПодключить хранилище S3 к проекту

Перейдите на страницу коннектора S3 и нажмите кнопку Активировать. После активации бакет будет доступен в интерфейсе JupyterLab в файловом менеджере в папке /s3/, и его можно будет просматривать как файловую систему.

Использовать хранилище S3 в проектеИспользовать хранилище S3 в проекте

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

Отключить хранилище S3Отключить хранилище S3

1. На странице проекта в разделе Ресурсы проекта нажмите Коннектор S3.
2. Выберите коннектор и перейдите на страницу ресурса.
3. Нажмите кнопку Деактивировать в правом верхнем углу страницы.

Вы сможете повторно подключить хранилище S3 к проекту, когда это будет необходимо.

Поделиться коннектором S3Поделиться коннектором S3

1. Выберите нужный проект в своем сообществе или на главной странице DataSphere во вкладке Недавние проекты.

2. В блоке Ресурсы проекта нажмите Коннектор S3.
3. Выберите нужный коннектор S3 в списке.
4. Перейдите на вкладку Доступ.
5. Включите опцию видимости напротив названия сообщества, с которым нужно поделиться коннектором S3.

Чтобы коннектор S3 стал доступен для работы в другом проекте, администратор проекта должен добавить его на вкладке Доступные.

Удалить коннектор S3Удалить коннектор S3

Вы можете удалить только деактивированный коннектор, недоступный в сообществе.

1. Выберите нужный проект в своем сообществе или на главной странице DataSphere во вкладке Недавние проекты.

2. В блоке Ресурсы проекта нажмите Коннектор S3.
3. В списке коннекторов S3 выберите тот, который хотите удалить. Нажмите и выберите Удалить.
4. Нажмите Подтвердить.

Отобразится сообщение о том, что секрет удален.