Appsmith Helm Chart 如何启用 MongoDB Community Operator 替代内置副本集【免费下载链接】appsmithPlatform to build admin panels, internal tools, and dashboards. Integrates with 25 databases and any API.项目地址: https://gitcode.com/GitHub_Trending/ap/appsmith在 Kubernetes 上部署 Appsmith 时Helm Chart 默认捆绑 Bitnami MongoDB 子图默认 2 成员副本集镜像appsmith/mongodb:6.0.27。如果你希望改由 MongoDB Kubernetes Operator 来管理副本集Appsmith Chart 提供了对应路径开启mongodbCommunity.enabled后Chart 会渲染一个MongoDBCommunity自定义资源CR由 Operator 负责副本集成员管理、SCRAM 凭证生命周期并生成 Appsmith 直接消费的连接串 Secret——不需要手工拼接APPSMITH_DB_URL。适用前提该路径是 chart 3.7.0 引入的 Preview 特性官方文档明确说明本版本仅覆盖全新安装仓库当前 chart 版本为 3.9.1见 Chart.yaml。如果集群上已有带生产数据的 Bitnami 版 Appsmith release不要直接改mongodbCommunity.enabled迁移文档正在另行准备。准备条件按 docs/install-mongodb-operator.md 给出的要求Kubernetes 1.28Helm 3.14kubectl已配置指向目标集群集群有默认StorageClass或者准备通过--set global.storageClassname显式指定不需要单独安装 Operator——Chart 可以通过子图把它一并装上Chart 依赖mongodb-kubernetes1.8.0条件为mongodbOperator.enabled。主路径全新安装并捆绑 Operatorhelm repo add appsmith https://helm.appsmith.com helm repo update kubectl create namespace appsmith helm install appsmith appsmith/appsmith -n appsmith --wait --timeout 10m \ --set mongodb.enabledfalse \ --set mongodbCommunity.enabledtrue \ --set mongodbOperator.enabledtrue三个关键开关的作用Flag用途mongodb.enabledfalse不部署默认的 Bitnami MongoDB 子图mongodbCommunity.enabledtrue部署供 Operator 调谐的MongoDBCommunityCRmongodbOperator.enabledtrue在同一命名空间安装上游 MongoDB Kubernetes Operator 子图安装新 release 时推荐开启mongodbCommunity.enabled后Chart 实际做三件事见 templates/mongodb-community.yaml渲染MongoDBCommunityCR副本集类型SCRAM 认证appsmith/appsmith用户带readWrite和clusterMonitor角色在未提供密码 Secret 时运行一次幂等的 pre-install Job 生成随机密码并写入 Secret见 templates/hooks/mongodb-community.yaml把 Appsmith 工作负载的 MongoDB 连接串接到 Operator 管理的 Secret 上。验证安装结果kubectl get pods -n appsmith kubectl get mongodbcommunity -n appsmith文档给出的期望输出文档示例abridgedPod 名和标签按你的环境会有差异NAME READY STATUS appsmith-0 1/1 Running appsmith-mongo-0 2/2 Running appsmith-postgresql-0 1/1 Running appsmith-redis-master-0 1/1 Running mongodb-kubernetes-operator-... 1/1 Running NAME PHASE VERSION appsmith-mongo Running 8.0.20判断标准是MongoDBCommunity的PHASE变为Running、appsmith-0进入Running。随后用 port-forward 打开 UI 确认可用kubectl port-forward -n appsmith svc/appsmith 8080:80打开 http://localhost:8080。生产访问则另行配置 Ingress这一步不在本路径范围内。核对密码与连接串MongoDB 用户密码存放在名为mongodbCommunity.name-password的 Secret——release 名为appsmith、使用默认命名时即appsmith-mongo-passwordkubectl get secret appsmith-mongo-password -n appsmith \ -o jsonpath{.data.password} | base64 -dAppsmith 自身从 Operator 管理的 Secret 读取连接串可在 templates/NOTES.txt 中看到这个 Secret 名的推导逻辑对应命令kubectl get secret appsmith-mongo-appsmith-appsmith -n appsmith \ -o jsonpath{.data.connectionString\.standardSrv} | base64 -d可选分支自带密码 Secret如果密码由 Vault、SOPS、ExternalSecrets 等外部体系管理先自己创建 Secret必须只有一个名为password的 key 存放明文密码再指向它kubectl create secret generic my-mongodb-secret \ -n appsmith \ --from-literalpasswordyour-password helm install appsmith appsmith/appsmith -n appsmith --wait --timeout 10m \ --set mongodb.enabledfalse \ --set mongodbCommunity.enabledtrue \ --set mongodbOperator.enabledtrue \ --set mongodbCommunity.auth.passwordSecretNamemy-mongodb-secretyour-password替换为你自己确定的密码值。设置mongodbCommunity.auth.passwordSecretName后Chart 跳过 pre-install Job并假定 Secret 已正确填充——Job 不存在的检查责任在你这边。生产环境的副本集配置Chart 默认值面向评估和开发环境单成员副本集、storageSize: 10Gi见 values.yamlMongoDB 功能完整但没有故障切换。文档建议生产上扩到 3 成员、固定资源并显式指定 StorageClassmongodbCommunity: enabled: true members: 3 # replica set size (odd number recommended) persistent: storageSize: 100Gi storageClass: gp3 # or omit to use cluster default resources: requests: cpu: 500m memory: 2Gi limits: memory: 4Gimembers从 1 调到 3 属于 upgrade 时的 values 变更Operator 会在线把成员加进副本集文档说明该过程无停机。常见问题排查MongoDBCommunity停在Pending阶段先看 Operator 日志定位原因kubectl logs -n appsmith -l app.kubernetes.io/namemongodb-kubernetes-operator --tail50文档列出的两个常见原因你设置了passwordSecretName但对应 Secret 不存在或缺少passwordkeyMongoDB 镜像拉不下来——用kubectl describe pod mongodbCommunity.name-0查看 image-pull 错误。Appsmith Pod 卡在InitAppsmith 的 init 容器会等待 MongoDB 可达。先确认kubectl get mongodbcommunity -n appsmith的 phase若 phase 已是Running但 Appsmith 仍不前进查看 init 容器日志kubectl logs -n appsmith appsmith-0 -c mongo-init-container密码初始化 Job 报ImagePullBackOffmongodbCommunity.name-password-initJob 的 Pod 默认使用docker.io/alpine/kubectl:latest集群无法访问 Docker Hub隔离环境或拉取策略限制时会卡住。把passwordInit.image覆盖到自有镜像仓库--set mongodbCommunity.passwordInit.image.registrymy-registry.example.com --set mongodbCommunity.passwordInit.image.repositorymy/kubectl --set mongodbCommunity.passwordInit.image.tag1.34.2helm uninstall后命名空间删除卡住MongoDBCommunityCR 带 finalizerOperator 负责移除若 Helm 先拆掉了 Operator Deploymentfinalizer 会残留、命名空间删不掉。手动清空 finalizer 后删除才会继续mongodbCommunity.name替换为实际 CR 名kubectl patch mongodbcommunity -n appsmith mongodbCommunity.name \ --typemerge -p {metadata:{finalizers:[]}}卸载顺序与限制卸载时先删 CR让 Operator 在处理 finalizer 期间仍在运行再卸载 release 和命名空间# 1. Delete the CR and wait for the operator to clear its finalizer kubectl delete mongodbcommunity -n appsmith --all --waittrue # 2. Uninstall Appsmith (and the bundled operator, if enabled) helm uninstall appsmith -n appsmith # 3. Remove the namespace kubectl delete namespace appsmith跳过快捷的第 1 步就可能触发上面说的 finalizer 残留问题。此外要注意子图安装的 MongoDB CRD 在 uninstall 后仍然存在Helm 从不删除crds/下的资源要彻底清理需kubectl delete crd mongodbcommunity.mongodbcommunity.mongodb.com等——这会移除全集群所有匹配资源只有确认没有其他东西依赖该 Operator 时才执行。最后一个边界如果mongodb.enabled与mongodbCommunity.enabled同时为 truetransition 模式templates/NOTES.txt 会提示两套 MongoDB 同时在跑、Appsmith 仍连接 Bitnami 实例并给出 mongodump/mongorestore 的迁移提示。本文主路径是全新安装直接替代不涉及从已有 Bitnami release 的在线迁移。【免费下载链接】appsmithPlatform to build admin panels, internal tools, and dashboards. Integrates with 25 databases and any API.项目地址: https://gitcode.com/GitHub_Trending/ap/appsmith创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Appsmith Helm Chart 如何启用 MongoDB Community Operator 替代内置副本集
Appsmith Helm Chart 如何启用 MongoDB Community Operator 替代内置副本集【免费下载链接】appsmithPlatform to build admin panels, internal tools, and dashboards. Integrates with 25 databases and any API.项目地址: https://gitcode.com/GitHub_Trending/ap/appsmith在 Kubernetes 上部署 Appsmith 时Helm Chart 默认捆绑 Bitnami MongoDB 子图默认 2 成员副本集镜像appsmith/mongodb:6.0.27。如果你希望改由 MongoDB Kubernetes Operator 来管理副本集Appsmith Chart 提供了对应路径开启mongodbCommunity.enabled后Chart 会渲染一个MongoDBCommunity自定义资源CR由 Operator 负责副本集成员管理、SCRAM 凭证生命周期并生成 Appsmith 直接消费的连接串 Secret——不需要手工拼接APPSMITH_DB_URL。适用前提该路径是 chart 3.7.0 引入的 Preview 特性官方文档明确说明本版本仅覆盖全新安装仓库当前 chart 版本为 3.9.1见 Chart.yaml。如果集群上已有带生产数据的 Bitnami 版 Appsmith release不要直接改mongodbCommunity.enabled迁移文档正在另行准备。准备条件按 docs/install-mongodb-operator.md 给出的要求Kubernetes 1.28Helm 3.14kubectl已配置指向目标集群集群有默认StorageClass或者准备通过--set global.storageClassname显式指定不需要单独安装 Operator——Chart 可以通过子图把它一并装上Chart 依赖mongodb-kubernetes1.8.0条件为mongodbOperator.enabled。主路径全新安装并捆绑 Operatorhelm repo add appsmith https://helm.appsmith.com helm repo update kubectl create namespace appsmith helm install appsmith appsmith/appsmith -n appsmith --wait --timeout 10m \ --set mongodb.enabledfalse \ --set mongodbCommunity.enabledtrue \ --set mongodbOperator.enabledtrue三个关键开关的作用Flag用途mongodb.enabledfalse不部署默认的 Bitnami MongoDB 子图mongodbCommunity.enabledtrue部署供 Operator 调谐的MongoDBCommunityCRmongodbOperator.enabledtrue在同一命名空间安装上游 MongoDB Kubernetes Operator 子图安装新 release 时推荐开启mongodbCommunity.enabled后Chart 实际做三件事见 templates/mongodb-community.yaml渲染MongoDBCommunityCR副本集类型SCRAM 认证appsmith/appsmith用户带readWrite和clusterMonitor角色在未提供密码 Secret 时运行一次幂等的 pre-install Job 生成随机密码并写入 Secret见 templates/hooks/mongodb-community.yaml把 Appsmith 工作负载的 MongoDB 连接串接到 Operator 管理的 Secret 上。验证安装结果kubectl get pods -n appsmith kubectl get mongodbcommunity -n appsmith文档给出的期望输出文档示例abridgedPod 名和标签按你的环境会有差异NAME READY STATUS appsmith-0 1/1 Running appsmith-mongo-0 2/2 Running appsmith-postgresql-0 1/1 Running appsmith-redis-master-0 1/1 Running mongodb-kubernetes-operator-... 1/1 Running NAME PHASE VERSION appsmith-mongo Running 8.0.20判断标准是MongoDBCommunity的PHASE变为Running、appsmith-0进入Running。随后用 port-forward 打开 UI 确认可用kubectl port-forward -n appsmith svc/appsmith 8080:80打开 http://localhost:8080。生产访问则另行配置 Ingress这一步不在本路径范围内。核对密码与连接串MongoDB 用户密码存放在名为mongodbCommunity.name-password的 Secret——release 名为appsmith、使用默认命名时即appsmith-mongo-passwordkubectl get secret appsmith-mongo-password -n appsmith \ -o jsonpath{.data.password} | base64 -dAppsmith 自身从 Operator 管理的 Secret 读取连接串可在 templates/NOTES.txt 中看到这个 Secret 名的推导逻辑对应命令kubectl get secret appsmith-mongo-appsmith-appsmith -n appsmith \ -o jsonpath{.data.connectionString\.standardSrv} | base64 -d可选分支自带密码 Secret如果密码由 Vault、SOPS、ExternalSecrets 等外部体系管理先自己创建 Secret必须只有一个名为password的 key 存放明文密码再指向它kubectl create secret generic my-mongodb-secret \ -n appsmith \ --from-literalpasswordyour-password helm install appsmith appsmith/appsmith -n appsmith --wait --timeout 10m \ --set mongodb.enabledfalse \ --set mongodbCommunity.enabledtrue \ --set mongodbOperator.enabledtrue \ --set mongodbCommunity.auth.passwordSecretNamemy-mongodb-secretyour-password替换为你自己确定的密码值。设置mongodbCommunity.auth.passwordSecretName后Chart 跳过 pre-install Job并假定 Secret 已正确填充——Job 不存在的检查责任在你这边。生产环境的副本集配置Chart 默认值面向评估和开发环境单成员副本集、storageSize: 10Gi见 values.yamlMongoDB 功能完整但没有故障切换。文档建议生产上扩到 3 成员、固定资源并显式指定 StorageClassmongodbCommunity: enabled: true members: 3 # replica set size (odd number recommended) persistent: storageSize: 100Gi storageClass: gp3 # or omit to use cluster default resources: requests: cpu: 500m memory: 2Gi limits: memory: 4Gimembers从 1 调到 3 属于 upgrade 时的 values 变更Operator 会在线把成员加进副本集文档说明该过程无停机。常见问题排查MongoDBCommunity停在Pending阶段先看 Operator 日志定位原因kubectl logs -n appsmith -l app.kubernetes.io/namemongodb-kubernetes-operator --tail50文档列出的两个常见原因你设置了passwordSecretName但对应 Secret 不存在或缺少passwordkeyMongoDB 镜像拉不下来——用kubectl describe pod mongodbCommunity.name-0查看 image-pull 错误。Appsmith Pod 卡在InitAppsmith 的 init 容器会等待 MongoDB 可达。先确认kubectl get mongodbcommunity -n appsmith的 phase若 phase 已是Running但 Appsmith 仍不前进查看 init 容器日志kubectl logs -n appsmith appsmith-0 -c mongo-init-container密码初始化 Job 报ImagePullBackOffmongodbCommunity.name-password-initJob 的 Pod 默认使用docker.io/alpine/kubectl:latest集群无法访问 Docker Hub隔离环境或拉取策略限制时会卡住。把passwordInit.image覆盖到自有镜像仓库--set mongodbCommunity.passwordInit.image.registrymy-registry.example.com --set mongodbCommunity.passwordInit.image.repositorymy/kubectl --set mongodbCommunity.passwordInit.image.tag1.34.2helm uninstall后命名空间删除卡住MongoDBCommunityCR 带 finalizerOperator 负责移除若 Helm 先拆掉了 Operator Deploymentfinalizer 会残留、命名空间删不掉。手动清空 finalizer 后删除才会继续mongodbCommunity.name替换为实际 CR 名kubectl patch mongodbcommunity -n appsmith mongodbCommunity.name \ --typemerge -p {metadata:{finalizers:[]}}卸载顺序与限制卸载时先删 CR让 Operator 在处理 finalizer 期间仍在运行再卸载 release 和命名空间# 1. Delete the CR and wait for the operator to clear its finalizer kubectl delete mongodbcommunity -n appsmith --all --waittrue # 2. Uninstall Appsmith (and the bundled operator, if enabled) helm uninstall appsmith -n appsmith # 3. Remove the namespace kubectl delete namespace appsmith跳过快捷的第 1 步就可能触发上面说的 finalizer 残留问题。此外要注意子图安装的 MongoDB CRD 在 uninstall 后仍然存在Helm 从不删除crds/下的资源要彻底清理需kubectl delete crd mongodbcommunity.mongodbcommunity.mongodb.com等——这会移除全集群所有匹配资源只有确认没有其他东西依赖该 Operator 时才执行。最后一个边界如果mongodb.enabled与mongodbCommunity.enabled同时为 truetransition 模式templates/NOTES.txt 会提示两套 MongoDB 同时在跑、Appsmith 仍连接 Bitnami 实例并给出 mongodump/mongorestore 的迁移提示。本文主路径是全新安装直接替代不涉及从已有 Bitnami release 的在线迁移。【免费下载链接】appsmithPlatform to build admin panels, internal tools, and dashboards. Integrates with 25 databases and any API.项目地址: https://gitcode.com/GitHub_Trending/ap/appsmith创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考