# Sử dụng tính năng Lifecycle

## **Tổng quan**

**Lifecycle** trên vStorage là tính năng giúp bạn quản lý vòng đời của các object trong bucket, từ đó giúp tối ưu chi phí lưu trữ. Với Lifecycle, bạn có thể cấu hình các quy tắc (rules) theo 2 loại:

* **Transition rule:** Rule hỗ trợ di chuyển object giữa các storage class. Bạn có thể thực hiện thiết lập một hoặc nhiều lifecycle rule di chuyển object nếu trong vòng N ngày mà object không được thay đổi.
* **Expiration rule**: Rule hỗ trợ xóa các object theo điều kiện ràng buộc. Bạn có thể thực hiện thiết lập một hoặc nhiều lifecycle rule xóa object sau một khoảng thời gian nhất định kể từ ngày object tồn tại trên hệ thống vStorage.

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-ece2a8cae0cdce37f83d7a513ef861a6e1a3341d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Tham khảo thêm bảng bên dưới để hiểu cách hoạt động của mỗi storage class:

<table data-full-width="true"><thead><tr><th>Item</th><th>Gold Class</th><th>Instant Archive</th><th>Archive</th></tr></thead><tbody><tr><td><strong>Được thiết kế cho</strong></td><td>Dành cho dữ liệu được truy cập thường xuyên, yêu cầu độ trễ thấp và thông lượng cao với thời gian truy xuất tính bằng <strong>mili giây (10 triệu object/ 1 giờ)</strong>.</td><td>Để lưu trữ dữ liệu lâu dài với khả năng truy xuất tính bằng <strong>mili giây (5 triệu object/ 1 giờ)</strong>.</td><td>Để lưu trữ dữ liệu dài hạn được truy cập một hoặc hai lần trong một năm với thời gian truy xuất theo <strong>giờ (5 triệu object/ 12 giờ và 10 triệu object/ 24 giờ).</strong></td></tr><tr><td><strong>Tính bền vững</strong></td><td>99.999999999%</td><td>99.999999999%</td><td>99.999999999%</td></tr><tr><td><strong>Tính sẵn sàng</strong></td><td>99.99%</td><td>99.99%</td><td>99.99%</td></tr><tr><td><strong>Quota tối thiểu</strong></td><td>No</td><td>No</td><td>5 TB</td></tr><tr><td><strong>Thời gian lưu trữ tối thiểu</strong></td><td>No</td><td>No</td><td>90 ngày</td></tr><tr><td><strong>Kích thước object tối thiểu</strong></td><td>0</td><td>0</td><td>128 KB</td></tr><tr><td>T<strong>raffic miễn phí</strong></td><td>Quota x 10</td><td>Quota x 2</td><td>Quota x1</td></tr><tr><td>R<strong>equest miễn phí</strong></td><td>Miễn phí request trên hiệu suất Gold Class</td><td>Miễn phí request trên miễn phí Instant Archive Class</td><td>Miễn phí request trên hiệu suất Archive Class</td></tr></tbody></table>

***

## Với Transition rule

Thực hiện theo hướng dẫn bên dưới để thiết lập transition rule:

1\. Đăng nhập vào [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list), sau đó chọn Region **HCM04**

2\. Chọn **project** chứa **bucket** bạn muốn thiết lập lifecycle. Giả sử tôi có một bucket `demo-project` đã được khởi tạo tạo Storage Class Gold như hình dưới:

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-4cbac5bd00ceaaf5580394b4196be2e2f7af3278%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

3\. Chọn biểu tượng **Action** và chọn **Configure Lifecycle.**

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-583b7d83f7245f251f9315be536906fa48189466%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

4\. Màn hình **Lifecycle** được hiển thị. Chọn **Create a lifecycle rule**.

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-2d877dd63584e6b63b77279f30481e292d7a6687%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

5\. Nhập **Rule name**. Rule name mà chúng tôi cho phép bạn nhập bao gồm các chữ cái (a-z, A-Z, 0-9, '\_', '-', space). Độ dài **Rule name** của bạn phải nằm trong khoảng từ 5 đến 50.

6\. Chọn **Rule type**: **Transition**

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-e40f52d65c50495b51523dc111440f349c5a64a3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

7\. Nhập **Filter**. Filter này được áp dụng cho một lifecycle rule cụ thể. **Mỗi lifecycle rule chỉ được đặt 1 filter duy nhất, nếu bạn muốn áp dụng quy tắc lifecycle mà bạn đang tạo lên tất cả các object thuộc bucket này, hãy để trống trường thông tin này.** Hoặc bạn có thể lọc các object mong muốn áp dụng lifecycle rule thông qua prefix.

8\. Chọn hành động xảy ra với object tại bucket mà bạn chọn, bao gồm:

* **Transition current version of objects:**

  * Khi kích hoạt, rule này sẽ tự động di chuyển **phiên bản hiện tại** object từ lớp lưu trữ hiện tại xuống lớp lưu trữ thấp hơn tùy chọn sau một khoảng thời gian nhất định.
  * Bạn có thể nhập số ngày trong phần "**After \_\_\_ days from object creation**" để định nghĩa số ngày object được di chuyển nếu không có thay đổi.

  <figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-66d264ace0c4e410412b379423405a7f0e2b88fd%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
* **Transition noncurrent version of objects:**

  * Khi kích hoạt, rule này sẽ tự động di chuyển **phiên bản không phải là phiên bản hiện tại** (noncurrent versions) object từ lớp lưu trữ hiện tại xuống lớp lưu trữ thấp hơn tùy chọn sau một khoảng thời gian nhất định.
  * Bạn có thể nhập số ngày trong phần "**After \_\_\_ days become noncurrent version**" để định nghĩa số ngày object được di chuyển nếu không có thay đổi.

  <figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-b22205ad5f6133f696d774d4d0d200c515a9dc5d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Với Expiration rule

Expiration rule là tập quy định tự động xóa object khi đến thời điểm hết hạn. Thực hiện theo hướng dẫn bên dưới để thiết lập expiration rule:

1\. Đăng nhập vào [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).

2\. Chọn **project** chứa **bucket** bạn muốn thiết lập lifecycle.

3\. Chọn biểu tượng **Action** và chọn **Configure Lifecycle.**

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2FfWMhzxmKET3C7ojZqCxD%2Fimage.png?alt=media&#x26;token=3501c6ac-0c54-43ae-99ca-064c2f829c0f" alt=""><figcaption></figcaption></figure>

4\. Màn hình **Lifecycle** được hiển thị. Chọn **Create a lifecycle rule**.

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2F4TbZT9ZW1iji6BIV1zvG%2Fimage.png?alt=media&#x26;token=8c155477-0701-4c76-a70c-1a43cba12d8b" alt=""><figcaption></figcaption></figure>

5\. Nhập **Rule name**. Rule name mà chúng tôi cho phép bạn nhập bao gồm các chữ cái (a-z, A-Z, 0-9, '\_', '-', space). Độ dài **Rule name** của bạn phải nằm trong khoảng từ 5 đến 50.

6\. Chọn Rule type: hiện tại, chúng tôi chỉ hỗ trợ 1 loại rule Expiration: Rule hỗ trợ xóa các object theo điều kiện ràng buộc.

7\. Nhập **Filter**. Filter này được áp dụng cho một lifecycle rule cụ thể. N**ếu bạn muốn áp dụng quy tắc lifecycle mà bạn đang tạo lên tất cả các object thuộc bucket này, hãy để trống trường thông tin này.** Hoặc bạn có thể lọc các object mong muốn áp dụng lifecycle rule thông qua prefix.

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-c9fe8901c287f88111f68fe1ba9e33f1ce385093%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

8\. Chọn hành động xảy ra với object tại bucket mà bạn chọn, bao gồm:

* **Expire current version of objects**:
  * Khi kích hoạt, rule này sẽ tự động xóa **phiên bản hiện tại** của object sau một khoảng thời gian nhất định.
  * Bạn có thể nhập số ngày trong phần "After \_\_\_ days from object creation" để định nghĩa số ngày kể từ khi tạo object mà phiên bản hiện tại sẽ hết hạn và bị xóa.
* **Permanently delete noncurrent versions**:
  * Rule này áp dụng cho các **phiên bản không phải là phiên bản hiện tại** (noncurrent versions) của object nếu bạn đã bật tính năng Versioning.
  * Bạn có thể định cấu hình để xóa các phiên bản cũ sau một số ngày kể từ khi chúng trở thành phiên bản không phải là phiên bản hiện tại, bằng cách điền vào "After \_\_\_ days become noncurrent version".
* **Delete incomplete multipart uploads**:
  * Khi bạn tải lên một object lớn bằng cách chia thành nhiều phần (multipart upload), nhưng quá trình tải lên không hoàn tất, các phần đã tải sẽ bị giữ lại trong S3.
  * Rule này cho phép tự động xóa các phần của **multipart upload không hoàn tất** sau một khoảng thời gian từ khi quá trình tải lên được bắt đầu.
  * Bạn có thể nhập số ngày trong phần "After \_\_\_ days from object creation" để xác định khoảng thời gian trước khi các phần incomplete của multipart upload bị xóa.
* **Delete expired object delete marker**:
  * Rule này chỉ áp dụng khi bạn đã bật Versioning và có các object delete marker trong bucket.
  * Khi kích hoạt, nó sẽ xóa các **delete marker** đã hết hạn, giúp cải thiện hiệu suất bằng cách làm sạch các marker không còn cần thiết. (Tùy chọn này thường chỉ có thể bật khi có delete marker hết hạn trong bucket.)

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-ddb18cdb6cdaf4fbbf5527e9c94a30313a891f39%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Lưu ý:**

* Việc xử lý object trong một lần chạy lifecycle rule phụ thuộc vào **số lượng object** trong bucket được thiết lập lifecycle rule của bạn và **workload** của hệ thống chúng tôi. Nếu bucket có **nhiều object** hoặc hệ thống có tải cao, việc xử lý sẽ **chậm và kéo dài qua các ngày kế tiếp**. Nếu bucket có **ít object** hoặc hệ thống có tải thấp, việc xử lý sẽ **nhanh và có thể hoàn thành trong một ngày**. Để đảm bảo việc xử lý object diễn ra hiệu quả và nhanh chóng, bạn nên chia nhỏ các lần chạy lifecycle rule và sử dụng Bộ lọc (Filter) để giảm thiểu số lượng object cần xử lý.
* Với **Transition rule**: bạn chỉ được phép chuyển dữ liệu xuống lớp lưu trữ thấp hơn, không thể tự động chuyển ngược lên lớp cao hơn.
* Bạn không thể bật **Delete expired object delete markers** đã hết hạn nếu bạn bật **Expire current versions of objects**. Các quy tắc này xung đột vì **Expire current versions of objects** tạo ra một delete marker, trong khi **Delete expired object delete markers** đã hết hạn xóa chính delete marker đó khi nó không có phiên bản không phải hiện tại. Bạn không thể đồng thời xóa phiên bản hiện tại và xóa delete marker đã hết hạn kết quả vì quy tắc **Expire current versions of objects** tạo ra chính thứ (delete marker) mà quy tắc kia đang cố gắng dọn dẹp. Đây là các thao tác tuần tự, không phải đồng thời.
  {% endhint %}