JFrog Artifactory hỗ trợ lưu trữ LuaRocks nguyên bản
Nếu các máy chủ NGINX/OpenResty hoặc gateway Kong của bạn kéo (pull) các module Lua trực tiếp từ trang công khai luarocks.org, một lần ngắt kết nối upstream có thể làm tắc mọi build và deploy phụ thuộc vào một “rock”. Với hỗ trợ LuaRocks trong JFrog Artifactory, bạn có thể lưu trữ và proxy những module đó từ một registry LuaRocks riêng tư do bạn kiểm soát, sử dụng trải nghiệm bản địa mà bạn mong đợi — không phải một giải pháp vá tạm thời. Bài viết này trình bày lợi ích khi dùng Artifactory làm registry LuaRocks, lý do điều đó quan trọng đặc biệt với OpenResty và Kong, và cách trỏ client luarocks về Artifactory chỉ trong vài phút.
Kéo rocks trực tiếp từ luarocks.org
LuaRocks là trình quản lý gói cho Lua, đóng vai trò tương tự như npm cho JavaScript hoặc pip cho Python. Một gói đơn lẻ được gọi là rock, và manifest của nó là rockspec. Nếu bạn chạy Lua trong môi trường production, rất có thể bạn đang kéo các rock bằng lệnh luarocks.
Hầu hết các đội phát triển Lua cài đặt rock trực tiếp từ luarocks.org trong lúc build. Điều đó hoạt động — cho đến khi không còn hoạt động nữa. Nguyên nhân có thể xuất phát từ nhiều tình huống, bao gồm:
- Khi luarocks.org chậm hoặc không truy cập được, các build và deploy của bạn cũng sẽ phải chờ theo.
- Mỗi máy tự tải lại cùng một rock, không có cache dùng chung, khiến mỗi lần kéo trở thành lưu lượng đi ra ngoài qua NAT gateway của bạn thay vì một đường đi được kiểm soát duy nhất.
- Các rock nội bộ và plugin Kong của bạn được lưu ở những nơi khác nhau, không có kho trung tâm để truy cập.
Với chỉ vài script, điều này có thể chấp nhận được. Với một đội máy NGINX/OpenResty ở edge hoặc một cluster Kong production, phụ thuộc vào registry công khai mà bạn không kiểm soát là rủi ro đối với tính sẵn sàng.
Registry LuaRocks riêng tư trong JFrog Artifactory
JFrog Artifactory hiện hỗ trợ LuaRocks như một loại repository bản địa, với mô hình ba-repo (local, remote, virtual) mà hàng nghìn khách hàng JFrog đã sử dụng cho Maven, npm, NuGet và các kho mã nguồn mở hàng đầu khác:
| Repository | Nội dung | Mục đích |
| Local | Các rock của bạn, thư viện nội bộ, tiện ích chia sẻ và plugin Kong do đội bạn tạo | Lưu trữ cục bộ cho các gói Lua bên thứ nhất |
| Remote | Một proxy và cache của luarocks.org | Lưu trữ các rock cộng đồng cần được cache cục bộ |
| Virtual | Gói cục bộ và gói từ remote chia sẻ một URL chung | Định nghĩa một endpoint duy nhất cho mọi lần pull của developer |
Việc phân chia thành local, remote và virtual cũng cho phép gán các quy tắc truy cập khác nhau cho từng loại, ví dụ áp đặt quyền nghiêm ngặt hơn cho các rock nội bộ so với những rock được cache từ công khai.
Remote repository sẽ lấy một rock công khai khi có yêu cầu đầu tiên và phục vụ nó từ cache cho những lần yêu cầu sau đó. Virtual repository gom các rock riêng tư và rock được cache công khai dưới một địa chỉ duy nhất, nên client luarocks chỉ cần giao tiếp với một endpoint duy nhất.
Các lần tải lại lặp lại sẽ đến từ cache của bạn thay vì luarocks.org, và mọi rock tổ chức bạn sử dụng, dù công khai hay riêng tư, đều nằm sau cùng một địa chỉ. Cùng mô hình local, remote, và virtual bạn đang dùng cho Maven hay npm giờ cũng hoạt động cho Lua.
Có hai luồng công việc hưởng lợi đáng kể từ registry LuaRocks riêng của JFrog: các module OpenResty và plugin Kong chạy ở edge.
OpenResty và NGINX: tự phục vụ các module lua-resty
OpenResty mở rộng NGINX bằng Lua để bạn có thể chạy logic ở tầng web-server, bao gồm: routing, rate limiting, authorization và shaping request tại edge. Các cấu phần xây dựng là họ lua-resty-*, như lua-resty-http cho các gọi ra ngoài, lua-resty-redis để truy cập Redis, và lua-resty-openidc cho OIDC và OAuth tại edge.
Hầu hết các đội cài đặt các rock đó từ registry công khai trên từng máy chủ. Bằng cách trỏ luarocks về một Artifactory virtual repository, cùng các lua-resty-* sẽ được giải quyết từ cache của bạn, dẫn đến thời gian cài đặt nhanh hơn trên toàn bộ hạ tầng edge. Bạn cũng có thể lưu các fork nội bộ của một module lua-resty trong local repo và ghim (pin) mọi node edge vào phiên bản chính xác bạn đã kiểm thử, đảm bảo rollout triển khai cài cùng một rock trên mọi instance.
Kong: phát hành plugin tùy chỉnh dưới dạng rock riêng tư
Kong Gateway được xây dựng trên OpenResty, và plugin tùy chỉnh của nó được viết bằng Lua. Kong đóng gói và cài đặt những plugin đó như các rock LuaRocks: bạn có thể tạo rockspec, sản xuất file .rock, rồi chạy luarocks install để đặt plugin lên mỗi node. Kong có thể cài từ một máy chủ rock từ xa, và repository LuaRocks của JFrog Artifactory chính là mục tiêu đó.
Vì vậy, một local repo trên Artifactory trở thành registry plugin riêng tư cho fleet Kong của bạn. CI job của bạn build .rock, publish nó lên local repo, và mọi node Kong cài cùng một phiên bản plugin từ một nguồn duy nhất, thay vì phải sao chép file thủ công mỗi lần. Việc promote một plugin từ staging lên production trở thành một việc tăng phiên bản (version bump) thay vì copy file thủ công — cải thiện tính toàn vẹn và khả năng truy vết của quá trình triển khai.
Kong cũng hỗ trợ plugin đóng gói theo OCI, và Artifactory cũng bao phủ đường đi đó, nên kịch bản vẫn phù hợp bất kể một tổ chức Kong dùng cách nào.
Tại sao điều này quan trọng ngay bây giờ
Lua không còn là một kịch bản bị xem nhẹ kể từ khi OpenResty và Kong tham gia vào luồng traffic production. Hiện nay, Lua chạy ngay trên đường đi yêu cầu của các máy chủ NGINX/OpenResty và gateway Kong — hai thành phần được triển khai rộng rãi trong hạ tầng API. Khi mã chạy gần luồng production đến vậy, registry cung cấp mã đó không nên là một trang công khai mà bạn không kiểm soát.
Maven, npm, NuGet, Docker và các loại gói hàng đầu khác đã chạy qua registry riêng tại hầu hết các tổ chức. Lua thường thì chưa. Hỗ trợ LuaRocks bản địa trong JFrog Artifactory giúp lấp khoảng trống đó, để tier gateway và edge của bạn nhận được cùng mức hosting và tính sẵn sàng như phần còn lại của phần mềm, với một client duy nhất trỏ về một endpoint duy nhất.
Để biết cách bắt đầu, vui lòng xem tài liệu LuaRocks repository documentation.
Một cài đặt LuaRocks đang giải quyết một rock từ Artifactory virtual repository của JFrog
Một registry cho toàn bộ gói Lua của bạn
Module NGINX/OpenResty và plugin Kong đều viết bằng Lua, và Lua có một trình quản lý gói. Với hỗ trợ LuaRocks trong JFrog Artifactory, trình quản lý gói đó giờ trỏ về hạ tầng do bạn kiểm soát. Các rock riêng tư được lưu trong local repo, trong khi hệ sinh thái công khai được cache qua remote repository với một URL duy nhất cho cả hai. Các máy chủ edge và gateway của bạn không còn phải mượn độ sẵn sàng của bên thứ ba, và các Lua rock trở thành một phần trong chuỗi cung ứng phần mềm được quản trị tập trung của bạn.
Sẵn sàng để lưu trữ rock của riêng bạn? Bắt đầu miễn phí, và tạo repository LuaRocks cho riêng bạn.
Muốn được tư vấn chuyên sâu hoặc triển khai giải pháp này cho tổ chức của bạn? Hãy liên hệ với Softribution để được hỗ trợ tư vấn kỹ thuật, triển khai và báo giá mua giải pháp phù hợp với nhu cầu của bạn.
