Skip to content

Commit

Permalink
Merge pull request #2837 from andystevensname/hotfix-v0.24.2
Browse files Browse the repository at this point in the history
[Hotfix] v0.24.2
  • Loading branch information
andystevensname authored Oct 30, 2019
2 parents 98737bd + 1f0c5ff commit d22d756
Show file tree
Hide file tree
Showing 12 changed files with 48 additions and 20 deletions.
4 changes: 1 addition & 3 deletions docs/platform/object-storage/bucket-versioning/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,7 @@ external_resources:
---

{{< note >}}
[Linode Object Storage](/docs/platform/object-storage/) is currently in a closed early access Beta, and you may not have access to Object Storage through the Cloud Manager or other tools. To request access to the Early Access Program (EAP), [open up a Customer Support ticket](/docs/platform/billing-and-support/support/#contacting-linode-support) or e-mail [email protected]. Beta access is completely free.

Because Object Storage is in Beta, there may be breaking changes to how you access and manage Object Storage. This guide will be updated to reflect these changes if and when they occur. To view the changes that happen to this guide over time, visit the [source text for it on GitHub](https://github.com/linode/docs/blob/master/docs/platform/object-storage/bucket-versioning/index.md).
[Linode Object Storage](/docs/platform/object-storage/) is now available to the general public in the Newark data center! Starting November 1, 2019, all customers with objects stored in Object Storage buckets will be billed. For more information, see our [Object Storage Pricing and Limitations](/docs/platform/object-storage/pricing-and-limitations/) guide.
{{</ note >}}

Linode Object Storage allows for bucket versioning so that you can retain different versions of your objects within buckets. This makes it easy to save older versions of objects, as well as quickly revert to an object's previous state.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,7 @@ external_resources:
![Host a Static Site using Linode Object Storage](host-a-static-site-using-linode-object-storage.png "Host a Static Site using Linode Object Storage")

{{< note >}}
Object Storage is currently in a closed early access Beta, and you may not have access to Object Storage through the Cloud Manager or other tools. To gain access to the Early Access Program (EAP), open up a Customer Support ticket noting that you'd like to be included in the program, or e-mail [email protected] -- beta access is completely free.

Additionally, because Object Storage is in Beta, there may be breaking changes to how you access and manage Object Storage. This guide will be updated to reflect these changes if and when they occur.
[Linode Object Storage](/docs/platform/object-storage/) is now available to the general public in the Newark data center! Starting November 1, 2019, all customers with objects stored in Object Storage buckets will be billed. For more information, see our [Object Storage Pricing and Limitations](/docs/platform/object-storage/pricing-and-limitations/) guide.
{{</ note >}}

## Why Host a Static Site on Object Storage?
Expand Down Expand Up @@ -269,7 +267,7 @@ Error document: 404.html
{{</ output >}}

{{< note >}}
The Linode Object Storage early access Beta provides SSL enabled by default. This means you can access your Object Storage bucket using `https`, as well.
Linode Object Storage provides SSL enabled by default. This means you can access your Object Storage bucket using `https`, as well.
{{</ note >}}

1. Use s3cmd's `sync` command to upload the contents of your static site's `public` directory to your Object Storage bucket. This step will make your site available publicly on the Internet. Ensure you are in your site's root directory on your computer (e.g. `/home/username/example-site`):
Expand Down
34 changes: 25 additions & 9 deletions docs/platform/object-storage/how-to-use-object-storage/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,7 @@ external_resources:
![How to Use Linode Object Storage](how-to-use-linode-object-storage.png "How to Use Linode Object Storage")

{{< note >}}
Object Storage is currently in a closed early access Beta, and you may not have access to Object Storage through the Cloud Manager or other tools. To gain access to the Early Access Program (EAP), open up a Customer Support ticket noting that you'd like to be included in the program, or e-mail [email protected] -- beta access is completely free.

Additionally, because Object Storage is in Beta, there may be breaking changes to how you access and manage Object Storage. This guide will be updated to reflect these changes if and when they occur.
[Linode Object Storage](/docs/platform/object-storage/) is now available to the general public in the Newark data center! Starting November 1, 2019, all customers with objects stored in Object Storage buckets will be billed. For more information, see our [Object Storage Pricing and Limitations](/docs/platform/object-storage/pricing-and-limitations/) guide.
{{</ note >}}

Linode's Object Storage is a globally-available, S3-compatible method for storing and accessing data. Object Storage differs from traditional hierarchical data storage (as in a Linode's disk) and [Block Storage Volumes](https://www.linode.com/docs/platform/block-storage/). Under Object Storage, files (also called *objects*) are stored in flat data structures (referred to as *buckets*) alongside their own rich metadata.
Expand All @@ -44,6 +42,10 @@ In this guide you will learn:

- [Cyberduck](/docs/platform/object-storage/how-to-use-object-storage/#cyberduck)

## Enable Object Storage

Object Storage is not enabled by default. All that is required to enable Object Storage is to create a bucket or an access key. To cancel Object Storage, see the [Cancel Object Storage](#cancel-object-storage) section.

## Object Storage Key Pair

The first step towards using Object Storage is to create a pair of keys for the service. This pair is composed of an *access key* and a *secret key*:
Expand Down Expand Up @@ -72,6 +74,10 @@ Object Storage is not available in the Linode Classic Manager.

![Click on the 'Access Keys' tab.](object-storage-access-keys-tab.png)

1. A prompt will appear asking you to confirm that you'd like to enable Object Storage. Click **Enable Object Storage**.

![Enable Object Storage](object-storage-enable-object-storage.png)

2. The **Create an Access Key** menu will appear.

![The 'Create an Access Key' menu.](object-storage-create-key.png)
Expand Down Expand Up @@ -108,6 +114,8 @@ The Cloud Manager provides a web interface for creating buckets. To create a buc

![The Object Storage menu.](object-storage-add-a-bucket.png)

If you have not created an access key or a bucket before, you will be prompted to enable Object Storage.

1. The **Create a Bucket** menu will appear.

![The Create a Bucket menu.](object-storage-create-a-bucket.png)
Expand Down Expand Up @@ -163,13 +171,11 @@ You can drag and drop multiple files to the **Upload Files Pane** at one time.

![View all of your bucket's objects](view-your-objects.png)

1. Click on the ellipsis menu corresponding to the object you'd like to view. Then, select **Open**.
1. Click on the ellipsis menu corresponding to the object you'd like to view. Then, select **Download**.

![Open a bucket's object](open-an-object.png)
![Download a bucket's object](object-storage-download-object.png)

1. A browser window will open your object's unique URL and display your object. In the example, the browser displays a `.png` image.

![View your uploaded object in your browser](object-displayed-in-browser.png)
1. The object will be downloaded to your local computer.

### Delete Objects from a Bucket

Expand All @@ -185,7 +191,7 @@ You can drag and drop multiple files to the **Upload Files Pane** at one time.

1. Click on the ellipsis menu corresponding to the object you'd like to delete. Then, select **Delete**.

![Delete an object from your bucket](delete-object.png)
![Delete an object from your bucket](object-storage-delete-object.png)

1. A dialog box will appear prompting you to confirm if you'd like to delete the object. Click **Delete** to proceed. Once the object has been deleted, it will no longer be visible on the **Objects Listing Page**.

Expand Down Expand Up @@ -576,6 +582,16 @@ To create a static site from your bucket:

For more information on hosting a static website with Object Storage, read our [Host a Static Site using Linode Object Storage](/docs/platform/object-storage/host-static-site-object-storage/) guide.

## Cancel Object Storage

1. To cancel Object Storage, you must first delete all of your buckets. To delete a bucket, the bucket must be empty. For buckets that contain large amounts of objects, consider employing [lifecycle policies](/docs/platform/object-storage/lifecycle-policies/) to delete the objects.

1. Once you've deleted all of your buckets, navigate to the **Account** page in the left-hand navigation. Click on the *Settings* tab. In the menu, you should see a setting for Object Storage:

![Cancel Object Storage](object-storage-cancel-object-storage.png)

1. Click **Cancel Object Storage**. A prompt will appear asking you to confirm the cancellation. If you still have active buckets, you will be prompted to delete them.

## Next Steps

There are S3 bindings available for a number of programming languages, including the popular [Boto](https://github.com/boto/boto3) library for Python, that allow you to interact with Object Storage programmatically.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions docs/platform/object-storage/lifecycle-policies/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,10 @@ contributor:
name: Linode
---

{{< note >}}
[Linode Object Storage](/docs/platform/object-storage/) is now available to the general public in the Newark data center! Starting November 1, 2019, all customers with objects stored in Object Storage buckets will be billed. For more information, see our [Object Storage Pricing and Limitations](/docs/platform/object-storage/pricing-and-limitations/) guide.
{{</ note >}}

While deleting a few objects in an Object Storage bucket might not take that long, when the objects number in the thousands or even millions the time required to complete the delete operations can easily become unmanageable. When deleting a substantial amount of objects, it's best to use *lifecycle policies*. These policies can be represented in XML; here's an (incomplete) snippet of an action that will delete objects after 1 day:

{{< file >}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,10 @@ contributor:
name: Linode
---

{{< note >}}
[Linode Object Storage](/docs/platform/object-storage/) is now available to the general public in the Newark data center! Starting November 1, 2019, all customers with objects stored in Object Storage buckets will be billed. For more information, see our [Object Storage Pricing and Limitations](/docs/platform/object-storage/pricing-and-limitations/) guide.
{{</ note >}}

## What is Object Storage?

Object Storage is a method of storing data that differs in a number of ways from [Block Storage](/docs/platform/block-storage/how-to-use-block-storage-with-your-linode/). Block Storage splits files into small *blocks* of data. Minimal file metadata is stored alongside this data and, in general, descriptive metadata must be stored in a separate file or database. In order to use a Block Storage volume it must be attached to a host server, where it acts like a hard drive.
Expand Down
16 changes: 12 additions & 4 deletions docs/platform/object-storage/pricing-and-limitations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,23 +14,31 @@ contributor:
---

{{< note >}}
Object Storage is currently in a closed early access Beta, and you may not have access to Object Storage through the Cloud Manager or other tools. To gain access to the Early Access Program (EAP), open up a Customer Support ticket noting that you'd like to be included in the program, or e-mail [email protected] -- beta access is completely free. This guide reflects the policies that will be enacted when Object Storage is made available to the general public.
[Linode Object Storage](/docs/platform/object-storage/) is now available to the general public in the Newark data center! Starting November 1, 2019, all customers with objects stored in Object Storage buckets will be billed.
{{</ note >}}

Linode Object Storage offers affordable and full-featured cloud storage for unstructured data and static sites. This guide will outline Object Storage pricing, storage limitations, and data transfer quotas.

## Pricing

Linode Object Storage has a prorated minimum monthly cost of $5, which provides 250 gigabytes of storage. If you use Object Storage for a fraction of the month you will be charged a fraction of the cost. For example, if you have Object Storage enabled for half of the month and use up to 250 gigabytes of storage you will be billed $2.50 at the end of the month. Each additional gigabyte of storage over the first 250 gigabytes will cost $0.02, and this usage is also prorated based on usage time.
Linode Object Storage has a prorated minimum monthly cost of $5, which includes 250 gigabytes of storage. If you use Object Storage for a fraction of the month you will be charged a fraction of the cost. For example, if you have Object Storage enabled for half of the month and use up to 250 gigabytes of storage you will be billed $2.50 at the end of the month. Each additional gigabyte of storage over the first 250 gigabytes will cost $0.02, and this usage is also prorated based on usage time.

## Storage Limitations

Currently, Object Storage accounts are limited 10 terabytes of storage, or 100,000 objects, whichever comes first. Accounts can have up to 10 buckets.
Currently, Object Storage accounts are limited 10 terabytes of storage, or 100,000 objects, whichever comes first. Accounts can have up to 25 buckets.

{{< note >}}
If you need to increase the storage limit, the object limit, or the bucket limit, please [open up a Customer Support ticket](https://www.linode.com/docs/platform/billing-and-support/support/#contacting-linode-support).
{{</ note >}}

## Transfer Quotas

Object Storage adds 1 terabyte of outbound data transfer to your data transfer pool. This 1 terabyte of transfer data is prorated. If you use Object Storage for half of a month, only 500 gigabytes of transfer data will be added to your monthly transfer pool. At this time, all outbound data, including data transfer to a Linode in the same data center, is billable. You are not charged for uploading objects (inbound traffic) to Object Storage. Any further outbound data is charged at a rate of $0.02 a gigabyte. For more information on network transfer pools, review our [Network Transfer Quota guide](https://linode.com/docs/platform/billing-and-support/network-transfer-quota/).
Object Storage adds 1 terabyte of outbound data transfer to your data transfer pool. This 1 terabyte of transfer data is prorated. If you use Object Storage for half of a month, only 500 gigabytes of transfer data will be added to your monthly transfer pool. At this time, all outbound data, including data transfer to a Linode in the same data center, is billable. You are not charged for uploading objects (inbound traffic) to Object Storage, with the exception that uploading a object to Object Storage from a Linode over IPv4 is billable, as that is considered outbound traffic on your Linode. Any further outbound data is charged at a rate of $0.02 a gigabyte. For more information on network transfer pools, review our [Network Transfer Quota guide](https://linode.com/docs/platform/billing-and-support/network-transfer-quota/).

## Rate Limiting

Users accessing Object Storage resources are limited to 750 requests per second, per bucket.

{{< note >}}
The rate limits for Object Storage may be subject to change. This document will be updated to include any future changes.
{{</ note >}}

0 comments on commit d22d756

Please sign in to comment.