feat: define Function and Trigger CRD types
Function: - runtime (go1.21/python3.11/nodejs20) - entrypoint, s3Bucket, s3Key - memoryMB (default 128), timeoutSec (default 30) - env map - status: phase (Pending/Building/Ready/Failed), imageRef, conditions Trigger: - type (http/cron), functionRef - schedule (cron only) - preWarmSeconds (default 300) - pre-warm before cron run - status: active, url, lastScheduleTime printcolumns for kubectl get output
This commit is contained in:
@@ -14,10 +14,20 @@ spec:
|
||||
singular: function
|
||||
scope: Namespaced
|
||||
versions:
|
||||
- name: v1alpha1
|
||||
- additionalPrinterColumns:
|
||||
- jsonPath: .spec.runtime
|
||||
name: Runtime
|
||||
type: string
|
||||
- jsonPath: .status.phase
|
||||
name: Phase
|
||||
type: string
|
||||
- jsonPath: .metadata.creationTimestamp
|
||||
name: Age
|
||||
type: date
|
||||
name: v1alpha1
|
||||
schema:
|
||||
openAPIV3Schema:
|
||||
description: Function is the Schema for the functions API
|
||||
description: Function — основной ресурс для управления serverless функцией.
|
||||
properties:
|
||||
apiVersion:
|
||||
description: |-
|
||||
@@ -37,15 +47,137 @@ spec:
|
||||
metadata:
|
||||
type: object
|
||||
spec:
|
||||
description: FunctionSpec defines the desired state of Function
|
||||
description: |-
|
||||
FunctionSpec — желаемое состояние функции.
|
||||
Описывает всё необходимое для сборки и запуска пользовательского кода.
|
||||
properties:
|
||||
foo:
|
||||
description: Foo is an example field of Function. Edit function_types.go
|
||||
to remove/update
|
||||
entrypoint:
|
||||
description: 'Entrypoint — точка входа в код функции (например: handler.handle)'
|
||||
type: string
|
||||
env:
|
||||
additionalProperties:
|
||||
type: string
|
||||
description: Env — переменные окружения, передаются в контейнер функции
|
||||
type: object
|
||||
memoryMB:
|
||||
default: 128
|
||||
description: 'MemoryMB — лимит памяти в мегабайтах (default: 128)'
|
||||
format: int32
|
||||
type: integer
|
||||
runtime:
|
||||
description: Runtime — язык и версия выполнения (go1.21, python3.11,
|
||||
nodejs20)
|
||||
enum:
|
||||
- go1.21
|
||||
- python3.11
|
||||
- nodejs20
|
||||
type: string
|
||||
s3Bucket:
|
||||
description: S3Bucket — бакет S3 где хранится zip архив с кодом
|
||||
type: string
|
||||
s3Key:
|
||||
description: S3Key — ключ объекта в S3 (путь до zip архива)
|
||||
type: string
|
||||
timeoutSec:
|
||||
default: 30
|
||||
description: 'TimeoutSec — максимальное время выполнения в секундах
|
||||
(default: 30)'
|
||||
format: int32
|
||||
type: integer
|
||||
required:
|
||||
- entrypoint
|
||||
- runtime
|
||||
- s3Bucket
|
||||
- s3Key
|
||||
type: object
|
||||
status:
|
||||
description: FunctionStatus defines the observed state of Function
|
||||
description: FunctionStatus — наблюдаемое состояние функции (заполняет
|
||||
контроллер).
|
||||
properties:
|
||||
conditions:
|
||||
description: Conditions — стандартные k8s conditions для интеграции
|
||||
с инструментами
|
||||
items:
|
||||
description: "Condition contains details for one aspect of the current
|
||||
state of this API Resource.\n---\nThis struct is intended for
|
||||
direct use as an array at the field path .status.conditions. For
|
||||
example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
|
||||
observations of a foo's current state.\n\t // Known .status.conditions.type
|
||||
are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
|
||||
+patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
|
||||
\ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
|
||||
patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
|
||||
\ // other fields\n\t}"
|
||||
properties:
|
||||
lastTransitionTime:
|
||||
description: |-
|
||||
lastTransitionTime is the last time the condition transitioned from one status to another.
|
||||
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
|
||||
format: date-time
|
||||
type: string
|
||||
message:
|
||||
description: |-
|
||||
message is a human readable message indicating details about the transition.
|
||||
This may be an empty string.
|
||||
maxLength: 32768
|
||||
type: string
|
||||
observedGeneration:
|
||||
description: |-
|
||||
observedGeneration represents the .metadata.generation that the condition was set based upon.
|
||||
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
|
||||
with respect to the current state of the instance.
|
||||
format: int64
|
||||
minimum: 0
|
||||
type: integer
|
||||
reason:
|
||||
description: |-
|
||||
reason contains a programmatic identifier indicating the reason for the condition's last transition.
|
||||
Producers of specific condition types may define expected values and meanings for this field,
|
||||
and whether the values are considered a guaranteed API.
|
||||
The value should be a CamelCase string.
|
||||
This field may not be empty.
|
||||
maxLength: 1024
|
||||
minLength: 1
|
||||
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
|
||||
type: string
|
||||
status:
|
||||
description: status of the condition, one of True, False, Unknown.
|
||||
enum:
|
||||
- "True"
|
||||
- "False"
|
||||
- Unknown
|
||||
type: string
|
||||
type:
|
||||
description: |-
|
||||
type of condition in CamelCase or in foo.example.com/CamelCase.
|
||||
---
|
||||
Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
|
||||
useful (see .node.status.conditions), the ability to deconflict is important.
|
||||
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
|
||||
maxLength: 316
|
||||
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
|
||||
type: string
|
||||
required:
|
||||
- lastTransitionTime
|
||||
- message
|
||||
- reason
|
||||
- status
|
||||
- type
|
||||
type: object
|
||||
type: array
|
||||
imageRef:
|
||||
description: ImageRef — полный путь к собранному Docker образу в registry
|
||||
type: string
|
||||
lastBuiltAt:
|
||||
description: LastBuiltAt — время последней успешной сборки образа
|
||||
format: date-time
|
||||
type: string
|
||||
message:
|
||||
description: Message — человекочитаемое сообщение об ошибке или статусе
|
||||
type: string
|
||||
phase:
|
||||
description: 'Phase — текущая фаза: Pending, Building, Ready, Failed'
|
||||
type: string
|
||||
type: object
|
||||
type: object
|
||||
served: true
|
||||
|
||||
@@ -14,10 +14,26 @@ spec:
|
||||
singular: trigger
|
||||
scope: Namespaced
|
||||
versions:
|
||||
- name: v1alpha1
|
||||
- additionalPrinterColumns:
|
||||
- jsonPath: .spec.type
|
||||
name: Type
|
||||
type: string
|
||||
- jsonPath: .spec.functionRef
|
||||
name: Function
|
||||
type: string
|
||||
- jsonPath: .status.active
|
||||
name: Active
|
||||
type: boolean
|
||||
- jsonPath: .status.url
|
||||
name: URL
|
||||
type: string
|
||||
- jsonPath: .metadata.creationTimestamp
|
||||
name: Age
|
||||
type: date
|
||||
name: v1alpha1
|
||||
schema:
|
||||
openAPIV3Schema:
|
||||
description: Trigger is the Schema for the triggers API
|
||||
description: Trigger — ресурс для управления способом вызова Function.
|
||||
properties:
|
||||
apiVersion:
|
||||
description: |-
|
||||
@@ -37,15 +53,50 @@ spec:
|
||||
metadata:
|
||||
type: object
|
||||
spec:
|
||||
description: TriggerSpec defines the desired state of Trigger
|
||||
description: TriggerSpec — желаемое состояние триггера.
|
||||
properties:
|
||||
foo:
|
||||
description: Foo is an example field of Trigger. Edit trigger_types.go
|
||||
to remove/update
|
||||
functionRef:
|
||||
description: FunctionRef — имя Function ресурса в том же namespace
|
||||
type: string
|
||||
preWarmSeconds:
|
||||
default: 300
|
||||
description: |-
|
||||
PreWarmSeconds — за сколько секунд до запуска прогреть контейнер.
|
||||
Актуально для cron: запускаем pod заранее чтобы избежать cold start.
|
||||
format: int32
|
||||
type: integer
|
||||
schedule:
|
||||
description: 'Schedule — расписание в формате cron (только для type=cron,
|
||||
например: "0 2 * * *")'
|
||||
type: string
|
||||
type:
|
||||
description: 'Type — тип триггера: http или cron'
|
||||
enum:
|
||||
- http
|
||||
- cron
|
||||
type: string
|
||||
required:
|
||||
- functionRef
|
||||
- type
|
||||
type: object
|
||||
status:
|
||||
description: TriggerStatus defines the observed state of Trigger
|
||||
description: TriggerStatus — наблюдаемое состояние триггера (заполняет
|
||||
контроллер).
|
||||
properties:
|
||||
active:
|
||||
description: Active — активен ли триггер в данный момент
|
||||
type: boolean
|
||||
lastScheduleTime:
|
||||
description: LastScheduleTime — время последнего запуска по расписанию
|
||||
(только для type=cron)
|
||||
format: date-time
|
||||
type: string
|
||||
message:
|
||||
description: Message — человекочитаемое сообщение об ошибке или статусе
|
||||
type: string
|
||||
url:
|
||||
description: URL — публичный URL для вызова функции (только для type=http)
|
||||
type: string
|
||||
type: object
|
||||
type: object
|
||||
served: true
|
||||
|
||||
Reference in New Issue
Block a user