云原生微服务容器编排运维【免费下载链接】flynn[UNMAINTAINED] A next generation open source platform as a service (PaaS)项目地址https://gitcode.com/gh_mirrors/fl/flynn点击查看免费下载导读Flynn 是一个开源的平台即服务PaaS应用可以通过 Buildpacksgit push部署或 Docker 镜像两种方式部署到集群中。本文以官方文档 docs/content/apps.md 为主体系统讲解 Flynn 中应用App的完整生命周期管理如何使用flynn env进行十二要素风格的应用配置、如何通过 Buildpack 构建与部署、零停机发布与回滚机制、进程管理与日志采集以及 HTTP 路由、自定义域名、HTTPS、服务发现和资源限制CPU/内存等生产级能力。读完本文你将掌握在 Flynn 集群上从创建应用到上线、扩容、排障、加固的全套 CLI 操作与底层原理并能在 cli/ 与 host/resource/ 等源码中验证每个行为的具体实现。Configuration用环境变量配置应用Flynn 遵循The Twelve-Factor App的实践使用环境变量来配置应用。环境变量的读写统一通过flynn env命令完成flynn env set SECRETthisismysecret关键行为设置环境变量会创建一次新的 release发布并触发应用全部进程以新配置重启。这在 cli/env.go 中有明确实现——runEnvSet解析varval对后调用setEnv最终依次执行client.CreateRelease与client.DeployAppReleaseCLI 会打印Created release id表示新 release 已生成并部署。flynn env的完整子命令与选项如下命令作用示例flynn env列出应用全部环境变量按名称排序输出flynn envflynn env set varval...设置一个或多个变量可一次传入多个flynn env set FOObar BAZfoobarflynn env unset var...删除一个或多个变量flynn env unset FOOflynn env get var读取单个变量值flynn env get FOO-t, --process-typeproc仅对指定进程类型如web设置或读取环境变量flynn env get -t web FOO从源码看env命令区分“应用级环境变量”存放在release.Env与“进程类型级环境变量”存放在release.Processes[proc].Env两层不带-t时读写应用级变量带-t时读写并合并对应进程类型的变量参见 cli/env.go。env set/env unset最终都走setEnv先取当前 app release将变更合并到目标环境变量 map 中然后创建新 release 并部署从而触发全量重启。External Databases接入 Flynn 外部数据库Flynn 应用既可以连接内置数据库PostgreSQL、MySQL、MongoDB、Redis也可以连接 Flynn 集群之外托管的数据库。外部数据库只需将其连接配置通过flynn env以环境变量形式传入应用即可例如flynn env set DATABASE_URLpostgres://user:passdb.example.com:5432/myapp内置数据库则可通过flynn resource add postgres或mongodb、mysql、redis一键开通Flynn 会自动向应用 release 注入DATABASE_URL、PGHOST、PGUSER等连接变量参见 docs/content/databases/ 与 docs/content/basics.md 中的完整示例。Buildpacks构建与自定义构建包Flynn 使用 Buildpacks 来准备和构建通过git push部署的应用并且会对大多数受支持语言自动选择标准 buildpack。当自动检测不可行或标准 buildpack 不适用时可以手动指定构建包。Flynn 内置了多构建包机制multi buildpack既支持单个自定义 buildpack也支持在一次部署中使用多个 buildpack。方式一提交.buildpacks文件。在应用仓库根目录创建并提交一个.buildpacks文件每行一个 buildpack 的 URLhttps://github.com/kr/heroku-buildpack-inline方式二设置BUILDPACK_URL环境变量。如果不想向仓库添加文件可以直接用flynn env指定flynn env set BUILDPACK_URLhttps://github.com/ryandotsmith/null-buildpack从构建链路看BUILDPACK_URL会被 gitreceive 服务注入 slugbuilder 构建任务的运行环境。在 gitreceive/receiver/flynn-receive.go 中构建任务的环境变量构建逻辑优先取当前 push 携带的环境变量其次取上一 release 的环境变量中的BUILDPACK_URL写入jobEnv[BUILDPACK_URL]后由 slugbuilder 的/builder/build.sh执行构建。因此两种指定方式是等价的且配置在环境变量中时对后续每次git push均生效。Deployment发布、取消发布与多分支部署每次推送新代码或修改应用配置Flynn 都会创建新的 release。部署采用零停机策略先启动新 release只有当新 release 正常起来后才会停止旧 release如果新 release 未能正常启动或出现其他异常部署会自动回滚旧 release 继续运行。这一策略意味着线上流量永远由健康版本承接发布失败不会造成服务中断是 Flynn 默认且无需额外配置的发布行为。Cancelling Deploys取消进行中的部署通过git push发起的部署可以通过Ctrl-C终止 push 进程或向该进程发送终止信号来取消。构建会被立即取消代码不会被部署。Building specific Git branches部署指定 Git 分支同一个代码仓库的不同分支可以通过创建多个应用、各自配置不同 git remote 来分别部署。典型场景是构建 staging预发布环境flynn create myapp-staging --remote staging flynn -a staging env set FOObar git push staging staging:master这里的关键在于flynn create myapp-staging --remote staging创建名为myapp-staging的应用并把 git remote 命名为staging而非默认的flynn。在 cli/app.go 中可以看到flynn create会为当前 git 仓库添加对应 remoteremote 名由-r/--remote指定默认flynn传空字符串则不配置 remoteflynn -a staging env set FOObar通过-a指定对staging应用设置环境变量git push staging staging:master把本地的staging分支推送到 Flynn 端的master分支触发构建与发布。创建、查看与删除应用除了部署flynn create、flynn apps、flynn info、flynn delete构成了应用的基础管理闭环实现见 cli/app.go# 不指定名字时随机生成如 turkeys-stupefy-perry flynn create # 列出集群内所有应用 flynn apps ID NAME f1e85f5392454a329929e3f27f7a5644 gitreceive 4c6325c1f13547059e5496c91a6a97dd router # 查看应用的 Git URL 与 Web URL自动判断 http/https flynn info example Git URL: https://git.dev.localflynn.com/example.git Web URL: http://example.dev.localflynn.com # 删除应用会一并清理路由、release 与已开通的资源 flynn delete -yflynn info会同时展示 Git 部署地址和自动注册的 Web 路由地址并根据路由是否配置了证书自动决定展示http://还是https://见 cli/app.go。Processes进程列表与进程级操作使用flynn ps可以获取应用下各个进程的列表返回的进程 ID 可传给flynn kill来终止进程。Flynn 会自动重启被终止的进程但一次性运行任务one-off run job除外。# 获取进程列表 $ flynn ps ID TYPE STATE CREATED RELEASE COMMAND host0-52aedfbf-e613-40f2-941a-d832d10fc400 web up 6 seconds ago cf39a906-38d1-4393-a6b1-8ad2befe8142 /runner/init start web # 终止进程 $ flynn kill host-28a16c12-6136-4e06-93b1-2b014147de79 Job host-28a16c12-6136-4e06-93b1-2b014147de79 killed.flynn ps还支持丰富的筛选与展示选项参见 cli/ps.go# 显示所有状态默认只显示 running 和 pending并附带完整命令 flynn ps --all --command # 只输出进程 ID便于脚本化处理 flynn ps --all --quiet # 按进程类型过滤如只看一次性 run 任务 flynn ps --all --typerun其中run类型即通过flynn run启动的一次性任务例如在应用容器中执行flynn run curl http://nodejs-web.discoverd:8080详见 cli/run.go-d可后台分离运行--limits可指定资源限制。扩容与缩容进程数量的调整使用flynn scale默认情况下首次部署含web进程类型的应用会自动扩容到web1flynn scale web3 scaling web: 13 09:33:51.730 web 4ef91e4b-d0c3-4e3f-931b-6db3b551dcd9 pending 09:33:51.733 web ccd3aff7-80b3-46b4-a95f-006bfceb80c6 pending 09:33:51.743 web flynn-ccd3aff7-80b3-46b4-a95f-006bfceb80c6 starting 09:33:51.751 web flynn-4ef91e4b-d0c3-4e3f-931b-6db3b551dcd9 starting 09:33:52.129 web flynn-4ef91e4b-d0c3-4e3f-931b-6db3b551dcd9 up 09:33:52.171 web flynn-ccd3aff7-80b3-46b4-a95f-006bfceb80c6 up scale completed in 464.957638msflynn scale还支持按主机标签调度进程例如web3,activetrue表示把 3 个 web 进程分布到打了activetrue标签的主机上db3,diskssd,memhigh要求主机同时具备diskssd与memhigh两个标签参见 cli/scale.go 中的用法说明。不带参数运行flynn scale则显示当前各进程类型的实例数。Logs日志查看、实时跟踪与外部日志Flynn 会自动记录应用进程写入标准输出stdout和标准错误stderr的所有内容。日志可通过flynn log获取使用-f可以实时跟踪新产生的日志flynn log # 查看最近日志 flynn log -f # 实时跟踪日志流flynn log的完整选项参见 cli/log.go选项作用-f, --follow持续输出新产生的日志行-j, --jobid只显示指定 job ID 的日志-n, --numberlines最多返回日志缓冲中的 n 行-r, --raw-output输出原始日志消息不带时间戳等前缀-s, --split-stderr将 stderr 日志行输出到终端 stderr-t, --process-typetype按进程类型过滤日志-i, --init将 containerinit 日志输出到 stderr默认输出格式带有时间戳、来源、进程类型与 job ID 前缀形如2026-09-26T01:39:43.000000Z web[web.host0-xxx]: 消息内容使用-r则可得到不带前缀的原始内容。日志由 logaggregator 组件汇聚与缓存CLI 通过 logaggregator 客户端按流类型stdout/stderr/init拉取见 logaggregator/。External Logs输出到外部 syslog应用也可以通过系统或客户端库把日志流式发送到远程 syslog 服务。大多数编程语言都有远程日志的内置支持例如 Python 的SysLogHandler。这类日志流与 Flynn 自身的flynn log相互独立适用于日志归档与集中监控场景。RoutesHTTP 路由、自定义域名与 HTTPSFlynn 会自动为每个应用配置一条https://$APPNAME.$CLUSTERDOMAIN路由指向web进程类型的实例。应用必须监听并接受PORT环境变量所指定端口上的 HTTP 请求才能收到流量PORT由 Flynn 在启动进程时注入。默认路由与flynn route查看创建应用后可以确认自动生成的路由$ flynn route ROUTE SERVICE ID STICKY LEADER PATH http:example.demo.localflynn.com example-web http/2e37467e-08fc-47e5-853b-4f0574cb6871 false false /Custom Domains添加自定义域名为应用添加额外的 HTTP 路由flynn route add http www.example.com同时需要为域名配置 DNS例如将www.example.com设置为$APPNAME.$CLUSTERDOMAIN的 CNAME 记录。Additional Process Types多进程类型对外提供服务Flynn 支持多个进程类型同时对外提供 Web 流量。这些额外进程类型必须在Procfile中定义且进程类型名必须以-web结尾。例如如下 Procfileweb: ./server admin-web: ./admin-server为额外进程类型配置路由时通过--service标志指定目标服务服务名默认为APPNAME-PROCTYPE即myapp-admin-webflynn route add http --service myapp-admin-web admin.example.comflynn route命令还支持 TCP 路由与丰富的路由属性参见 cli/route.go 的 usageflynn route add tcp [-s service] [-p port] [--leader] [--no-drain-backends] flynn route update id [-s service] [-c tls-cert -k tls-key] [--sticky] [--no-sticky] [--leader] [--no-leader] [--disable-keep-alives] [--enable-keep-alives] flynn route remove id常用路由选项说明选项作用-s, --serviceservice路由指向的服务名默认APPNAME-web-c, --tls-certtls-certPEM 编码证书路径-表示从 stdin 读取仅 HTTP 路由-k, --tls-keytls-keyPEM 编码私钥路径-表示从 stdin 读取仅 HTTP 路由--sticky启用基于 Cookie 的粘性路由仅 HTTP 路由--leader启用仅领导者模式路由常用于数据库主节点-p, --portport监听端口--no-drain-backends停止后端时不等候进行中的请求完成--disable-keep-alives禁用路由与后端之间的 keep-alive从实现看HTTP 路由通过url.Parse(http://domain)解析域名与路径example.com/path/形式的路径同样受支持并将 service 默认填为APPNAME-web见 cli/route.goTCP 路由不解析域名只绑定端口并转发到指定 service。HTTPS自动终结 TLS 并启用 HTTP/2路由器可以自动终结 HTTPS 流量。创建或更新路由时通过--tls-cert与--tls-key标志指定证书链与私钥为路由启用 HTTPS 后HTTP/2 也会自动开启。flynn route update http/2b3b2004-38f1-4e68-b856-7d8af3e4c6e1 --tls-cert cert.pem --tls-key cert.key证书文件应包含 PEM 编码的目标证书块以及为链接到受信任根所需的中间证书。此外--tls-cert与--tls-key必须同时指定源码parseTLSCert会校验这一点支持从 stdin 传入 PEM 内容参见 cli/route.go。Service Discovery集群内服务发现Flynn 会自动把每个web进程类型注册到服务发现中供不走路由器的集群内部请求使用。服务发现条目可通过 DNS 访问DNS 名称模式为$APPNAME-$PROCTYPE.discoverd例如myapp-web.discoverd与myapp-admin-web.discoverd。该特性可用于应用与应用、进程与进程之间的内部通信例如从应用内直接访问数据库主节点leader.postgres.discoverd:5432或使用flynn run curl http://nodejs-web.discoverd:8080访问同集群内的另一个应用服务。Limits内存、CPU 与其他资源限制资源限制内存及其他可以通过flynn limit命令查看与设置flynn limit set web memory2GBflynn limit支持的类型在 host/resource/resource.go 中定义包括类型含义默认值memory容器内可用内存字节1GBcpumilliCPU 数量1/1000 核1000 等价于 1024 CPU shares1000temp_disk容器临时根磁盘可用空间100MBmax_fd容器内可打开的最大文件描述符数 110000max_procs容器内可启动的最大进程数未设置查看当前限制的示例输出$ flynn limit web: cpu1000 temp_disk100MB max_fd10000 memory1GB worker: cpu1000 temp_disk100MB max_fd10000 memory1GB一次设置多个限制flynn limit set web memory512MB max_fd12000 cpu500 temp_disk200MB从源码看flynn limit set会解析varval对并合并到对应进程类型的资源规格中随后同样走“创建 release 部署”链路cli/limit.go因此调整限制同样会触发应用进程重启。资源规格由Request调度时要求宿主具备的预留量与Limit可消耗上限两部分组成见 host/resource/resource.go。CPU SharesCPU 份额的相对优先级CPU 份额是相对的份额越多进程优先级越高。当宿主机负载高时拥有 2000 milliCPU 的任务获得的 CPU 时间是默认值 1000 的任务的两倍。flynn limit set web cpu1500Slugbuilder Limits调整构建进程内存部分构建过程需要大量内存。如果在git push部署时遇到构建缓慢或随机失败可以尝试提高slugbuilder进程的内存限制flynn limit set slugbuilder memory4GB也可以在集群范围内设置全局默认的slugbuilder内存限制即为负责处理git push部署的应用gitreceive与taffy设置SLUGBUILDER_DEFAULT_MEMORY_LIMIT环境变量limitSLUGBUILDER_DEFAULT_MEMORY_LIMIT2GB flynn -a gitreceive env set $limit flynn -a taffy env set $limit该默认值的生效逻辑位于 gitreceive/receiver/flynn-receive.go构建 slugbuilder 任务时先检查上一 release 中是否定义了slugbuilder进程类型——有则直接采用其资源限制否则读取SLUGBUILDER_DEFAULT_MEMORY_LIMIT若解析成功则把该值同时作为 memory 的Limit与Request应用。也就是说逐应用设置flynn limit set slugbuilder ...优先于全局默认值而全局默认值通过环境变量对后续所有git push构建生效。部署方式补充Docker 镜像部署除 Buildpack 外Flynn 还内置了tarreceive应用用于把 Docker 镜像导入集群并部署。一次完整的 Docker 部署流程如下详见 docs/content/docker.md# 1. 构建镜像 docker build -t nodejs-flynn-example . # 2. 创建应用--remote 表示不配置 git remote因为本次走 docker push flynn create --remote nodejs # 3. 推送并部署镜像 flynn -a nodejs docker push nodejs-flynn-example # 4. 首次部署后扩容 app 进程 flynn -a nodejs scale app1以 Docker 镜像部署的 release 会生成一个app进程类型其ENTRYPOINT、CMD与ENV均取自镜像配置并自动注册APPNAME-web服务名供集群内部通过nodejs-web.discoverd:8080访问外部则通过自动注册的http://nodejs.1.localflynn.com路由访问。这与 Buildpack 部署在路由、服务发现、资源限制与日志方面共用同一套应用管理模型。小结Flynn 应用管理的核心模型可以概括为配置即环境变量、发布即 release、流量即路由、容量即进程数与资源限制。flynn env的任何变更都会产生新 release 并触发零停机滚动发布flynn scale、flynn limit同样通过 release 机制生效flynn route负责把域名/端口映射到以-web结尾的进程类型服务并支持 TLS 终结、HTTP/2、粘性会话与领导者模式flynn ps/flynn kill/flynn log覆盖了运行态进程与日志的日常运维。结合本文给出的源码路径cli/、host/resource/resource.go、gitreceive/receiver/flynn-receive.go你可以进一步深入验证每个命令背后的实现细节并将其迁移到自己的 PaaS 运维实践中。赞分享云原生微服务容器编排运维【免费下载链接】flynn[UNMAINTAINED] A next generation open source platform as a service (PaaS)项目地址https://gitcode.com/gh_mirrors/fl/flynn点击查看免费下载相关推荐Flynn环境变量管理配置应用的最佳实践Flynn环境变量管理配置应用的最佳实践 你还在为应用环境变量配置繁琐而头疼吗手动修改配置文件容易出错多环境同步困难敏感信息暴露风险高本文将带你掌握F云原生微服务容器编排运维Flower Docker 部署实战用 -e 标志通过环境变量定制 SuperLink 遥测、日志与高级配置Flower Docker 部署实战用 e 标志通过环境变量定制 SuperLink 遥测、日志与高级配置 本篇聚焦 Flower 框架 Docker 部署文人工智能联邦学习机器学习深度学习OpenIM 环境配置与部署完整指南从配置路径解析到环境变量矩阵OpenIM 环境配置与部署完整指南从配置路径解析到环境变量矩阵 本篇技术指南以 OpenIMopen im server即时通讯服务器的环境配置为核心即时通讯后端微服务WebSocket上一篇NodeMCU rfswitch 模块实战用 ESP8266 发送 433/315MHz 射频控制码下一篇Win11Debloat 使用指南免费 Windows 11 精简优化工具一键去广告、关遥测、卸预装应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考