@lazycatcloud/lzc-cli 1.3.17 → 2.0.0-pre.1

package/template/_lpk/hello-vue.manifest.yml.in

@@ -0,0 +1,38 @@
+application:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+#@build if env.DEV_MODE=1
+  injects:
+    - id: frontend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const devPort = 3000;
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.dev.id) {
+              ctx.response.send(200, renderDevPage("not_linked", devPort));
+              return;
+            }
+
+            const via = ctx.net.via.client(ctx.dev.id);
+            if (!ctx.dev.online()) {
+              ctx.response.send(200, renderDevPage("offline", devPort));
+              return;
+            }
+
+            if (!ctx.net.reachable("tcp", "127.0.0.1", devPort, via)) {
+              ctx.response.send(200, renderDevPage("not_ready", devPort));
+              return;
+            }
+
+            ctx.proxy.to("http://127.0.0.1:" + String(devPort), {
+              via: via,
+              use_target_host: true,
+            });
+#@build else
+  routes:
+    - /=file:///lzcapp/pkg/content/dist
+#@build end

package/template/_lpk/manifest.yml.in

@@ -1,14 +1,7 @@
-name: ${name} # app名称
-package: ${package} # app的唯一标识符
-version: 0.0.1 # app的版本
-description: # app描述
-
-license: https://choosealicense.com/licenses/mit/
-homepage: # 出现bug时候提交反馈的地方
-author: # app author
-
-#application作为一个特殊的container运行，对应的service名称为固定的`app`，其他service可以通过此名称与app进行通讯
+# application 作为默认前台容器运行，对应固定 service 名 app
 application:
-  subdomain: ${subdomain} #期望的app域名
+  subdomain: ${subdomain} # 默认访问子域名前缀
   routes:
+    # file:// 路由：直接返回静态文件（前端构建产物）
+    # 该示例默认读取 /lzcapp/pkg/content/dist 下的内容
     - /=file:///lzcapp/pkg/content/dist

package/template/_lpk/package.yml.in

@@ -0,0 +1,7 @@
+package: ${package} # app的唯一标识符
+version: 0.0.1 # app的版本
+name: ${name} # app名称
+description: # app描述
+author: # app author
+license: https://choosealicense.com/licenses/mit/
+homepage: # 出现bug时候提交反馈的地方

package/template/_lpk/todolist-golang.manifest.yml.in

@@ -0,0 +1,30 @@
+application:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+  image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
+#@build if env.DEV_MODE=1
+  injects:
+    - id: backend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const backendPort = 3000;
+            const backendURL = "http://127.0.0.1:" + String(backendPort);
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.net.reachable("tcp", "127.0.0.1", backendPort)) {
+              ctx.response.send(200, renderDevPage(backendPort));
+              return;
+            }
+
+            ctx.proxy.to(backendURL, {
+              use_target_host: true,
+            });
+#@build else
+  routes:
+    # exec:// 路由会执行 /app/run.sh，并把请求转发到 3000 端口
+    # 适合「一个容器同时承载前端+后端」的入门场景
+    - /=exec://3000,/app/run.sh
+#@build end

package/template/_lpk/todolist-java.manifest.yml.in

@@ -0,0 +1,29 @@
+application:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+  image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
+#@build if env.DEV_MODE=1
+  injects:
+    - id: backend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const backendPort = 8080;
+            const backendURL = "http://127.0.0.1:" + String(backendPort);
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.net.reachable("tcp", "127.0.0.1", backendPort)) {
+              ctx.response.send(200, renderDevPage(backendPort));
+              return;
+            }
+
+            ctx.proxy.to(backendURL, {
+              use_target_host: true,
+            });
+#@build else
+  routes:
+    # exec:// 路由会执行 /app/run.sh，并把请求转发到 8080 端口
+    - /=exec://8080,/app/run.sh
+#@build end

package/template/_lpk/todolist-python.manifest.yml.in

@@ -0,0 +1,37 @@
+application:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+#@build if env.DEV_MODE=1
+  injects:
+    - id: backend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const backendHost = "backend";
+            const backendPort = 3000;
+            const backendURL = "http://" + backendHost + ":" + String(backendPort);
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.net.reachable("tcp", backendHost, backendPort)) {
+              ctx.response.send(200, renderDevPage(backendPort));
+              return;
+            }
+
+            ctx.proxy.to(backendURL, {
+              use_target_host: true,
+            });
+#@build else
+  image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
+  routes:
+    # exec:// 路由会执行 /app/run.sh，并把请求转发到 3000 端口
+    - /=exec://3000,/app/run.sh
+#@build end
+
+#@build if env.DEV_MODE=1
+services:
+  backend:
+    image: embed:app-runtime
+    command: /app/run.sh
+#@build end

package/template/_lpk/todolist-serverless.manifest.yml.in

@@ -0,0 +1,38 @@
+application:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+#@build if env.DEV_MODE=1
+  injects:
+    - id: frontend-dev-proxy
+      on: request
+      auth_required: false
+      when:
+        - "/*"
+      do:
+        - src: |
+            const devPort = 3000;
+            #@build include ./manifest.dev.page.js
+
+            if (!ctx.dev.id) {
+              ctx.response.send(200, renderDevPage("not_linked", devPort));
+              return;
+            }
+
+            const via = ctx.net.via.client(ctx.dev.id);
+            if (!ctx.dev.online()) {
+              ctx.response.send(200, renderDevPage("offline", devPort));
+              return;
+            }
+
+            if (!ctx.net.reachable("tcp", "127.0.0.1", devPort, via)) {
+              ctx.response.send(200, renderDevPage("not_ready", devPort));
+              return;
+            }
+
+            ctx.proxy.to("http://127.0.0.1:" + String(devPort), {
+              via: via,
+              use_target_host: true,
+            });
+#@build else
+  routes:
+    - /=file:///lzcapp/pkg/content/dist
+#@build end

package/template/_lpk/vue.lzc-build.yml.in

@@ -1,5 +1,3 @@
-# 整个文件中，可以通过 ${var} 的方式，使用 manifest 字段指定的文件定义的值
-
 # buildscript
 # - 可以为构建脚本的路径地址
 # - 如果构建命令简单，也可以直接写 sh 的命令
@@ -20,45 +18,3 @@ icon: ./lazycat.png
 
 # deploy_params 指定用户运行时输入的模板字段
 # deploy_params: ./lzc-deploy-params.yml
-
-# devshell 自定义应用的开发容器环境
-# - routes 指定应用容器的访问路由
-
-# devshell 没有指定 image 的情况，将会默认使用 registry.lazycat.cloud/lzc-cli/devshell:v0.0.5
-# devshell:
-#   routes:
-#     - /=http://127.0.0.1:8080
-
-# devshell 指定 image 的情况
-# devshell:
-#   routes:
-#     - /=http://127.0.0.1:3000
-#   image: registry.lazycat.cloud/lzc-cli/devshell:v0.0.5
-
-# devshell 指定构建Dockerfile
-# image 字段如果没有定义，将默认使用 ${package}-devshell:${version}
-# devshell:
-#   routes:
-#     - /=http://127.0.0.1:3000
-#   image: ${package}-devshell:${version}
-#   pull_policy: build
-#   build: .
-
-# dvshell 指定开发依赖的情况
-# 这种情况下，选用 alpine:latest 作为基础镜像，在 dependencies 中添加所需要的开发依赖即可
-# 如果 dependencies 和 build 同时存在，将会优先使用 dependencies
-devshell:
-  routes:
-    - /=http://127.0.0.1:3000
-  dependencies:
-    - nodejs
-    - vim
-    - npm
-  # setupscript 每次进入到app container后都会执行的配置脚本
-  # - 可以为脚本的路径地址
-  # - 如果构建命令简单，也可以直接写 sh 的命令
-  # setupscript: export GOPROXY=https://goproxy.cn
-  # setupscript: ./setupscript.sh
-  setupscript: |
-    export GOPROXY=https://goproxy.cn
-    export npm_config_registry=https://registry.npmmirror.com

package/template/blank/lzc-build.dev.yml

@@ -0,0 +1,4 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev

package/template/blank/lzc-build.yml

@@ -1,5 +1,3 @@
-# 整个文件中，可以通过 ${var} 的方式，使用 manifest 字段指定的文件定义的值
-
 # buildscript
 # - 可以为构建脚本的路径地址
 # - 如果构建命令简单，也可以直接写 sh 的命令
@@ -11,48 +9,33 @@ manifest: ./lzc-manifest.yml
 # contentdir: 指定打包的内容，将会打包到 lpk 中
 # contentdir: ./
 
+# images: 在盒子侧构建镜像并写入 lpk v2 images 目录
+# - key 是 image alias
+# - 在 lzc-manifest.yml 中通过 embed:alias 引用
+# - dockerfile 与 dockerfile-content 二选一
+# - context 可选，默认是 dockerfile 所在目录
+# images:
+#   my-nginx:
+#     context: ./image
+#     dockerfile: ./image/Dockerfile
+#     # 可选，默认 registry.lazycat.cloud
+#     upstream-match: registry.lazycat.cloud
+#   other-image:
+#     dockerfile: ./other/Dockerfile
+#   inline-image:
+#     context: ./
+#     dockerfile-content: |
+#       FROM alpine:3.20
+#       RUN echo "hello"
+#
+# 构建时默认是混合模式:
+# - 先沿父镜像链向上找 upstream
+# - 找到 upstream 后，仅 embed 非 upstream 的 layers
+# - 如果未匹配到 upstream，则自动全量 embed
+
 # pkgout: lpk 包的输出路径
 pkgout: ./
 
 # icon 指定 lpk 包 icon 的路径路径，如果不指定将会警告
 # icon 仅仅允许 png 后缀的文件
 icon: ./lzc-icon.png
-# devshell 自定义应用的开发容器环境
-# - routes 指定应用容器的访问路由
-
-# devshell 没有指定 image 的情况，将会默认使用 registry.lazycat.cloud/lzc-cli/devshell:v0.0.5
-# devshell:
-#   routes:
-#     - /=http://127.0.0.1:8080
-
-# devshell 指定 image 的情况
-# devshell:
-#   routes:
-#     - /=http://127.0.0.1:3000
-#   image: registry.lazycat.cloud/lzc-cli/devshell:v0.0.5
-
-# devshell 指定构建Dockerfile
-# image 字段如果没有定义，将默认使用 ${package}-devshell:${version}
-# devshell:
-#   routes:
-#     - /=http://127.0.0.1:3000
-#   image: ${package}-devshell:${version}
-#   pull_policy: build
-#   build: .
-
-# dvshell 指定开发依赖的情况
-# 这种情况下，选用 alpine:latest 作为基础镜像，在 dependencies 中添加所需要的开发依赖即可
-# 如果 dependencies 和 build 同时存在，将会优先使用 dependencies
-# devshell:
-#   routes:
-#     - /=http://127.0.0.1:3000
-#   dependencies:
-#     - nodejs
-#     - npm
-#   # setupscript 每次进入到app container后都会执行的配置脚本
-#   # - 可以为脚本的路径地址
-#   # - 如果构建命令简单，也可以直接写 sh 的命令
-#   # setupscript: export GOPROXY=https://goproxy.cn
-#   # setupscript: ./setupscript.sh
-#   setupscript: |
-#     export npm_config_registry=https://registry.npmmirror.com

package/template/blank/lzc-manifest.yml

@@ -1,11 +1,9 @@
-name: helloworld
-package: cloud.lazycat.app.helloworld
-version: 0.0.1
-description:
-license: https://choosealicense.com/licenses/mit/
-homepage:
-author:
+# application 是默认前台服务，对应固定 service 名 app
 application:
-  subdomain: helloworld
+  subdomain: helloworld # 默认访问子域名前缀
   routes:
-    - /=https://developer.lazycat.cloud/
+    # 路由示例：把首页转发到一个外部站点
+    # 常见写法:
+    #   - /=http://example.com
+    #   - /=file:///lzcapp/pkg/content/html
+    - /=http://example.com

package/template/blank/package.yml

@@ -0,0 +1,7 @@
+package: cloud.lazycat.app.helloworld # 应用唯一ID，建议使用反向域名格式
+version: 0.0.1 # 应用版本
+name: helloworld # 应用名称
+description: # 应用描述
+author: # 作者信息
+license: https://choosealicense.com/licenses/mit/
+homepage: # 项目主页或文档地址

package/template/golang/Dockerfile

@@ -0,0 +1,19 @@
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3 AS builder
+
+RUN apk add --no-cache go
+WORKDIR /workspace
+
+COPY go.mod ./
+COPY main.go ./
+RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o /workspace/app ./main.go
+
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3
+
+WORKDIR /app
+COPY --from=builder /workspace/app /app/app
+COPY run.sh /app/run.sh
+RUN chmod +x /app/run.sh /app/app
+COPY web /app/web
+
+EXPOSE 3000
+CMD ["/app/run.sh"]

package/template/golang/Dockerfile.dev

@@ -0,0 +1,20 @@
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3 AS builder
+
+RUN apk add --no-cache go
+WORKDIR /workspace
+
+COPY go.mod ./
+COPY main.go ./
+RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o /workspace/app ./main.go
+
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3
+
+RUN apk add --no-cache go
+WORKDIR /app
+COPY --from=builder /workspace/app /app/app
+COPY run.sh /app/run.sh
+RUN chmod +x /app/run.sh /app/app
+COPY web /app/web
+
+EXPOSE 3000
+CMD ["sh", "-lc", "trap : TERM INT; sleep infinity & wait"]

package/template/golang/README.md

@@ -0,0 +1,44 @@
+# Lazycat Golang Todo App
+
+## First Deploy
+```bash
+lzc-cli project deploy
+lzc-cli project info
+```
+
+By default, project commands use `lzc-build.dev.yml` when it exists.
+Each command prints the active `Build config`.
+Use `--release` if you want to operate on `lzc-build.yml`.
+
+Open the app first.
+In dev mode, the app will not auto-start the Golang service.
+If the backend service is not ready yet, the app page will show the expected port and what to do next.
+
+## Recommended Backend Dev Loop
+```bash
+lzc-cli project sync --watch
+lzc-cli project exec /bin/sh
+/app/run.sh
+```
+
+You can also build locally and use `lzc-cli project cp` instead of `project sync --watch`.
+
+## Troubleshooting
+```bash
+lzc-cli project log -f
+lzc-cli project exec /bin/sh
+```
+
+## API
+```text
+GET /api/health
+GET /api/todos
+POST /api/todos
+PUT /api/todos/{id}/toggle
+DELETE /api/todos/{id}
+```
+
+## Data Path
+```text
+/lzcapp/var/todos.json
+```

package/template/golang/_gitignore

@@ -0,0 +1,3 @@
+/bin/
+*.lpk
+/cloud.lazycat.app.golang-template

package/template/golang/_lzcdevignore

@@ -0,0 +1,21 @@
+.git
+.git/**
+node_modules
+node_modules/**
+.venv
+.venv/**
+dist
+dist/**
+build
+build/**
+__pycache__
+__pycache__/**
+.idea
+.idea/**
+.vscode
+.vscode/**
+.DS_Store
+.lzc-cli-*
+.lzc-cli-*/**
+*.lpk
+*.lpk.tar

package/template/golang/go.mod

@@ -0,0 +1,3 @@
+module cloud.lazycat.app.golang-template
+
+go 1.22

package/template/golang/lzc-build.dev.yml

@@ -0,0 +1,12 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev
+
+envs:
+  - DEV_MODE=1
+
+images:
+  app-runtime:
+    context: ./
+    dockerfile: ./Dockerfile.dev

package/template/golang/lzc-build.yml

@@ -0,0 +1,16 @@
+# manifest: 指定 lpk 的 manifest 文件
+manifest: ./lzc-manifest.yml
+
+# pkgout: lpk 输出目录
+pkgout: ./
+
+# icon: 应用图标（png）
+icon: ./lzc-icon.png
+
+# images: 构建容器镜像并写入 lpk v2 的 images 目录
+images:
+  app-runtime:
+    # context: Docker 构建上下文目录
+    context: ./
+    # dockerfile: 镜像构建文件
+    dockerfile: ./Dockerfile