@lazycatcloud/lzc-cli 1.3.14 → 2.0.0-pre.0

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

@@ -0,0 +1,16 @@
+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:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+  image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
+  routes:
+    # exec:// 路由会执行 /app/run.sh，并把请求转发到 3000 端口
+    # 适合「一个容器同时承载前端+后端」的入门场景
+    - /=exec://3000,/app/run.sh

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

@@ -0,0 +1,15 @@
+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:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+  image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
+  routes:
+    # exec:// 路由会执行 /app/run.sh，并把请求转发到 8080 端口
+    - /=exec://8080,/app/run.sh

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

@@ -0,0 +1,15 @@
+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:
+  subdomain: ${subdomain} # 默认访问子域名前缀
+  image: embed:app-runtime # 引用 lzc-build.yml 里的 images.app-runtime
+  routes:
+    # exec:// 路由会执行 /app/run.sh，并把请求转发到 3000 端口
+    - /=exec://3000,/app/run.sh

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/_gitignore

@@ -0,0 +1 @@
+lzc-build.base.yml

package/template/blank/lzc-build.yml

@@ -1,4 +1,4 @@
-# 整个文件中，可以通过 ${var} 的方式，使用 manifest 字段指定的文件定义的值
+# 可选基础文件: lzc-build.base.yml（与当前文件同目录，先加载再与当前文件合并）
 
 # buildscript
 # - 可以为构建脚本的路径地址
@@ -11,48 +11,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,18 @@
-name: helloworld
-package: cloud.lazycat.app.helloworld
-version: 0.0.1
-description:
+name: helloworld # 应用名称（启动器里显示）
+package: cloud.lazycat.app.helloworld # 应用唯一ID，建议使用反向域名格式
+version: 0.0.1 # 应用版本，建议遵循 semver
+description: # 应用描述
 license: https://choosealicense.com/licenses/mit/
-homepage:
-author:
+homepage: # 项目主页或文档地址
+author: # 作者信息
+
+# application 是默认前台服务，对应固定 service 名 app
 application:
-  subdomain: helloworld
+  subdomain: helloworld # 默认访问子域名前缀
   routes:
+    # 路由示例：把首页转发到一个外部站点
+    # 常见写法:
+    # - /=file:///lzcapp/pkg/content/dist        (静态前端)
+    # - /=exec://3000,/app/run.sh                (执行命令并转发到端口)
+    # - /api/=http://backend:3000/api/           (转发到其他 service)
     - /=https://developer.lazycat.cloud/

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 /lzcapp/pkg/content/web
+
+EXPOSE 3000
+CMD ["/app/run.sh"]

package/template/golang/README.md

@@ -0,0 +1,33 @@
+# Lazycat Golang Todo App
+
+## First Deploy
+```bash
+lzc-cli project deploy
+lzc-cli project info
+```
+
+Then open the app from launcher or browser.
+
+## 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
+```
+
+## Build LPK
+```bash
+lzc-cli project build -o golang-app.lpk
+```
+
+## Install
+```bash
+lzc-cli lpk install golang-app.lpk
+```

package/template/golang/_gitignore

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

package/template/golang/go.mod

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

package/template/golang/lzc-build.yml

@@ -0,0 +1,21 @@
+# 可选基础文件: lzc-build.base.yml（与当前文件同目录，先加载再与当前文件合并）
+
+# manifest: 指定 lpk 的 manifest 文件
+manifest: ./lzc-manifest.yml
+
+# contentdir: 需要打包进 lpk 的目录
+contentdir: ./
+
+# pkgout: lpk 输出目录
+pkgout: ./
+
+# icon: 应用图标（png）
+icon: ./lzc-icon.png
+
+# images: 构建容器镜像并写入 lpk v2 的 images 目录
+images:
+  app-runtime:
+    # context: Docker 构建上下文目录
+    context: ./
+    # dockerfile: 镜像构建文件
+    dockerfile: ./Dockerfile

package/template/golang/main.go

@@ -0,0 +1,252 @@
+package main
+
+import (
+	"encoding/json"
+	"net/http"
+	"os"
+	"path/filepath"
+	"sort"
+	"strconv"
+	"strings"
+	"sync"
+	"sync/atomic"
+	"time"
+)
+
+type todoItem struct {
+	ID        int64  `json:"id"`
+	Title     string `json:"title"`
+	Done      bool   `json:"done"`
+	UpdatedAt int64  `json:"updatedAt"`
+}
+
+type todoStore struct {
+	mu     sync.RWMutex
+	nextID atomic.Int64
+	items  map[int64]todoItem
+	file   string
+}
+
+func newTodoStore(file string) (*todoStore, error) {
+	store := &todoStore{
+		items: map[int64]todoItem{},
+		file:  file,
+	}
+	store.nextID.Store(1)
+	if err := os.MkdirAll(filepath.Dir(file), 0o755); err != nil {
+		return nil, err
+	}
+	if err := store.load(); err != nil {
+		return nil, err
+	}
+	return store, nil
+}
+
+func (s *todoStore) load() error {
+	bs, err := os.ReadFile(s.file)
+	if err != nil {
+		if os.IsNotExist(err) {
+			return nil
+		}
+		return err
+	}
+	var items []todoItem
+	if len(bs) == 0 {
+		return nil
+	}
+	if err := json.Unmarshal(bs, &items); err != nil {
+		return err
+	}
+
+	var maxID int64 = 0
+	for _, item := range items {
+		s.items[item.ID] = item
+		if item.ID > maxID {
+			maxID = item.ID
+		}
+	}
+	s.nextID.Store(maxID + 1)
+	return nil
+}
+
+func (s *todoStore) persistLocked() error {
+	items := make([]todoItem, 0, len(s.items))
+	for _, item := range s.items {
+		items = append(items, item)
+	}
+	sort.Slice(items, func(i, j int) bool {
+		return items[i].ID < items[j].ID
+	})
+
+	bs, err := json.MarshalIndent(items, "", "  ")
+	if err != nil {
+		return err
+	}
+	tmpFile := s.file + ".tmp"
+	if err := os.WriteFile(tmpFile, bs, 0o644); err != nil {
+		return err
+	}
+	return os.Rename(tmpFile, s.file)
+}
+
+func (s *todoStore) list() []todoItem {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	items := make([]todoItem, 0, len(s.items))
+	for _, item := range s.items {
+		items = append(items, item)
+	}
+	sort.Slice(items, func(i, j int) bool {
+		return items[i].UpdatedAt > items[j].UpdatedAt
+	})
+	return items
+}
+
+func (s *todoStore) add(title string) (todoItem, error) {
+	id := s.nextID.Add(1) - 1
+	item := todoItem{
+		ID:        id,
+		Title:     title,
+		Done:      false,
+		UpdatedAt: time.Now().UnixMilli(),
+	}
+	s.mu.Lock()
+	s.items[id] = item
+	err := s.persistLocked()
+	s.mu.Unlock()
+	if err != nil {
+		return todoItem{}, err
+	}
+	return item, nil
+}
+
+func (s *todoStore) toggle(id int64) (todoItem, bool, error) {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	item, ok := s.items[id]
+	if !ok {
+		return todoItem{}, false, nil
+	}
+	item.Done = !item.Done
+	item.UpdatedAt = time.Now().UnixMilli()
+	s.items[id] = item
+	if err := s.persistLocked(); err != nil {
+		return todoItem{}, false, err
+	}
+	return item, true, nil
+}
+
+func (s *todoStore) remove(id int64) (bool, error) {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	if _, ok := s.items[id]; !ok {
+		return false, nil
+	}
+	delete(s.items, id)
+	if err := s.persistLocked(); err != nil {
+		return false, err
+	}
+	return true, nil
+}
+
+func writeJSON(w http.ResponseWriter, status int, value any) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(status)
+	_ = json.NewEncoder(w).Encode(value)
+}
+
+func main() {
+	store, err := newTodoStore("/lzcapp/var/todos.json")
+	if err != nil {
+		panic(err)
+	}
+	mux := http.NewServeMux()
+
+	mux.HandleFunc("/api/health", func(w http.ResponseWriter, r *http.Request) {
+		if r.Method != http.MethodGet {
+			w.WriteHeader(http.StatusMethodNotAllowed)
+			return
+		}
+		writeJSON(w, http.StatusOK, map[string]string{"status": "ok"})
+	})
+
+	mux.HandleFunc("/api/todos", func(w http.ResponseWriter, r *http.Request) {
+		switch r.Method {
+		case http.MethodGet:
+			writeJSON(w, http.StatusOK, map[string]any{"items": store.list()})
+		case http.MethodPost:
+			var payload struct {
+				Title string `json:"title"`
+			}
+			if err := json.NewDecoder(r.Body).Decode(&payload); err != nil {
+				writeJSON(w, http.StatusBadRequest, map[string]string{"error": "invalid json"})
+				return
+			}
+			title := strings.TrimSpace(payload.Title)
+			if title == "" {
+				writeJSON(w, http.StatusBadRequest, map[string]string{"error": "title is required"})
+				return
+			}
+			item, err := store.add(title)
+			if err != nil {
+				writeJSON(w, http.StatusInternalServerError, map[string]string{"error": "failed to persist todos"})
+				return
+			}
+			writeJSON(w, http.StatusOK, item)
+		default:
+			w.WriteHeader(http.StatusMethodNotAllowed)
+		}
+	})
+
+	mux.HandleFunc("/api/todos/", func(w http.ResponseWriter, r *http.Request) {
+		tail := strings.TrimPrefix(r.URL.Path, "/api/todos/")
+		if strings.HasSuffix(tail, "/toggle") {
+			if r.Method != http.MethodPut {
+				w.WriteHeader(http.StatusMethodNotAllowed)
+				return
+			}
+			idPart := strings.TrimSuffix(tail, "/toggle")
+			idPart = strings.TrimSuffix(idPart, "/")
+			id, err := strconv.ParseInt(idPart, 10, 64)
+			if err != nil {
+				writeJSON(w, http.StatusBadRequest, map[string]string{"error": "invalid id"})
+				return
+			}
+			item, ok, err := store.toggle(id)
+			if err != nil {
+				writeJSON(w, http.StatusInternalServerError, map[string]string{"error": "failed to persist todos"})
+				return
+			}
+			if !ok {
+				writeJSON(w, http.StatusNotFound, map[string]string{"error": "todo not found"})
+				return
+			}
+			writeJSON(w, http.StatusOK, item)
+			return
+		}
+
+		if r.Method != http.MethodDelete {
+			w.WriteHeader(http.StatusMethodNotAllowed)
+			return
+		}
+		idPart := strings.TrimSuffix(tail, "/")
+		id, err := strconv.ParseInt(idPart, 10, 64)
+		if err != nil {
+			writeJSON(w, http.StatusBadRequest, map[string]string{"error": "invalid id"})
+			return
+		}
+		removed, err := store.remove(id)
+		if err != nil {
+			writeJSON(w, http.StatusInternalServerError, map[string]string{"error": "failed to persist todos"})
+			return
+		}
+		if !removed {
+			writeJSON(w, http.StatusNotFound, map[string]string{"error": "todo not found"})
+			return
+		}
+		writeJSON(w, http.StatusOK, map[string]bool{"ok": true})
+	})
+
+	mux.Handle("/", http.FileServer(http.Dir("/lzcapp/pkg/content/web")))
+	_ = http.ListenAndServe(":3000", mux)
+}

package/template/golang/run.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+set -e
+exec /app/app