配置默认ConfigMap¶
The config-defaults ConfigMap, known as the Defaults ConfigMap, contains settings that determine how Knative sets default values for resources.
This ConfigMap is located in the knative-serving namespace.
You can view the current config-defaults ConfigMap by running the following command:
kubectl get configmap -n knative-serving config-defaults -oyaml
例子 config-defaults ConfigMap¶
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
revision-timeout-seconds: "300"
max-revision-timeout-seconds: "600"
revision-cpu-request: "400m"
revision-memory-request: "100M"
revision-ephemeral-storage-request: "500M"
revision-cpu-limit: "1000m"
revision-memory-limit: "200M"
revision-ephemeral-storage-limit: "750M"
container-name-template: "user-container"
container-concurrency: "0"
container-concurrency-max-limit: "1000"
allow-container-concurrency-zero: "true"
enable-service-links: "false"
See below for a description of each property.
属性¶
修订的超时秒¶
The revision timeout value determines the default number of seconds to use for the revision's per-request timeout if none is specified.
- Global key:
revision-timeout-seconds - Per-revision spec key:
timeoutSeconds - Possible values: integer
- Default:
"300"(5 minutes)
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
revision-timeout-seconds: "300"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
timeoutSeconds: 300
containers:
- image: gcr.io/knative-samples/helloworld-go
最大修订超时秒数¶
The max-revision-timeout-seconds value determines the maximum number of seconds that can be used for revision-timeout-seconds. This value must be greater than or equal to revision-timeout-seconds. If omitted, the system default is used (600 seconds).
If this value is increased, the activator's terminationGraceTimeSeconds should also be increased to prevent in-flight requests from being disrupted.
- Global key:
max-revision-timeout-seconds - Per-revision annotation key: N/A
- Possible values: integer
- Default:
"600"(10 minutes)
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
max-revision-timeout-seconds: "600"
修订的CPU请求¶
The revision-cpu-request value determines the CPU allocation assigned to revisions by default. If this value is omitted, the system default is used. This key is not enabled by default for Knative.
- Global key:
revision-cpu-request - Per-revision annotation key:
cpu - Possible values: integer
- Default:
"400m"(0.4 of a CPU, or 400 milli-CPU)
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
revision-cpu-request: "400m"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
containers:
- image: gcr.io/knative-samples/helloworld-go
resources:
requests:
cpu: "400m"
修订的内存请求¶
The revision-memory-request value determines the memory allocation assigned
to revisions by default. If this value is omitted, the system default is used. This key is not enabled by default for Knative.
- Global key:
revision-memory-request - Per-revision annotation key:
memory - Possible values: integer
- Default:
"100M"(100 megabytes of memory)
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
revision-memory-request: "100M"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
containers:
- image: gcr.io/knative-samples/helloworld-go
resources:
requests:
memory: "100M"
修订临时存储请求¶
The revision-ephemeral-storage-request value determines the ephemeral storage
allocation assigned to revisions by default. If this value is omitted, the system default is used. This key is not enabled by default for Knative.
- Global key:
revision-ephemeral-storage-request - Per-revision annotation key:
ephemeral-storage - Possible values: integer
- Default:
"500M"(500 megabytes of storage)
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
revision-ephemeral-storage-request: "500M"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
containers:
- image: gcr.io/knative-samples/helloworld-go
resources:
requests:
ephemeral-storage: "500M"
修订 CPU 限制¶
The revision-cpu-limit value determines the default CPU allocation limit for revisions. If this value is omitted, the system default is used. This key is not enabled by default for Knative.
- Global key:
revision-cpu-limit - Per-revision annotation key:
cpu - Possible values: integer
- Default:
"1000m"(1 CPU, or 1000 milli-CPU)
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
revision-cpu-limit: "1000m"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
containers:
- image: gcr.io/knative-samples/helloworld-go
resources:
requests:
cpu: "1000m"
修订内存限制¶
The revision-memory-limit value determines the default memory allocation limit for revisions. If this value is omitted, the system default is used. This key is not enabled by default for Knative.
- Global key:
revision-memory-limit - Per-revision annotation key:
memory - Possible values: integer
- Default:
"200M"(200 megabytes of memory)
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
revision-memory-limit: "200M"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
containers:
- image: gcr.io/knative-samples/helloworld-go
resources:
requests:
memory: "200M"
修订临时存储限制¶
The revision-ephemeral-storage-limit value determines the default ephemeral storage limit allocated to revisions. If this value is omitted, the system default is used. This key is not enabled by default for Knative.
- Global key:
revision-ephemeral-storage-limit - Per-revision annotation key:
ephemeral-storage - Possible values: integer
- Default:
"750M"(750 megabytes of storage)
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
revision-ephemeral-storage-limit: "750M"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
containers:
- image: gcr.io/knative-samples/helloworld-go
resources:
requests:
ephemeral-storage: "750M"
容器名称模板¶
The container-name-template value provides a template for the default
container name if no container name is specified. This field supports Go templating and is supplied by the ObjectMeta of the enclosing Service or Configuration, so values such as {{.Name}} are also valid.
- Global key:
container-name-template - Per-revision annotation key:
name - Possible values: string
- Default:
"user-container"
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
container-name-template: "user-container"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
containers:
- name: user-container
image: gcr.io/knative-samples/helloworld-go
容器的并发¶
The container-concurrency value specifies the maximum number of requests the container can handle at once. Requests above this threshold are queued. Setting a value of zero disables this throttling and lets through as many requests as
the pod receives.
- Global key:
container-concurrency - Per-revision spec key:
containerConcurrency - Possible values: integer
- Default:
"0"
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
container-concurrency: "0"
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
name: helloworld-go
namespace: default
spec:
template:
spec:
containerConcurrency: 0
容器并发最大限制¶
The container-concurrency-max-limit setting disables arbitrary large concurrency values, or autoscaling targets, for individual revisions. The container-concurrency default setting must be at or below this value. The value of the container-concurrency-max-limit setting must be greater than 1.
Note
Even with this set, a user can choose a containerConcurrency value of zero (unbounded), unless allow-container-concurrency-zero is set to "false".
- Global key:
container-concurrency-max-limit - Per-revision annotation key: N/A
- Possible values: integer
- Default:
"1000"
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
container-concurrency-max-limit: "1000"
apiVersion: operator.knative.dev/v1beta1
kind: KnativeServing
metadata:
name: knative-serving
namespace: knative-serving
spec:
config:
defaults:
container-concurrency-max-limit: "1000"
允许容器并发为零¶
The allow-container-concurrency-zero value determines whether users can
specify 0 (unbounded) for containerConcurrency.
- Global key:
allow-container-concurrency-zero - Per-revision annotation key: N/A
- Possible values: boolean
- Default:
"true"
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
allow-container-concurrency-zero: "true"
使服务链接¶
The enable-service-links value specifies the default value used for the enableServiceLinks field of the PodSpec when it is omitted by the user. See the Kubernetes documentation about the enableServiceLinks feature.
This is a tri-state flag with possible values of (true|false|default).
In environments with large number of Services, it is suggested to set this value to false. See serving#8498.
- Global key:
enable-service-links - Per-revision annotation key: N/A
- Possible values:
true|false|default - Default:
"false"
Example:
apiVersion: v1
kind: ConfigMap
metadata:
name: config-defaults
namespace: knative-serving
data:
enable-service-links: "false"