Сховище обєктів Vultr

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.

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

Cyberduck — графічний файловий менеджер для Windows і Mac. Він підтримує S3, FTP і багато популярних файлообмінних служб. Наша тестована версія була 6.8.2.

Підключіться до сховища об’єктів Vultr, натиснувши «Відкрити підключення».

З'явиться діалогове вікно «Відкрити підключення». Вам потрібно вказати " Server", " Access Key ID" і " Password". Використовуйте значення, надані у вашій підписці на зберігання об’єктів.

• " Server" - це ім'я хоста S3 ( ewr1.vultrobjects.com).
• " Access Key ID" - це ключ доступу S3.
• " Password" - це секретний ключ S3.

Натисніть кнопку «Підключити», щоб підключитися. Після цього ви зможете керувати файлами за допомогою 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.

Технічна інформація

Межі ставок

Сховище об’єктів має обмеження швидкості 400 запитів на секунду. Якщо вашій програмі потрібні більші обсяги запитів, ми рекомендуємо розгорнути кешуючий проксі-сервер перед сховищем об’єктів для забезпечення продуктивності та безпеки.

Правила найменування відро

• Назви сегментів мають бути унікальними для кожного місця.
• Назви сегментів мають починатися та закінчуватися малою літерою.
• Назви сегментів можуть містити тире (-).
• Максимальна довжина назв сегментів становить 255 символів.
• Неможливо отримати доступ до імен сегментів, які довше 63 символів, якщо використовується ім’я хоста віртуального сегмента, наприклад: "mylongbucketname.ewr1.vultrobjects.com". Для довших імен сегментів слід використовувати метод каталогу верхнього рівня, наприклад "ewr1.vultrobjects.com/mylongbucketname".

S3-сумісність

У таблиці нижче наведено сумісність між сховищем об’єктів Vultr і протоколом S3. Сумісність може бути додатково обмежена залежно від інструменту S3, який використовується для доступу до сховища об’єктів Vultr.

Для запитів на завантаження заголовок "Content-Length" може не відповідати розміру файлу. Це тому, що ми використовуємо gzip на наших веб-серверах для підвищення продуктивності. У рідкісних випадках, коли це спричиняє проблеми для вашої системи автоматизації, ви можете вимкнути gzip на запити. Проект libcloud оновлюється, щоб підтримувати цю поведінку.