13.3. func.yaml 中的可配置字段

buildEnvs 字段允许您设置环境变量，供构建您的功能的环境使用。与使用 envs 设置的变量不同，使用 buildEnv 的变量集合在函数运行时不可用。

您可以直接从值设置 buildEnv 变量。在以下示例中，名为 EXAMPLE1 的 buildEnv 变量被直接分配为 one 值：

buildEnvs:
- name: EXAMPLE1
  value: one

您还可以从本地环境变量设置 buildEnv 变量。在以下示例中，名为 EXAMPLE2 的 buildEnv 变量被分配了 LOCAL_ENV_VAR 本地环境变量的值：

buildEnvs:
- name: EXAMPLE1
  value: '{{ env:LOCAL_ENV_VAR }}'

envs 字段允许您在运行时设置环境变量供您的功能使用。您可以通过几种不同方式设置环境变量：

这个示例演示了设置环境变量的不同方法：

name: test
namespace: ""
runtime: go
...
envs:
- name: EXAMPLE1 1
  value: value
- name: EXAMPLE2 2
  value: '{{ env:LOCAL_ENV_VALUE }}'
- name: EXAMPLE3 3
  value: '{{ secret:mysecret:key }}'
- name: EXAMPLE4 4
  value: '{{ configMap:myconfigmap:key }}'
- value: '{{ secret:mysecret2 }}' 5
- value: '{{ configMap:myconfigmap2 }}' 6

builder 字段指定函数用于构建镜像的策略。它接受 pack 或 s2i 的值。

build 字段指示如何构建函数。local 值表示该函数在您的机器上本地构建。git 值表示函数使用 git 字段中指定的值来在集群中构建。

volumes 字段允许您将 secret 和配置映射作为可在指定路径的函数访问的卷挂载，如下例所示：

name: test
namespace: ""
runtime: go
...
volumes:
- secret: mysecret 1
  path: /workspace/secret
- configMap: myconfigmap 2
  path: /workspace/configmap

options 字段允许您修改部署的功能的 Knative Service 属性，如自动扩展。如果未设置这些选项，则使用默认的选项。

这些选项可用：

这是 scale 选项配置示例：

name: test
namespace: ""
runtime: go
...
options:
  scale:
    min: 0
    max: 10
    metric: concurrency
    target: 75
    utilization: 75
  resources:
    requests:
      cpu: 100m
      memory: 128Mi
    limits:
      cpu: 1000m
      memory: 256Mi
      concurrency: 100

image 字段在构建后为您的功能设置镜像名称。您可以修改此字段。如果您这样做，在下次运行 kn func build 或 kn func deploy 时，功能镜像将使用新名称创建。

在部署函数时，imageDigest 字段包含镜像清单的 SHA256 哈希。不要修改这个值。

labels 字段允许您在部署的功能中设置标签。

您可以直接从值设置标签。在以下示例中，带有 role 键的标签直接被分配了 backend 的值：

labels:
- key: role
  value: backend

您还可以从本地环境变量设置标签。在以下示例中，为带有 author 键的标签分配 USER 本地环境变量的值：

labels:
- key: author
  value: '{{ env:USER }}'

name 字段定义您的函数的名称。该值在部署时用作 Knative 服务的名称。您可以更改此字段来重命名后续部署中的函数。

namespace 字段指定部署您的功能的命名空间。

runtime 字段指定您的功能的语言运行时，如 python。