Vultr Object Storage

• Что такое хранилище объектов?
• Как я могу заказать хранение объектов?
• Как я могу использовать хранилище объектов?
• s3cmd: пример инструмента CLI
• Cyberduck: пример графического инструмента
• Техническая информация

S3-совместимое * хранилище объектов теперь доступно в облаке Vultr. Наша технология хранения объектов является доступной, масштабируемой и легко интегрируемой в существующие решения. Эта статья содержит обзор хранилища объектов и инструкции по началу работы с ним.

Что такое хранилище объектов?

Хранилище объектов - это веб-сервис для хранения и поиска файлов. Файлы называются «объектами». К объектам, загруженным в хранилище объектов, можно получить доступ в частном или публичном доступе в Интернете. Хранилище объектов поддерживает практически неограниченное количество объектов.

Варианты использования для хранения объектов включают в себя:

• Размещайте статические ресурсы сайта (изображения, javascript, css, медиа-файлы).
• Поделитесь программным обеспечением или бизнес-файлами.
• Резервное копирование и восстановление решений.
• Храните большое количество предметов.
• Устраните необходимость управлять и расширять файловое хранилище.

Как я могу заказать хранение объектов?

На портале для клиентов Vultr в верхней части страницы отображается пункт меню «Объекты». Это приведет вас к списку подписки на хранилище объектов .

На странице списка подписки вам будут представлены ссылки для заказа хранилища объектов и управления существующими подписками хранилища объектов.

Как я могу использовать хранилище объектов?

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

Хранилище объектов Vultr является S3-совместимым *. Это означает, что он совместим с большинством инструментов, разработанных для Amazon S3.

Ключевые понятия

Хранилище объектов приобретается на Vultr через подписки . Одна подписка предоставляет вам фиксированный объем хранилища в данном месте. Каждая подписка изолирована и имеет собственный набор ключей доступа S3. Если вы хотите хранить объекты как в Нью-Джерси, так и в Лос-Анджелесе, вам необходимо приобрести две подписки.

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

Существует множество S3-совместимых программ. Программное обеспечение, которое вы можете использовать, зависит от ваших личных предпочтений и операционной системы вашего компьютера. Как инструменты на основе CLI, так и графические инструменты обычно доступны. Ниже мы приведем несколько примеров в этом документе.

Объекты хранятся в ведрах. Прежде чем вы сможете начать загрузку объектов, вам нужно создать хотя бы одно ведро. Ведра похожи на папки в файловой системе. Имена ковшей уникальны в любом месте. Например, я не мог создать два ведра с именем mybucketв Нью-Джерси. См. «Правила именования сегментов» для получения дополнительной информации.

Ковши доступны в Интернете по имени. Например, если я создал ведро с именем mybucketв Нью - Джерси, ковш будет доступен на , https://mybucket.ewr1.vultrobjects.com/а также https://ewr1.vultrobjects.com/mybucket/. Часть ewr1.vultrobjects.comимени хоста зависит от региона и может указываться в списке подписки на хранилище объектов .

Объекты загружаются в ведра. В большинстве инструментов S3 объекты по умолчанию являются «частными». Это означает, что вам понадобятся ключи доступа S3 для загрузки объекта. Файлы также можно сделать общедоступными, сделав их доступными в Интернете. Загрузка photo.jpgв mybucket, а затем установка разрешения «public» сделает файл доступным по адресу https://mybucket.ewr1.vultrobjects.com/photo.jpg.

s3cmd: пример инструмента CLI

S3cmd - это клиент командной строки S3 для Linux и Mac. Наша протестированная версия была 2.0.2.

Сначала вам нужно будет настроить s3cmd.

s3cmd --configure

Мастер задаст вам несколько вопросов. Используйте значения, указанные в подписке на хранилище объектов, для вопросов ниже. Заменить access123, secret123и ewr1.vultrobjects.comсоответственно.

Access key: access123
Secret key: secret123
...
S3 Endpoint: ewr1.vultrobjects.com
DNS style bucket+hostname:port: %(bucket)s.ewr1.vultrobjects.com
...

После завершения работы мастера вы можете использовать s3cmdдоступ к хранилищу ваших объектов.

# make bucket
s3cmd mb s3://mybucket

# remove bucket
s3cmd rb s3://mybucket

# list buckets
s3cmd ls

# list files in bucket
s3cmd ls s3://mybucket

# upload file, private access
s3cmd put photo.jpg s3://mybucket/photo.jpg

# upload file, public access
s3cmd put -P photo.jpg s3://mybucket/photo.jpg

# download file
s3cmd get s3://mybucket/photo.jpg

# delete file
s3cmd rm s3://mybucket/photo.jpg

# change access on file to public
s3cmd setacl s3://mybucket/photo.jpg --acl-public

# change access on file to private
s3cmd setacl s3://mybucket/photo.jpg --acl-private

# enable directory listing on a bucket
s3cmd setacl s3://mybucket/ --acl-public

# disable directory listing on a bucket
s3cmd setacl s3://mybucket/ --acl-private

Дополнительные примеры см. На s3cmdстранице man.

Cyberduck: пример графического инструмента

Cyberduck - графический файловый менеджер для Windows и Mac. Он поддерживает S3, FTP и многие популярные сервисы обмена файлами. Наша протестированная версия была 6.8.2.

Подключитесь к хранилищу объектов Vultr, нажав «Открыть соединение».

The "Open Connection" dialog will appear. You need to specify "Server", "Access Key ID", and "Password". Use the values provided with your object storage subscription.

• "Server" is the S3 hostname ( ewr1.vultrobjects.com ).
• "Access Key ID" is the S3 access key.
• "Password" is the S3 secret key.

Click the "Connect" button to connect. Afterwards, you can manage files with Cyberduck.

# create bucket
Choose "File, New Folder" from the menu, or right click in the file area and choose "New Folder". The folder name is the bucket name.

# remove bucket
Right click on a bucket, click "Delete".

# upload file
Drag and drop a file from your computer onto the bucket.

# download file
Right click on a file, click "Download As...".

# delete file
Right click on a file, click "Delete".

# change access on file to public
Right click on a file, click "Info". Go to the "Permissions" tab. Click the gear on the lower left corner, and choose "Everyone" from the menu. Set the "Permission" dropdown to "READ" for the "Everyone" ACL table entry. Close the "Info" window.

# change access on file to private
Right click on a file, click "Info". Go to the "Permissions" tab. If "Everyone" appears in the "Access Control List (ACL)", click the gear on the lower left corner and remove the entry. Close the "Info" window.

# enable directory listing on a bucket
Right click on a bucket, click "Info". Go to the "Permissions" tab. Click the gear on the lower left corner, and choose "Everyone" from the menu. Set the "Permission" dropdown to "READ" for the "Everyone" ACL table entry. Close the "Info" window.

# disable directory listing on a bucket
Right click on a bucket, click "Info". Go to the "Permissions" tab. If "Everyone" appears in the "Access Control List (ACL)", click the gear on the lower left corner and remove the entry. Close the "Info" window.

Technical information

Rate Limits

Object storage has a rate limit of 400 requests per second. If your application requires higher request volumes, we recommend deploying a caching proxy in front of your object storage for performance and security.

Rules on bucket naming

• Bucket names must be unique per location.
• Bucket names must begin and end with a lowercase letter.
• Bucket names may contain a dash (-).
• Bucket names max length is 255 characters.
• Bucket names longer than 63 characters cannot be accessed when using a virtual bucket host name, for example: "mylongbucketname.ewr1.vultrobjects.com". For longer bucket names, the top-level directory method must be used, such as "ewr1.vultrobjects.com/mylongbucketname".

S3-compatibility

The table below lists compatibility between Vultr object storage and the S3 protocol. Compatibility may be further limited depending on the S3 tool used to access Vultr object storage.

For download requests, the "Content-Length" header may not match the size of the file. This is because we use gzip on our webservers to improve performance. In the rare event that this is causing issues for your automation system, you can disable gzip on requests. The libcloud project is being updated to support this behavior.