OpenRun完全指南：革命性代码优先内部工具部署平台，从单节点到Kubernetes的无缝体验

【免费下载链接】openrunDeployment platform for code-first internal tools. Deploy web apps declaratively, on a single-node or on Kubernetes, with OIDC/SAML auth and RBAC.项目地址: https://gitcode.com/gh_mirrors/cl/openrun

OpenRun是一个革命性的代码优先内部工具部署平台，专为开发者和团队设计，提供从单节点到Kubernetes的无缝部署体验。无论您是想在本地快速部署一个内部工具，还是需要在生产环境的Kubernetes集群中管理数百个应用，OpenRun都能为您提供简单、安全、高效的解决方案。

什么是OpenRun？🤔

OpenRun是一个声明式的Web应用部署平台，专注于内部工具的部署和管理。它采用GitOps工作流，让您可以通过简单的配置文件来管理所有应用的部署、更新和配置。OpenRun的核心优势在于其声明式部署和零配置部署能力，让团队能够专注于代码开发，而不是基础设施管理。

OpenRun的核心功能亮点 ✨

声明式GitOps部署：OpenRun使用简单的Starlark（类似Python的语法）配置文件来定义应用，所有配置都存储在Git中，实现版本控制和自动化部署。

无缝扩展能力：从单节点（Docker/Podman）轻松扩展到Kubernetes集群，无需修改任何应用配置。

企业级安全特性：内置OAuth/OIDC/SAML认证、完整的RBAC权限管理和审计日志，满足企业安全要求。

智能资源管理：空闲应用自动暂停，实现零资源消耗，需要时再按需启动。

多框架支持：支持Streamlit、Gradio、FastHTML、NiceGUI、Reflex等流行框架的零配置部署。

OpenRun架构解析 🏗️

单节点架构

在单节点模式下，OpenRun作为一个独立的服务运行，使用SQLite存储元数据，通过Docker或Podman管理应用容器。这种架构非常适合个人开发者或小型团队快速开始。

Kubernetes架构

对于需要高可用性和扩展性的生产环境，OpenRun可以部署在Kubernetes集群中。在这种模式下，OpenRun作为API服务器和请求路由器，将应用部署为Kubernetes服务。

快速开始指南 🚀

安装OpenRun

OpenRun支持多种安装方式，最简单的安装方法只需一条命令：

# Linux/macOS安装 curl -sSL https://openrun.dev/install.sh | sh # Windows安装 powershell -Command "irm https://openrun.dev/install.ps1 | iex"

安装完成后，启动OpenRun服务器：

openrun server start

创建第一个应用

OpenRun使用声明式配置来管理应用。创建一个简单的配置文件myapp.star：

# 设置资源限制（可选） limits = {"cpus": "1", "memory": "512m"} # Streamlit应用声明 app(path="/misc/streamlit_example", source="github.com/streamlit/streamlit-example", git_branch="master", spec="python-streamlit", container_opts=limits) # FastHTML应用声明 app(path="fasthtml.:", source="github.com/AnswerDotAI/fasthtml/examples", spec="python-fasthtml", params={"APP_MODULE":"basic_ws:app"}, container_opts=limits)

应用配置文件：

openrun apply --approve myapp.star

GitOps自动化部署

OpenRun支持GitOps工作流，可以自动同步Git仓库中的配置变更：

openrun sync schedule --approve --promote github.com/openrundev/openrun/examples/utils.star

OpenRun的独特优势 💪

1. 声明式配置管理

与传统的CLI或UI操作不同，OpenRun采用声明式配置，所有应用配置都存储在Git中。这意味着：

• 版本控制：所有配置变更都有完整的历史记录
• 回滚能力：轻松回滚到之前的版本
• 团队协作：多人协作时不会产生配置冲突
• 环境一致性：开发、测试、生产环境配置完全一致

2. 零配置框架支持

OpenRun通过AppSpecs支持多种流行框架的零配置部署：

• Streamlit应用：无需Dockerfile，直接部署
• Gradio应用：自动识别和配置
• FastHTML应用：快速部署Python Web应用
• NiceGUI应用：简化Python GUI应用部署

3. 企业级安全特性

OpenRun内置了企业级的安全特性：

• 多种认证方式：支持OAuth、OpenID Connect、SAML、客户端证书认证
• RBAC权限管理：细粒度的角色和权限控制
• 审计日志：所有操作自动记录，满足合规要求
• 服务绑定：安全地管理数据库连接等敏感信息

4. 智能资源管理

OpenRun的智能资源管理功能包括：

• 按需启动：应用在首次访问时自动启动
• 空闲暂停：长时间不使用的应用自动暂停，释放资源
• 资源限制：为每个应用设置CPU和内存限制
• 健康检查：自动监控应用健康状态

从单节点到Kubernetes的无缝迁移 🔄

OpenRun最强大的特性之一是其无缝的扩展能力。您可以从单节点开始，随着业务增长，无需修改应用配置即可迁移到Kubernetes集群。

单节点部署

在单节点模式下，OpenRun使用Docker或Podman管理容器，SQLite存储元数据。这种模式适合：

• 个人开发者
• 小型团队
• 开发和测试环境
• 概念验证项目

Kubernetes部署

当需要更高的可用性和扩展性时，可以轻松迁移到Kubernetes：

1. 部署OpenRun到K8S：使用Helm chart或Terraform部署
2. 迁移应用配置：无需修改应用配置文件
3. 切换元数据存储：从SQLite切换到PostgreSQL
4. 启用高可用：配置多副本和自动扩缩容

配置示例对比

# 单节点配置（与K8S配置完全相同） app("/myapp", "github.com/myorg/myapp", spec="python-streamlit") # Kubernetes配置（相同的配置文件） app("/myapp", "github.com/myorg/myapp", spec="python-streamlit")

OpenRun的实际应用场景 🎯

1. 内部工具平台

为团队提供统一的内部工具部署平台，简化工具管理和访问控制。

2. 数据科学应用部署

快速部署Streamlit、Gradio等数据科学应用，让数据科学家专注于模型开发。

3. API网关和管理

作为API网关，统一管理多个后端服务的访问权限和监控。

4. 开发环境标准化

为开发团队提供标准化的开发环境，减少环境配置时间。

最佳实践和建议 📋

1. 配置文件组织

建议按环境组织配置文件：

config/ ├── production/ │ ├── apps.star │ └── secrets.toml ├── staging/ │ ├── apps.star │ └── secrets.toml └── development/ ├── apps.star └── secrets.toml

2. 资源管理策略

根据应用类型设置合理的资源限制：

# 轻量级应用 light_app_limits = {"cpus": "0.5", "memory": "256m"} # 中等负载应用 medium_app_limits = {"cpus": "1", "memory": "512m"} # 重负载应用 heavy_app_limits = {"cpus": "2", "memory": "1g"}

3. 监控和日志

OpenRun支持OpenTelemetry，可以集成到现有的监控系统中：

# openrun.toml 配置示例 [telemetry] otlp_endpoint = "http://jaeger:4318"

常见问题解答 ❓

Q: OpenRun支持哪些编程语言？

A: OpenRun支持所有可以在容器中运行的语言，包括Python、Go、Node.js、Java、Rust等。对于特定框架，如Streamlit、Gradio等，OpenRun提供零配置支持。

Q: 如何管理应用依赖？

A: 对于容器化应用，依赖管理在Dockerfile或Containerfile中定义。对于支持AppSpecs的框架，OpenRun会自动处理依赖安装。

Q: OpenRun是否支持数据库部署？

A: OpenRun专注于应用部署，不直接部署数据库服务。但可以通过服务绑定功能连接外部数据库服务。

Q: 如何实现蓝绿部署？

A: OpenRun内置了蓝绿部署支持，通过--stage参数创建预发布版本，验证通过后使用openrun promote命令切换流量。

Q: 是否支持自定义域名和SSL证书？

A: 是的，OpenRun支持自定义域名和自动SSL证书管理，基于Certmagic实现自动证书颁发和续期。

总结 🎉

OpenRun作为一款革命性的代码优先内部工具部署平台，为开发者和团队提供了从单节点到Kubernetes的完整解决方案。其声明式配置、零配置框架支持、企业级安全特性和智能资源管理功能，使其成为部署和管理内部工具的理想选择。

无论您是个人开发者想要快速部署一个小工具，还是企业团队需要管理数百个内部应用，OpenRun都能提供简单、安全、高效的部署体验。通过GitOps工作流和声明式配置，OpenRun让应用部署变得像提交代码一样简单。

开始您的OpenRun之旅，体验革命性的内部工具部署平台带来的便利和效率提升！

【免费下载链接】openrunDeployment platform for code-first internal tools. Deploy web apps declaratively, on a single-node or on Kubernetes, with OIDC/SAML auth and RBAC.项目地址: https://gitcode.com/gh_mirrors/cl/openrun