anvilworks/anvil-app-server

Anvil App Server Docker镜像

镜像概述和主要用途

Anvil App Server Docker镜像是开源Anvil App Server的容器化版本，用于快速部署和运行在Anvil平台（[***]

核心功能和特性

• 便捷部署：直接挂载Anvil应用目录即可运行，无需手动配置基础环境
• 灵活应用管理：支持自定义应用名称，可指定运行容器内特定目录的应用
• 依赖支持：可配置应用依赖项，确保依赖在容器内正常加载
• 数据持久化：PostgreSQL数据库及应用数据存储在/anvil-data目录，支持通过卷挂载实现数据持久化
• 多方式配置：支持通过命令行参数、环境变量或配置文件进行个性化配置

使用场景和适用范围

• 开发环境：本地快速测试Anvil应用功能
• 生产部署：部署Anvil应用到服务器提供服务
• 团队协作：统一应用运行环境，简化跨团队部署流程
• 适用于需要快速部署Anvil应用的开发者、小型开发团队或企业

使用方法和配置说明

基本用法

1. 克隆Anvil应用

首先克隆您在Anvil平台或本地构建的Anvil应用：

bash
$ git clone ssh://<MY-APP> MyApp

2. 运行容器

将应用目录挂载到容器的/apps/MainApp目录，并映射端口（默认3030）：

bash
$ docker run -v $PWD/MyApp:/apps/MainApp -p 3030:3030 anvilworks/anvil-app-server

启动后，可通过http://localhost:3030访问应用。

高级用法

自定义应用名称和依赖

• 自定义应用名称：默认运行/apps/MainApp目录下的应用，可通过--app参数指定其他应用名称。例如，将应用挂载到/apps/CustomAppName并指定运行该应用：

bash
$ docker run -v $PWD/MyApp:/apps/CustomAppName -p 3030:3030 anvilworks/anvil-app-server --app CustomAppName

• 依赖管理：确保应用的所有依赖项（参考https://github.com/anvil-works/anvil-runtime/blob/master/doc/dependencies.md%EF%BC%89%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%60/apps%60%E7%9B%AE%E5%BD%95%E4%B8%8B%E5%8F%AF%E7%94%A8%E3%80%82

持久化数据

Anvil App Server在容器内/anvil-data目录存储PostgreSQL数据库及其他应用数据。为实现数据持久化，需将该目录挂载为卷，并以具有写入权限的非root用户运行容器：

bash
# 创建本地数据目录
$ mkdir anvil-data

# 挂载应用目录和数据目录，指定当前用户ID运行容器
$ docker run -v $PWD/MyApp:/apps/MainApp -v $PWD/anvil-data:/anvil-data -u $UID -p 3030:3030 anvilworks/anvil-app-server

其他配置

支持通过命令行参数、环境变量或配置文件传递所有常规配置选项。完整配置说明请参考https://github.com/anvil-works/anvil-runtime%E3%80%82