# Syllabus Waypoint ## ⚠️ Lưu ý quan trọng trước khi bắt đầu Waypoint mã nguồn mở cũ (`waypoint.hcl`, build/deploy/release, tự host) **đã bị archive**, community edition dừng ở bản 0.11.4 và không còn maintain. # TUẦN 1 - Nền tảng IDP & kiến trúc HCP Waypoint ### Ngày 1: Khái niệm Internal Developer Platform (IDP) * **Mục tiêu:** Hiểu bài toán "developer self-service" mà Waypoint giải quyết. * **Nội dung:** * Lý thuyết: Platform Engineering, golden path/golden pattern; tách vai trò Platform Engineer (định nghĩa template) vs Application Developer (tiêu thụ template). * So sánh sơ bộ với Backstage, Port - Waypoint khác biệt vì build trực tiếp trên HCP Terraform thay vì tự có provisioning engine riêng. * **Mini-Project:** Không, warm-up. ### Ngày 2: Kiến trúc tổng thể HCP Waypoint * **Mục tiêu:** Nắm sơ đồ luồng dữ liệu. * **Nội dung:** * Lý thuyết: `Template/Add-on definition → No-code Terraform module → Workspace → Apply`. Khi developer dùng template/cài add-on, Waypoint gọi HCP Terraform API tạo workspace + trigger run; khi destroy, Waypoint trigger destroy run và xóa workspace. * Thực hành: Tạo HCP account, bật HCP Waypoint, kết nối tới 1 HCP Terraform organization. * **Mini-Project:** Setup kết nối HCP Waypoint ↔ HCP Terraform hoàn chỉnh với team token đúng scope. ### Ngày 3: No-code Ready Terraform Modules * **Mục tiêu:** Nền tảng bắt buộc phải giỏi trước khi làm Waypoint. * **Nội dung:** * Lý thuyết: Điều kiện module trở thành "no-code ready" (biến/output rõ ràng, versioning); vì sao Waypoint bắt buộc dựa vào module dạng này. * Thực hành: Viết 1 module đơn giản (vd deploy container service), publish lên private registry, đánh dấu no-code ready. ### Ngày 4: Templates trong HCP Waypoint * **Mục tiêu:** Thành thạo tạo golden pattern đầu tiên. * **Nội dung:** * Lý thuyết: Template trừu tượng hóa application scaffolding - Terraform định nghĩa hạ tầng, dependency, workflow, access control trong 1 nơi, dùng làm blueprint tái sử dụng. * Thực hành: Tạo Template từ module Ngày 3, developer consume template tạo application mới qua UI. * **Mini-Project:** 1 Template hoàn chỉnh: developer chỉ nhập tên app + region, hạ tầng còn lại tự động provision. ### Ngày 5: Input Variables cho Template * **Mục tiêu:** Kiểm soát biến nào khóa cứng, biến nào để developer tự nhập. * **Nội dung:** * Lý thuyết: Platform team chọn/khóa giá trị biến, hoặc để developer tự cung cấp giá trị khi tạo ứng dụng. * Thực hành: 1 biến khóa cứng (compliance - vd region chỉ us-east-1), 1 biến developer tự chọn (instance size). # TUẦN 2 - Add-ons, Actions, RBAC & Catalog ### Ngày 6: Add-ons - quản lý dependency ứng dụng * **Mục tiêu:** Tách "app core infra" (Template) khỏi "dependency" (Add-on). * **Nội dung:** * Lý thuyết: Add-on định nghĩa resource hạ tầng bằng Terraform, cung cấp như dependency (database, cache, queue) trong vòng đời ứng dụng. * Thực hành: Tạo Add-on "Redis cache", cài vào application Ngày 4. * **Mini-Project:** Application có Template (compute) + 2 Add-on (Postgres, Redis) cài/xóa độc lập. ### Ngày 7: Variable Outputs * **Mục tiêu:** Developer đọc được kết quả provisioning mà không cần vào Terraform trực tiếp. * **Nội dung:** Lý thuyết + thực hành: Expose connection string của Add-on Redis ra UI Waypoint cho developer đọc. ### Ngày 8: Actions - golden workflow vận hành * **Mục tiêu:** Chuẩn hóa thao tác vận hành hàng ngày, không chỉ tạo hạ tầng. * **Nội dung:** * Lý thuyết: HCP CLI/Terraform provider dùng HCP API truy cập resource Waypoint; Action định nghĩa và thực thi golden workflow (build, rollback, thao tác private environment). * Thực hành: Action gọi webhook trigger CI/CD pipeline (vd GitHub Actions) từ Waypoint UI. * **Mini-Project:** Action "Rollback" gắn vào Template Ngày 4 - 1 nút bấm trigger Terraform run về version trước. ### Ngày 9: RBAC & Access Control * **Mục tiêu:** Kiểm soát ai tạo Template, ai chỉ consume. * **Nội dung:** * Lý thuyết: HCP Waypoint thực thi authentication/authorization mọi thao tác qua UI/API/CLI/Terraform Provider, quyền giới hạn theo Role-Based Access Control. * Thực hành: Role "platform team" (full quyền Template/Add-on) vs "app developer" (chỉ consume). ### Ngày 10: Project Selection & tổ chức multi-team * **Mục tiêu:** Nhiều team dùng chung HCP org mà không đụng workspace của nhau. * **Nội dung:** Lý thuyết: Cấu hình Template/Add-on chọn HCP Terraform project cụ thể khi tạo workspace. ### Ngày 11: Application Catalog * **Mục tiêu:** Nguồn sự thật cho toàn bộ ứng dụng trong org. * **Nội dung:** Lý thuyết: Catalog giúp platform/operations team tìm câu trả lời vận hành nhanh. * Thực hành: Duyệt catalog, gắn metadata/tag cho từng application. # TUẦN 3 - Production Fundamentals ### Ngày 12: Template Upgrade Path * **Mục tiêu:** Vận hành golden pattern theo thời gian - phần production quan trọng nhất. * **Nội dung:** * Lý thuyết: Platform engineer cập nhật no-code module gốc → khả năng upgrade của Template đẩy cập nhật tới mọi ứng dụng đã tạo từ template đó. * Thực hành: Sửa module Ngày 3 (thêm tag bắt buộc), publish version mới, trigger upgrade cho app cũ, quan sát Plan diff. * **Mini-Project:** Quy trình "propose → test → publish → rollout" cho 1 thay đổi compliance bắt buộc. ### Ngày 13: Security Model của HCP Waypoint * **Mục tiêu:** Đánh giá đúng mức an toàn khi giao golden pattern cho nhiều team. * **Nội dung:** Lý thuyết: Giao tiếp client↔Waypoint và nội bộ với dịch vụ khác (HCP Terraform) mã hóa TLS; dữ liệu nhạy cảm (token, output, biến sensitive dùng cho Actions) mã hóa bằng Vault Transit trước khi lưu database. ### Ngày 14: IaC hóa Waypoint * **Mục tiêu:** Quản lý Template/Add-on bằng code, không thao tác tay qua UI. * **Nội dung:** * Lý thuyết: Terraform provider `hashicorp/hcp` quản lý resource như `hcp_waypoint_application`. * Thực hành: Viết Terraform config định nghĩa lại Template/Add-on Ngày 4-6. * **Mini-Project:** Toàn bộ setup Waypoint (Template + Add-on + RBAC) version-controlled 100% bằng Terraform. ### Ngày 15: CI/CD Integration * **Mục tiêu:** Golden workflow gắn liền pipeline hiện có. * **Nội dung:** Lý thuyết: Waypoint tích hợp CI/CD hiện có, cung cấp lớp trừu tượng nhất quán. * Thực hành: Action trigger GitHub Actions build → kết quả hiện ngược trong catalog. ### Ngày 16: Bối cảnh Legacy OSS & So sánh tự build IDP (nửa ngày + nửa ngày) * **Mục tiêu:** Nhận diện hệ thống cũ nếu gặp, và biết khi nào nên/không nên dùng Waypoint. * **Nội dung:** * (0.5 ngày) Legacy OSS: `waypoint.hcl`, 3-stage build/deploy/release, server tự host - chỉ cần đủ nhận diện, không đầu tư sâu vì đã archived. * (0.5 ngày) So sánh: Waypoint tốn chi phí HCP Terraform Plus, đổi lại có UI self-service + RBAC + catalog + upgrade path sẵn - vs tự build script/portal riêng. ### Ngày 17: Thiết kế Golden Pattern cho tổ chức thật * **Mục tiêu:** Áp dụng vào bài toán thực tế. * **Nội dung:** Thực hành: Liệt kê 3-5 loại ứng dụng phổ biến (web service, batch job, static site...), thiết kế Template + Add-on tương ứng cho mỗi loại. # TUẦN 4 - HCP Terraform ### Ngày 18: Workspace Lifecycle * **Mục tiêu:** Hiểu chính xác điều gì xảy ra khi Waypoint "âm thầm" gọi API. * **Nội dung:** * Lý thuyết: Vòng đời `Create Workspace → Plan → Policy Check → Apply → Destroy`; execution mode (remote/local/agent); mỗi application/add-on = 1 workspace riêng. * Thực hành: Tìm workspace Waypoint tự tạo ở Ngày 4, đọc log Plan/Apply thô. * **Mini-Project:** Trace toàn bộ vòng đời 1 workspace từ "Create App" đến Apply xong, ghi chú từng bước API call. ### Ngày 19: Run Tasks * **Mục tiêu:** Chèn kiểm tra tùy chỉnh giữa Plan và Apply. * **Nội dung:** * Lý thuyết: Run Task là webhook gọi ở post-plan/pre-apply, tích hợp scan bên thứ 3 (cost estimation, security scan). * Thực hành: Đăng ký Run Task chặn Apply nếu Plan thiếu tag bắt buộc. ### Ngày 20: Policy Sets (Sentinel/OPA) * **Mục tiêu:** Guardrail ở tầng Terraform, không chỉ ở tầng Template. * **Nội dung:** * Lý thuyết: Policy Set gắn workspace/project, chạy tự động mọi run; `advisory` (cảnh báo) vs `hard-mandatory` (chặn cứng). * Thực hành: Viết Sentinel policy chặn instance type ngoài whitelist, gắn vào project chứa workspace Waypoint. ### Ngày 21: Variable Sets & Dynamic Credentials (OIDC) * **Mục tiêu:** Quản lý credential tập trung, không hardcode secret. * **Nội dung:** * Lý thuyết: Variable Set dùng chung nhiều workspace; Dynamic Provider Credentials qua OIDC - lấy short-lived credential từ AWS/Azure/GCP mỗi run thay vì static key. * Thực hành: Cấu hình OIDC trust HCP Terraform ↔ AWS IAM role, verify workspace Waypoint chạy không cần static access key. * **Mini-Project:** Pipeline Waypoint → HCP Terraform → AWS chạy 100% dynamic credentials, có ít nhất 1 Sentinel policy chặn vi phạm compliance. # TUẦN 5 - Registry Design, Versioning, Multi-cloud ### Ngày 22: Private Module Registry Architecture * **Mục tiêu:** Registry không hỗn loạn khi scale. * **Nội dung:** * Lý thuyết: Phân lớp theo domain (`networking/` → aws-vpc, aws-eks, aws-rds; `application/` → web-service, batch-job, cron-job); registry thiết kế kém → Template rời rạc, khó audit. * Thực hành: Tái cấu trúc registry đã dùng theo layer domain, naming convention thống nhất. ### Ngày 23: Semantic Versioning Strategy cho Template * **Mục tiêu:** Upgrade có kiểm soát, không chỉ "upgrade được". * **Nội dung:** * Lý thuyết: Semver (`v1.0.0 → v1.1.0 → v2.0.0`); `non-breaking` (thêm optional variable) vs `breaking` (đổi tên/xóa output); trạng thái `supported` vs `deprecated`. * Thực hành: Changelog cho module Ngày 3, giả lập breaking change (đổi tên output), viết migration note. * **Mini-Project:** Văn bản chính sách versioning: quy tắc bump version, deprecation window, cách thông báo breaking change qua catalog. ### Ngày 24: Multi-Cloud Pattern Design * **Mục tiêu:** Template không khóa cứng vào 1 cloud. * **Nội dung:** * Lý thuyết: Tách `Abstract Template` (interface chung) khỏi `Provider-specific module` bên dưới - Template "Web Service" map tới AWS ECS / Azure Container Apps / Cloud Run tùy `cloud_provider`. * Thực hành: 2 module cùng interface biến/output (`aws-ecs-service`, `gcp-cloudrun-service`), 1 Template chọn theo biến. * **Mini-Project:** Template "Web Service" chạy trên cả AWS và GCP chỉ bằng đổi 1 biến. # TUẦN 6 - Analytics, FinOps, Day-2, Ecosystem ### Ngày 25: Platform Analytics & Observability * **Mục tiêu:** IDP phải tự đo được sức khỏe/mức sử dụng của chính nó. * **Nội dung:** * Lý thuyết: 4 loại chỉ số - audit log (ai tạo/xóa app), usage metrics (Template dùng nhiều nhất), adoption metrics (% team đã dùng Waypoint), error rate theo Template. * Thực hành: Export audit log ra dashboard đơn giản, tính adoption rate giả lập. ### Ngày 26: FinOps & Cost Controls trong Template * **Mục tiêu:** Ngăn developer tạo tài nguyên vượt ngân sách từ thiết kế. * **Nội dung:** * Lý thuyết: Ép giới hạn trong biến Template (whitelist `instance_type`, `max_size` autoscaling, tag `cost_center` bắt buộc); kết hợp Sentinel cost policy (Ngày 20) để chặn cứng. * Thực hành: Validation block trong module Terraform giới hạn `instance_type`. * **Mini-Project:** Template có cost guardrail đầy đủ: whitelist size, tag bắt buộc, cảnh báo vượt ngưỡng qua Run Task. ### Ngày 27: Day-2 Operations * **Mục tiêu:** Trả lời "Template tạo app xong, 6 tháng sau thì sao?" * **Nội dung:** * Lý thuyết: Scaling, backup định kỳ, credential/certificate rotation, patch management (Add-on version bump theo lịch). * Thực hành: Action "Backup Database" gọi API snapshot Add-on Postgres, lên lịch chạy định kỳ qua CI/CD trigger. * **Mini-Project:** Runbook Day-2 đầy đủ cho 1 application: scale, backup, rotate credential, patch - mỗi quy trình có 1 Action tương ứng. ### Ngày 28: Ecosystem Integration * **Mục tiêu:** Waypoint hiếm khi đứng một mình trong enterprise lớn. * **Nội dung:** * Lý thuyết: Backstage làm catalog UI tổng hợp (Waypoint là 1 data source), Jira/ServiceNow cho approval workflow trước khi Action chạy, Datadog/PagerDuty nhận alert khi Apply fail hoặc Day-2 Action lỗi. * Thực hành: Action gửi notification Slack/PagerDuty khi Terraform run fail. * **Mini-Project:** Sơ đồ tích hợp Waypoint vào hệ sinh thái enterprise giả định: Backstage + Jira + Datadog + PagerDuty. # TUẦN 7 - Governance tổng hợp & Capstone ### Ngày 29: Governance & Compliance tổng hợp * **Mục tiêu:** Hợp nhất toàn bộ guardrail đã học thành 1 chính sách governance nhất quán. * **Nội dung:** Thực hành: Khóa cứng biến compliance (region, tagging, encryption) trong Template kết hợp Sentinel policy (Ngày 20) - viết thành 1 tài liệu governance duy nhất cho tổ chức. ### Ngày 30: Capstone - Internal Developer Platform Enterprise-grade * **Yêu cầu:** 1. Registry phân lớp domain rõ ràng (`networking/`, `application/`), naming convention nhất quán. 2. Tối thiểu 2 Template hỗ trợ multi-cloud (cùng interface, khác provider - AWS + GCP hoặc AWS + Azure). 3. Chính sách semantic versioning bằng văn bản, đã test rollout 1 breaking change có migration note. 4. Toàn bộ workspace chạy bằng Dynamic Credentials (OIDC) - không secret tĩnh. 5. Ít nhất 1 Sentinel policy hard-mandatory + 1 Run Task (cost estimation hoặc security scan). 6. Cost guardrail trong Template (whitelist size, tag bắt buộc, cảnh báo vượt ngân sách). 7. Ít nhất 2 Action Day-2 (backup + rollback) hoạt động thật, lên lịch được. 8. Dashboard theo dõi adoption/error rate theo Template. 9. Ít nhất 1 điểm tích hợp ecosystem thật (Slack/PagerDuty alert khi Apply fail). 10. RBAC phân quyền platform team vs developer, toàn bộ Template/Add-on định nghĩa bằng Terraform (`hashicorp/hcp` provider), version-controlled trên Git.