編程語言編譯器云原生語言運(yùn)行時(shí)【免費(fèi)下載鏈接】wingA programming language for the cloud ?? A unified programming model, combining infrastructure and runtime code into one language ?項(xiàng)目地址https://gitcode.com/gh_mirrors/wi/wing點(diǎn)擊查看免費(fèi)下載導(dǎo)讀sim.Container是 Wing 標(biāo)準(zhǔn)庫中用于在本地模擬器Wing Simulator中運(yùn)行 Docker 容器的資源它允許開發(fā)者在真實(shí)的云端部署之前用本地容器完成服務(wù)聯(lián)調(diào)與測試。本文以倉庫中的 Hangar 測試快照 entrypoint.test.w_test_sim.md 為線索完整拆解sim.Container自定義entrypoint與args的實(shí)戰(zhàn)寫法、全部構(gòu)造參數(shù)、底層docker run命令的生成邏輯、hostPort端口映射原理以及容器的停止與強(qiáng)制清理機(jī)制讀完即可在自己的 Wing 項(xiàng)目中熟練編排帶自定義啟動(dòng)命令的本地容器并理解其運(yùn)行日志的每一行含義。一、快照文檔是什么Hangar 端到端測試的產(chǎn)物tools/hangar/__snapshots__/test_corpus/sdk_tests/container/目錄下的快照文件是 Wing 倉庫中 Hangar 工具鏈見 tools/hangar/README.md運(yùn)行端到端測試后生成的確定性輸出?？煺漳夸浀亩ㄎ贿壿嫸x在 tools/hangar/src/paths.tssnapshotDir path.join(hangarDir, __snapshots__)而測試用例的收集路徑定義在 tools/hangar/src/generate_tests.ts。本文的主角entrypoint.test.w_test_sim.md就是測試源文件 tests/sdk_tests/container/entrypoint.test.w 在sim 目標(biāo)Wing Simulator下執(zhí)行一次測試后的標(biāo)準(zhǔn)輸出快照其內(nèi)容如下[INFO] container with entrypoint | hello [WARNING] container with entrypoint | Timeout waiting for container root/Default/with-entrypoint to shutdown, removing forcefully pass ─ entrypoint.test.wsim ? root/Default/test:container with entrypoint Tests 1 passed (1) Snapshots 1 skipped Test Files 1 passed (1) Duration DURATION這份快照雖然只有十幾行卻完整記錄了一次帶自定義 entrypoint 的容器測試從啟動(dòng)、請求到關(guān)閉的全過程是理解sim.Container行為最直接的事實(shí)依據(jù)。二、測試源碼剖析自定義 entrypoint 的最小完整示例快照對應(yīng)的測試源碼 entrypoint.test.w 全文如下/*\ skipPlatforms: - win32 - darwin \*/ bring sim; bring http; bring expect; // only relevant in simulator if target sim { let entrypoint new sim.Container( name: my-entrypoint-app, image: ./my-docker-image, containerPort: 3000, args: [-c, RESPONSEhello /usr/local/bin/node /app/index.js], entrypoint: /bin/sh, ) as with-entrypoint; test container with entrypoint { let response http.get(http://localhost:{entrypoint.hostPort!}); log(response.body); expect.equal(hello, response.body); } }這段代碼有幾個(gè)值得注意的關(guān)鍵點(diǎn)skipPlatforms聲明該測試明確跳過 win32 與 darwin 平臺因?yàn)槿萜髻Y源依賴 Docker 守護(hù)進(jìn)程Linux 是 Wing 模擬器容器測試的標(biāo)準(zhǔn)環(huán)境。if target sim條件編譯sim.Container僅存在于模擬器目標(biāo)因此整個(gè)資源創(chuàng)建與測試都包裹在目標(biāo)判斷中避免在tf-aws等編譯目標(biāo)下生效。這一點(diǎn)從同名編譯快照 entrypoint.test.w_compile_tf-aws.md 可以得到印證——tf-aws 目標(biāo)下生成的主 Terraform 文件幾乎是空的沒有任何容器相關(guān)資源。自定義entrypoint與argsentrypoint: /bin/sh覆蓋了鏡像默認(rèn)的入口程序args: [-c, RESPONSEhello /usr/local/bin/node /app/index.js]則把啟動(dòng)參數(shù)傳給/bin/sh組合效果等價(jià)于在容器內(nèi)執(zhí)行RESPONSEhello /usr/local/bin/node /app/index.js——即以環(huán)境變量方式注入響應(yīng)內(nèi)容并啟動(dòng) Node 服務(wù)。hostPort!非空斷言hostPort是 Wing 的 token 屬性只有在容器真正啟動(dòng)、端口完成映射后才會(huì)解析出宿主機(jī)端口測試中通過!斷言其已就緒。鏡像本身來自本地目錄 tests/sdk_tests/container/my-docker-image其中的 Dockerfile 與 index.js 定義了測試服務(wù)的真實(shí)行為FROM node:20.8.0-alpine EXPOSE 3000 ADD index.js /app/index.js ENTRYPOINT [ /app/index.js ]const response process.env.RESPONSE; const server http.createServer((req, res) { res.end(response ?? Hello, Wingnuts!); }); console.log(listening on port 3000); server.listen(3000);注意index.js中process.env.RESPONSE的讀取邏輯默認(rèn)鏡像入口直接運(yùn)行/app/index.js時(shí)響應(yīng)的是默認(rèn)值Hello, Wingnuts!而entrypoint.test.w通過把entrypoint換成/bin/sh、用args注入RESPONSEhello環(huán)境變量讓同一鏡像在測試中返回hello。快照第一行[INFO] container with entrypoint | hello正是log(response.body)輸出的結(jié)果expect.equal(hello, response.body)隨之通過測試在末尾打印pass。三、sim.Container 完整 API全部構(gòu)造參數(shù)與默認(rèn)值sim.Container的構(gòu)造參數(shù)ContainerProps定義于 packages/winglang/sdk/src/target-sim/container.ts官方 API 文檔見 docs/api/04-standard-library/sim/container.md。完整參數(shù)清單如下參數(shù)類型必填默認(rèn)值說明namestr是無容器名稱也參與鏡像標(biāo)簽的生成imagestr是無公共 Docker 鏡像名拉取運(yùn)行或本地含Dockerfile的目錄路徑構(gòu)建運(yùn)行containerPortnum否不暴露端口容器內(nèi)部需要暴露的 TCP 端口設(shè)置后才會(huì)生成hostPortenvMutMapstr否{}注入容器的環(huán)境變量argsMutArraystr否[]傳給容器 entrypoint 的參數(shù)entrypointstr否鏡像默認(rèn) entrypoint覆蓋容器入口程序volumesMutArraystr否[]卷掛載點(diǎn)如[/host:/container]以/開頭且不含:的路徑按匿名卷處理networkstr否Docker 默認(rèn)網(wǎng)絡(luò)Docker 網(wǎng)絡(luò)模式如host、bridgesourcePatternstr否構(gòu)建上下文全部文件計(jì)算源碼哈希時(shí)參與的 glob 模式用于判斷是否需要重建鏡像sourceHashstr否基于源文件自動(dòng)計(jì)算顯式指定代表容器源碼的哈希值其中entrypoint與args的語義需要區(qū)分entrypoint覆蓋的是 Docker 的--entrypoint入口程序本身而args是傳給該入口的啟動(dòng)參數(shù)。在 Dockerfile 中鏡像默認(rèn)入口是ENTRYPOINT [ /app/index.js ]測試將其替換為/bin/sh后args中的-c RESPONSEhello ...就變成了 shell 執(zhí)行的命令行。正是二者的組合實(shí)現(xiàn)了同一鏡像、不同啟動(dòng)方式的靈活性。四、底層原理一條 docker run 命令是如何拼出來的sim.Container在模擬器中運(yùn)行時(shí)的實(shí)際載體是 packages/winglang/sdk/src/target-sim/container.inflight.ts 中的Container類。該類的start()方法container.inflight.ts逐段拼接出最終的docker run命令固定參數(shù)-i --rm --name wing-ulid其中--rm保證容器退出即被清理容器名以wing-前綴加 ULID 生成以避免沖突網(wǎng)絡(luò)參數(shù)配置了network時(shí)追加--networknetworkcontainer.inflight.ts端口映射設(shè)置了containerPort時(shí)追加-p containerPort由 Docker 自動(dòng)分配宿主機(jī)端口container.inflight.ts環(huán)境變量env非空時(shí)先寫入臨時(shí)文件再以--env-file方式傳入container.inflight.ts 與 createEnvFile卷掛載對volumes逐項(xiàng)追加-vcontainer.inflight.tsentrypoint 覆蓋配置了entrypoint時(shí)追加--entrypoint 值這正是本次測試的核心參數(shù)container.inflight.ts最后是鏡像標(biāo)簽與args中的每一個(gè)參數(shù)container.inflight.ts。于是entrypoint.test.w中的配置最終展開為類似這樣的命令docker run -i --rm --name wing-ulid -p 3000 --entrypoint /bin/sh my-entrypoint-app:hash -c RESPONSEhello /usr/local/bin/node /app/index.js鏡像標(biāo)簽與構(gòu)建/拉取分流在預(yù)檢階段 packages/winglang/sdk/src/target-sim/container.ts 會(huì)根據(jù)image是否為本地路徑?jīng)Q定鏡像標(biāo)簽若image是本地目錄如./my-docker-image鏡像標(biāo)簽為${name}:${hash}其中hash取自顯式傳入的sourceHash或由sourcePattern限定范圍后對源文件計(jì)算 MD5fs.md5(props.image, props.sourcePattern)若image是公共鏡像名如hashicorp/http-echo鏡像標(biāo)簽直接使用該名稱。運(yùn)行時(shí)prepareImage 先嘗試docker inspect檢查鏡像是否已存在已存在則直接復(fù)用不存在時(shí)本地目錄走docker build -t tag dir鏡像名走docker pull tag。這意味著本地 Dockerfile 變更會(huì)因源碼哈希變化而自動(dòng)觸發(fā)重建這是sourcePattern/sourceHash參數(shù)存在的原因。hostPort 的生成與就緒等待hostPort是資源在預(yù)檢階段創(chuàng)建的 token 屬性container.ts僅當(dāng)配置了containerPort時(shí)才存在。容器啟動(dòng)后模擬器通過 start() 中的waitUntil循環(huán)每 100ms 檢查一次容器狀態(tài)總超時(shí) 30 秒見 waitUntil普通網(wǎng)絡(luò)模式下通過docker inspect讀取NetworkSettings.Ports中containerPort/tcp對應(yīng)的HostPort拿到映射后的宿主機(jī)端口使用network: host時(shí)宿主機(jī)端口與容器端口相同container.inflight.ts這一行為在 network.test.w 中有專門的斷言expect.equal(networkHost.hostPort, 5678)。拿到端口后測試中的http.get(http://localhost:{entrypoint.hostPort!})才能命中容器內(nèi)的 3000 端口服務(wù)。容器中途意外退出會(huì)拋出 Container stopped unexpectedly 錯(cuò)誤。五、容器生命周期與快照中的 WARNING 日志解讀快照第二行是[WARNING] container with entrypoint | Timeout waiting for container root/Default/with-entrypoint to shutdown, removing forcefully它來自容器關(guān)閉邏輯而不是測試失敗——測試本身最終標(biāo)記為pass。關(guān)閉流程在 kill() 中實(shí)現(xiàn)模擬器先向 docker 子進(jìn)程發(fā)送SIGTERM優(yōu)雅退出信號并等待 2 秒若容器在 2 秒內(nèi)未退出則觸發(fā)超時(shí)分支打印上述 WARNING 日志并執(zhí)行docker rm -f containerName強(qiáng)制刪除container.inflight.ts。這里的root/Default/with-entrypoint是資源在 Wing 應(yīng)用樹中的完整路徑with-entrypoint正是源碼中as with-entrypoint指定的顯示 ID。本測試中的容器以/bin/sh作為入口shell 進(jìn)程對 SIGTERM 的響應(yīng)路徑導(dǎo)致容器未在 2 秒內(nèi)完成優(yōu)雅退出因此出現(xiàn)了強(qiáng)制移除的警告——這是模擬器保證資源及時(shí)釋放的兜底機(jī)制并非錯(cuò)誤。相比之下Dockerfile 中的index.js顯式注冊了 SIGINT 處理process.on(SIGINT, ...)說明對信號響應(yīng)良好的服務(wù)可以更平滑地關(guān)閉。六、狀態(tài)保留與更多實(shí)戰(zhàn)配置sim.Container還支持跨模擬器重啟保留數(shù)據(jù)。官方文檔 container.md 指出關(guān)閉 Wing Console 時(shí)所有容器都會(huì)被停止并移除要讓容器狀態(tài)在重啟后保留可以掛載匿名卷new sim.Container( name: my-service, image: ./my-service, containerPort: 8080, volumes: [/var/data], );其實(shí)現(xiàn)機(jī)制在 container.inflight.ts以/開頭且不含:的卷路徑被識別為匿名卷Wing 會(huì)為它生成wing-volume-ulid的命名卷并通過狀態(tài)文件state.jsoncontainer.inflight.ts記錄路徑與卷名的映射下次啟動(dòng)時(shí)復(fù)用同一命名卷。這一模式在 mount.test.w 中以postgres:15鏡像 /var/lib/postgresql/data數(shù)據(jù)目錄的形式給出了實(shí)際用例同時(shí)展示了env傳POSTGRES_PASSWORD的寫法。其他相關(guān)測試用例還包括container.test.w同時(shí)驗(yàn)證公共鏡像拉取hashicorp/http-echo與本地目錄構(gòu)建兩種模式并分別斷言bang\n與Hello, Wingnuts!響應(yīng)network.test.w驗(yàn)證network: host模式下hostPort直接等于containerPortpull-failure.test.w 與 build-failure.test.w分別用非法鏡像協(xié)議foo://do-not-pull-me和不存在的構(gòu)建目錄驗(yàn)證失敗路徑。七、運(yùn)行與驗(yàn)證方式在倉庫環(huán)境中這些容器測試屬于 Hangar 端到端測試體系按 tools/hangar/README.md 的說明在 Wing 開發(fā)流程中執(zhí)行。直接驗(yàn)證本文示例的方式是確保本機(jī) Linux 環(huán)境已安裝并運(yùn)行 Docker 守護(hù)進(jìn)程然后對 entrypoint.test.w 執(zhí)行wing test并指定sim目標(biāo)。若輸出與 entrypoint.test.w_test_sim.md 快照一致即pass ─ entrypoint.test.wsim ? root/Default/test:container with entrypoint、Tests 1 passed (1)則說明自定義entrypointargs的容器編排正確生效。需要說明的是sim.Container是模擬器專屬資源對應(yīng)winglang/sdk.sim.Container不參與tf-aws等云端目標(biāo)的資源生成因此這類容器編排通常用于本地開發(fā)聯(lián)調(diào)與回歸測試云端部署仍需借助平臺提供的容器工作負(fù)載能力。贊分享編程語言編譯器云原生語言運(yùn)行時(shí)【免費(fèi)下載鏈接】wingA programming language for the cloud ?? A unified programming model, combining infrastructure and runtime code into one language ?項(xiàng)目地址https://gitcode.com/gh_mirrors/wi/wing點(diǎn)擊查看免費(fèi)下載相關(guān)推薦Wing 容器 Entrypoint 快照測試解析從 sim.Container 參數(shù)到 tf-aws 編譯產(chǎn)物Wing 容器 Entrypoint 快照測試解析從 sim.Container 參數(shù)到 tf aws 編譯產(chǎn)物 導(dǎo)讀 本文圍繞 Wing 倉庫中 hanga編程語言編譯器云原生語言運(yùn)行時(shí)Wing 模擬器容器測試全解從 sim.Container 到 hangar 快照的端到端驗(yàn)證Wing 模擬器容器測試全解從 sim.Container 到 hangar 快照的端到端驗(yàn)證 本文圍繞 Wing 倉庫中 sim.Container 資源在編程語言編譯器云原生語言運(yùn)行時(shí)Wing 容器資源深度解析從 hangar 編譯快照看 sim.Container 在 tf-aws 與模擬器目標(biāo)下的行為Wing 容器資源深度解析從 hangar 編譯快照看 sim.Container 在 tf aws 與模擬器目標(biāo)下的行為 本文以倉庫 tools/hanga編程語言編譯器云原生語言運(yùn)行時(shí)上一篇fre:ac免費(fèi)音頻轉(zhuǎn)換器跨平臺終極指南與實(shí)用教程下一篇Taro Runner 公用工具函數(shù)解析tarojs/runner-utils 的 Sass 注入、多端文件解析與 Vite 編譯上下文創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考