6.9. Configuration du projet de fonction dans func.yaml

Le champ buildEnvs vous permet de définir des variables d'environnement qui seront disponibles pour l'environnement qui construit votre fonction. Contrairement aux variables définies à l'aide de envs, une variable définie à l'aide de buildEnv n'est pas disponible pendant l'exécution de la fonction.

Vous pouvez définir une variable buildEnv directement à partir d'une valeur. Dans l'exemple suivant, la variable buildEnv nommée EXAMPLE1 se voit directement attribuer la valeur one:

buildEnvs:
- name: EXAMPLE1
  value: one

buildEnvs:
- name: EXAMPLE1
  value: one

Vous pouvez également définir une variable buildEnv à partir d'une variable d'environnement locale. Dans l'exemple suivant, la variable buildEnv nommée EXAMPLE2 se voit attribuer la valeur de la variable d'environnement locale LOCAL_ENV_VAR:

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

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

Le champ envs vous permet de définir des variables d'environnement qui seront disponibles pour votre fonction au moment de l'exécution. Vous pouvez définir une variable d'environnement de différentes manières :

Cet exemple montre les différentes façons de définir une variable d'environnement :

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

name: test
namespace: ""
runtime: go
...
envs:
- name: EXAMPLE1 

  value: value
- name: EXAMPLE2 

  value: '{{ env:LOCAL_ENV_VALUE }}'
- name: EXAMPLE3 

  value: '{{ secret:mysecret:key }}'
- name: EXAMPLE4 

  value: '{{ configMap:myconfigmap:key }}'
- value: '{{ secret:mysecret2 }}' 

- value: '{{ configMap:myconfigmap2 }}' 

Le champ builder indique la stratégie utilisée par la fonction pour construire l'image. Il accepte les valeurs pack ou s2i.

Le champ build indique comment la fonction doit être construite. La valeur local indique que la fonction est construite localement sur votre machine. La valeur git indique que la fonction est construite sur un cluster en utilisant les valeurs spécifiées dans le champ git.

Le champ volumes vous permet de monter les secrets et les cartes de configuration en tant que volume accessible à la fonction au chemin spécifié, comme le montre l'exemple suivant :

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

name: test
namespace: ""
runtime: go
...
volumes:
- secret: mysecret 

  path: /workspace/secret
- configMap: myconfigmap 

  path: /workspace/configmap

Le champ options vous permet de modifier les propriétés du service Knative pour la fonction déployée, telles que l'autoscaling. Si ces options ne sont pas définies, les options par défaut sont utilisées.

Les options suivantes sont disponibles :

Voici un exemple de configuration des options de 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

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

Le champ image définit le nom de l'image de votre fonction après sa construction. Vous pouvez modifier ce champ. Si vous le faites, la prochaine fois que vous exécuterez kn func build ou kn func deploy, l'image de la fonction sera créée avec le nouveau nom.

Le champ imageDigest contient le hachage SHA256 du manifeste de l'image lorsque la fonction est déployée. Ne pas modifier cette valeur.

Le champ labels vous permet de définir des étiquettes sur une fonction déployée.

Vous pouvez définir une étiquette directement à partir d'une valeur. Dans l'exemple suivant, l'étiquette de la clé role se voit directement attribuer la valeur backend:

labels:
- key: role
  value: backend

labels:
- key: role
  value: backend

Vous pouvez également définir une étiquette à partir d'une variable d'environnement locale. Dans l'exemple suivant, l'étiquette de la touche author se voit attribuer la valeur de la variable d'environnement locale USER:

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

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

Le champ name définit le nom de votre fonction. Cette valeur est utilisée comme nom de votre service Knative lorsqu'il est déployé. Vous pouvez modifier ce champ pour renommer la fonction lors des déploiements ultérieurs.

Le champ namespace indique l'espace de noms dans lequel votre fonction est déployée.

Le champ runtime indique la langue d'exécution de votre fonction, par exemple python.