diff --git a/English/.gitbook/assets/vserver-om-activation-flow.png b/English/.gitbook/assets/vserver-om-activation-flow.png new file mode 100644 index 00000000..7601282b Binary files /dev/null and b/English/.gitbook/assets/vserver-om-activation-flow.png differ diff --git a/English/.gitbook/assets/vserver-om-execution-status.png b/English/.gitbook/assets/vserver-om-execution-status.png new file mode 100644 index 00000000..63665091 Binary files /dev/null and b/English/.gitbook/assets/vserver-om-execution-status.png differ diff --git a/English/.gitbook/assets/vserver-om-operating-model.png b/English/.gitbook/assets/vserver-om-operating-model.png new file mode 100644 index 00000000..d4c9ddb5 Binary files /dev/null and b/English/.gitbook/assets/vserver-om-operating-model.png differ diff --git a/English/.gitbook/assets/vserver-om-task-lifecycle.png b/English/.gitbook/assets/vserver-om-task-lifecycle.png new file mode 100644 index 00000000..5b111014 Binary files /dev/null and b/English/.gitbook/assets/vserver-om-task-lifecycle.png differ diff --git a/English/SUMMARY.md b/English/SUMMARY.md index 71d1c272..27e8aa05 100644 --- a/English/SUMMARY.md +++ b/English/SUMMARY.md @@ -18,6 +18,11 @@ * [Getting started](vserver/compute-hcm03-1a/getting-started/README.md) * [UserData](vserver/compute-hcm03-1a/getting-started/userdata.md) * [Quota Limit](vserver/compute-hcm03-1a/quota-limit.md) + * [Scheduled O&M](vserver/compute-hcm03-1a/operation-and-maintenance/README.md) + * [Activate the O&M service](vserver/compute-hcm03-1a/operation-and-maintenance/activate-the-service.md) + * [Create and manage Scheduled Tasks](vserver/compute-hcm03-1a/operation-and-maintenance/create-and-manage-scheduled-tasks.md) + * [Monitor execution history](vserver/compute-hcm03-1a/operation-and-maintenance/monitor-execution-history.md) + * [Quota and FAQ](vserver/compute-hcm03-1a/operation-and-maintenance/quota-and-faq.md) * [Instance](vserver/compute-hcm03-1a/instance/README.md) * [Connect to virtual server](vserver/compute-hcm03-1a/instance/connect-to-virtual-server/README.md) * [Connecting a Windows Server by Remote Desktop (RDP)](vserver/compute-hcm03-1a/instance/connect-to-virtual-server/2.-remote-desktop-to-windows-server-hcm-03.md) diff --git a/English/overview/product-updates-all/2026.md b/English/overview/product-updates-all/2026.md index fa7c58d3..2a716196 100644 --- a/English/overview/product-updates-all/2026.md +++ b/English/overview/product-updates-all/2026.md @@ -153,6 +153,20 @@ For more details about the updated renewal mechanism and policy, please refer [h {% endtab %} {% tab title="New features" %} + +**Aug 2026** + +**vServer - Scheduled O&M (Beta): schedule automated VM operations** + +vServer introduces **Operation and Maintenance (O&M) — Scheduled Task** in Beta, letting you schedule **START**, **STOP** and **REBOOT** operations on your virtual machines at a fixed time instead of performing them manually every day. + +* Schedule runs **daily** at the hour and minute you choose, within an effective window (start date — end date). +* Select targets by **VM list** or by **tag** (`tag_key`/`tag_value`) — VMs tagged later are picked up automatically with no need to update the task. +* Full task lifecycle management: create, update, duplicate, cancel, delete, plus **Run now** to execute without waiting for the schedule. +* **Execution history down to each VM**: success/failure status with a specific error message, filterable by status and trigger type. +* One-time **Activate**: the system provisions a dedicated Service Account per user with least-privilege permissions, so scheduled operations run securely under your own identity. +* Available in **HCM-03** and **HAN-01**; default quota of **20 tasks per account**. +* Learn more at [Scheduled O&M](../../vserver/compute-hcm03-1a/operation-and-maintenance/). **Jul 2026** **VKS - GreenNode CLI** diff --git a/English/vserver/compute-hcm03-1a/operation-and-maintenance/README.md b/English/vserver/compute-hcm03-1a/operation-and-maintenance/README.md new file mode 100644 index 00000000..3840310c --- /dev/null +++ b/English/vserver/compute-hcm03-1a/operation-and-maintenance/README.md @@ -0,0 +1,62 @@ +# Scheduled O&M + +vServer **Operation and Maintenance (O&M) — Scheduled Task** lets you schedule routine operations on your virtual machines (VMs) automatically, instead of performing them by hand every day. You define it once — which action (Start, Stop or Reboot), on which VMs, at what time — and the system carries it out on schedule and records the result of every run. + +{% hint style="info" %} +**Note:** This is a **Beta** release for early-access customers. Features may be adjusted or extended based on your feedback. +{% endhint %} + +## Benefits + +* **Cost savings:** automatically shut down dev/test VMs outside working hours and start them again the next morning. +* **Less manual work:** no need to remember the time or have someone on duty to start/stop servers every day. +* **Consistent operations:** reboot application VMs on a regular cadence to refresh resources. +* **Full transparency:** every run keeps a detailed history down to each VM — whether it succeeded or failed, and why. + +## Common use cases + +| Scenario | How to use Scheduled Task | +| ----------------------------------------------- | ------------------------------------------------------------------------------------------ | +| Dev/test environments used only in office hours | Create two tasks: STOP at 19:00 and START at 07:00 daily for VMs tagged `env=dev` | +| Applications that need periodic restarts | Create a REBOOT task daily during off-peak hours (for example 03:00) | +| Nightly batch jobs on a dedicated VM | START the VM at 22:00 to run the job, STOP it at 05:00 once the job finishes | + +## Beta scope + +* Supported actions: **START**, **STOP**, **REBOOT**. +* Schedule frequency: **daily**, at the hour and minute you choose. +* Available regions: **HCM-03** and **HAN-01**. + +## Concepts and terminology + +| Term | Meaning | +| ------------------- | ------------------------------------------------------------------------------------------------------------------------- | +| **Scheduled Task** | A scheduled job: the action, the list of targets (VMs/tags), the schedule and the effective time window. | +| **Action** | The operation performed on a VM: START / STOP / REBOOT. | +| **Target** | The VMs affected by the task. Selected directly by VM or indirectly by tag. | +| **Tag** | A key/value label on a VM (for example `env=dev`). A tag-based task applies to every VM carrying that tag at run time. | +| **Execution** | One run of a task (scheduled or manual), with an aggregate status and per-VM results. | +| **Trigger** | How an execution starts: **SCHEDULED** (at the scheduled time) or **MANUAL** (you clicked "Run now"). | +| **Service Account** | A dedicated service account the system creates for you at activation, used to perform scheduled operations securely. | +| **Quota** | The maximum number of Scheduled Tasks your account can create. | +| **Region** | The infrastructure region where the VMs run (HCM-03, HAN-01). Each task belongs to a single region. | + +## How it works + +You define tasks in the Portal; the O&M scheduler watches them and triggers them on time; the action is applied to your VMs through vServer; the outcome is written to the execution history for you to review at any time. + +

Scheduled O&M operating model

+ +Three notable design points: + +* **Definition is separate from execution:** you can create or edit tasks at any time; the system takes care of running them at the scheduled moment. +* **Actions run on your behalf, under your own identity:** every operation uses a Service Account dedicated to your account with least-privilege permissions — never a shared account. +* **Everything is recorded:** each run produces a history entry with results down to the individual VM. + +## Beta limitations + +| Area | Current (Beta) | Roadmap | +| ----------------- | ------------------------------------------- | ---------------------------------------------- | +| Schedule frequency| Daily | Hourly / weekly / monthly to be added | +| Actions | START / STOP / REBOOT | Additional operations under evaluation | +| Region scope | One region per task (HCM-03, HAN-01) | More regions per the product roadmap | diff --git a/English/vserver/compute-hcm03-1a/operation-and-maintenance/activate-the-service.md b/English/vserver/compute-hcm03-1a/operation-and-maintenance/activate-the-service.md new file mode 100644 index 00000000..6ee31a73 --- /dev/null +++ b/English/vserver/compute-hcm03-1a/operation-and-maintenance/activate-the-service.md @@ -0,0 +1,29 @@ +# Activate the O&M service + +## Prerequisites + +* A VNG Cloud account with access to the vServer Portal. +* At least one running VM in region **HCM-03** or **HAN-01**. +* Permission to use the O&M feature (if you use a sub-account through IAM, the corresponding permissions must be granted). + +## Activation (one time only) + +Before creating your first Scheduled Task you need to activate the service. The process is fully automatic and takes only a few seconds. + +

O&M service activation flow

+ +1. Go to **Operation & Maintenance (O&M)** in the vServer Portal. +2. Click **Activate**. The system creates a dedicated Service Account for your account and attaches a least-privilege operations policy. +3. Once the status turns **ACTIVE**, you can start creating tasks. + +## Activation statuses + +| Status | Meaning | What you should do | +| ------------------- | --------------------------------------------------------------------------- | --------------------------------------------- | +| **NOT\_ACTIVATED** | The service has not been activated yet | Click **Activate** | +| **ACTIVE** | The service is ready | Use it normally | +| **SA\_BROKEN** | The Service Account is broken (for example deleted or its permissions changed) | Click **Re-activate** to let the system repair it | + +{% hint style="info" %} +**Note:** While the service is not activated, or the Service Account is broken, you can still view your task list and execution history. Only create/update/delete/run operations are temporarily blocked until activation succeeds. +{% endhint %} diff --git a/English/vserver/compute-hcm03-1a/operation-and-maintenance/create-and-manage-scheduled-tasks.md b/English/vserver/compute-hcm03-1a/operation-and-maintenance/create-and-manage-scheduled-tasks.md new file mode 100644 index 00000000..bdc16983 --- /dev/null +++ b/English/vserver/compute-hcm03-1a/operation-and-maintenance/create-and-manage-scheduled-tasks.md @@ -0,0 +1,97 @@ +# Create and manage Scheduled Tasks + +## Create a Scheduled Task + +1. Go to **O&M** and choose **Create Scheduled Task**. +2. Enter a name and description for the task. +3. Select the region that holds the target VMs (**HCM-03** or **HAN-01**). +4. Choose the action: **START**, **STOP** or **REBOOT**. +5. Set the daily schedule: hour and minute. +6. Set the effective window: start date and end date. +7. Select the targets: a list of specific VMs, or a tag. +8. Confirm. The task becomes **ACTIVE** and waits for its scheduled time. + +### Parameters + +| Parameter | Required | Description and constraints | +| --------------------------------- | -------- | ------------------------------------------------------------------------------------------- | +| Task name (`name`) | Yes | 5–50 characters; letters, digits and the characters `_` `-` `.` only; no spaces. | +| Description (`description`) | No | A note about the purpose of the task. | +| Region | Yes | HCM-03 or HAN-01. The task only affects VMs in this region. | +| Action (`action`) | Yes | START / STOP / REBOOT. | +| Schedule (`schedule`) | Yes | Daily frequency; choose the hour (0–23) and minute (0–59). | +| Effective from (`effective_from`) | Yes | The moment the task becomes eligible to run. | +| Effective until (`effective_until`)| Yes | After this moment the task no longer runs. | +| Targets (`targets`) | Yes | A list of VMs (instances) or a list of tags (key/value). | + +### Choosing targets: by VM or by tag? + +| Criterion | By VM (instance) | By tag | +| ---------------------- | ----------------------------------- | ---------------------------------------------------------- | +| How you select | Name each VM explicitly | Specify a tag key/value pair | +| Scope | Fixed to the selected list | Dynamic: every VM carrying the tag at run time | +| VMs added later | You must update the task | Automatically included once the tag is applied | +| Best for | A small, stable set of VMs | Groups that change often (dev/test, autoscaling) | + +{% hint style="warning" %} +**Important:** With tag-based tasks, manage your tags carefully — applying the wrong tag means that VM will be stopped or rebooted on the task's schedule. +{% endhint %} + +### Example: shut down dev VMs outside working hours + +Goal: VMs tagged `env=dev` in HCM-03 stop at 19:00 and start again at 07:00 the next morning, through the end of 2026. + +| Parameter | Task 1 — evening shutdown | Task 2 — morning startup | +| --------------- | --------------------------- | --------------------------- | +| Name | `stop-dev-19h` | `start-dev-07h` | +| Region | HCM-03 | HCM-03 | +| Action | STOP | START | +| Schedule | Daily at 19:00 | Daily at 07:00 | +| Effective window| 2026-08-01 → 2026-12-31 | 2026-08-01 → 2026-12-31 | +| Targets | tag `env=dev` | tag `env=dev` | + +## How the system runs a task + +Once created, the task is **ACTIVE** and continuously monitored. At the scheduled time — or when you click **Run now** — an execution starts. + +

Scheduled Task lifecycle — from creation to each individual run

+ +### Built-in safeguards + +* **Reconcile before running:** the system re-checks the target list against vServer immediately before each execution. VMs that have been deleted are dropped from the task automatically, so they never produce errors in the history. +* **No duplicate runs:** each scheduled moment executes exactly once, even if the system is busy or restarts. +* **Per-VM isolation:** a failure on one VM does not stop the others; each VM's result is recorded separately. +* **Automatic expiry:** once past the effective end date, the task stops on its own — no need to remove the schedule manually. + +### Run now (manual trigger) + +Besides the automatic schedule, you can click **Run now** to execute a task immediately — useful for verifying a task you just created, or handling an unplanned situation. Manual runs are recorded in the history with trigger type **MANUAL** and do not affect the next scheduled run. + +{% hint style="info" %} +**Note:** There is a cooldown between two consecutive **Run now** actions on the same task to prevent duplicate operations. If you click too quickly, the system tells you how many seconds to wait. +{% endhint %} + +## Managing tasks + +### Management operations + +| Operation | Description | Condition | +| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | +| List / view details | View all your tasks with their configuration, targets and next run time | Always available | +| Update | Change the name, description, action, schedule, effective window and targets; you may also change the region (which then requires selecting new targets) | Task is **ACTIVE** | +| Duplicate | Create a new task from an existing configuration — just change the name and adjust the differences | Service activated; quota available | +| Run now (Trigger) | Execute immediately without waiting for the schedule | Task is **ACTIVE** | +| Cancel | Stop the task's schedule; the task becomes **CANCELED** and its history is preserved | Task is **ACTIVE** | +| Delete | Remove the task from your list and release its quota | Task is no longer ACTIVE — **Cancel** it first | + +### Task statuses + +| Status | Meaning | +| -------------- | ------------------------------------------------------------------------------------ | +| **ACTIVE** | Running on schedule within its effective window | +| **CANCELED** | Cancelled — no longer runs, but its history remains viewable | +| **EXPIRED** | Past its effective end date — the system sets this automatically and the task stops | + +{% hint style="success" %} +**Tip:** Cancel and Delete are different — Cancel keeps the task and its full history for reference, while Delete removes the task entirely and releases the quota. An ACTIVE task must be cancelled before it can be deleted. +{% endhint %} diff --git a/English/vserver/compute-hcm03-1a/operation-and-maintenance/monitor-execution-history.md b/English/vserver/compute-hcm03-1a/operation-and-maintenance/monitor-execution-history.md new file mode 100644 index 00000000..9ed72faf --- /dev/null +++ b/English/vserver/compute-hcm03-1a/operation-and-maintenance/monitor-execution-history.md @@ -0,0 +1,20 @@ +# Monitor execution history + +Every time a task runs — whether on schedule or manually — the system creates an execution record. You can browse the executions of each task (paginated, filterable by status and trigger type) and drill down into the result for each individual VM. + +## Aggregate status of an execution + +

Execution status model

+ +| Status | Meaning | +| -------------------- | ------------------------------------------------------------------------------------ | +| **PENDING** | Recorded and queued for processing | +| **RUNNING** | Currently executing across the target VMs | +| **SUCCESS** | Every VM succeeded | +| **PARTIAL\_FAILED** | Some VMs succeeded and some failed — open the details to see why | +| **FAILED** | Every VM failed | +| **SKIPPED** | The run was deliberately skipped (for example a precondition was not met) — with a note | + +## Per-VM details + +Within an execution, each VM has its own record: the status (**SUCCESS** / **FAILED** / **SKIPPED**), the timestamp, and a specific error message if it failed (for example the VM no longer exists, or the VM is in a state that does not allow the operation). This lets you pinpoint the cause without guesswork. diff --git a/English/vserver/compute-hcm03-1a/operation-and-maintenance/quota-and-faq.md b/English/vserver/compute-hcm03-1a/operation-and-maintenance/quota-and-faq.md new file mode 100644 index 00000000..0f7173ad --- /dev/null +++ b/English/vserver/compute-hcm03-1a/operation-and-maintenance/quota-and-faq.md @@ -0,0 +1,45 @@ +# Quota and FAQ + +## Quota + +* Each account has a maximum number of Scheduled Tasks it can create. The current default is **20 tasks per account**. +* Creating or duplicating a task consumes quota; deleting a task releases it. +* You can check your current quota directly in the O&M interface. + +{% hint style="info" %} +**Note:** If you see a quota-exceeded message when creating a task, delete tasks you no longer need or contact VNG Cloud support to raise your quota. +{% endhint %} + +## Frequently asked questions + +### My task did not run at the scheduled time. Why? + +Check in order: (1) the task is still **ACTIVE** (a CANCELED or EXPIRED task never runs); (2) the current time falls inside the effective window (effective from/until); (3) the service activation status is **ACTIVE**. If all three are correct and the task still does not run, contact support with the task name and the scheduled time. + +### What does the SA\_BROKEN activation status mean? + +Your Service Account is broken — usually because it was deleted or its permissions were changed unintentionally. Just click **Re-activate** and the system repairs it. Your existing tasks are not lost; schedules resume once activation succeeds. + +### I deleted a VM in vServer. Will my task fail? + +No. Before each execution the system reconciles the target list against vServer and drops any deleted VM. The task continues to run normally on the remaining VMs. + +### An execution reported PARTIAL\_FAILED. What should I do? + +Open the execution details to inspect each VM — the failing ones carry a specific error message. Resolve the underlying cause (for example a VM in a state that does not allow the operation), then click **Run now** to retry if needed. + +### Does a manual run shift the automatic schedule? + +No. A manual run (**MANUAL**) is independent of the schedule; the next automatic run still happens at its scheduled time. + +### How do I pause a task for a while? + +Use **Cancel** to stop the schedule — the history is preserved. When you need it again, create a new task or use **Duplicate** on the cancelled task to restore its configuration quickly. + +### Can one task cover VMs in multiple regions? + +Not yet. In this Beta each task belongs to a single region. If you have VMs in both **HCM-03** and **HAN-01**, create a separate task per region. + +## Feedback and support + +While using the Beta, if you run into an issue or want to suggest a feature, please contact VNG Cloud support through your existing support channel. Your feedback is an important input as we refine the product ahead of general availability. diff --git a/Vietnamese/.gitbook/assets/vserver-om-activation-flow.png b/Vietnamese/.gitbook/assets/vserver-om-activation-flow.png new file mode 100644 index 00000000..d3b6fb5d Binary files /dev/null and b/Vietnamese/.gitbook/assets/vserver-om-activation-flow.png differ diff --git a/Vietnamese/.gitbook/assets/vserver-om-execution-status.png b/Vietnamese/.gitbook/assets/vserver-om-execution-status.png new file mode 100644 index 00000000..a243cbf2 Binary files /dev/null and b/Vietnamese/.gitbook/assets/vserver-om-execution-status.png differ diff --git a/Vietnamese/.gitbook/assets/vserver-om-operating-model.png b/Vietnamese/.gitbook/assets/vserver-om-operating-model.png new file mode 100644 index 00000000..025fdf72 Binary files /dev/null and b/Vietnamese/.gitbook/assets/vserver-om-operating-model.png differ diff --git a/Vietnamese/.gitbook/assets/vserver-om-task-lifecycle.png b/Vietnamese/.gitbook/assets/vserver-om-task-lifecycle.png new file mode 100644 index 00000000..60c54192 Binary files /dev/null and b/Vietnamese/.gitbook/assets/vserver-om-task-lifecycle.png differ diff --git a/Vietnamese/SUMMARY.md b/Vietnamese/SUMMARY.md index b583545c..b89fa5bf 100644 --- a/Vietnamese/SUMMARY.md +++ b/Vietnamese/SUMMARY.md @@ -20,6 +20,11 @@ * [Trải nghiệm sản phẩm vServer](vserver/compute-hcm03-1a/trai-nghiem-san-pham-vserver/README.md) * [UserData](vserver/compute-hcm03-1a/trai-nghiem-san-pham-vserver/userdata.md) * [Hạn mức tài nguyên](vserver/compute-hcm03-1a/han-muc-tai-nguyen.md) + * [Lập lịch vận hành (Scheduled O&M)](vserver/compute-hcm03-1a/operation-and-maintenance/README.md) + * [Kích hoạt dịch vụ O&M](vserver/compute-hcm03-1a/operation-and-maintenance/kich-hoat-dich-vu.md) + * [Tạo và quản lý Scheduled Task](vserver/compute-hcm03-1a/operation-and-maintenance/tao-va-quan-ly-scheduled-task.md) + * [Theo dõi lịch sử thực thi](vserver/compute-hcm03-1a/operation-and-maintenance/theo-doi-lich-su-thuc-thi.md) + * [Hạn mức và câu hỏi thường gặp](vserver/compute-hcm03-1a/operation-and-maintenance/han-muc-va-cau-hoi-thuong-gap.md) * [Instance](vserver/compute-hcm03-1a/server/README.md) * [Kết nối vào máy chủ ảo](vserver/compute-hcm03-1a/server/ket-noi-vao-may-chu-ao/README.md) * [Kết nối vào máy chủ Windows sử dụng công cụ Remote Desktop (RDP)](vserver/compute-hcm03-1a/server/ket-noi-vao-may-chu-ao/ket-noi-vao-may-chu-windows-su-dung-cong-cu-remote-desktop-rdp.md) diff --git a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md index 61c45923..148107a8 100644 --- a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md +++ b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md @@ -146,6 +146,20 @@ Chính sách gia hạn tài nguyên này áp dụng từ ngày 8/1/2026 và áp {% endtab %} {% tab title="Tính năng mới" %} + +**Tháng 8, 2026** + +**vServer - Scheduled O&M (Beta): lập lịch tự động vận hành máy chủ ảo** + +vServer ra mắt **Operation and Maintenance (O&M) — Scheduled Task** phiên bản Beta, cho phép lên lịch tự động các thao tác **Khởi động (START)**, **Tắt (STOP)** và **Khởi động lại (REBOOT)** máy chủ ảo theo khung giờ định sẵn, thay cho việc thao tác thủ công hằng ngày. + +* Lên lịch chạy **hằng ngày** theo giờ/phút bạn chọn, kèm khoảng thời gian hiệu lực (ngày bắt đầu — ngày kết thúc). +* Chọn đối tượng theo **danh sách VM** hoặc theo **tag** (`tag_key`/`tag_value`) — VM mới gắn tag tự động được áp dụng mà không cần cập nhật lại task. +* Quản lý vòng đời task đầy đủ: tạo, cập nhật, nhân bản, huỷ, xoá và **Chạy ngay (Trigger)** không cần chờ đến giờ. +* Theo dõi **lịch sử thực thi chi tiết đến từng VM**: trạng thái thành công/thất bại kèm thông báo lỗi cụ thể, lọc theo trạng thái và loại trigger. +* Kích hoạt một lần (**Activate**): hệ thống tự tạo Service Account riêng cho từng người dùng với quyền tối thiểu, đảm bảo thao tác theo lịch được thực hiện an toàn dưới danh nghĩa tài khoản của bạn. +* Sẵn sàng tại 2 region **HCM-03** và **HAN-01**; hạn mức mặc định **20 task/tài khoản**. +* Tìm hiểu thêm tại [Lập lịch vận hành (Scheduled O&M)](../../vserver/compute-hcm03-1a/operation-and-maintenance/). **Tháng 7, 2026** **VKS - GreenNode CLI** diff --git a/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/README.md b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/README.md new file mode 100644 index 00000000..58147f7a --- /dev/null +++ b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/README.md @@ -0,0 +1,62 @@ +# Lập lịch vận hành (Scheduled O&M) + +vServer **Operation and Maintenance (O&M) — Scheduled Task** là tính năng cho phép bạn lên lịch tự động các thao tác vận hành trên máy chủ ảo (VM), thay vì phải thao tác thủ công mỗi ngày. Bạn chỉ cần định nghĩa một lần: làm gì (Khởi động, Tắt hoặc Khởi động lại), trên những VM nào, vào khung giờ nào — hệ thống sẽ tự động thực hiện đúng lịch và ghi lại kết quả từng lần chạy. + +{% hint style="info" %} +**Chú ý:** Đây là phiên bản **Beta** dành cho khách hàng trải nghiệm sớm. Tính năng có thể được điều chỉnh, bổ sung dựa trên phản hồi của bạn trong quá trình sử dụng. +{% endhint %} + +## Lợi ích + +* **Tiết kiệm chi phí:** tự động tắt các VM môi trường dev/test ngoài giờ làm việc và bật lại vào sáng hôm sau. +* **Giảm thao tác thủ công:** không cần nhớ giờ, không cần trực để bật/tắt máy chủ hằng ngày. +* **Vận hành nhất quán:** khởi động lại định kỳ các VM chạy ứng dụng cần làm mới tài nguyên. +* **Minh bạch:** mọi lần thực thi đều có lịch sử chi tiết đến từng VM — thành công hay thất bại, lý do là gì. + +## Tình huống sử dụng điển hình + +| Tình huống | Cách dùng Scheduled Task | +| --------------------------------------------- | -------------------------------------------------------------------------------------------- | +| Môi trường dev/test chỉ dùng giờ hành chính | Tạo 2 task: STOP lúc 19:00 và START lúc 07:00 hằng ngày cho nhóm VM gắn tag `env=dev` | +| Ứng dụng cần khởi động lại định kỳ | Tạo task REBOOT hằng ngày vào khung giờ thấp điểm (ví dụ 03:00) | +| Batch job chạy đêm trên VM riêng | START VM lúc 22:00 để chạy job, STOP lúc 05:00 sau khi job kết thúc | + +## Phạm vi phiên bản Beta + +* Thao tác hỗ trợ: **START** (Khởi động), **STOP** (Tắt), **REBOOT** (Khởi động lại). +* Chu kỳ lịch: **hằng ngày (Daily)** theo giờ/phút bạn chọn. +* Khu vực triển khai: region **HCM-03** và **HAN-01**. + +## Khái niệm và thuật ngữ + +| Thuật ngữ | Ý nghĩa | +| ------------------- | -------------------------------------------------------------------------------------------------------------------------------- | +| **Scheduled Task** | Một "nhiệm vụ theo lịch": gồm loại thao tác, danh sách đối tượng (VM/tag), lịch chạy và khoảng thời gian hiệu lực. | +| **Action** | Hành động thực hiện trên VM: START / STOP / REBOOT. | +| **Target** | VM chịu tác động của task. Chọn trực tiếp theo VM hoặc gián tiếp theo tag. | +| **Tag** | Nhãn key/value gắn trên VM (ví dụ `env=dev`). Task theo tag áp dụng cho mọi VM mang tag đó tại thời điểm thực thi. | +| **Execution** | Một lần task chạy (theo lịch hoặc thủ công), có trạng thái tổng hợp và kết quả chi tiết từng VM. | +| **Trigger** | Cách một execution được kích hoạt: **SCHEDULED** (đến giờ theo lịch) hoặc **MANUAL** (bạn bấm "Chạy ngay"). | +| **Service Account** | Tài khoản dịch vụ hệ thống tự tạo riêng cho bạn khi kích hoạt, dùng để thực thi thao tác theo lịch một cách an toàn. | +| **Quota** | Số lượng Scheduled Task tối đa tài khoản của bạn được tạo. | +| **Region** | Khu vực hạ tầng nơi VM đang chạy (HCM-03, HAN-01). Mỗi task thuộc về một region. | + +## Mô hình hoạt động + +Bạn định nghĩa task trên Portal; bộ lập lịch của O&M theo dõi và kích hoạt đúng giờ; thao tác được thực hiện trên VM qua vServer; kết quả được ghi vào lịch sử thực thi để bạn tra cứu bất cứ lúc nào. + +

Mô hình hoạt động tổng quan của Scheduled O&M

+ +Ba điểm đáng chú ý trong thiết kế: + +* **Tách bạch giữa "định nghĩa" và "thực thi":** bạn có thể tạo/sửa task bất cứ lúc nào; việc thực thi do hệ thống tự đảm nhiệm đúng giờ đã hẹn. +* **Thực thi thay bạn, dưới danh nghĩa của bạn:** mọi thao tác dùng Service Account riêng của tài khoản bạn với quyền tối thiểu, không dùng tài khoản chung. +* **Mọi thứ đều được ghi lại:** mỗi lần chạy tạo một bản ghi lịch sử với kết quả chi tiết đến từng VM. + +## Giới hạn của phiên bản Beta + +| Hạng mục | Hiện tại (Beta) | Kế hoạch | +| ----------------- | ------------------------------------------- | ------------------------------------------------- | +| Chu kỳ lịch | Hằng ngày (Daily) | Bổ sung theo giờ / theo tuần / theo tháng | +| Thao tác | START / STOP / REBOOT | Nghiên cứu bổ sung các thao tác vận hành khác | +| Phạm vi region | Mỗi task thuộc 1 region (HCM-03, HAN-01) | Mở rộng region theo lộ trình sản phẩm | diff --git a/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/han-muc-va-cau-hoi-thuong-gap.md b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/han-muc-va-cau-hoi-thuong-gap.md new file mode 100644 index 00000000..247463a3 --- /dev/null +++ b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/han-muc-va-cau-hoi-thuong-gap.md @@ -0,0 +1,45 @@ +# Hạn mức và câu hỏi thường gặp + +## Hạn mức sử dụng (Quota) + +* Mỗi tài khoản có hạn mức số lượng Scheduled Task được phép tạo. Hạn mức mặc định hiện tại: **20 task / tài khoản**. +* Tạo mới hoặc nhân bản task sẽ trừ hạn mức; xoá task sẽ hoàn trả hạn mức. +* Bạn có thể tra cứu hạn mức hiện tại ngay trên giao diện O&M. + +{% hint style="info" %} +**Chú ý:** Nếu nhận thông báo vượt hạn mức khi tạo task, hãy xoá các task không còn dùng hoặc liên hệ đội ngũ hỗ trợ VNG Cloud để nâng hạn mức. +{% endhint %} + +## Câu hỏi thường gặp và xử lý sự cố + +### Task không chạy vào giờ đã hẹn? + +Kiểm tra lần lượt: (1) task còn ở trạng thái **ACTIVE** không (task đã CANCELED hoặc EXPIRED sẽ không chạy); (2) thời điểm hiện tại có nằm trong khoảng hiệu lực (effective from/until) không; (3) trạng thái kích hoạt dịch vụ có đang **ACTIVE** không. Nếu tất cả đều đúng mà task vẫn không chạy, liên hệ hỗ trợ kèm tên task và khung giờ. + +### Trạng thái kích hoạt hiển thị SA\_BROKEN nghĩa là gì? + +Service Account của bạn gặp sự cố (thường do bị xoá hoặc thay đổi quyền ngoài ý muốn). Chỉ cần nhấn **Re-activate** — hệ thống sẽ tự khôi phục. Các task hiện có không bị mất; lịch chạy tiếp tục sau khi kích hoạt lại thành công. + +### Tôi đã xoá một VM trên vServer, task có bị lỗi không? + +Không. Trước mỗi lần thực thi, hệ thống tự đối soát với vServer và loại VM đã xoá khỏi danh sách đối tượng. Task tiếp tục chạy bình thường trên các VM còn lại. + +### Execution báo PARTIAL\_FAILED, tôi cần làm gì? + +Mở chi tiết execution để xem từng VM: VM nào thất bại sẽ có thông báo lỗi cụ thể. Xử lý theo nguyên nhân (ví dụ VM đang ở trạng thái không cho phép thao tác) rồi có thể bấm **Chạy ngay** để thực hiện lại nếu cần. + +### Chạy thủ công có làm lệch lịch tự động không? + +Không. Lần chạy thủ công (**MANUAL**) độc lập với lịch; lần chạy tự động kế tiếp vẫn diễn ra đúng giờ đã hẹn. + +### Tôi muốn tạm dừng task một thời gian? + +Dùng **Huỷ (Cancel)** để dừng lịch — lịch sử vẫn được giữ. Khi cần chạy lại, tạo task mới hoặc dùng **Nhân bản (Duplicate)** từ task đã huỷ để khôi phục cấu hình nhanh. + +### Một task áp dụng được cho VM ở nhiều region không? + +Chưa. Trong bản Beta, mỗi task thuộc về một region. Nếu có VM ở cả **HCM-03** và **HAN-01**, hãy tạo task riêng cho từng region. + +## Góp ý & hỗ trợ + +Trong quá trình trải nghiệm bản Beta, nếu bạn gặp sự cố hoặc có đề xuất tính năng, vui lòng liên hệ đội ngũ hỗ trợ VNG Cloud qua kênh hỗ trợ hiện tại của bạn. Mọi phản hồi của bạn đều là đầu vào quan trọng giúp chúng tôi hoàn thiện sản phẩm trước khi phát hành chính thức. diff --git a/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/kich-hoat-dich-vu.md b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/kich-hoat-dich-vu.md new file mode 100644 index 00000000..7d0773f9 --- /dev/null +++ b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/kich-hoat-dich-vu.md @@ -0,0 +1,29 @@ +# Kích hoạt dịch vụ O&M + +## Điều kiện tiên quyết + +* Tài khoản VNG Cloud đã đăng nhập được Portal vServer. +* Có ít nhất một VM đang hoạt động tại region **HCM-03** hoặc **HAN-01**. +* Tài khoản có quyền sử dụng tính năng O&M (nếu dùng tài khoản con qua IAM, cần được gán quyền tương ứng). + +## Kích hoạt dịch vụ (một lần duy nhất) + +Trước khi tạo Scheduled Task đầu tiên, bạn cần kích hoạt dịch vụ. Quá trình này hoàn toàn tự động và chỉ mất vài giây. + +

Luồng kích hoạt dịch vụ O&M

+ +1. Truy cập mục **Operation & Maintenance (O&M)** trên Portal vServer. +2. Nhấn nút **Activate**. Hệ thống sẽ tự tạo Service Account riêng cho tài khoản của bạn và gắn quyền vận hành tối thiểu. +3. Khi trạng thái chuyển sang **ACTIVE**, bạn có thể bắt đầu tạo task. + +## Các trạng thái kích hoạt + +| Trạng thái | Ý nghĩa | Bạn cần làm gì | +| ------------------- | -------------------------------------------------------------------- | --------------------------------------------- | +| **NOT\_ACTIVATED** | Chưa kích hoạt dịch vụ | Nhấn **Activate** | +| **ACTIVE** | Dịch vụ sẵn sàng | Sử dụng bình thường | +| **SA\_BROKEN** | Service Account gặp sự cố (ví dụ bị xoá/đổi quyền ngoài ý muốn) | Nhấn **Re-activate** để hệ thống tự khôi phục | + +{% hint style="info" %} +**Chú ý:** Khi chưa kích hoạt hoặc Service Account gặp sự cố, bạn vẫn xem được danh sách task và lịch sử thực thi; chỉ các thao tác tạo/sửa/xoá/chạy task bị tạm chặn cho đến khi kích hoạt thành công. +{% endhint %} diff --git a/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/tao-va-quan-ly-scheduled-task.md b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/tao-va-quan-ly-scheduled-task.md new file mode 100644 index 00000000..be33fceb --- /dev/null +++ b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/tao-va-quan-ly-scheduled-task.md @@ -0,0 +1,97 @@ +# Tạo và quản lý Scheduled Task + +## Tạo Scheduled Task + +1. Vào mục **O&M**, chọn **Tạo Scheduled Task**. +2. Đặt tên và mô tả cho task. +3. Chọn region chứa các VM cần thao tác (**HCM-03** hoặc **HAN-01**). +4. Chọn loại thao tác: **START**, **STOP** hoặc **REBOOT**. +5. Thiết lập lịch chạy hằng ngày: giờ và phút. +6. Thiết lập thời gian hiệu lực: ngày bắt đầu và ngày kết thúc. +7. Chọn đối tượng áp dụng: danh sách VM cụ thể hoặc theo tag. +8. Xác nhận tạo task. Task sẽ ở trạng thái **ACTIVE** và chờ đến giờ đã hẹn. + +### Bảng tham số + +| Tham số | Bắt buộc | Mô tả và ràng buộc | +| -------------------------------- | -------- | ----------------------------------------------------------------------------------------------- | +| Tên task (`name`) | Có | 5–50 ký tự; chỉ gồm chữ cái, chữ số và các ký tự `_` `-` `.`; không chứa dấu cách. | +| Mô tả (`description`) | Không | Ghi chú mục đích của task. | +| Region | Có | HCM-03 hoặc HAN-01. Task chỉ tác động VM trong region này. | +| Thao tác (`action`) | Có | START / STOP / REBOOT. | +| Lịch chạy (`schedule`) | Có | Chu kỳ hằng ngày; chọn giờ (0–23) và phút (0–59). | +| Hiệu lực từ (`effective_from`) | Có | Thời điểm task bắt đầu được xét chạy. | +| Hiệu lực đến (`effective_until`) | Có | Sau thời điểm này task không chạy nữa. | +| Đối tượng (`targets`) | Có | Danh sách VM (instance) hoặc danh sách tag (key/value). | + +### Chọn đối tượng: theo VM hay theo tag? + +| Tiêu chí | Theo VM (instance) | Theo tag | +| ------------------- | --------------------------------- | ------------------------------------------------------- | +| Cách chọn | Chỉ định đích danh từng VM | Chỉ định cặp tag key/value | +| Phạm vi áp dụng | Cố định theo danh sách đã chọn | Động: mọi VM mang tag tại thời điểm chạy | +| VM mới thêm sau này | Phải cập nhật task để bổ sung | Tự động được áp dụng nếu gắn đúng tag | +| Phù hợp khi | Số VM ít, danh sách ổn định | Nhóm VM thay đổi thường xuyên (dev/test, autoscale) | + +{% hint style="warning" %} +**Quan trọng:** Với task theo tag, hãy quản lý tag chặt chẽ — gắn nhầm tag đồng nghĩa VM đó sẽ bị tắt/khởi động lại theo lịch của task. +{% endhint %} + +### Ví dụ: tắt VM dev ngoài giờ làm việc + +Mục tiêu: các VM gắn tag `env=dev` tại HCM-03 tự tắt lúc 19:00 và tự bật lại lúc 07:00 sáng hôm sau, áp dụng đến hết năm 2026. + +| Tham số | Task 1 — Tắt buổi tối | Task 2 — Bật buổi sáng | +| --------- | --------------------------- | --------------------------- | +| Tên | `stop-dev-19h` | `start-dev-07h` | +| Region | HCM-03 | HCM-03 | +| Thao tác | STOP | START | +| Lịch chạy | Hằng ngày 19:00 | Hằng ngày 07:00 | +| Hiệu lực | 01/08/2026 → 31/12/2026 | 01/08/2026 → 31/12/2026 | +| Đối tượng | tag `env=dev` | tag `env=dev` | + +## Cách hệ thống thực thi task + +Sau khi tạo, task ở trạng thái **ACTIVE** và được hệ thống theo dõi liên tục. Đến đúng giờ đã hẹn (hoặc khi bạn bấm **Chạy ngay**), một lần thực thi (execution) được khởi động. + +

Vòng đời một Scheduled Task — từ khi tạo đến từng lần thực thi

+ +### Các cơ chế đảm bảo an toàn + +* **Đối soát trước khi chạy:** hệ thống kiểm tra lại danh sách VM với vServer ngay trước mỗi lần thực thi. VM đã bị xoá sẽ tự động được loại khỏi task, không tạo lỗi trong lịch sử. +* **Chống chạy trùng:** mỗi mốc giờ chỉ thực thi đúng một lần, kể cả khi hệ thống bận hoặc khởi động lại. +* **Xử lý độc lập từng VM:** một VM lỗi không làm dừng các VM còn lại; kết quả từng VM được ghi riêng. +* **Tự hết hạn:** quá "ngày kết thúc hiệu lực", task tự dừng, không cần thao tác gỡ lịch. + +### Chạy ngay (Manual Trigger) + +Ngoài lịch tự động, bạn có thể bấm **Chạy ngay** để thực thi task tức thì — hữu ích khi cần kiểm tra cấu hình task mới tạo hoặc xử lý tình huống đột xuất. Lần chạy thủ công được ghi lịch sử với loại trigger **MANUAL**, không ảnh hưởng đến lịch tự động tiếp theo. + +{% hint style="info" %} +**Chú ý:** Giữa hai lần **Chạy ngay** liên tiếp trên cùng một task có khoảng chờ (cooldown) để tránh thao tác trùng lặp. Nếu bấm quá nhanh, hệ thống sẽ báo số giây cần chờ trước khi chạy lại. +{% endhint %} + +## Quản lý Scheduled Task + +### Các thao tác quản lý + +| Thao tác | Mô tả | Điều kiện | +| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | +| Xem danh sách / chi tiết | Xem toàn bộ task của bạn kèm cấu hình, đối tượng và lần chạy kế tiếp | Luôn khả dụng | +| Cập nhật (Update) | Sửa tên, mô tả, loại thao tác, lịch chạy, thời gian hiệu lực, đối tượng áp dụng; có thể đổi region (khi đó bắt buộc chọn lại đối tượng cho region mới) | Task đang **ACTIVE** | +| Nhân bản (Duplicate) | Tạo task mới từ cấu hình task sẵn có, chỉ cần đổi tên và điều chỉnh khác biệt | Dịch vụ đã kích hoạt; còn quota | +| Chạy ngay (Trigger) | Thực thi tức thì không chờ lịch | Task đang **ACTIVE** | +| Huỷ (Cancel) | Dừng lịch chạy của task; task chuyển sang **CANCELED**, lịch sử được giữ nguyên | Task đang **ACTIVE** | +| Xoá (Delete) | Gỡ task khỏi danh sách và hoàn trả quota | Task không còn ACTIVE — cần **Huỷ (Cancel)** trước | + +### Trạng thái của task + +| Trạng thái | Ý nghĩa | +| -------------- | ------------------------------------------------------------------------------------------ | +| **ACTIVE** | Đang hoạt động, sẽ chạy theo lịch trong thời gian hiệu lực | +| **CANCELED** | Đã bị huỷ — không chạy nữa nhưng vẫn xem được lịch sử | +| **EXPIRED** | Đã quá ngày kết thúc hiệu lực — hệ thống tự chuyển trạng thái, task không chạy nữa | + +{% hint style="success" %} +**Mẹo:** Huỷ (Cancel) khác Xoá (Delete) — Cancel giữ lại task và toàn bộ lịch sử để tra cứu; Delete gỡ hẳn task khỏi danh sách và hoàn trả hạn mức. Task đang ACTIVE cần được Cancel trước, sau đó mới Delete được. +{% endhint %} diff --git a/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/theo-doi-lich-su-thuc-thi.md b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/theo-doi-lich-su-thuc-thi.md new file mode 100644 index 00000000..4b4620a5 --- /dev/null +++ b/Vietnamese/vserver/compute-hcm03-1a/operation-and-maintenance/theo-doi-lich-su-thuc-thi.md @@ -0,0 +1,20 @@ +# Theo dõi lịch sử thực thi + +Mỗi lần task chạy — dù theo lịch hay chạy thủ công — hệ thống tạo một bản ghi thực thi (execution). Bạn có thể xem danh sách execution của từng task (có phân trang, lọc theo trạng thái và loại trigger), và đi sâu vào chi tiết từng VM trong mỗi lần chạy. + +## Trạng thái tổng hợp của một lần thực thi + +

Trạng thái của một lần thực thi (Execution)

+ +| Trạng thái | Ý nghĩa | +| -------------------- | ---------------------------------------------------------------------------------------------- | +| **PENDING** | Đã ghi nhận, chờ xử lý | +| **RUNNING** | Đang thực thi trên các VM | +| **SUCCESS** | Tất cả VM đều thành công | +| **PARTIAL\_FAILED** | Một phần VM thành công, một phần thất bại — xem chi tiết từng VM để biết nguyên nhân | +| **FAILED** | Tất cả VM đều thất bại | +| **SKIPPED** | Lần chạy được chủ động bỏ qua (ví dụ điều kiện thực thi không thoả) — có ghi chú lý do | + +## Chi tiết từng VM + +Trong mỗi execution, từng VM có bản ghi riêng gồm: trạng thái (**SUCCESS** / **FAILED** / **SKIPPED**), thời điểm thực hiện và thông báo lỗi cụ thể nếu thất bại (ví dụ VM không tồn tại, VM đang ở trạng thái không cho phép thao tác...). Nhờ đó bạn xác định nhanh nguyên nhân mà không cần đoán.