跳到主要内容
版本:5.0.1

常用应用属性

DeepSeek V3 中英对照 Common application properties

你可以在 application.properties 文件、application.yml 文件或作为命令行开关来指定各种属性。本附录列出了常见的 Spring Cloud Kubernetes 属性,并引用了使用这些属性的底层类。

备注

属性贡献可以来自类路径上的额外 jar 文件,因此你不应将其视为一个详尽的列表。此外,你也可以定义自己的属性。

名称默认描述
spring.cloud.kubernetes.client.api-version
spring.cloud.kubernetes.client.apiVersionv1Kubernetes API 版本
spring.cloud.kubernetes.client.ca-cert-data
spring.cloud.kubernetes.client.ca-cert-file
spring.cloud.kubernetes.client.caCertDataKubernetes API CACertData
spring.cloud.kubernetes.client.caCertFileKubernetes API CACertFile
spring.cloud.kubernetes.client.client-cert-data
spring.cloud.kubernetes.client.client-cert-file
spring.cloud.kubernetes.client.client-key-algo
spring.cloud.kubernetes.client.client-key-data
spring.cloud.kubernetes.client.client-key-file
spring.cloud.kubernetes.client.client-key-passphrase
spring.cloud.kubernetes.client.clientCertDataKubernetes API ClientCertData
spring.cloud.kubernetes.client.clientCertFileKubernetes API ClientCertFile
spring.cloud.kubernetes.client.clientKeyAlgoRSAKubernetes API ClientKeyAlgo
spring.cloud.kubernetes.client.clientKeyDataKubernetes API ClientKeyData
spring.cloud.kubernetes.client.clientKeyFileKubernetes API ClientKeyFile
spring.cloud.kubernetes.client.clientKeyPassphrasechangeitKubernetes API ClientKeyPassphrase
spring.cloud.kubernetes.client.connection-timeout
spring.cloud.kubernetes.client.connectionTimeout10s连接超时
spring.cloud.kubernetes.client.http-proxy
spring.cloud.kubernetes.client.https-proxy
spring.cloud.kubernetes.client.logging-interval
spring.cloud.kubernetes.client.loggingInterval20s日志记录间隔
spring.cloud.kubernetes.client.master-url
spring.cloud.kubernetes.client.masterUrlhttps://kubernetes.default.svcKubernetes API Master Node URL
spring.cloud.kubernetes.client.namespacetrueKubernetes 命名空间
spring.cloud.kubernetes.client.no-proxy
spring.cloud.kubernetes.client.oauth-token
spring.cloud.kubernetes.client.oauthTokenKubernetes API OAuth Token
spring.cloud.kubernetes.client.passwordKubernetes API 密码
spring.cloud.kubernetes.client.proxy-password
spring.cloud.kubernetes.client.proxy-username
spring.cloud.kubernetes.client.request-timeout
spring.cloud.kubernetes.client.requestTimeout10s请求超时
spring.cloud.kubernetes.client.rollingTimeout900s滚动超时
spring.cloud.kubernetes.client.service-account-namespace-path/var/run/secrets/kubernetes.io/serviceaccount/namespace
spring.cloud.kubernetes.client.trust-certs
spring.cloud.kubernetes.client.trustCertsfalseKubernetes API 信任证书
spring.cloud.kubernetes.client.user-agentSpring-Cloud-Kubernetes-Application
spring.cloud.kubernetes.client.usernameKubernetes API 用户名
spring.cloud.kubernetes.client.watch-reconnect-interval
spring.cloud.kubernetes.client.watch-reconnect-limit
spring.cloud.kubernetes.client.watchReconnectInterval1s重连间隔
spring.cloud.kubernetes.client.watchReconnectLimit-1重连间隔限制重试次数
spring.cloud.kubernetes.config.enabledtrue启用 ConfigMap 属性源定位器。
spring.cloud.kubernetes.config.fail-fastfalse
spring.cloud.kubernetes.config.include-profile-specific-sourcestrue
spring.cloud.kubernetes.config.labels
spring.cloud.kubernetes.config.name
spring.cloud.kubernetes.config.namespace
spring.cloud.kubernetes.config.read-typeBATCH
spring.cloud.kubernetes.config.retry
spring.cloud.kubernetes.config.sources
spring.cloud.kubernetes.config.use-name-as-prefixfalse
spring.cloud.kubernetes.discovery.all-namespacesfalse如果为所有命名空间启用了发现
spring.cloud.kubernetes.discovery.cache-loading-timeout-seconds60初始化发现缓存的超时时间,若超时将中止应用程序。
spring.cloud.kubernetes.discovery.discovery-server-url
spring.cloud.kubernetes.discovery.enabledtrue如果启用了 Kubernetes 发现
spring.cloud.kubernetes.discovery.filter从 Kubernetes API 服务器检索服务后,用于过滤服务的 SpEL 表达式。
spring.cloud.kubernetes.discovery.include-external-name-servicesfalse发现是否也应该搜索在其规范中包含“type: ExternalName”的服务。
spring.cloud.kubernetes.discovery.include-not-ready-addressesfalse如果端点地址未被 Kubernetes 标记为 'ready',则视为已发现
spring.cloud.kubernetes.discovery.known-secure-ports[443, 8443]已知安全端口集合
spring.cloud.kubernetes.discovery.metadata.add-annotationstrue将注释作为元数据包含
spring.cloud.kubernetes.discovery.metadata.add-labelstrue将标签作为元数据包含
spring.cloud.kubernetes.discovery.metadata.add-pod-annotationsfalse在响应中添加 Pod 注解。
spring.cloud.kubernetes.discovery.metadata.add-pod-labelsfalse在响应中添加 Pod 标签。
spring.cloud.kubernetes.discovery.metadata.add-portstrue将端口作为元数据包含
spring.cloud.kubernetes.discovery.metadata.annotations-prefix注释的前缀
spring.cloud.kubernetes.discovery.metadata.labels-prefix标签的前缀
spring.cloud.kubernetes.discovery.metadata.ports-prefixport.端口的默认前缀为 "port."
spring.cloud.kubernetes.discovery.namespaces如果设置了此选项且 allNamespaces 为 false,则仅从 Kubernetes API 服务器获取与这些命名空间匹配的服务和端点。
spring.cloud.kubernetes.discovery.order0
spring.cloud.kubernetes.discovery.primary-port-name如果设置了此项,当服务定义了多个端口时,具有给定名称的端口将被用作主端口。
spring.cloud.kubernetes.discovery.service-labels如果设置了此选项,则仅从 Kubernetes API 服务器获取匹配这些标签的服务。
spring.cloud.kubernetes.discovery.use-endpoint-slicesfalse使用 EndpointSlice 替代 Endpoints
spring.cloud.kubernetes.discovery.wait-cache-readytrue等待发现缓存(服务与端点)完全加载,否则在启动时中止应用程序
spring.cloud.kubernetes.leader.auto-startuptrue是否应在启动时自动开始领导者选举。默认值:true
spring.cloud.kubernetes.leader.config-map-nameleaders存储领导者信息的 Kubernetes ConfigMap。默认值:leaders
spring.cloud.kubernetes.leader.create-config-maptrue启用/禁用创建不存在的 ConfigMap。默认值:true
spring.cloud.kubernetes.leader.election.lease-duration15s
spring.cloud.kubernetes.leader.election.lock-namespring-k8s-leader-election-lock
spring.cloud.kubernetes.leader.election.lock-namespacedefault
spring.cloud.kubernetes.leader.election.publish-eventstrue
spring.cloud.kubernetes.leader.election.renew-deadline10s
spring.cloud.kubernetes.leader.election.restart-on-failuretrue
spring.cloud.kubernetes.leader.election.retry-period2s
spring.cloud.kubernetes.leader.election.use-config-map-as-lockfalse
spring.cloud.kubernetes.leader.election.wait-after-renewal-failure3s
spring.cloud.kubernetes.leader.election.wait-for-pod-readytrue
spring.cloud.kubernetes.leader.enabledtrue是否启用领导者选举。默认值:true
spring.cloud.kubernetes.leader.leader-id-prefixleader.id.ConfigMap 中 Leader ID 属性的前缀。默认值:leader.id。
spring.cloud.kubernetes.leader.namespaceKubernetes 命名空间,用于存放领导者 ConfigMap 和候选者。
spring.cloud.kubernetes.leader.publish-failed-eventsfalse在领导权获取失败时启用/禁用发布事件。默认值:false
spring.cloud.kubernetes.leader.role该候选人将竞选的领导职位。
spring.cloud.kubernetes.leader.update-period60000ms领导状态检查周期。默认值:60秒
spring.cloud.kubernetes.loadbalancer.cluster-domaincluster.local集群域。
spring.cloud.kubernetes.loadbalancer.enabledtrue负载均衡器已启用,默认值为 true。
spring.cloud.kubernetes.loadbalancer.modepod{@link KubernetesLoadBalancerMode} 设置负载均衡服务器列表时使用 Pod 的 IP 地址或服务名称。默认值为 POD。
spring.cloud.kubernetes.loadbalancer.port-namehttp服务端口名称。
spring.cloud.kubernetes.reload.enable-reload-filteringfalse仅针对带有 spring.cloud.kubernetes.config.informer.enabled=true 标签的源创建 informer。此属性仅与基于事件的重载相关。
spring.cloud.kubernetes.reload.enabledfalse启用Kubernetes配置变更时重新加载。
spring.cloud.kubernetes.reload.max-wait-for-restart2s当使用重启或关机策略时,Spring Cloud Kubernetes 会在重启前等待一段随机时间。这样做是为了避免同一应用程序的所有实例同时重启。此属性配置从接收到需要重启的信号到实际触发重启之间的最大等待时间。
spring.cloud.kubernetes.reload.modeEVENT设置 Kubernetes 配置重新加载的检测模式。
spring.cloud.kubernetes.reload.monitoring-config-mapstrue启用对密钥的监控以检测变更。
spring.cloud.kubernetes.reload.monitoring-secretsfalse是否监控密钥。
spring.cloud.kubernetes.reload.namespaces设置 informer 的命名空间。此属性仅与基于事件的重载相关。
spring.cloud.kubernetes.reload.period15000ms当检测模式为 POLLING 时,设置要使用的轮询周期。
spring.cloud.kubernetes.reload.strategyREFRESH设置Kubernetes配置变更时的重载策略。
spring.cloud.kubernetes.secrets.enabledtrue启用 Secrets 属性源定位器。
spring.cloud.kubernetes.secrets.fail-fastfalse
spring.cloud.kubernetes.secrets.include-profile-specific-sourcestrue
spring.cloud.kubernetes.secrets.labels
spring.cloud.kubernetes.secrets.name
spring.cloud.kubernetes.secrets.namespace
spring.cloud.kubernetes.secrets.read-typeBATCH
spring.cloud.kubernetes.secrets.retry
spring.cloud.kubernetes.secrets.sources
spring.cloud.kubernetes.secrets.use-name-as-prefixfalse