Overleaf Import API

Cho phép các trang web khác mở các đoạn mã LaTeX và dự án trong một bản triển khai Kubernetes.

Import API (/docs và các nút “Open in Ayakaleaf”, mô-đun open-in-overleaf) chạy trong dịch vụ web của mọi pod Ayakaleaf Pro và được bật theo mặc định. Các tệp được cung cấp qua URL sẽ được tải xuống thông qua linked-url-proxy trong cùng pod. Cách gọi API được mô tả trong Overleaf Import API.

Dịch vụ	web (mô-đun open-in-overleaf); tải xuống thông qua linked-url-proxy
Bên ngoài → Overleaf	trình duyệt gửi GET hoặc POST ${OVERLEAF_SITE_URL}/docs từ bất kỳ trang web nào
Pod → bên ngoài	các lượt tải snip_uri và zip_uri, bị giới hạn như mô tả trong URL bên ngoài
Trạng thái	yêu cầu của khách chưa đăng nhập, được giữ trong Redis trong 10 phút cho đến khi họ đăng nhập
Tác vụ định kỳ	không có

​

Cấu hình

Không cần làm gì để bật tính năng này. Các cài đặt liên quan trong ConfigMap:

Cài đặt
OVERLEAF_ALLOW_PUBLIC_ACCESS: "true"	Khách chưa đăng nhập có thể mở /devs, và yêu cầu họ gửi sẽ được giữ cho đến khi họ đăng nhập, xem Truy cập công khai.
MAX_UPLOAD_SIZE	Kích thước ZIP lớn nhất mà một yêu cầu có thể mang theo, tính bằng MB (mặc định 50). Ingress hoặc load balancer của bạn cũng phải chấp nhận phần thân yêu cầu có kích thước đó.
OVERLEAF_LINKED_URL_*	Các địa chỉ mà snip_uri và zip_uri có thể trỏ tới, xem URL bên ngoài.

​

Nhiều replica

Không cần thêm gì. Yêu cầu của khách chưa đăng nhập được giữ trong Redis, nên nó sẽ được tiếp tục trên bất kỳ replica nào mà khách truy cập sau khi đăng nhập.

​

Đã kiểm thử trên Kubernetes

Trên Kubernetes 1.37 với một replica, các bài kiểm thử end-to-end của chúng tôi cho Import API đều đạt (14 trường hợp): trang /devs và dự án mẫu của nó, các đoạn mã, tài liệu hoàn chỉnh, liên kết mã hóa URL và tệp từ data URL được chuyển thành dự án, từ chối các yêu cầu không thể trở thành dự án, từ chối tải xuống từ các địa chỉ nội bộ, các bài gửi và liên kết của khách chưa đăng nhập được giữ qua bước đăng nhập, và, với OVERLEAF_ALLOW_PUBLIC_ACCESS, /devs cho khách chưa đăng nhập và một đoạn mã đã gửi được tiếp tục một lần sau khi đăng nhập; trường hợp cuối cùng cũng đạt trên ba replica phía sau HAProxy.