59072bd16c
- Added critical warnings against compiling the Rust backend on macOS for deployment to Linux, detailing the reasons and potential errors. - Updated deployment procedures for the backend to ensure builds are performed directly on the Linux dev server. - Included new instructions for building container images with Docker/Podman and clarified frontend build processes. - Enhanced the critical rules section to emphasize the importance of following deployment protocols to avoid system errors.
138 lines
3.0 KiB
TypeScript
138 lines
3.0 KiB
TypeScript
// Container management API client
|
|
// Extends RPC client with container-specific methods
|
|
|
|
import { rpcClient } from './rpc-client'
|
|
|
|
export interface ContainerStatus {
|
|
id: string
|
|
name: string
|
|
state: 'created' | 'running' | 'stopped' | 'exited' | 'paused' | 'unknown'
|
|
image: string
|
|
created: string
|
|
ports: string[]
|
|
lan_address?: string // Launch URL for the app's UI
|
|
}
|
|
|
|
export interface ContainerAppInfo {
|
|
id: string
|
|
name: string
|
|
version: string
|
|
status: ContainerStatus
|
|
health: 'healthy' | 'unhealthy' | 'unknown' | 'starting'
|
|
}
|
|
|
|
export interface BundledAppConfig {
|
|
id: string
|
|
name: string
|
|
image: string
|
|
ports: { host: number; container: number }[]
|
|
volumes: { host: string; container: string }[]
|
|
}
|
|
|
|
export const containerClient = {
|
|
/**
|
|
* Install a container app from a manifest file
|
|
*/
|
|
async installApp(manifestPath: string): Promise<string> {
|
|
return rpcClient.call<string>({
|
|
method: 'container-install',
|
|
params: { manifest_path: manifestPath },
|
|
})
|
|
},
|
|
|
|
/**
|
|
* Start a container
|
|
*/
|
|
async startContainer(appId: string): Promise<void> {
|
|
return rpcClient.call<void>({
|
|
method: 'container-start',
|
|
params: { app_id: appId },
|
|
})
|
|
},
|
|
|
|
/**
|
|
* Stop a container
|
|
*/
|
|
async stopContainer(appId: string): Promise<void> {
|
|
return rpcClient.call<void>({
|
|
method: 'container-stop',
|
|
params: { app_id: appId },
|
|
})
|
|
},
|
|
|
|
/**
|
|
* Remove a container
|
|
*/
|
|
async removeContainer(appId: string): Promise<void> {
|
|
return rpcClient.call<void>({
|
|
method: 'container-remove',
|
|
params: { app_id: appId },
|
|
})
|
|
},
|
|
|
|
/**
|
|
* Get container status
|
|
*/
|
|
async getContainerStatus(appId: string): Promise<ContainerStatus> {
|
|
return rpcClient.call<ContainerStatus>({
|
|
method: 'container-status',
|
|
params: { app_id: appId },
|
|
})
|
|
},
|
|
|
|
/**
|
|
* Get container logs
|
|
*/
|
|
async getContainerLogs(appId: string, lines: number = 100): Promise<string[]> {
|
|
return rpcClient.call<string[]>({
|
|
method: 'container-logs',
|
|
params: { app_id: appId, lines },
|
|
})
|
|
},
|
|
|
|
/**
|
|
* List all containers
|
|
*/
|
|
async listContainers(): Promise<ContainerStatus[]> {
|
|
return rpcClient.call<ContainerStatus[]>({
|
|
method: 'container-list',
|
|
params: {},
|
|
})
|
|
},
|
|
|
|
/**
|
|
* Get health status for all containers
|
|
*/
|
|
async getHealthStatus(): Promise<Record<string, string>> {
|
|
return rpcClient.call<Record<string, string>>({
|
|
method: 'container-health',
|
|
params: {},
|
|
})
|
|
},
|
|
|
|
/**
|
|
* Start a bundled app (creates container if needed, then starts it)
|
|
*/
|
|
async startBundledApp(app: BundledAppConfig): Promise<void> {
|
|
return rpcClient.call<void>({
|
|
method: 'bundled-app-start',
|
|
params: {
|
|
app_id: app.id,
|
|
image: app.image,
|
|
ports: app.ports,
|
|
volumes: app.volumes,
|
|
},
|
|
})
|
|
},
|
|
|
|
/**
|
|
* Stop a bundled app
|
|
*/
|
|
async stopBundledApp(appId: string): Promise<void> {
|
|
return rpcClient.call<void>({
|
|
method: 'bundled-app-stop',
|
|
params: { app_id: appId },
|
|
})
|
|
},
|
|
}
|