配置项详解

容器化部署时,直接用环境变量注入配置即可。

先看“基本”,能跑起来后再看“进阶”。

API 配置项

类型配置项默认值用途与修改时机
基本APP_ENVdevelopment运行模式;上线改为 production
基本SECRET_ENCRYPTION_KEY加密密钥;生产环境必须设置稳定随机值。
基本DATABASE_URLpostgres://devops:devops@postgres:5432/devops?sslmode=disablePostgreSQL 连接串;换数据库或账号时改。
基本REDIS_ADDRredis:6379Redis 地址;使用外部 Redis 时改。
基本PUBLIC_BASE_URLhttp://localhost:8088平台外部地址;有公网域名、HTTPS、反代时改。
进阶API_ADDR:8080API 容器监听地址;自定义端口时改。
进阶APP_CORS_ORIGINShttp://localhost:8088允许访问 API 的前端 Origin;前后端不同域时改。
进阶LOG_LEVELdebug日志级别;生产通常改为 info

Worker 配置项

类型配置项默认值用途与修改时机
基本APP_ENVdevelopment运行模式;和 API 保持一致。
基本SECRET_ENCRYPTION_KEY解密平台密钥;必须和 API 一致。
基本DATABASE_URLpostgres://devops:devops@postgres:5432/devops?sslmode=disablePostgreSQL 连接串;和 API 指向同库。
基本REDIS_ADDRredis:6379Redis 地址;和 API 指向同实例。
基本BUILD_EXECUTOR_IMAGEmoby/buildkit:v0.24.0-rootlessBuildKit 镜像;构建集群拉不到默认镜像时改。
进阶LOG_LEVELdebug日志级别;生产通常改为 info
进阶DEPLOY_ROLLOUT_TIMEOUT_SECONDS600发布等待超时;应用启动慢时调大。
进阶CERT_MANAGER_CLUSTER_ISSUERletsencrypt-http01证书 Issuer 名称;集群名称不同时改。
进阶BUILD_JOB_TIMEOUT_SECONDS5400构建超时;大型项目构建慢时调大。
进阶BUILD_JOB_TTL_SECONDS3600构建 Pod 保留时间;想看更久日志时调大。
进阶BUILD_CACHE_ENABLEDfalse构建缓存开关;需要加速重复构建时开启。
进阶BUILD_CACHE_TAGbuildcache构建缓存 tag;需要隔离缓存时改。
进阶BUILD_NPM_REGISTRYnpm 镜像源;需要内部源时设置。
进阶BUILD_PRIVATE_EGRESS_CIDRS构建可访问的内网 CIDR;需要访问内网镜像源时设。
进阶BUILD_BLOCKED_EGRESS_CIDRS构建禁访 CIDR;需要更严格隔离时设。