CLI后端云原生【免費下載鏈接】vercelDevelop. Preview. Ship.項目地址https://gitcode.com/gh_mirrors/ve/vercel點擊查看免費下載vercel-runtime 是運行于 Vercel Compute 之上的 Python 函數(shù)運行時橋接層為 ASGI/WSGI 應用提供服務器實現(xiàn)、可觀測性、日志與平臺集成能力。本文以 python/vercel-runtime/CHANGELOG.md 為脈絡結合 python/vercel-runtime/src/vercel_runtime/ 的源碼實現(xiàn)與測試用例系統(tǒng)梳理該包從 0.1.0 到 0.17.0 的每一次能力升級WebSocket、隊列訂閱、Cron、Worker 服務、運行時緩存、冷啟動優(yōu)化與依賴 vendoring幫助讀者既掌握配置與調用方式也理解底層實現(xiàn)原理。一、包定位與總體架構python/vercel-runtime/README.md 明確了該包的使命提供在 Vercel Compute 上運行 Python 應用所需的橋接具體包含 ASGI/WSGI 服務器實現(xiàn)、可觀測性、日志與平臺集成。從 pyproject.toml 可見其關鍵約束包名vercel-runtime當前版本 0.17.0要求requires-python 3.12構建后端為uv_builduv_build0.10.11,0.11與 0.11.0 中升級 uv 到 v0.10.11的變更直接對應運行時依賴uvicorn、werkzeug 等被 vendoring 進src/vercel_runtime/_vendor/避免與用戶項目的依賴版本沖突重新同步執(zhí)行./python/vercel-runtime/scripts/vendor.sh[tool.uv]中exclude-newer 2 days與 0.14.0 的 Patch 變更一致uv sync --inexact --frozen則是 0.5.0 冷啟動優(yōu)化的產物。源碼目錄src/vercel_runtime/下的核心模塊構成運行時骨架模塊職責vc_init.py平臺側IPC 模式入口模塊導入、應用類型探測、請求生命周期、日志掛鉤dev.py本地vercel dev入口靜態(tài)資源、Django 靜態(tài)文件、uvicorn/werkzeug 啟動asgi.pyASGI 類型定義與公共輔助讀請求體、發(fā) JSON 響應resolver.py應用導入與 ASGI/WSGI 自動探測routing.py服務路由前綴剝離對應 0.4.3crons.pyCron 服務引導與多路由分發(fā)workers.pyWorker 服務與隊列集成激活cache.py運行時緩存上下文注入對應 0.14.0headers.pyOIDC 頭處理對應 0.13.2與請求頭規(guī)范化wsgi_websocket.pyWSGI WebSocket 升級對應 0.16.0從 vc_init.py 可以看到運行時與平臺通信的基石當存在VERCEL_IPC_PATH環(huán)境變量時運行時建立 UNIX 域套接字連接通過 NUL 分隔的 JSON 消息與 functions runtime 通信send_message支持log、metric、handler-started、end、unrecoverable-error等消息類型。平臺側還內置/_vercel/ping健康檢查響應ASGI 與 WSGI 兩套路徑均有實現(xiàn)。二、0.17.0Python 隊列與工作流全面遷移到 vercel-queue SDK0.17.0 是最近一次 Minor 變更PR 17ee736將 Python 隊列訂閱者queue subscribers與工作流workflows的集成從 vercel-workers 遷移到新的 vercel-queue SDK。變更點可以歸納為四條主線1.[[tool.vercel.subscribers]]構建期內省與服務化入口點在構建期通過vercel.queue.get_subscriptions()被內省生成vercel.queue.asgi_app()handler 模塊來服務流量觸達類型queue/v2beta攜帶 SDK 注冊的消費組consumer groups與每個訂閱的調優(yōu)參數(shù)對應源碼bootstrap_queue_service_app()在 workers.py 中導入vercel.queue并調用其asgi_app()若缺少vercel-queue包則拋出明確錯誤。2. Celery / Dramatiq 集成包自動注入構建產物與vercel dev中會自動注入匹配的vercel-celery/vercel-dramatiq集成包bundled 變體除非項目顯式依賴vercel-queue底層由install_queue_integrations()實現(xiàn)見 workers.py構建器通過環(huán)境變量VERCEL_QUEUE_INTEGRATIONS傳入module:installer[:serving_activator]格式的條目逗號分隔運行時依次調用 installerqueue_servingFalse時只激活發(fā)布側能力傳輸注冊、broker 默認值避免非 worker 函數(shù)啟動嵌入 worker 導致運行時阻塞queue_servingTrue時再執(zhí)行可選的 serving activator 激活消費側。3. 工作流的分代處理依賴vercel 0.8.0的項目按新 SDK 生成與訂閱者一致走 vercel-queue更舊或無法判明版本的項目保留 legacy vercel-workers 服務方式worker env 標記、注入固定版本的vercel-workers直接依賴vercel-workers的項目整體保留舊集成legacy 訂閱 schema、直接入口服務、worker env 標記。4. dev 與構建側的對齊vercel dev通過vercel.queue.asgi_app()服務隊列 sidecar隊列 broker 在 sidecar 啟動時按 SDK 注冊的消費組投遞與生產觸發(fā)行為一致legacy 項目繼續(xù)走 vercel-workers 引導CLI 不再注入config.hasWorkerServices所有隊列服務決策由 Python builder 依據(jù)項目元數(shù)據(jù)完成——這解釋了 workers.py 中has_worker_services()讀取VERCEL_HAS_WORKER_SERVICES的歷史邏輯與is_dev_queue_serving()讀取VERCEL_DEV_QUEUE_SERVING這一新路徑的并存。三、WebSocket 支持ASGI 與 WSGI 雙路徑0.15.0 / 0.16.00.15.0PR fe6d98b通過 vendored wsproto 為 Python ASGI 應用加入 WebSocket 支持。vendored 的 wsproto 位于 src/vercel_runtime/_vendor/wsproto/對應 uvicorn 協(xié)議層中的websockets_impl.py實現(xiàn)。測試夾具 tests/fixtures/asgi_websocket_app.py 與 tests/fixtures/wsgi_websocket_app.py 分別覆蓋兩條路徑。0.16.0PR ee389a1為 WSGI 應用如 Flask flask-sock補上 WebSocket運行時把原始連接套接字暴露在 WSGIenviron的werkzeug.socket/gunicorn.socket鍵中一旦寫入101握手響應就結束請求生命周期讓平臺開始雙向流式傳輸——這與 ASGI 的websocket.accept行為對齊。實現(xiàn)層面vc_init.py 的send_wrapper在 ASGI 路徑下于websocket.accept、websocket.close或websocket.http.response.body完成時調用finish_request()結束handler-started/end的 IPC 生命周期WSGI 路徑則在 vc_init.py 的_vc_fire_end_once中保證每個請求恰好發(fā)送一次 end 消息WebSocket 升級時在 101 寫入后立即觸發(fā)。attach_wsgi_websocket()來自 wsgi_websocket.py負責把原始 socket 注入 environ。四、WSGI 請求體與 chunked 解碼0.14.20.14.2PR 76aeb97修復了 WSGI 請求體在沒有Content-Length時以Transfer-Encoding: chunked到達的解碼問題并按 PEP 3333 規(guī)范從 WSGI environ 中剝離 hop-by-hop 幀頭。從 vc_init.py 的 WSGI handler 可以看到read_wsgi_request_body(self.rfile, self.headers)負責解析請求體非法體返回 400構建 environ 時顯式跳過transfer-encoding頭保證 PEP 3333 兼容。相關測試見 tests/test_request_body.py。五、運行時緩存為 Python 函數(shù)配置緩存0.14.00.14.0PR 4d56632為 Python 函數(shù)引入運行時緩存配置并附帶exclude-newer 2 days防止解析到過新的依賴的補丁。運行時緩存的核心實現(xiàn)在 cache.py平臺通過x-vercel-sc-*系列頭傳遞緩存上下文x-vercel-sc-headers緩存請求頭 JSON、x-vercel-sc-host、x-vercel-sc-basepath、x-vercel-sc-protocol、x-vercel-sc-runtime-cacheset_runtime_cache_from_asgi_pairs()/set_runtime_cache_from_http_headers()分別從 ASGI scope 與 WSGI 頭中解析這些值調用_apply_cache_context()構造BuildCache與AsyncBuildCache實例并注入vercel.cache.context端點拼裝為{protocol}://{host}{basepath}/v1/suspense-cache/見_build_endpoint()并攜帶x-vercel-internal-sc-client-name RUNTIME_CACHE標記對vercelSDK 舊版本 0.5.9做了set_context(cache...)的降級兼容vercel.cache采用可選導入未安裝該 SDK 時靜默跳過避免硬依賴請求結束時由clear_runtime_cache_context()清理見 vc_init.py 的finish_request()。此外x-vercel-sc-no-header-leak控制是否向業(yè)務代碼隱藏內部頭SC_HEADERS_ALWAYS_STRIP恒剝離x-vercel-sc-runtime-cache與SC_HEADERS_STRIP_ON_NO_LEAK僅在 no-leak 標記下剝離其余 sc 頭兩組集合定義在 cache.py。六、OIDC 令牌透傳與頭處理0.13.2 / 0.5.10.13.2PR 2767cb8在請求沒有攜帶 request-scoped OIDC 頭時將VERCEL_OIDC_TOKEN暴露為x-vercel-oidc-token請求頭。實現(xiàn)位于 headers.pyget_oidc_token_for_request(has_public_oidc, internal_oidc_token)決定最終注入值append_oidc_header_if_missing()在 ASGI 中間件中補充缺省頭見 vc_init.pyWSGI 路徑在handle_one_request中同樣處理并剝離內部頭x-vercel-internal-*invocation-id、request-id、span-id、trace-id、OIDC。0.5.1 的fix typings則是類型標注層面的完善。七、Cron 服務動態(tài)聲明、模塊級入口與多路由分發(fā)0.5.6 / 0.6.0 / 0.13.0Cron 能力歷經三次迭代0.5.6PR 15175為 Python 增加 cron worker 服務支持0.6.0PR 15393支持基于模塊module-based的 cron 入口點0.13.0PR 15930支持從 Python 服務動態(tài)指定 crons——cron 路由不再局限于構建期靜態(tài)配置運行時可通過環(huán)境變量__VC_CRON_ROUTESJSON 路由表引導。crons.py 給出了完整實現(xiàn)細節(jié)is_cron_service()VERCEL_SERVICE_TYPEcron或VERCEL_SERVICE_TYPEjob VERCEL_SERVICE_TRIGGERschedule判定為 cron 服務bootstrap_cron_service_app()讀取__VC_CRON_ROUTES路由表將完整 cron 路徑映射到兩種 handler 說明符——module:function調用具名可調用對象同步/異步自動識別異步用asyncio.to_thread包裹同步 handler或裸模塊名以if __name__ __main__方式執(zhí)行通過run_entrypoint_as_main運行生成的 ASGI 應用只接受GET/POST其余返回 405支持lifespan協(xié)議路由未命中返回 404handler 異常返回 500安全模型若設置了CRON_SECRET環(huán)境變量請求必須攜帶Authorization: Bearer secret并使用hmac.compare_digest做常數(shù)時間比較未授權返回 401。在 vc_init.py 中cron 服務會以app bootstrap_cron_service_app(...)覆蓋入口變量。測試夾具 tests/fixtures/cron_sync_handler.py、tests/fixtures/cron_async_handler.py、tests/fixtures/cron_dunder_main.py 及cron_multi_handler_a/b覆蓋了同步、異步、__main__與多路由場景。八、Worker 服務與 Django 任務0.6.0 / 0.9.0 / 0.10.00.6.0PR 15396為 Django 任務tasks增加 Python worker 服務支持0.9.0PR 15434 / 15433vercel dev開始支持 background workers 與 cron services 的本地調試0.10.0PR 15454Celery worker 服務的 broker 聲明支持直接寫broker_urlvercel://無需再從vercel.workers.celery導入。workers.py 的is_worker_service()判定VERCEL_SERVICE_TYPEworker或jobqueue/workflowtriggerprepare_worker_environment()在導入用戶代碼前設置 worker 環(huán)境通過可選導入vercel.workers._runtimemaybe_bootstrap_worker_service_app()在 vc_init.py 中被調用將生成的 worker app 掛載為入口的app變量。0.13.1PR 894e7d4將框架相關邏輯重構進獨立的python/vercel-workers包讓 vercel-runtime 保持與框架無關的職責邊界。九、Django 靜態(tài)文件服務0.8.0 / 0.12.00.8.0PR 15483修復 Django 項目 dev server 報錯0.9.0PR 15501修復vercel dev中 Django WSGI 應用的靜態(tài)文件服務0.12.0PR 15709 / 15772修復 manifest 存儲后端的靜態(tài)文件服務以及未使用 staticfiles 時vc dev的回歸。dev.py 展示了完整的 Django 靜態(tài)處理策略_wrap_django_static()當django.contrib.staticfiles在INSTALLED_APPS中時用StaticFilesHandler包裝 WSGI 應用使STATIC_URL請求直接從源碼目錄經 staticfiles finder 服務無需先跑collectstatic_handle_manifest()當STORAGES[staticfiles].BACKEND或STATICFILES_STORAGE含Manifest/Compressed且項目使用 WhiteNoise 時若STATIC_ROOT已收集產物則直接交給 WhiteNoise 并從STATIC_ROOT服務并給出 collectstatic 提示日志否則覆蓋為StaticFilesStorage使{% static %}輸出非哈希 URLDjango 5 用settings.STORAGES、舊版用STATICFILES_STORAGE做版本分支。同時 dev.py 還提供通用的public/目錄靜態(tài)服務ASGI 路徑優(yōu)先嘗試 FastAPI/StarletteStaticFilesWSGI 路徑用_static_wsgi_app()做帶路徑穿越防護_is_safe_file校驗 realpath 前綴的靜態(tài)讀取。十、冷啟動優(yōu)化與依賴安裝策略0.4.0 / 0.5.0 / 0.10.1冷啟動是 serverless Python 的關鍵指標CHANGELOG 記錄了三次直接優(yōu)化0.4.0PR 15011Lambda 執(zhí)行期間若提供了_runtime_requirements.txt則安裝之0.5.0PR 15080為大于 250MB 的 Lambda 優(yōu)化冷啟動——移除uv pip install改用uv sync --inexact --frozenLambda zip 先打包依賴至 245MB其余依賴運行時再裝0.10.1PR 15639使用 hardlink 鏈接模式替代 copy減少 /tmp 臨時存儲的磁盤峰值占用。vc_init.py 給出了運行時依賴安裝的完整流程啟動時檢查_uv/_runtime_config.json若存在則在/tmp/_vc_deps下手工寫pyvenv.cfg構造 PEP 405 venv 骨架避免子進程隨后調用 vendoreduv sync --inexact --active --frozen --no-dev --no-editable --no-install-project --no-build --no-cache --no-progress --link-mode hardlink并用--no-install-package排除bundledPackages已在_vendor中打包的依賴通過UV_NO_INSTALLER_METADATA1跳過運行期從不讀取的安裝元數(shù)據(jù)完成后寫入.installed標記文件供 warm start 復用Using cached runtime dependencies并用site.addsitedir將運行時安裝的 site-packages 前插到sys.path首位。安裝失敗會通過_fatal報告unrecoverable-errorIPC 消息并退出。十一、依賴 vendoring 與 quirks 系統(tǒng)0.3.0 / 0.5.3 / 0.5.4 / 0.13.00.3.0PR 14827將 Python 運行時依賴 vendoring避免與用戶項目依賴版本沖突0.5.3PR 15289新增prisma-client-py支持并引入 quirks 系統(tǒng)0.5.4PR 15305matplotlib 環(huán)境變量移入 quirks。vendoring 的工程化配置完整保留在 pyproject.toml[tool.vendoring]指定目標目錄src/vercel_runtime/_vendor/、補丁目錄patches/如 patches/werkzeug-001.patch、依賴清單 src/vercel_runtime/_vendor/vendor.txt 與命名空間vercel_runtime._vendor并通過 substitute 變換支持 uvicorn 的動態(tài)import_from_string把uvicorn.lifespan/loops/protocols.重寫為vercel_runtime._vendor.uvicorn.*同時丟棄bin/、colorama/tests/、*.so。當前 vendor 目錄包含 click、colorama、h11、markupsafe、uvicorn、werkzeug、wsproto 等包其中 wsproto 正是 0.15.0 WebSocket 支持的依賴。VERCEL_RUNTIME_ENV_PATH_PREPEND見 vc_init.py則允許 quirks 向PATH前置目錄如 bundled shims。十二、入口點解析與應用類型探測0.7.0 / 0.10.0 / 0.11.00.7.0PR 15419將vc_init_dev移入 vercel-runtimedev 側與應用側共享引導邏輯0.10.0PR 15614讓指定不同入口變量真正生效——此前入口變量配置可能被忽略0.11.0PR 15635簡化運行時總是傳入app變量。resolver.py 實現(xiàn)了應用解析import_module()通過importlib.util.spec_from_file_location從絕對路徑加載模塊resolve_app()從模塊中取出指定變量缺失時給出指向 Vercel 文檔的報錯提示。detect_app_type()resolver.py的判定順序為優(yōu)先.asgi可調用屬性 → 自身是協(xié)程函數(shù)且位置參數(shù)為 3scope, receive, send→ 進一步區(qū)分 WSGI 與BaseHTTPRequestHandler子類。平臺側入口通過__VC_HANDLER_ENTRYPOINT、__VC_HANDLER_ENTRYPOINT_ABS、__VC_HANDLER_MODULE_NAME、__VC_HANDLER_VARIABLE_NAME四個環(huán)境變量定位入口見 vc_init.pydev 側則對應VERCEL_DEV_MODULE_NAME、VERCEL_DEV_ENTRY_ABS、VERCEL_DEV_FRAMEWORK、VERCEL_DEV_VARIABLE_NAME見 dev.py。0.14.1PR 1318682的 minor 性能改進與 0.11.0 的 flaky 單測修復PR 15647、0.4.2 的補測試PR 15133則屬于持續(xù)的質量建設。十三、可觀測性日志、指標與致命錯誤上報0.5.5 / 0.5.20.5.2PR 15268修復非 IPC 代碼路徑的 ASGI lifecycle 事件0.5.5PR 15319通過 IPCunrecoverable-error消息上報致命初始化錯誤。vc_init.py 的setup_logging()是日志體系的樞紐自定義VCLogHandler把logging記錄映射為fatal/error/warn/info/debug級別并經 IPC 發(fā)送StreamWrapper重寫sys.stdout/sys.stderr讓print與日志關聯(lián)到當前請求上下文invocationId/requestIdprint_wrapper保證內建print也走包裝后的 stdout。握手前的初始化日志被緩沖上限 1MB見_INIT_LOG_BUF_MAX_BYTESserver-started握手完成后由_flush_init_log_buf()統(tǒng)一沖刷。致命錯誤走_send_unrecoverable_error()vc_init.py——這是握手完成前 functions runtime 唯一接受的兩種消息之一。平臺側存在VERCEL_IPC_PATH還會對 urllib3/requests 的urlopen打補丁發(fā)送fetch-metric請求指標vc_init.py。十四、服務路由前綴與發(fā)布流程0.4.3 / 0.4.1 / 0.2.0 / 0.1.00.4.3PR 15097在 Python 運行時中剝離服務services路由前綴——ASGI 經apply_service_route_prefix_to_asgi_scope、WSGI 經apply_service_route_prefix_to_target/strip_service_route_prefix處理routing.pysplit_request_target拆分 path 與 query0.4.1PR 15033修復發(fā)布流程中的 PyPI 發(fā)布集成0.2.0PR 14682與 changesets 集成使 CHANGELOG 由 PR 驅動的版本管理自動生成——這正是本文所依據(jù)文檔的來源機制0.1.0vercel-runtime首次發(fā)布提供 Vercel 上 Python 函數(shù)的運行時工具。十五、版本演進一覽版本核心變更關鍵源碼/配置落點0.17.0隊列/工作流遷移 vercel-queue SDKworkers.pyinstall_queue_integrations/bootstrap_queue_service_app0.16.0WSGI WebSocketwerkzeug.socket/gunicorn.socketwsgi_websocket.py、vc_init.py0.15.0ASGI WebSocketvendored wsproto_vendor/wsproto0.14.2WSGI chunked 解碼read_wsgi_request_body、test_request_body.py0.14.0運行時緩存cache.py0.13.2OIDC 頭透傳headers.py0.13.0動態(tài) cronscrons.py__VC_CRON_ROUTES0.12.0Django manifest 靜態(tài)文件dev.py0.10.0入口變量生效、Celeryvercel://brokerresolver.py0.9.0dev 支持 background/cron 服務dev.py_setup_apps0.5.0冷啟動優(yōu)化uv sync --inexact --frozenvc_init.py0.3.0依賴 vendoringpyproject.toml[tool.vendoring]結語從 0.1.0 到 0.17.0vercel-runtime 的演進清晰勾勒出一條平臺能力下沉的路徑WebSocket 雙協(xié)議支持、隊列與工作流的 SDK 化vercel-queue、動態(tài) Cron、運行時緩存、OIDC 透傳等能力逐一進入運行時內核而冷啟動優(yōu)化與依賴 vendoring 則持續(xù)壓低 serverless 的邊際成本。對開發(fā)者而言理解這份 CHANGELOG 與 src/vercel_runtime/ 源碼的對應關系可以在排查vercel dev與生產環(huán)境行為差異如 Django 靜態(tài)文件、隊列消費組、Cron 鑒權時快速定位問題邊界若需深入某一能力的細節(jié)tests/ 目錄下的 fixturesASGI/WSGI/WebSocket/Cron 各場景是最直接的行為規(guī)范文檔。贊分享CLI后端云原生【免費下載鏈接】vercelDevelop. Preview. Ship.項目地址https://gitcode.com/gh_mirrors/ve/vercel點擊查看免費下載相關推薦Django Vercel借助 Python Runtime 與 Serverless Functions 部署 Django 6 實戰(zhàn)指南Django Vercel借助 Python Runtime 與 Serverless Functions 部署 Django 6 實戰(zhàn)指南 Django示例工程前端后端Cua Driver SDK-Owned Runtime從守護進程到進程內 Runtime 的架構演進RFC 2549 全解析Cua Driver SDK Owned Runtime從守護進程到進程內 Runtime 的架構演進RFC 2549 全解析 導讀 RFC 2549 是人工智能AI AgentGUI 自動化Agent 評測強化學習Agent 沙箱計算機視覺MCP 服務Vercel Python Serverless Functions 實戰(zhàn)基于 Hello World 示例掌握 Python Runtime 部署Vercel Python Serverless Functions 實戰(zhàn)基于 Hello World 示例掌握 Python Runtime 部署 導讀 本示例工程前端后端上一篇Mojito框架快速入門指南下一篇破解LCOV差異覆蓋率報告難題從沖突分析到精準測試實踐指南創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考