配置默认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"