Tôi vừa phải đưa một service markdown ra khỏi API của mình

Tôi vừa phải đưa một service markdown ra khỏi API của mình

Tin ngắn hàng ngày dành cho bạn
  • Manus đã chính thức mở cửa cho tất cả người dùng rồi đấy mọi người. Cho những ai chưa biết thì đây là một công cụ viết báo cáo (làm mưa làm gió) giống như Deep Research của OpenAI á. Mỗi ngày được miễn phí 300 Credits để nghiên cứu. Mỗi lượt nghiên cứu tiêu tốn tuỳ thuộc vào độ phức tạp của yêu cầu. À với cả họ đang có chương trình tặng miễn phí Credits hay sao á. Như mình thì vào thấy được hẳn 2000.

    Mình dùng thử, so sánh với cùng một lệnh giống như đợt trước dùng bên Deep Research thì nội dung khác biệt nhau hoàn toàn. Manus báo cáo như kiểu viết văn hơn so với OpenAI là các gạch đầu dòng và bảng biểu.

    À lúc đăng ký xong có bắt nhập số điện thoại để xác minh, nếu lỗi thì các bạn đợi qua ngày thử lại xem có được không nhé.

    » Xem thêm
  • Mọi người chắc nghe nhiều về xu hướng tìm kiếm thông tin bằng AI chứ không cần công cụ tìm kiếm như Google nữa rồi đúng không? Không đâu xa ánh xạ vào bản thân thì thấy đúng thật, thi thoảng mới tìm kiếm thôi chứ còn đâu toàn hỏi tụi AI.

    Ngay từ đầu viết blog, thứ mà mình hướng đến là chia sẻ kinh nghiệm chứ không phải là những bài mang nặng tính kỹ thuật, máy móc, hướng dẫn từ đầu... Vì thời điểm đó đã có quá nhiều người làm nội dung này rồi và họ làm rất tốt, tại sao mình phải cố phát minh lại bánh xe? Một điều nữa là tin tưởng độc giả của mình có khả năng tìm hiểu vấn đề. Nếu bạn đọc đủ nhiều các bài viết trên blog thì thấy mình luôn cố gắng chèn thêm các liên kết tham khảo ngoài bài viết, nêu ra vấn đề mở và rất ít khi kết luận chắc chắn một điều gì đó.

    Mình đã cố gắng rèn luyện kỹ năng viết, kỹ năng trình bày và cả cách tương tác với độc giả để mang lại giá trị cho họ. Nhiều lúc ngồi lật lại các con số thống kê thấy lượng đọc bài viết tăng lên lại cảm thấy vui. Nhưng khi nguồn truy cập đến từ Google thì lại thấy buồn, vì điều đó chứng tỏ họ biết đến mình chỉ khi đang cố đi tìm giải pháp, có thể họ chỉ đọc chớp nhoáng, may ra tìm được cách giải quyết và thế là đóng cửa sổ trình duyệt rồi đi như một cơn gió.

    Chừng vài tháng đổ lại đây, một điều khiến mình rất vui đó là lượng người truy cập thẳng vào trang chủ mà không thông qua công cụ tìm kiếm đang tăng dần lên, có nhiều hôm lượng truy cập tự nhiên còn cao hơn cả đến từ Google. Điều đó chứng tỏ độc giả đã có thói quen quay lại trang của mình nhiều hơn và họ tìm thấy được giá trị từ blog mang lại. Vui mừng khôn xiết 🤩

    Bên cạnh đó thì lượng truy cập vào chuyên mục Threads - tức là mục mình đang viết bài này đang cao hơn bao giờ hết. Điều đó chứng tỏ xu hướng đi theo tin nhanh là đúng đắn. Mình có thể ngồi cả ngày để viết tin ngắn cho bạn đọc vì nó rất nhanh mà tiện, không tốn công đi tìm tài liệu để viết, không tốn cả thời gian viết nữa, còn mình thì có rất nhiều thứ để chia sẻ 😅. Nhưng không vì thế mà bỏ bê các bài viết dài, vì dài thì có nhiều thông tin để chia sẻ hơn.

    Vài lời tâm sự thế thôi chứ hơn một tháng nay mình chưa viết bài viết mới nào vì công việc bận quá. Xong lâu dần cứ trì hoãn lại thành lười. À với cả tháng 5 này rất thích hợp để đọc các cuốn sách về cách mạng á. Có hôm đọc đến 2 giờ sáng mới đi ngủ 🥱

    » Xem thêm
  • Mình mới nhìn thấy một trang web khá thú vị nói về các cột mốc đáng nhớ trong lịch sử phát triển Internet toàn cầu: Internet Artifacts

    Chỉ từ 1977 - khi Internet còn nằm trong hộp thí nghiệm thì nhìn xem - giờ đây Internet đã khiến mọi thứ phát triển đến mức nào 🫣

    » Xem thêm

Vấn đề

Hôm cuối tuần vừa rồi tôi ngồi lại nghiên cứu về các giải pháp tăng khả năng SEO cho 2coffee. Tôi nhận ra có một phương pháp mà tôi chưa áp dụng đó là CLS. Nói nôm na thì điểm CLS thể hiện mức độ thay đổi bố cục trang web. Một ví dụ đơn giản là người dùng đang xem trang web của bạn thì đột nhiên văn bản bị nhảy xuống nhường chỗ cho hình ảnh đang tải. Hành động này gây ra một số khó chịu với người dùng bởi vì việc thay đổi bố cục đột ngột như thế trong khi đọc gây ra một sự khó chịu, nếu thay vì văn bản mà là một nút bấm mà người dùng đang định bấm vào thì sao? Cảm giác hụt hẫng như vừa bị "chơi" một vố vậy.

Diễn biến

Blog của tôi thường có một đến nhiều ảnh trong bài viết nhưng đa phần là sẽ có một hình ảnh mở đầu đại diện cho cả bài. Vì vậy khả năng văn bản được tải xuống sau đó hình ảnh nhảy ra bất thình lình hoàn toàn có thể xảy ra. Đặc biệt là với người dùng thiết bị di động với tốc độ mạng chậm hoặc cấu hình yếu.

cls thấp

Có một cách để giải quyết vấn đề này đó là bạn cần phải chỉ định chiều cao (height) cho hình ảnh. Lúc đầu tôi nghĩ chỉ cần thiết lập width: 100%; height: auto là đủ, nhưng tôi đã sai lầm vì nếu không xác định height rõ ràng trình duyệt không xác định được chiều cao của ảnh để đặt trước chỗ. Tóm lại, nếu muốn đặt chỗ, bạn cần xác định được height. Lúc này những vấn đề bắt đầu xảy đến.

  • Thứ nhất là không thể thiết lập height cố định cho tất cả hình ảnh được vì kích thước của chúng không đồng nhất, nếu làm như thế có thể khiến tất cả ảnh khác bị méo mó.
  • Giải pháp tôi nghĩ đến là chỉ định height rõ ràng cho từng ảnh trong trình soạn thảo bài viết. Sau đó kết hợp với thuộc tính css aspect-ratio: attr(width) / attr(height) có thể giúp tôi co dãn hình ảnh một cách thoải mái. Tưởng chừng mọi việc đã được giải quyết thì lúc này một vấn đề khác lại xuất hiện.

Đó là bài viết của tôi lưu ở dạng markdown, ở định dạng này tôi có thể dễ dàng soạn thảo bài viết mà không đụng chạm đến những đoạn mã HTML phức tạp. Lợi ích của markdown là giúp tôi lưu trữ bài viết được "sạch" hơn. Sau đó, để lấy ra bài viết, tôi dùng một thư viện hỗ trợ chuyển markdown thành HTML. Vấn đề là thư viện tôi đang sử dụng không hỗ trợ việc thêm thuộc tính cho thẻ <img>.

Tôi cố tìm một thư viện khác nhưng có vẻ không cái nào làm được. Tôi thử đọc mã nguồn của thư viện đang sử dụng để tìm giải pháp nhưng có vẻ điều này vượt ngoài tầm với. Phần vì không hiểu phần vì không muốn tốn nhiều thời gian. Khi đó tôi chợt nghĩ nếu đang sử dụng Node thì hẳn đã có hàng tá thư viện làm tốt điều này (Cho ai chưa biết thì tôi đang sử dụng Golang để viết API).

Quả không sai, chỉ qua một vài lần tìm kiếm tôi đã tìm ra được showdown hỗ trợ thêm thuộc tính vào thẻ <img>. Lúc này phải nói thật thư viện Golang không có cửa so với Javascript. Một phần do cộng đồng JS rất lớn nên hầu như thư viện nào cũng có.

Việc này dẫn đến quyết định tách hẳn một service chuyên để parse markdown bằng Javascript dựa trên showdown. Nhưng làm sao thì làm, phải đảm bảo được tốc độ gọi service "gần" như hàm native trong Go. Vì thế tôi quyết định triển khai gRPC và sử dụng các cuộc gọi nội bộ (internal).

Phương pháp

Cho những ai chưa biết, gRPC là một Framework có thể được dùng để gọi hàm từ một service khác với tốc độ và độ tin cậy cao. Cũng giống như REST, gRPC sử dụng HTTP để truyền tải thông tin nhưng là HTTP/2.

Có nhiều lý do để tôi quyết định lựa chọn gRPC. Thứ nhất là tôi muốn service chỉ được gọi nội bộ (không có ý định publish), thứ hai là tốc độ và thứ ba là phân biệt rạch ròi giữa các service gọi nội bộ và các service được publish - điều mà gRPC đang thể hiện tốt.

Triển khai gRPC có khuynh hướng phức tạp hơn so với REST. Bạn sẽ phải viết nhiều mã hơn và triển khai các cuộc gọi gRPC phức tạp hơn. Nhưng bù lại là sự tin cậy và tốc độ, thật đáng để đánh đổi.

markdown là tên gọi của service này. markdown được viết bằng Node. Trong markdown chỉ có một file .proto rất đơn giản có một hàm:

syntax = "proto3";
package hicoffee.markdown;

service Markdown {
  rpc ConvertMarkdownToHTML (ConvertMarkdownToHTMLRequest) returns (ConvertMarkdownToHTMLReply) {}
}

message ConvertMarkdownToHTMLRequest {
  string markdown = 1;
}

message ConvertMarkdownToHTMLReply {
  string html = 1;
}

Triển khai của Node cũng rất đơn giản:

const PROTO_PATH = __dirname + '/protos/markdown.proto';

require('dotenv').config();
const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');
const { ConvertMarkdownToHTML } = require('./handlers/markdown');

const packageDefinition = protoLoader.loadSync(
  PROTO_PATH,
  {
    keepCase: true,
    longs: String,
    enums: String,
    defaults: true,
    oneofs: true
  });
const markdown_proto = grpc.loadPackageDefinition(packageDefinition).hicoffee.markdown;

function convertMarkdownToHTML(call, callback) {
  callback(null, { html: ConvertMarkdownToHTML(call.request.markdown) });
}

function main() {
  const server = new grpc.Server();
  server.addService(markdown_proto.Markdown.service, { ConvertMarkdownToHTML: convertMarkdownToHTML });
  server.bindAsync(process.env.ADDRESS, grpc.ServerCredentials.createInsecure(), () => {
    server.start();
    console.log(`Server running at ${process.env.ADDRESS}`);
  });
}

main();

Chỉ có một hàm xử lý chính là ConvertMarkdownToHTML, hàm này đơn giản chỉ sử dụng thư viện showdown để chuyển markdown thành HTML rồi trả về kết quả.

Trong Go, triển khai client để gọi sang markdown có phần hơi mất thời gian. Về cơ bản vẫn là dựa vào file .proto để gọi hàm, chỉ có một lưu ý là bạn cần qua một bước build .proto thành hai tệp *.pb.go thì mới sử dụng được.

$ protoc --go_out=. --go_opt=paths=source_relative --go-grpc_out=. --go-grpc_opt=paths=source_relative protos/markdown.proto

Bạn đọc xem thêm hướng dẫn cũng như cách build tại Protocol Buffer Compiler Installation.

Cuối cùng để kiểm tra markdown có hoạt động, tôi sử dụng phần mềm bloomrpc. bloomrpc là một GUI client cho phép gọi gRPC một cách nhanh chóng và đơn giản.

kiểm tra hàm markdown

Vì các cuộc gọi là nội bộ nên tôi không triển khai thêm phần xác thực client. Nếu bạn có ý định triển khai gRPC công cộng hãy xem xét đến bảo mật.

Cuối cùng tôi triển khai tất cả lên máy chủ và chúng hoạt động đúng như mong đợi.

Tổng kết

Không vấn đề nào mà không thể giải quyết, giải pháp giải quyết vấn đề phụ thuộc vào kinh nghiệm của bạn mà đi từ đơn giản đến phức tạp. Nếu như tôi chỉ biết mỗi Go, không biết đến gRPC... thì mọi chuyện có thể sẽ đi theo hướng khác. Hy vọng qua bài viết này mang đến cho bạn đọc thêm một phương pháp giải quyết vấn đề nữa. Không có cách nào là tốt nhất mà chỉ có cách phù hợp nhất, bời vì tốt chỉ mang tính tương đối còn phù hợp thì đi theo hoàn cảnh mà bạn lựa chọn.

Cao cấp
Hello

5 bài học sâu sắc

Mỗi sản phẩm đi kèm với những câu chuyện. Thành công của người khác là nguồn cảm hứng cho nhiều người theo sau. 5 bài học rút ra được đã thay đổi con người tôi mãi mãi. Còn bạn? Hãy bấm vào ngay!

Mỗi sản phẩm đi kèm với những câu chuyện. Thành công của người khác là nguồn cảm hứng cho nhiều người theo sau. 5 bài học rút ra được đã thay đổi con người tôi mãi mãi. Còn bạn? Hãy bấm vào ngay!

Xem tất cả

Đăng ký nhận thông báo bài viết mới

hoặc
* Bản tin tổng hợp được gửi mỗi 1-2 tuần, huỷ bất cứ lúc nào.

Bình luận (0)

Nội dung bình luận...