Tuy nhiên sau khi tìm hiểu về cơ chế thì mình thấy việc này không hề giả trân 😆 bạn có thể tham khảo paper sau Bypassing Content-based internet packages with an SSL/TLS Tunnel, SNI Spoofing, and DNS spoofing được submit vào tháng 12 năm 2022.

Cơ chế đơn giản như sau

Chuyển hướng toàn bộ lưu lượng web đến một VPS cá nhân, giả mạo thông tin kết nối để ISP tin rằng bạn đang truy cập một máy chủ hợp pháp như máy chủ zoom.us, tiktok.com. Sau khi lưu lượng được chuyển hướng đến VPS, nó sẽ được chuyển đến các điểm đích thông qua một máy chủ proxy hoặc VPN cài đặt trên VPS. Điều này cho phép người dùng sử dụng internet chùa mà không bị hạn chế. :blush:

Về cơ bản thì nhà mạng vẫn làm ngơ thôi, còn nếu muốn chặn thì mình nghĩ chắc vẫn có cơ chế block 🥲

TSError: ⨯ Unable to compile TypeScript:
worker/generate.ts:18:4 - error TS2322: Type '"batch"' is not assignable to type '"fine-tune" | "assistants"'.

18    purpose: "batch",
      ~~~~~~~

  node_modules/openai/resources/files.d.ts:119:5
    119     purpose: 'fine-tune' | 'assistants';
            ~~~~~~~
    The expected type comes from property 'purpose' which is declared here on type 'FileCreateParams'

Đi vào trong source code của node_modules pakage này mình phát hiện một điều, trong file openai-node/src/resources/files.ts - L185. Property purpose thiếu mất type là batch.

purpose: 'fine-tune' | 'assistants';

Trong thời gian chờ team dev của OpenAI fix lỗi này (Mình đã log 1 issue tại đây). Để có thể dùng được thư viện, chúng ta cần override lại FileCreateParams Interface.

Có khá nhiều cách, trong bài viết này mình sử dụng Remap paths trong tsconfig. Theo nghĩa đen, chỉ cần sao chép, dán nguyên văn nội dung file từ node_modules và áp dụng các bản sửa lỗi của riêng bạn.

// tsconfig.json
{
  "paths": {
    "openai/resources/*": ["worker/declarations/openai/resources/*"]
  }
}

Trong thư mục worker/declarations/openai/resources/ mình tạo 1 file index.d.ts với nội dung sửa lại purpose như sau:

...

export interface FileCreateParams {
	/**
	 * The File object (not file name) to be uploaded.
	 */
	file: Uploadable;
	/**
	 * The intended purpose of the uploaded file.
	 *
	 * Use "fine-tune" for
	 * [Fine-tuning](https://platform.openai.com/docs/api-reference/fine-tuning) and
	 * "assistants" for
	 * [Assistants](https://platform.openai.com/docs/api-reference/assistants) and
	 * [Messages](https://platform.openai.com/docs/api-reference/messages). This allows
	 * us to validate the format of the uploaded file is correct for fine-tuning.
	 */
	purpose: "assistants" | "batch" | "fine-tune";
}
export interface FileListParams {
	/**
	 * Only return files with the given purpose.
	 */
	purpose?: string;
}

...
//# sourceMappingURL=files.d.ts.map

Ngoài ra nếu bạn không muốn phải chỉnh sửa compilerOptions trong tsconfig.json. Tạo thư mục node_modules trong src của bạn, sau đó đặt typings của modules bạn muốn ghi đè vào bên trong:

├── node_modules
│   └── ...
│
└── src
    ├── index.ts
    ├── ... your codes ...
    │
    └── node_modules
        └── <module-to-be-overwritten>
            └── index.d.ts

Tham khảo thêm tại How TypeScript resolves modules section.

• Stackoverflow
  • Best way to override third party TypeScript types in node_modules
  • Exclude/overwrite npm-provided typings

Cảm ơn bạn đã quan tâm tới tận cuối bài viết 😆

Ban đầu cá nhân mình cũng rất mong muốn được một Data Engineer có nhiều kinh nghiệm chinh chiến trong nghề giúp sức, nhưng tìm hoài trong công ty không có vị trí này và cũng chưa thấy có ai đã từng vận hành hệ thống kiểu này cho khách, nên thôi tự mình thử implement coi sao 🫣, nếu bạn cũng có kinh nghiệm với các hệ thống xây dựng data pipeline kiểu này, hãy để lại comment góp ý nhé 🚀

Bối cảnh

Hệ thống của khách hàng có 3 services chính, phục vụ end-user, mỗi service lại sử dụng các 3rd-party khác nhau để thu thập metrics nhằm theo dõi, đo lường, phân tích hành vi người sử dụng.

Mục đích cuối cùng là để có những bản báo cáo, phân tích, giúp bộ phận Marketing có sự đánh giá chính xác hơn về tình hình kinh doanh online và có cơ sở thực tế để thực hiện các chiến dịch Marketing, quảng cáo hiệu quả hơn.

Hệ thống gồm 3 services, và các event logs được gửi tới nhiều 3rd services phục vụ cho việc lưu trữ. Các event logs này sau đó được biến đổi cấu trúc và lưu lại vào mấy dịch vụ OLAP (Online Analytical Processing) serverless query service đại loại như GCP BigQuery, AWS Athena.

Dữ liệu từ các OLAP services sẽ được query và thực hiện insert vào AWS DynamoDB bởi một Batch Process đã được lập lịch.

Để quản trị viên có thể dễ dàng phân tích số liệu qua biểu đồ, phía khách hàng đã build một ứng dụng riêng, quẩy dữ liệu sau cùng từ AWS DynamoDB và hiển thị cho quản trị viên, nhân viên bán hàng, …

Vấn đề

Hệ thống trên đang tồn tại một số vấn đề như:

• Độ trễ trong việc hiển thị dữ liệu mới nhất, không phù hợp ở thời điểm cần phản hồi nhanh.
• Cấu trúc / Format dữ liệu không đồng nhất giữa các services
• Cần nhiều tài nguyên: thời gian xử lý, cấu hình máy chủ do dữ liệu ứ đọng lớn
• Gánh nặng quản trị hệ thống khi xảy ra lỗi một thành phần nào đó trong hệ thống

Trước những vấn đề đó, khách hàng tìm tới chúng tôi mong muốn có giải pháp khắc phục hiện trạng này. Như vậy cần cải thiện hệ thống để khắc phục các nhược điểm trên.

Giải pháp

Để tiết kiệm tiền cho khách, đội dự án đập toàn bộ những phần cũ đi và xậy lại một Data Stream Pipeline 😆

• Thời Gian Thực (Real-time): Cho phép xử lý dữ liệu ngay lập tức khi nó được tạo ra,thông tin mới nhất sẽ có sẵn ngay khi nó xuất hiện.
• Khả Năng Mở Rộng (Scalability): Thích ứng với các biến động trong khối lượng dữ liệu.
• Phản Hồi Nhanh (Quick Feedback): Với khả năng xử lý dữ liệu ngay lập tức, data stream pipeline cung cấp phản hồi nhanh chóng, giúp người dùng có thể đưa ra quyết định dựa trên thông tin mới ngay khi nó có sẵn.
• Xử Lý Dữ Liệu Liên tục (Continuous Data Processing): Không chờ đến khi có một lô dữ liệu đầy đủ như trong batch processing.
• Tính Linh Hoạt (Flexibility): Data stream pipeline thường linh hoạt hơn với khả năng xử lý dữ liệu đa dạng từ nhiều nguồn và định dạng khác nhau. Việc thêm mới và cập nhật dữ liệu có thể được thực hiện dễ dàng hơn.
• Tiết Kiệm Tài Nguyên (Resource Efficiency): Do data stream pipeline thường chỉ xử lý dữ liệu cần thiết và không đợi đến khi có lượng dữ liệu lớn, nó có thể tiết kiệm tài nguyên so với việc xử lý theo batch.

Kiến trúc Pipeline

Trong kiến trúc trên thì các services lần lượt đóng vai trò nhiệm vụ sau:

• AWS Kinesis Data Streams: Source Stream
• AWS Kinesis Data Firehose: Delivery Stream
• AWS Lambda: Transformer Function
• AWS S3: Data Lake
• Snowflake: Data Warehouse

Tất cả đều là Fully Managed Services giúp giảm gánh nặng quản trị hệ thống cho đội ngũ kỹ sư hạ tầng bên khách.

Data Flow

• ① Các services hiện tại sẽ tích hợp Kinesis Client và thực hiện PUT event vào Source Stream (AWS Kinesis Data Streams).
• ② Sau đó event sẽ được chuyển tới Delivery Stream (AWS Kinesis Data Firehose)
  • ③ Tại đây event sẽ được phân loại, validate, transform thông qua Transformer Function (Lambda Function).
    • Trong trường hợp này chỉ đơn thuần là convert từ JSON dang CSV format (Loading data into Snowflake is fast and flexible. You get the greatest speed when working with CSV files)
• ④ Dữ liệu sau xử lý sẽ đi vào Data Lake (AWS S3)
• ⑤ Từ AWS S3, thông qua Snow Pipe Auto-ingestion, dữ liệu được đồng bộ tới Database > Table trên Data Warehouse (Snowflake)

Monitoring

… To be define :relieved:

Proof of Concept

Toàn bộ code thực hiện demo từ khâu triển khai xây dựng hạ tầng trên AWS = CDK, Cấu hình Snowflake, Thực hiện PUT dummy Orders data tới Source Stream đều đã được public lên Github cá nhân mình:

⭐ 🌟 https://github.com/euclid1990/data-stream-pipeline :bell:

1. Chuẩn bị tài khoản

• Đăng ký tài khoản AWS: https://portal.aws.amazon.com/billing/signup
• Đăng ký tài khoản Snowflake: https://signup.snowflake.com
  • Sau khi hoàn tất đăng ký bạn sẽ có 400$ credit / Trial trong 1 tháng

2. Cấu hình chung

Trước hết chúng ta cần có source code trên máy

git clone git@github.com:euclid1990/data-stream-pipeline.git
cd data-stream-pipeline

Chỉnh sửa tệp tin .env

$ cp .env.example .env
$ code .env

CDK_STACK="PipelineStack"   >>>  Tên stack sẽ tạo trên AWS
CDK_ACCOUNT="123456789012"  >>>  *AWS Account ID* của bạn / Bắt buộc chỉnh sửa
CDK_REGION="us-east-1"      >>>  Region sẽ thực hiện deploy stack trên
CDK_USER_NAME="cdk"         >>>  Tên user name tạo mới để chạy CDK, tách biệt với default account
CDK_ROLE_NAME="cdk-role"    >>>  Role mà CDK_USER_NAME sẽ assume để có permission cần thiết provision AWS resources
CDK_USER_POLICY_NAME="cdk-inline-policy"   >>>  Tên user name tạo mới để chạy CDK, tách biệt với default account

Thêm quyền execute cho toàn bộ Bash script trong thư mục /scripts

chmod +x ./scripts/*/**/*.sh

3. Tạo AWS User/Role chạy CDK app

./scripts/create_iam_user_role.sh

4. Thực hiện deploy AWS Stack

./scripts/cdk.sh deploy --outputs-file ./outputs.json

Kết quả

Toàn bộ các Outputs sẽ được save ở file ./outputs.json phục vụ cho việc setup Snowflake cũng như Produce event tới Kinesis Data Streams

5. Cấu hình Snowflake Auto-ingest S3 Data

Chi tiết bước này đã được phía Snowflake hướng dẫn rất kỹ tại đây

• Refreshing External Tables Automatically for Amazon S3

Mình đã re-write lại các step = bash script cho tiện

• 5.1. Giới hạn quyền truy cập tới AWS S3 Bucket theo VPC ID của Snowflake account

  • Truy vấn thông tin VPC ID trên Snowflake nơi đặt tài khoản Snowflake của bạn trên AWS
    • Nội dung SQL Query: ./scripts/snowflake/01-allow-vpc-id/retrieve_snowflake_aws_vpc_id.sql
    • Kết quả

  • Thiết lập Bucket Policy tương ứng

    ./scripts/snowflake/01-allow-vpc-id/restrict_s3_access_to_vpc.sh <VPC_ID>
    

• 5.2. Cấu hình quyền truy cập từ Snowflake tới AWS S3

  • Tạo mới IAM Policy

    ./scripts/snowflake/02-aws-snowflake-s3-access-policy/create.sh
    

    

  • Tạo mới IAM Role trên AWS

    ./scripts/snowflake/03-aws-snowflake-iam-role/create.sh`
    

    Output của việc thực thi script

    

    Kết quả trên AWS IAM Roles

    

    Ở bước này, toàn bộ các câu SQL cần dùng để thực thi trong các step sắp tới đã được generate thành file ./scripts/snowflake/03-aws-snowflake-iam-role/integration.sql.

    

    Hãy copy & paste sang SQL Worksheet trên Snowflake.

    • Tạo Database s3_to_snowflake
    • Tạo S3 Storage Integration s3_int

    • Thực hiện truy xuất ARN của AWS IAM user được tạo tự động cho tài khoản Snowflake của bạn

      

      • STORAGE_AWS_IAM_USER_ARN: AWS IAM user được tạo cho tài khoản Snowflake của bạn. Tất cả các tích hợp lưu trữ S3 đều sử dụng IAM user đó.
      • STORAGE_AWS_EXTERNAL_ID: External ID cần thiết để thiết lập mối quan hệ tin cậy trust relationship.

    Thực thi theo các bước hướng dẫn từ Output của script trên.

    • Cho phép Snowflake IAM User quyền được truy cập tới Bucket Objects

      ./scripts/snowflake/03-aws-snowflake-iam-role/update.sh <STORAGE_AWS_IAM_USER_ARN> <STORAGE_AWS_EXTERNAL_ID>
      

      Kết quả trên AWS, Trust relationships đã được cập nhật

      

• 5.3. Làm mới dữ liệu của external table với Amazon SQS notifications cho S3 bucket

  • Sử dụng nội dung trong ./scripts/snowflake/03-aws-snowflake-iam-role/integration.sql để tạo mới
    • Stage
    • CSV Format
    • External Table

  • Sau đó chúng ta có thể truy xuất thông tin tới ARN của SQS queue cho External table trong cột notification_channel

  • Thực hiện cấu hình Event Notifications cho S3 Bucket với giá trị cột notification_channel

    ./scripts/snowflake/04-aws-s3-event-notification/create.sh <notification_channel_arn>
    

    Kết quả trên AWS, S3 Event Notification đã được cập nhật

    

6. Kiểm tra việc Sync dữ liệu / Auto-ingest sang Snowflake

Before

• Dữ liệu trên AWS S3 và Snowflake đều chưa có gì 🚫

  

  

After

• Thực hiện stream 1,800 records tới AWS Kinesis Data Streams

./scripts/produce.sh 1800

• Dữ liệu xuất hiện tại S3 Desitnation Stream

  

• Dữ liệu được auto-ingest tới Snowflake Table

  Record ID = 1,800 đã có mặt 😆

  

🍀 Như vậy chúng ta có thể xác nhận luồng dữ liệu hoạt động như mong đợi. Kiểm chứng đề xuất có khả năng hiện thực hoá 💯

Cảm ơn bạn đã quan tâm tới tận cuối bài viết 🚀

Hệ thống của mình là một web app thông thường được host trên AWS với mô hình giản lược sau:

Toàn bộ Traffic sẽ đi qua các thành phần CloudFront, ALB trươc khi tới ECS Cluster.

Cụm ECS gồm có 3 thành phần Container chính

• NGINX: Đóng vai trò reverse proxy nhận request
• Web Application: Dynamic web app nhận request từ Nginx
• Fluentd: Push log từ NGINX và Web Container sang Firehorse > Opensearch > Kibana phục vụ cho việc phân tích log. (Custom log routing / Streaming AWS ECS logs via Fluentd using AWS FireLense)

Vấn đề

Vào một ngày bình thường như bao ngày, AWS liên tục gửi alert về việc % sử dụng CPU của RDS Database liên tục trên ngưỡng 90% đáng báo động 😢

Trước hoàn cảnh đó, cả team cần gấp rút tìm ra nguyên nhân tại sao lại xảy ra hiện tượng như vậy. Chúng ta hãy sang phần tiếp theo xem đội dự án đã xử lý ra sao.

Quá trình điều tra

Giai đoạn 1

Thuận tự nhiên, lỗi ở RDS thì engineer vào AWS RDS Performance Insight > TOP SQL. Phát hiện ra câu query chính khiến tải RDS tăng.

SELECT `articles`.`id`
FROM `articles`
WHERE `articles`.`deleted_at` IS NULL
ORDER BY `articles`.`id`
DESC LIMIT 8 OFFSET 357678
/*controller:article,action:index*/

Câu query thực gây ra việc tăng tải của hệ thống đã được thay đổi

Hàng loạt các câu query tương tự như trên xuất hiện trong bảng xếp hạng TOP những câu query chiếm tài nguyên của RDS.

Ở giai đoạn này chúng tôi phán đoán ở ArticleController > Index action đang phát sinh nhiều request hơn thực tế.

Giai đoạn 2

Điều tra log người dùng truy cập hệ thống xem bất thường gì không.

Với thiết kế ban đầu, hệ thống sẽ lưu toàn bộ dữ liệu log người dùng truy cập để phục vụ cho Marketing Insight và Debug. Logs được đẩy vào Opensearch và Visualize trên Kibana.

Filter log truy cập url article bởi NGINX theo khoảng thời gian, team phát hiện số lượng request tăng đột biết từ 10~15k request trong khoảng thời gian phát sinh sự cố. Đặc biết khi chú ý tới giá trị OFFSET câu query SQL ở giai đoạn 1, và query parameter phân trang ?page=. Nhận thấy các số trong page đều chạy từ nhỏ đến rất lớn (>= 10,000), hành vi này không giống với thực tế end-user sử dụng mà thay vào đó khá giống từ Crawler Bot đi thu thập dữ liệu.

Trích xuất thông tin từ dữ liệu log, đội dự án thu được 2 thông tin chính:

• Dải IP của BOT (Check thông tin tại ipinfo)
  • 123.100.101.0/24
  • 123.100.102.0/24
  • …
  • Đã chỉnh sửa khác với giá trị thực tế

  • Để get network IP / CIDR 24 từ danh sách các IP có thể dụng đoạn code Javascript/NodeJS sau:

    const ipList = [
      '123.100.101.1',
      '123.100.101.2',
      '123.100.102.5',
      ...
    ];
    
    function getCIDR(ip) {
      const ipParts = ip.split('.');
      return ipParts.slice(0, 3).join('.') + '.0/24';
    }
    
    const cidrArray = ipList.map(getCIDR);
    
    const uniqueCIDRs = Array.from(new Set(cidrArray));
    
    console.log(uniqueCIDRs);
    

• Header User-Agent của BOT

  Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36
  

Giải pháp

Kết thúc giai đoạn 2, đội dự án phán đoán nguyên nhân RDS tăng tải do xuất hiện nhiều request từ Crawler Bot.

Đầu tiên cần xác định quan điểm chặn, phạm vi ảnh hưởng tới người dùng thực:

• Chặn những page mà chỉ có Bot muốn vào, người dùng hiếm vào (Hành vi)
• Chặn những page có performance thấp, ảnh hưởng RDS nếu tần suất truy cập nhiều

Từ đó đưa ra các giải pháp block access / chặn truy cập từ Crawler Bot như.

• Chặn truy cập theo header trên ALB listener rules
  • Condition match header của Bot
  • Action return fixed response 503
• Chặn truy cập từ các client IP thuộc dải IP của Bot / 1 trong 2 cách
  • Chặn truy cập trên WAF > WebACLs
    • Sử dụng Rule builder > Block hoặc Rate Limit các truy cập từ IP set của Bot
      • Rate-based rule statement
      • Cấu hình các quy tắc - Aggregation options and keys

      • Ví dụ:

        

        Mặc định mỗi WebACLs sẽ có 5000 WCU (WAF web ACL capacity units). 1 Rule trên sẽ mất 7 WCU. Nếu dùng quá 1500 WCU thì bạn cần lưu ý thêm Price của AWS WAF tại đây, bởi lúc đó AWS sẽ charge phí sử dụng.

    • Có thể sử dụng thêm Match regex URI / Query string với condition ?page= để giảm thiểu độ ảnh hưởng
  • Chặn truy cập ở NGINX Layer
    • Sử config của NGINX bằng cách thêm phần map là IP range của Bot. ($http_cf_client_ip là real client IP được thêm vào header từ CloudFront)

    http {
      map $http_cf_client_ip $block_access {
        ~*^123\.100\.101\..*$   1;
        ~*^123\.100\.102\..*$   1;
        default                 0;
      }
    
      server {
    
        location / {
          if ($block_access) {
            return 403;
          }
          try_files $uri @app;
        }
    
        location @app {
          proxy_pass http://app_service;
          ...
        }
      }
    }
    

Sau nhiều cân nhắc thì kết quả đội dự án quyết định sử dụng giải pháp AWS WAF - WebACLs với khả năng block request linh hoạt và hiệu quả.

Kiểm tra

Sử dụng conditions với điều kiện hẹp hơn, và các công cụ benchmark request như ApacheBench

$ ab -A basicAuthUsername:basicAuthPassword -n 100 -c 10 "https://example.com/"

-n requests: Số lượng request được gửi
-c concurrency: Số lượng request được thực hiện 1 thời điểm

Bổ sung kiến thức: CloudFront không pass Client IP sang ALB và NGINX, vậy làm thế nào để có thể get được Client IP trên các Layer này ??

Trên lý thuyết AWS cung cấp header “CloudFront-Viewer-Address” - Adding CloudFront request headers . Tuy nhiên muốn pass header này qua origin* cần **disable caching với Cache Policy.

Xem lại sơ đồ kiến trúc hệ thống, chúng ta thấy CloudFront module có trigger Lambda@Edge Function mỗi khi có request tới (Event Type = Origin-request). Về cơ bản để thêm header thì chỉ cần một đoạn code Javascript như sau:

'use strict';

exports.handler = (event, context, callback) => {
    const request = event.Records[0].cf.request;
    const clientIp = event.Records[0].cf.request['clientIp'];
    const headerName = 'CF-Client-IP';
    request.headers[headerName.toLowerCase()] = [{ key: headerName, value: clientIp }];
    callback(null, request);
    return;
};

Tham khảo thêm về Adding HTTP Security Headers Using Lambda@Edge and Amazon CloudFront

Trên NGINX layer config như sau để log ra Client IP

log_format main escape=json
  '{'
    ...
    '"request":"$request",'
    '"request_method":"$request_method",'
    '"host":"$host",'
    '"uri":"$uri",'
    '"status":"$status",'
    '"http_cf_client_ip":"$http_cf_client_ip",'
    ...
  '}';

access_log  /var/log/nginx/access.log  main;

Cảm ơn bạn đã quan tâm tới tận cuối bài viết 😆

Ví dụ, status của một button có thể là: "hidden", "enabled", "disabled".

Với Typescript chúng ta có ít nhất hai cách

// Kiểu string enums
export enum ButtonStatus {
  HIDDEN = 'HIDDEN',
  ENABLED = 'ENABLED',
  DISABLED = 'DISABLED',
};

// Kiểu string literal union types
type ButtonStatus = 'HIDDEN' | 'ENABLED' | 'DISABLED';

Có cũng có kiểu enum cơ bản (không có phần = 'HIDDEN'), khi đó các giá trị sẽ chạy từ 0 → 2, nhưng ta sẽ không bàn về nó trong bài viết so sánh này.

Nào, hãy bắt đầu so sánh coi 🥰

Declaring & Accessing

• Tính ngắn gọn trong khai báo
  • [✔] Union Type
  • [✘] String Enums
• Autocompletion trên Editor/IDE
  • [✔] Union Type
    • Tự động nhận trên VsCode
  • [✘] String Enums
    • Cần exported và imported mới hoạt động

Chiến thắng với 2 points cho Union types!

Extending

• [✔] Union Type

  type DynamicButtonStatus = ButtonStatus | 'LOADING';
  

• [✘] String Enums
  • Sử dụng trick spread operator

    export enum ButtonStatus {
      HIDDEN = 'HIDDEN',
      ENABLED = 'ENABLED',
      DISABLED = 'DISABLED',
    };
    
    // extend enum using "spread"
    const NewButtonStatus = {
        ...ButtonStatus,
        SHOW: 'SHOW',
        BLINK: 'BLINK'
    };
    

Thêm 1 point cho Union types!

TypeError

• [✔] Union Type
  • Playground Link

    // With union types of string literals
    type ButtonStatus = 'HIDDEN' | 'ENABLED' | 'DISABLED';
    
    function TestUnionType(status: ButtonStatus) {
      switch (status) {
        case 'HIDDEN': return 1;
        case 'ENABLED': return 2;
        case 'DISABLED': return 3;
        // Notice that there's no default case
      }
    }
    
    // Compile success if pass valid status with Union Type
    console.log(TestUnionType('HIDDEN'));
    
    // Compile error if pass invalid status with Union Type
    console.log(TestUnionType('SHOW'));
    

  • Error được phát hiện từ bước Transpile

    Argument of type '"SHOW"' is not assignable to parameter of type 'ButtonStatus'.
    

• [✘] String Enums
  • Playground Link

    // With string enums
    enum ButtonStatus {
      HIDDEN = 'HIDDEN',
      ENABLED = 'ENABLED',
      DISABLED = 'DISABLED'
    };
    
    
    function TestStringEnums(status: ButtonStatus) {
      switch (status) {
        case ButtonStatus.HIDDEN: return 1;
        case ButtonStatus.ENABLED: return 2;
        case ButtonStatus.DISABLED: return 3;
        default: return 4;
      }
    }
    
    const status1 = 'HIDDEN' as ButtonStatus;
    
    // Compile success if pass valid status with String Enums
    console.log(TestStringEnums(status1));
    
    const status2 = 'SHOW' as ButtonStatus;
    
    // NO Compile error if pass invalid status with String Enums
    console.log(TestStringEnums(status2));
    

  • Truyền sai giá trị status2 nhưng chương trình vẫn được transpiled và run bình thường.

Chỉ có 1 cách duy nhất để sử dụng union types, trong khi với enums bạn có thể sử dụng ButtonStatus.HIDDEN hoặc giá trị trực tiếp 'HIDDEN' mà không gặp phải compiler complaining.

Thêm 1 point về Typesafe cho Union types!

Iterating

• [✘] Union Type

  // Union types
  // ? Can't iterate over a type, defining an array is needed
  const ButtonStatus = ['HIDDEN', 'ENABLED', 'DISABLED'] as const;
  // Notice that the array and type can have the same name if you want
  type ButtonStatus = typeof buttonStatuses[number];
  
  for(const status of buttonStatus) {
    // ? the type of status here is ButtonStatus
    // ? always iterate in order
  }
  

• [✔] String Enums

  // String enums
  // ? Just do it
  for(const status in ButtonStatus) {
    // ? The type of status here is string
    // ? iteration order not guaranteed with "in"
  }
  

Trả lại 1 point cho String Enums

Renaming

• [✘] Union Type
  • Find and replace toàn Project
• [✔] String Enums
  • Right click > Rename symbol

Rõ ràng String Enums tiện hơn, trả thêm 1 point cho String Enums

Tổng kết

Trong bài viết so sánh trên quan điểm cá nhân mình thì Union Type nhận được 4 điểm và String Enums nhận được 2 điểm!

Hãy sử dụng Union types by default :laughing:

Nếu bạn có quan điểm khác, hãy để lại comment dưới bài viết này, xin chân thành cảm ơn các góp ý từ bạn đọc 🌺

• Bạn muốn demo website đang code cho khách hàng truy cập từ xa
• Bạn cần trỏ mobile app > backend API endpoint tới server trên máy cá nhân cho tiện debug
• Bạn muốn test tính năng webhook từ một service bên thứ 3 tới endpoint trỏ tới server trên localhost
• …

Việc bạn công khai ứng dụng lên internet sẽ không được khuyến khích vì lý do bảo mật, vì vậy hãy cân nhắc nhiều cách khác nhau, trước khi thực hiện điều đó.

Trước đây để thực hiện việc export ứng dụng ra ngoài Internet có rất nhiều công cụ hỗ trợ như Ngrok, Localtunnel, …

Trong bài viết này mình xin giới thiệu một công cụ mới, hỗ trợ Developer có thể làm việc này rất dễ dàng và hoàn toàn miễn phí, được cung cấp bởi VSCode ➡︎ Local Port Forwarding. Tính năng Built-in port forwarding - Forward local server ports from within VS Code được xuất hiện trên VSCode từ phiên bản 1.82.0.

Các bước thực hiện

Bước 1

Chuẩn bị ứng dụng, trong bài viết này mình sử dụng một web server chạy trên Localhost dùng Port 3000

Tất nhiên hãy để ý, phiên bản VSCode mà bạn đang sử dụng phải là phiên bản ≥ 1.82.0.

Bước 2

Sau khi đã khởi chạy server trên máy cá nhân, bạn tiến hành mở Project bằng VSCode, sau đó nhấn tổ hợp phím Ctr + Shift + P (Windows/Linux) hoặc Cmd + Shift + P (MacOS), tiếp đó tìm tới Forward a Port.

Bấm vào Forward A Port button

Bước 3

Nhập Port của server trên Local. Ở đây Bun server mình đang khởi động chạy trên cổng 3000

Sau đó nhấn Enter và chọn Allow

VSCode sẽ yêu cầu bạn tiến hành cấp quyền cho ứng dụng có thể truy cập tài khoản Github quyền read-only

Chọn Authorize Visual-Studio-Code và đợi một chút, bên ứng dụng VSCode sẽ hiện Logs khởi tạo địa chỉ cho ứng dụng của bạn trên Internet.

Chúng ta có thể tìm được địa chỉ Domain Address tại đây:

Bước 4

Truy cập thử Endpoint mà Port Forwarding cung cấp.

Sau khi cấp quyền cho Dev Tunnels của Microsoft, chúng ta đã có thể truy cập ứng dụng từ Internet.

:heart_eyes:

Mặc định địa chỉ này sẽ Private, tức là chỉ có bạn mới có thể truy cập được, nếu muốn công khai cho người ngoài truy cập thì hãy thiết lập Public Address trong cột Visibility như hình bên dưới.

Tổng kết

Trên đây mình đã giới thiệu tới bạn đọc cách chuyển tiếp Port của ứng dụng trên Local lên Internet với VSCode, hy vọng sẽ giúp ích cho bạn đọc.

Ngoài lề, forwarded ports được bảo mật thế nào ?

Mặc định, cả việc hosting và connecting tới tunnel đều yêu cầu authentication từ cùng một GitHub và Microsoft account.

VSCode không thiết lập bất kỳ listener nào ngoài việc kết nối ra tới services được hosted trên Azure.

Tuy nhiên, một khi Public Port (Thay vì Private), bất kỳ người dùng nào cũng có thể truy cập được. Cần cẩn thận để tránh lưu trữ bất kỳ thông tin bí mật hoặc dịch vụ không an toàn nào trên các cổng đó.

Nếu một tổ chức muốn kiểm soát quyền truy cập vào Forward Port, bạn có thể cho phép hoặc từ chối quyền truy cập vào miền global.rel.tunnels.api.visualstudio.com

Tham khảo thêm các giới hạn về Port Forwarding tại đây

Mình sẽ khởi động một chuỗi các bài viết mang tính thực chiến hơn là hướng dẫn chi tiết. Dù cho phương pháp trong bài viết có thể không là tối ưu hay cao siêu nhất … nhưng chắc chắn không phải kiểu bài viết chưa xài trên môi trường thực tế đã đem đi khè người nghe, khiến người đọc bị Bias theo suy nghĩ của tác giả 🤣

Nội dung bài viết có thể không phải 100% là của mình mà là của anh em đồng nghiệp, bạn bè gần xa để lại. Và toàn bộ kiến thức này được sử dụng trong dự án thực (nghe vậy thôi chứ anh em cũng đừng tin tưởng 100% 😆)

Để mở đầu, mình sẽ chia sẻ tới các bạn một issue mà bạn Trần Văn Tuấn đồng nghiệp của mình đã điều tra cùng khách nhằm giải quyết bài toán nâng cấp phiên bản MySQL từ 5.7 lên 8.0 trên Production (sản phẩm hơn 30 triệu end-users) sử dụng Amazon Relational Database Service (RDS). Nội dung bài viết này mình đã Remix lại một chút :joy:

1. Vấn đề

Hệ thống hiện tại sử dụng Amazon Relational Database Service (RDS) phiên bản MySQL 5.7 và Khách hàng mong muốn nâng cấp lên phiên bản MySQL 8.0

Mỗi phiên bản của không chỉ MySQL mà đa số các phần mềm đều có định dạng như sau MAJOR.MINOR.PATCH, do đó việc upgrade MySQL 5.7 → 8.0, đồng nghĩa với việc bạn thực hiện một MAJOR upgrade. Dĩ nhiên theo như tài liệu từ chính chủ thì:

Major version upgrades can contain database changes that are not backward-compatible with existing applications. As a result, you must manually perform major version upgrades of your DB instances. [1]

→ Tin buồn, bạn buộc phải upgrade bằng tay - upgrade manually ✋

For major version upgrades, you must manually modify the DB engine version through the AWS Management Console, AWS CLI, or RDS API. [2]

→ Và nếu như đang sử dụng AWS RDS, sẽ có những công cụ sau để nâng cấp phiên bản MySQL: AWS Console, AWS CLI hoặc RDS API. Và để giảm thiểu rủi ro thì việc sử dụng AWS CLI được khuyến khích hơn cả.

Cho dù dùng công cụ nào bạn cũng sẽ phải đương đầu với bài toán Downtime trên Production, như vậy nhiệm vụ của chúng ta ngoài việc đảm bảo hệ thống chạy ổn định trên phiên bản mới, còn phải giảm thiểu việc dịch vụ ngừng hoạt động khi đang tiến hành nâng cấp hệ thống.

2. Giải pháp

Có 2 hướng tiếp cận để nâng cấp MySQL engine version trên AWS RDS:

Hướng 1

Upgrade Directly, nâng cấp trực tiếp DB instance hiện tại từ MySQL v5.7 sang v8.0

Hướng 2

Use a Read Replica để nâng cấp, mục tiêu giảm Downtime của MySQL Database:

• Tạo một read replica từ master DB instance.
• Upgrade MySQL engine version của read replica instance.
• Promote read replica instance sang standalone DB instance → New master DB instance.
• Đổi DNS endpoint từ RDS endpoint hiện tại sang master DB instance’s endpoint mới.

Cho dù chọn cách nào thì bạn cũng cần chuẩn bị và diễn tập trước khi thao tác trên môi trường người dùng 😎

3. Chuẩn bị

3.1. Prechecks trước khi nâng cấp MySQL 5.7 lên 8.0

MySQL 8.0 includes a number of incompatibilities with MySQL 5.7. These incompatibilities can cause problems during an upgrade from MySQL 5.7 to MySQL 8.0. So, some preparation might be required on your database for the upgrade to be successful. [1]

Để đảm bảo việc nâng cấp suôn sẻ thì bạn cần đảm bảo các yêu cầu sau:

• Không có tables nào sử dụng các kiểu dữ liệu và hàm đã lỗi thời. Nếu có thì bạn cần sử dụng REPAIR TABLE trước khi nâng cấp sang bản 8.0.
• Không tồn tại các orphan *.frm files, keyword violations
• Trigger nếu có phải đảm bảo không bị thiếu
• Chi tiết hơn anh em xem tại đây.

Khi chúng ta bắt đầu upgrade thì AWS RDS sẽ thực hiện việc prechecks tự động để xác định các không tương thích. Tất nhiên nếu tồn tại, thì RDS sẽ ngăn ngừa việc upgrade và cho chúng ta một mả log để điều tra.

Cách chuẩn bị tốt nhất là chúng ta nên tạo test instance từ staging db snapshot, sau đó thử tiến hành upgrade, get log file xem có chỗ nào không tương thích không và tiến hành fix trên local trước.

MySQL cũng có sẵn các hướng dẫn xử lý vấn đề mà chúng ta có thể tham khảo:

• Upgrading MySQL
• Upgrading to MySQL 8.0? Here is what you need to know

3.2. Bật sao lưu dự phòng

Hãy đảm bảo rằng tính năng Auto backup được kích hoạt (hoặc giá trị của backup retention period ≥ 0).

Amazon RDS takes two DB snapshots during the upgrade process. The first DB snapshot is of the DB instance before any upgrade changes have been made. If the upgrade doesn’t work for your databases, you can restore this snapshot to create a DB instance running the old version. The second DB snapshot is taken when the upgrade completes.

Amazon RDS only takes DB snapshots if you have set the backup retention period for your DB instance to a number greater than 0. To change your backup retention period, see Modifying an Amazon RDS DB instance. [1]

Nếu option này không được kích hoạt thì chúng ta sẽ cần tạo snapshot thủ công.

A snapshot is taken (if backups are enabled) while the instance is still running on the previous version. If Amazon RDS doesn’t find any recent backups, a full snapshot is taken during the upgrade process, which can impact the overall upgrade time. [3]

Việc chủ động tạo một bản snapshot trước khi upgrade sẽ giúp giảm thời gian upgrade đi đáng kể.

Chúng ta có thể dùng aws-cli với câu lệnh sau:

aws rds create-db-snapshot \
    --db-instance-identifier $db_instance_name \
    --db-snapshot-identifier $db_snapshot_name

3.3. Một số điểm cần lưu ý khác

1. Upgrade DB instance OS (Optional)

To perform a major version upgrade for a MySQL version 5.6 DB instance on Amazon RDS to MySQL version 5.7 or later, first perform any available OS updates. After OS updates are complete, upgrade to each major version: 5.6 to 5.7 and then 5.7 to 8.0. MySQL DB instances created before April 24, 2014, show an available OS update until the update has been applied. For more information on OS updates, see Applying updates for a DB instance. [1]

Sẽ tốt hơn nếu hệ điều hành của DB instance được cập nhật.

1. Recheck targets which are needed to be upgraded

   If your MySQL DB instance is using read replicas, you must upgrade all of the read replicas before upgrading the source instance.

   If your DB instance is in a Multi-AZ deployment, both the primary and standby replicas are upgraded. Your DB instance will not be available until the upgrade is complete.

Chúng ta sẽ cần phải nâng cấp Read Replicas instances và DB instances ở cả các AZ khác.

4. Tiến hành Upgrade

Highlight Recommend: Testing an upgrade trước khi bạn quyết định sử dụng phương pháp nào

4.1. Upgrade Directly

• Sử dụng command sau:

  aws rds modify-db-instance \
      --db-instance-identifier $db_instance_name \
      --engine-version $new_mysql_version \
      --allow-major-version-upgrade \
      --apply-immediately
  

• Thời gian Downtime

  Database engine upgrades require downtime. The duration of the downtime varies based on the size of your DB instance.

  MySQL major version upgrades typically complete in about 10 minutes. Some upgrades might take longer because of the DB instance class size or because the instance doesn’t follow certain operational guidelines in Best practices for Amazon RDS. [1]

  Chạy thử với free-tier db instance db.t3.micro, mất khoảng ~12 minutes để upgrade thành công.

  Tuy nhiên trong quá trình upgrading, db instance sẽ bị shuts down ở một chế độ đặc biệt có tên là a slow shutdown nhằm đảm bảo tính nhất quán (consistency). Chính vì lý do đó mà trong 5 phút đầu của quá trình upgrade, ứng dụng của chúng ta vẫn có thể kết nối được tới DB.

• Xác nhận

  Để đảm bảo DB instance đã được upgrade lên đúng phiên bản mong muốn, sử dụng lệnh sau:

  aws rds describe-db-instances \
    --db-instance-identifier $db_instance_name \
    --query 'DBInstances[*].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceStatus:DBInstanceStatus,EngineVersion:EngineVersion}'
  

4.2. Using a read replica to reduce downtime

Hướng tiếp cận này đòi hỏi DB instance phải được bật tính năng Auto Backup.

Các bước được dùng trong upgrade bạn có thể tham khảo (chi tiết tại đây):

• Để xây dựng môi trường test chúng ta có thể làm theo các bước sau

  • Create a read replica of your MySQL 5.7 instance.

    read_replica_db_instance_name="read-replica-rds-upgrade-testing"
    
    # Create read replica
    aws rds create-db-instance-read-replica \
        --db-instance-identifier $read_replica_db_instance_name \
        --source-db-instance-identifier $db_instance_name
    
    # Wait util read replica db instance becomes available (~8 minutes)
    aws rds wait db-instance-available --db-instance-identifier $read_replica_db_instance_name
    

  • (Không bắt buộc) Khi read replica được khởi tạo và Status hiển thị Available, chuyển đổi read replica sang Multi-AZ deployment và bật tính năng backups.

  • Khi read replica Status hiển thị Available, Nâng cấp read replica sang MySQL 8.0.

    # Upgrade
    aws rds modify-db-instance \
        --db-instance-identifier $read_replica_db_instance_name \
        --engine-version $new_mysql_version \
        --allow-major-version-upgrade \
        --apply-immediately
    
    # Wait util read replica db instance becomes available (~13 minutes)
    aws rds wait db-instance-available --db-instance-identifier $read_replica_db_instance_name
    
    # Ensure that upgraded read replica has latest MySQL engine version
    aws rds describe-db-instances \
      --db-instance-identifier $read_replica_db_instance_name \
      --query 'DBInstances[*].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceStatus:DBInstanceStatus,EngineVersion:EngineVersion}'
    
    

  • Khi quá trình upgrade hoàn thành Status hiển thị Available hãy xác nhận lại xem read replica có được cập nhật với phiên bản MySQL 5.7 DB chưa.

  • (Không bắt buộc) Bạn có thể tạo thêm read replica để tăng HA.

  • (Không bắt buộc) Cấu hình các custom DB parameter group cho read replica.

  • Promote read replica lên standalone DB instance

    # Promote read replica
    aws rds promote-read-replica \
        --db-instance-identifier $read_replica_db_instance_name
    
    # Wait util read replica db instance become available (~5 minutes)
    aws rds wait db-instance-available --db-instance-identifier $read_replica_db_instance_name
    
    

    Tuy nhiên bạn cần lưu ý sau

    When you promote your MySQL 8.0 read replica to a standalone DB instance, it no longer is a replica of your MySQL 5.7 DB instance. We recommend that you promote your MySQL 8.0 read replica during a maintenance window when your source MySQL 5.7 DB instance is in read-only mode and all write operations are suspended. When the promotion is completed, you can direct your write operations to the upgraded MySQL 8.0 DB instance to ensure that no write operations are lost.

    In addition, we recommend that, before promoting your MySQL 8.0 read replica, you perform all necessary data definition language (DDL) operations on your MySQL 8.0 read replica. An example is creating indexes. This approach avoids negative effects on the performance of the MySQL 8.0 read replica after it has been promoted. [1]

  • Đổi kết nối của ứng dụng sang new MySQL 8.0 DB instance. (Update DNS endpoint or DB setting in app)

• Thời gian Downtime

  • Short downtime: Trong khi read replica instance tiến hành upgraded, ứng dụng của chúng ta vẫn có thể truy cập vào primary db instance. Sau quá trình upgrade tất cả các dữ liệu sẽ được đồng bộ từ primary sang read replica instance.

Downtime = Time to promote read replica to standalone instance + Time to change DNS endpoint/DB setting app.

Thực tế với free-tier db instance, sẽ mất khoảng ~5 phút để promote read replica instance.

• Lợi ích

  Easy to rollback: Nếu chẳng may có bất kỳ vấn đề nào xảy ra trong quá trình nâng cấp, chúng ta có thể dễ dàng rollbackk lại bằng cách thay đổi DNS endpoint/DB endpoint sang v5.7 DB instance.

Tham khảo thêm các bài viết về hướng tiếp cận này

• Upgrading to RDS MySQL 8.0 with minimum downtime
• Upgrading a MySQL DB on AWS RDS
• Our MySQL RDS Upgrade Journey: Cutting Down Downtime by 11,200% and Lessons Learned
• Zero Downtime Maintenances on MySQL RDS

5. Hậu nâng cấp

5.1. Kiểm tra lại tiến trình nâng cấp đã hoàn thành chưa

Chúng ta có thể sử dụng câu lệnh sau để kiểm tra xem trạng thái của DB instance đã sẵn sàng chưa

aws rds wait db-instance-available --db-instance-identifier $db_instance_name

5.2. Retest the system

Kết nối ứng dụng vào new DB instance, và thực hiện retest hành vi hệ thống.

5.3. Rollback trong trường hợp upgrade failed

5.3.1. Trường hợp Upgrade directly

After the upgrade is complete, you can’t revert to the previous version of the database engine. If you want to return to the previous version, restore the first DB snapshot taken to create a new DB instance. [1]

• Chúng ta sẽ không thể rollback engine hiện tại (v8.0) về engine phiên bản trước (v5.7). Mà sẽ buộc phải upgrade latest snapshot được tạo trước khi tiến hành nâng cấp:

 new_db_instance_name="new-rds-upgrade-testing"

 aws rds restore-db-instance-from-db-snapshot \
  --db-instance-identifier $new_db_instance_name \
  --db-snapshot-identifier $db_snapshot_name

• Cập nhật lại endpoints / Route 53 trỏ về new RDS, và connection endpoint trong ứng dụng sang new MySQL RDS instance.

5.3.2. Trường hợp Upgrade using read replica

• Chúng ta chỉ cần upgrade DNS endpoint sang DB endpoint (v5.7) cũ vì DB instance này chạy hoàn toàn độc lập với RDS master instance (v8.0).

6. Kết luận

• Phương án 2 được khuyến khích sử dụng vì những lợi ích sau
  • Short downtime duration
  • Easy to rollback.
• Dù dùng cách gì thì chúng ta cũng cần cẩn thận kiểm tra, diễn tập trước khi tiến hành, và đây là các đầu mục lớn cần làm:
  • Prechecks for upgrades.
  • Backup data to snapshot.
  • Testing an upgrade with test DB instance. ( Tạo một snapshot từ staging db instance => Tạo một DB instance mới từ snapshot này. Thử tiến hành upgrade trên DB instance này).
  • Để hạn chế lỗi, hãy biến toàn bộ các thao tác về scripts: backup, upgrade and rollback vì làm như vậy sẽ giảm thiểu rủi ro, nhớ nhớ quên quên.
• Tính toán sơ bộ thời gian dùng để upgrade: việc này có thể phụ thuộc vào số lượng instance, kích thước database, phương án upgrade, database schema, engine, …

References

• [1] AWS Official User Guide - Upgrading the MySQL DB engine
• [2] AWS Official User Guide - Upgrading a DB instance engine version
• [3] AWS Premium Support - I want to upgrade my Amazon RDS MySQL version
• [4] Best Practices for Upgrading Amazon RDS for MySQL and Amazon RDS for MariaDB

Anh em coder động vào bài toán xử lý các trường datetime trong Database chắc hẳn ai cũng từng phải convert thời gian từ múi giờ này qua múi giờ khác. Trên PHP thì có Carbon, Javascript thì dùng Moment, Date-fns… đều là những thư viện khá mạnh phục vụ tận răng.

Để convert thời gian từ múi giờ UTC sang múi giờ của Việt Nam (UTC+07) thì có mấy timezone có thể dùng:

• Asia/Bangkok
• Asia/Ho_Chi_Minh
• Asia/Saigon

Mình thì trước giờ hay xài đại Asia/Ho_Chi_Minh, nay thử convert cái field time trong Database thì kết quả hơi choáng, code mình vẫn viết test đầy đủ mà nay dính case sau:

moment.tz('1970-01-01T01:00:00.000Z', 'UTC').tz('Asia/Ho_Chi_Minh').format()
'1970-01-01T09:00:00+08:00'

Bạn thấy đấy, 1970-01-01T01:00:00.000Z ở múi giờ UTC bị chuyển thành 1970-01-01T09:00:00+08:00 ở múi giờ UTC+07. Kết quả chính xác phải là 1970-01-01T08:00:00+07:00 chứ 😥 Tại sao timezone của Việt Nam ở thời điểm năm 1970 lại là UTC+08 WTF !!!!

Vấn đề này làm mình mất 30p debug code, đâm vào cả trong thư viện mà chẳng hiểu sao nó xử lý vậy :joy:, cuối cùng phải search Wikipedia về lịch sử timezone của Việt Nam mới biết:

Hoá ra trước thời điểm 13/06/1975 các vùng miền của Việt Nam sử dụng múi giờ là khác nhau, chỗ UTC+08 chỗ UTC+07.

Như vậy thì thư viện không hề sai :v Nhưng nếu dùng để convert field TIME() trong Database ra giờ thì sẽ cần lưu ý để phù hợp với logic.

moment.tz('1975-06-13T01:00:00.000Z', 'UTC').tz('Asia/Ho_Chi_Minh').format()
'1975-06-13T08:00:00+07:00'

Test lại cho chắc 😎

Tóm lại là đừng có nghĩ timezone của một quốc gia luôn cố định ở mọi thời điểm, mà nó có thể thay đổi 🐖

Trước các kỳ nghỉ lễ, nghỉ phép của Việt Nam, mình sẽ cần phải thông báo cho khách những thông tin về ngày nghỉ trước khoảng 2 tuần để hai bên cũng nhau điều chỉnh & sắp xếp lại công việc cho phù hợp, tránh gây ảnh hưởng tới tiến độ dự án. Và cứ mỗi lần như vậy, mình lại lọ mọ soạn các tin nhắn thông báo kiểu vậy, hoặc lục lại tin nhắn trong quá khứ để gửi cho khách hàng. Hoặc lên Google tìm kiếm. (Ví dụ với ngày Giỗ Tổ Hùng Vương bạn có thể dùng keyword: フン王の命日　祝日のお知らせ sẽ ra rất nhiều kết quả). Tuy nhiên việc chọn lọc nội dung cũng khá mất thời gian.

Nhân dịp cuối năm 2021, cần gửi lịch nghỉ Tết dương lịch cho khách hàng, mình sẽ tổng hợp lại toàn bộ các mẫu thông báo xin nghỉ trong bài viết này. Hy vọng sẽ giúp ích ít nhiều cho mình và bạn đọc sau này. Cảm ơn anh Nguyễn Thành Nam đã bỏ thời gian review và giúp mình bổ sung thêm các mẫu tin nhắn vào bài viết này 😎

Các mẫu tin nhắn bên dưới có các ký tự △, 〇, ◎, ◇, □, … Nếu sử dụng lại bạn cần thay thế lại bằng câu chữ, ngày giờ cho phù hợp.

1. Thông Báo Nghỉ Lễ

1.1. Tết Dương Lịch

Thông báo trước ngày nghỉ 2 tuần

△△株式会社　〇〇様
いつも大変お世話になっております。
弊社のベトナム年末年始休暇の件でご連絡させて頂きます。

弊社は下記の通り休業とさせていただきます。
営業休止中はご不便をお掛けいたしますが、何卒ご理解・ご協力の程、宜しくお願い申し上げます。
＜営業休止期間＞
(*)年末年始：12月◇◇日（木）～ 1月□□日（月）
※1月◉◉日より通常営業

当該期間中に頂きましたご連絡につきましては、なるべく早めに回答できるように致しますが、
対応は休業明け以降になりますので、予めご了承の程宜しくお願いいたします。

Trường hợp bổ sung

• Nghỉ kéo dài hơn do ảnh hưởng COVID-19 khiến công ty không thể sắp xếp được cho nhân viên đi du lịch, nên cho nghỉ bù vào dịp cuối năm

  ※コロナウィルスの状況により、今年7月△△日及び〇〇日で行う予定がある会社旅行ができずに、
  全員通常に通勤しましたので、年末の☆☆日（12月▲▲日~●●日）をその福祉として、お休みとなります。
  また、1月◇◇日は土曜日に当たるために、1月□□日（月）が振替休日となります。
  弊社の勤務カレンダーも共有させていただきます。
  https://company.domain/calendar
  

Thông báo nhắc lại trước ngày nghỉ 1 ngày

△△株式会社　〇〇様
いつも大変お世話になっております。
◇◇です。
早いもので本年も残すところ、あとわずかとなりました。
〇〇様には1年間大変お世話になり、心より感謝しております。
なお、弊社の年内の営業は12月▲▲日までとなり、新年は1月●●日から営業開始となります。
来年も本年同様のご愛顧のほど、よろしくお願い申し上げます。

1.2. Tết Âm Lịch

• Mẫu 1

  お世話になっております。
  弊社の旧正月（テト）の休暇の件でご連絡させて頂きます。
  弊社は下記の通り休業とさせていただきます。
  営業休止中はご不便をお掛けいたしますが、何卒ご理解・ご協力の程、宜しくお願い申し上げます。
  
  ＜営業休止期間＞
  旧正月（テト）: ◆◆月◇◇日 ~ ◼︎◼︎月□□日
  ※ ▲▲月△△日より通常営業
  弊社の勤務カレンダーも共有させていただきます。
  https://company.domain/calendar
  
  当該期間中に頂きましたご連絡につきましては、なるべく早めに回答できるように致します。
  以上になりますが、ご了承の程宜しくお願いいたします。
  

• Mẫu 2 (Mẫu này mình cũng chưa thử gửi bao giờ 😢)

  春節 (旧正月) 休みのお知らせ
  
  拝啓 初冬の候、貴社ますますご繁栄のこととお慶び申し上げます。
  平素は格別の御高配を賜り、厚く御礼申し上げます。
  さて、誠に勝手ながら弊社では春節(旧正月)休みにつきまして、下記のとおり休業日とさせていただきます。
  皆様には大変ご迷惑をおかけいたしますが、何卒ご容赦くださいませ。
  これからも変わらぬお引き立てを賜りますよう宜しくお願い申し上げます。
  敬具
  記
  1．休業実施期間：▲▲月△△日 ~ ◎◎月〇〇日
  2．休業実施日数：□□日
  ※休業中もメールはお受けしておりますが、ご返答につきましては◆◆月◇◇日以降順次対応させて頂きます。
  春節 (旧正月) 休業期間中、皆様方には大変ご迷惑をおかけいたしますが、ご理解とご協力を賜りますよう宜しくお願い致します。
  以上
  

1.3. Giỗ Tổ Hùng Vương

いつもお世話になっております。
弊社では下記の通り、4月下旬の【ベトナムの雄王記念日】休暇を実施させていただきます。

＜営業休止期間＞
雄王記念日：4月〇〇（◎）

※ ▲▲月△△日より通常営業
弊社の勤務カレンダーも共有させていただきます。
https://company.domain/calendar

当該期間中に頂きましたご連絡につきましては、なるべく早めに回答できるように致します。
ご不便をお掛けいたしますが、何卒ご理解頂きますようお願い申し上げます。

1.4. Giải phóng miền Nam và Quốc tế Lao động (30/4 - 01/5)

いつもお世話になっております。
弊社では下記の通り、4月下旬の【南部解放記念日＆メーデー】休暇を実施させていただきます。

＜営業休止期間＞
南部解放記念日 & メーデー：4月△△日(金) ~ 5月□□日（月）

※ 5月◇◇日が土曜日に当たるため、5月◆◆日（月）振替休日となります。
5月◆◆日（火）より平常通り営業いたします。
弊社の勤務カレンダーも共有させていただきます。
https://company.domain/calendar

当該期間中に頂きましたご連絡につきましては、なるべく早めに回答できるように致します。
ご不便をお掛けいたしますが、何卒ご理解頂きますようお願い申し上げます。

1.5. Quốc Khánh (02/09)

平素は格別のお引き立てを頂きまして、誠にありがとうございます。
誠に勝手ながら、ベトナムの建国記念日休みに伴い、
▲▲年9月02日（□）から▲▲年09月〇〇（◎）まで休業とさせて頂きます。
営業開始日は▲▲年9月□□日（◆）となります。
この間、弊社からのご返信やサービス提供ができなくなりますのでご了承願います。
皆様にはご不便をお掛けいたしますが、何卒ご寛容くださいますようお願い申し上げます。

※ 弊社の勤務カレンダーも共有させていただきます。
https://company.domain/calendar

2. Thông Báo Nghỉ Khác

2.1. Nghỉ Du Lịch Công Ty

• Thông báo nghỉ du lịch

  • Mẫu 1

    いつもお世話になっております。
    誠に勝手ながら、弊社では下記の期間を社員旅行のため、臨時休業とさせて頂きます。
    皆様にはご不便をおかけしますが、何卒ご了承の程宜しくお願い申し上げます。
    
    【期間：▲▲月△△日 ~ ◎◎月〇〇日】
    ※ ▲▲月△△日より通常勤務となります。
    
    弊社の勤務カレンダーも共有させていただきます。
    https://company.domain/calendar
    
    当該期間中に頂きましたご連絡につきましては、なるべく早めに回答できるように致します。
    予めご了承の程宜しくお願いいたします。
    

  • Mẫu 2

    社員旅行に伴う臨時休業のお知らせ
    拝啓　〇〇の候、ますますご清栄のこととお慶び申し上げます。
    平素は格別のご高配を賜り、厚く御礼申し上げます。
    さて、誠に勝手ながら弊社では、▲▲月△△日 ~ ◎◎月〇〇日までを社員旅行につき、臨時休業とさせていただきます。
    休業中にいただきましたご連絡につきましては、◆◆月◇◇日以降に順次ご対応させていただきます。
    皆様にはご不便をおかけしますが、何卒ご了承の程宜しくお願い申し上げます。
    敬具
    記
    ※ 社員旅行による休業日　▲▲月△△日 ~ ◎◎月〇〇日
    ※ ◆◆月◇◇日より通常通りに営業いたします。
    お問い合わせ先：●●●●●●●●●●
    住所：◎◎◎◎◎◎◎◎◎◎
    TEL：★-★★★★-★★★★
    FAX：☆-☆☆☆☆-☆☆☆☆
    

• Rủ khách đi du lịch cùng 😂

  毎年恒例の社内旅行が下記のとおりに決定しましたのでお知らせいたします。
  日時：▲▲月△△日 ~ ◎◎月〇〇日
  行き先：◆◆省、□□市
  宿泊先： ROYAL LOTUS RESORT AND VILLAS （5★リゾート）
  参加対象：弊社の全社員および弊社のお客様
  参加費：無料
  *交通費（ハノイ ~ □□往復）および□□での他の費用は弊社の負担となります。
  お忙しいことと存じますが、是非ご参加賜わりますようご招待申し上げます。
  以上、ご返事をお待ちしております。
  

Do không phải là một Native Japanese nên có thể sẽ có sai sót về ngữ pháp, câu cú trong tiếng Nhật. Và mục đích chính là truyền tải thông tin về ngày nghỉ với đội dự án nên có thể với một số bạn nội dung này hơi đơn điệu. Nếu bạn đọc thấy có điều gì chưa hợp lý, hãy để lại comment để mình có thể cập nhật nội dung tốt hơn nhé. Cảm ơn rất nhiều 💯

• Phím tắt của 2 công cụ chat này không giống nhau
  • Ví dụ: Trên Chatwork để gửi tin nhắn bạn có thể dùng shift + enter trong khi trên Slack sử dụng command + enter

Việc này có thể không vấn đề với nhiều người dùng nhưng với mình nó lại là cả một vấn đề, việc học và thay đổi một thói quen là một việc khá tốn thời gian và không cần thiết.

Ban đầu mình có hỏi thăm một người bạn, và nhận được lời khuyên sử dụng: Keyboard Maestro, tuy nhiên phần mềm này có giá ~36$, do đó mình quyết định thử tìm hiểu xem có cách nào mapping lại phím mà đỡ tốn kém hơn không. Kết quả là việc này có thể hoàn thành rất dễ dàng với công cụ có tên là: Karabiner Elements.

Để cài đặt Karabiner Elements các bạn truy cập trang web https://karabiner-elements.pqrs.org và tải về cũng như cài đặt một cách hoàn toàn miễn phí.

Sau khi cài đặt xong, chúng ta sẽ thấy biểu tượng của phần mềm trên thanh trạng thái hệ thống, và có thể tuỳ biến phím đơn trên bàn phím với giao diện Simple modifications sẵn có. Ngoài ra bạn có thể map lại các phím chức năng tiêu chuẩn F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12 trên bàn phím ngoài sang các phím chức năng của Apple MacOS như:

• F1 – Giảm độ sáng màn hình
• F2 – Tăng độ sáng màn hình
• F3 – Điều khiển nhiệm vụ mở
• F4 – Mở Launchpad
• F5 – Giảm độ sáng bàn phím (Chỉ trên máy tính xách tay tương thích)
• F6 – Tăng độ sáng bàn phím (Chỉ trên máy tính xách tay tương thích)
• F7 – Bỏ qua lại (Âm thanh)
• F8 – Tạm dừng / Phát (Âm thanh)
• F9 – Bỏ qua phía trước (Âm thanh)
• F10 – Tắt tiếng
• F11 – Giảm âm lượng
• F12 – Tăng âm lượng

bằng cách sử dụng Function keys.

Tuỳ biến tổ hợp phím

Để tuỳ biến lại tổ hợp phím tắt một cách phức tạp hơn bạn cần sửa config ở file sau

$ vim ~/.config/karabiner/karabiner.json

Bạn tìm tới mục "rules":, thêm object sau vào

{
    "description": "shift+enter to command+enter / custom Slack send messages",
    "manipulators": [
        {
            "from": {
                "key_code": "return_or_enter",
                "modifiers": {
                    "mandatory": [
                        "shift"
                    ]
                }
            },
            "to": [
                {
                    "key_code": "return_or_enter",
                    "modifiers": [
                        "right_command"
                    ]
                }
            ],
            "type": "basic",
            "conditions": [
                {
                  "type": "frontmost_application_if",
                  "bundle_identifiers": [
                    "^com\\.tinyspeck\\.slackmacgap$"
                  ]
                }
              ]
        }
    ]
}

Ở trên mình tiến hành tuỳ biến shortcut key cho việc gửi tin nhắn trên Slack sang giống như trên Chatwork (Cá nhân mình thích gõ shift + enter hơn), ngoài ra bạn có thể tham khảo thêm một số rules mẫu tại đây hoặc một số do mình chia sẻ tại đây

Chia sẻ thêm là trong đoạn tuỳ biến trên có phần "bundle_identifiers" để giới hạn phạm vi application sẽ kích hoạt việc tuỳ biến, và bundle_identifiers được mình lấy theo cách sau:

• Tìm link app (Qua Google hoặc App store).
  • Ví dụ app Slack: https://apps.apple.com/app/slack/id803453959
• Copy number ID từ URL
  • 803453959
• Mở đường dẫn https://itunes.apple.com/lookup?id=xxx, thay xxx thành number ID bạn có
  • https://itunes.apple.com/lookup?id=803453959.
• Truy cập đường dẫn trên trình duyệt sẽ tải về một file txt, Tìm kiếm từ khoá "bundleId" và bạn sẽ có bundle_identifiers
  • com.tinyspeck.slackmacgap

Chúc các bạn thành công 🦞