@atomservice/app 0.1.5

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@atomservice/app",
+  "version": "0.1.5",
+  "description": "通用应用容器原子服务",
+  "type": "module",
+  "author": "openorson",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openorson/atomservice.git",
+    "directory": "services/app"
+  },
+  "bugs": "https://github.com/openorson/atomservice/issues",
+  "homepage": "https://github.com/openorson/atomservice/tree/main/services/app#readme",
+  "keywords": [
+    "atomservice",
+    "container",
+    "app",
+    "self-hosted",
+    "podman"
+  ],
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "files": [
+    "src"
+  ],
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@atomservice/gateway": "0.1.5"
+  },
+  "peerDependencies": {
+    "@atomservice/core": "0.1.5"
+  }
+}

package/src/app.compose.ts

@@ -0,0 +1,30 @@
+import { tmpl } from "@atomservice/core"
+
+export function appCompose(
+  id: string,
+  contextPath: string,
+  containerfilePath: string | undefined,
+  port: number,
+  hostPort?: number,
+): string {
+  const portsBlock = hostPort ? `\n    ports:\n      - "${hostPort}:${port}"` : ""
+  const dockerfileBlock = containerfilePath ? `\n      dockerfile: ${containerfilePath}` : ""
+
+  return tmpl`\
+services:
+  ${id}:
+    build:
+      context: ${contextPath}${dockerfileBlock}
+    container_name: ${id}
+    expose:
+      - "${port}"${portsBlock}
+    networks:
+      - atomservice
+    restart: unless-stopped
+
+networks:
+  atomservice:
+    name: atomservice
+    external: true
+`
+}

package/src/app.options.ts

@@ -0,0 +1,20 @@
+import type { CallableService } from "@atomservice/core"
+import type { GatewayInstance } from "@atomservice/gateway"
+
+export type GitConfig = boolean | { branch?: string }
+
+export interface ProjectConfig {
+  root: { path: string }
+  package?: { path: string }
+}
+
+export interface AppOptions {
+  id?: string
+  project: ProjectConfig
+  git?: GitConfig
+  port?: number
+  hostPort?: number
+  healthPath?: string
+  domain?: string
+  gateway?: CallableService<GatewayInstance>
+}

package/src/app.service.ts

@@ -0,0 +1,89 @@
+import path from "node:path"
+import type { CallableService } from "@atomservice/core"
+import { defineService, onDown, onHealth, onUp, useConfig, useLogger, useShell } from "@atomservice/core"
+import { appCompose } from "./app.compose.ts"
+import type { AppOptions, GitConfig } from "./app.options.ts"
+
+export function app(opts: AppOptions): CallableService {
+  const serviceId = opts.id && opts.id !== "default" ? `app-${opts.id}` : "app"
+  const port = opts.port ?? 3000
+
+  return defineService({
+    name: "app",
+    id: opts.id,
+    setup: () => {
+      const logger = useLogger()
+      const $ = useShell()
+      const config = useConfig()
+      const gw = opts.gateway?.()
+
+      const composePath = path.join(config.root, serviceId, "compose.yml")
+
+      function resolveProjectPaths() {
+        const rootPath = opts.project.root.path
+        const pkg = opts.project.package
+        const packagePath = pkg ? (pkg.path.startsWith("/") ? pkg.path : path.join(rootPath, pkg.path)) : undefined
+        const containerfilePath = packagePath ? path.join(packagePath, "Containerfile") : undefined
+        return { rootPath, containerfilePath }
+      }
+
+      function resolveGitBranch(git: GitConfig | undefined): string | null {
+        if (!git) return null
+        if (git === true) return "main"
+        return git.branch ?? "main"
+      }
+
+      onUp(async () => {
+        const { rootPath, containerfilePath } = resolveProjectPaths()
+        const branch = resolveGitBranch(opts.git)
+
+        if (branch) {
+          logger.info(`拉取代码 ${branch}…`)
+          await $`git -C ${rootPath} pull origin ${branch}`
+        }
+
+        await $`mkdir -p ${path.join(config.root, serviceId)}`
+        await Bun.write(composePath, appCompose(serviceId, rootPath, containerfilePath, port, opts.hostPort))
+
+        logger.info(`构建并启动 ${serviceId}…`)
+        await $`podman compose -f ${composePath} up -d --build`
+
+        if (opts.domain && gw) {
+          logger.info(`注册路由 ${opts.domain} → ${serviceId}:${port}`)
+          await gw.registerRoute(opts.domain, `${serviceId}:${port}`)
+        }
+
+        logger.success(`${serviceId} 已启动`)
+      })
+
+      onDown(async () => {
+        logger.info(`停止 ${serviceId}…`)
+        await $`podman compose -f ${composePath} down`
+
+        if (opts.domain && gw) {
+          await gw.unregisterRoute(opts.domain)
+        }
+
+        logger.success(`${serviceId} 已停止`)
+      })
+
+      onHealth(async () => {
+        if (opts.hostPort) {
+          try {
+            const res = await fetch(`http://localhost:${opts.hostPort}${opts.healthPath ?? "/"}`)
+            if (res.ok || res.status < 500) return { status: "healthy" }
+            return { status: "unhealthy", message: `HTTP ${res.status}` }
+          } catch (e) {
+            return { status: "unhealthy", message: String(e) }
+          }
+        }
+
+        const result = await $`podman inspect --format {{.State.Status}} ${serviceId}`.quiet().nothrow()
+        const containerStatus = result.text().trim()
+        return containerStatus === "running"
+          ? { status: "healthy" }
+          : { status: "unhealthy", message: `容器状态: ${containerStatus}` }
+      })
+    },
+  })
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export type { AppOptions, GitConfig, ProjectConfig } from "./app.options.ts"
+export { app } from "./app.service.ts"