#Добавление пользовательских образов Task в селектор

Это руководство объясняет, как настроить параметры селектора для параметра image в форме UI Task, рассматривая два сценария:

• Добавление изображений для hub Tasks
• Добавление изображений для Tasks в собственном namespace.

#Обзор функциональности

• Каждый параметр селектора поступает из ConfigMap с data.name (метка) и data.image (значение).
• Метки, специфичные для Task, например catalog.tekton.dev/tool-image-python, позволяют UI сопоставлять ConfigMap с нужным параметром Task.
• UI запрашивает namespace, указанный в аннотации Task (например, kube-public), используя селектор меток, определенный в дескрипторе Task, а затем отображает селектор с результатами.

#Сценарии использования

• Добавить пользовательский образ зеркала registry для селектора Task.
• Добавить новый minor-версию runtime наряду с существующими параметрами селектора.
• Предоставить hardened image option для пользовательского Task.

#Предварительные требования

• Tekton Pipelines установлен.
• Вы можете создавать ConfigMap в kube-public.
• Вы можете задавать style.tekton.dev/descriptors для целевого Task (Hub Tasks уже предоставляют его; для пользовательских Tasks его нужно добавить).

#Сценарий A: Добавление изображений в селектор Hub Task

Используйте этот путь, если вы расширяете селектор Hub Task.

#1. Найдите селектор меток в дескрипторе Task

Найдите аннотацию style.tekton.dev/descriptors в Task и найдите запись, у которой path указывает на параметр image.

Дескриптор, оканчивающийся на urn:alm:descriptor:expression:props.options:api, содержит запрос labelSelector=...; ключ метки там должен присутствовать в вашем ConfigMap.

В следующем примере вам нужно создать ConfigMap с меткой catalog.tekton.dev/tool-image-python в namespace kube-public.

kind: Task
metadata:
  name: python
  labels:
    app.kubernetes.io/version: "0.1"
  annotations:
    style.tekton.dev/descriptors: |
      - path: params.PYTHON_IMAGE
        x-descriptors:
          ...
          - urn:alm:descriptor:expression:props.options:api:/kubernetes/${context.cluster}/api/v1/namespaces/kube-public/configmaps?labelSelector=catalog.tekton.dev%2Ftool-image-python
          ...

Дополнительную информацию о style.tekton.dev/descriptors см. в разделе How to Configure Dynamic Forms.

#2. Создайте ConfigMap в kube-public

Создайте ConfigMap, используя этот ключ метки.

По умолчанию Tasks поставляются с ConfigMap, помеченными catalog.tekton.dev/source: system, чтобы обозначить записи, предоставляемые платформой. Не изменяйте и не удаляйте их, а ваши пользовательские ConfigMap не должны содержать эту метку.

apiVersion: v1
kind: ConfigMap
metadata:
  name: tekton-task-python-custom
  namespace: kube-public
  labels:
    catalog.tekton.dev/tool-image-python: "3.10"
data:
  name: "Python 3.10"
  image: "registry.example.com/tekton/python:3.10"

#3. Примените и проверьте

kubectl apply -f tekton-task-python-custom.yaml
# configmap/tekton-task-python-custom created

kubectl -n kube-public get configmap -l catalog.tekton.dev/tool-image-python=3.10
# NAME                             DATA   AGE
# tekton-task-python-custom        2      15s

Откройте форму Task; селектор теперь должен включать Python 3.10 и устанавливать image в registry.example.com/tekton/python:3.10.

#Сценарий B: Добавление изображений в селектор вашего собственного Task

Используйте этот путь, если вы управляете определением Task и вам нужно настроить дескрипторы вместе с ConfigMap.

#1. Настройте style.tekton.dev/descriptors в Task

Пример дескриптора Task для селектора image:

apiVersion: tekton.dev/v1
kind: Task
metadata:
  name: python
  labels:
    app.kubernetes.io/version: "0.1"
  annotations:
    style.tekton.dev/descriptors: |
      - path: params.PYTHON_IMAGE
        x-descriptors:
          - urn:alm:descriptor:label:en:PYTHON_IMAGE
          - urn:alm:descriptor:description:en:The used Python image.
          - urn:alm:descriptor:com.tectonic.ui:select:image
          - urn:alm:descriptor:expression:props.options:api:/kubernetes/${context.cluster}/api/v1/namespaces/kube-public/configmaps?labelSelector=catalog.tekton.dev%2Ftool-image-python-custom
          - urn:alm:descriptor:props:select:allowCreate
          - urn:alm:descriptor:expression:props.options:path:items
          - urn:alm:descriptor:expression:props.options:label:path:data.name
          - urn:alm:descriptor:expression:props.options:value:path:data.image
          - urn:alm:descriptor:com.tectonic.ui:validation:required
spec:
  params:
    - name: PYTHON_IMAGE
      description: Image used for Python steps.
      type: string
  steps:
    - name: python-script
      image: $(params.PYTHON_IMAGE)
      script: |
        #!/bin/sh
        # Define your task script

Элементы дескриптора и их назначение:

Дополнительную информацию о style.tekton.dev/descriptors см. в разделе How to Configure Dynamic Forms.

#2. Создайте соответствующий ConfigMap в kube-public

Используйте тот же ключ метки, который запрашивает ваш дескриптор. Для пользовательских Tasks лучше использовать ключ метки, который не конфликтует с селекторами Task по умолчанию, чтобы избежать случайного отображения в Hub Tasks.

По умолчанию Tasks поставляются с ConfigMap, помеченными catalog.tekton.dev/source: system, чтобы обозначить записи, предоставляемые платформой. Не изменяйте и не удаляйте их, а ваши пользовательские ConfigMap не должны содержать эту метку.

apiVersion: v1
kind: ConfigMap
metadata:
  name: custom-task-python-3-13
  namespace: kube-public
  labels:
    catalog.tekton.dev/tool-image-python-custom: "3.13-team"
data:
  name: "Python 3.13 (Team Edition)"
  image: "registry.example.com/internal/python:3.13"

Вы также можете разместить ConfigMap в любом другом namespace по вашему выбору; вам нужно лишь убедиться, что namespace ConfigMap совпадает с namespace, указанным в аннотации style.tekton.dev/descriptors у Task. Например, вы можете задать аннотацию Task, как показано ниже; замените <NAMESPACE> на ваш namespace.

kind: Task
metadata:
  name: python
  labels:
    app.kubernetes.io/version: "0.1"
  annotations:
    # replace <NAMESPACE> with your namespace
    style.tekton.dev/descriptors: |
      - path: params.PYTHON_IMAGE
        x-descriptors:
          ...
          - urn:alm:descriptor:expression:props.options:api:/kubernetes/${context.cluster}/api/v1/namespaces/<NAMESPACE>/configmaps?labelSelector=catalog.tekton.dev%2Ftool-image-python-custom
          ...

#3. Примените и проверьте

kubectl apply -f custom-task-python-3-13.yaml
# configmap/custom-task-python-3-13 created

kubectl -n kube-public get configmap -l catalog.tekton.dev/tool-image-python-custom=3.13-team
# NAME                             DATA   AGE
# custom-task-python-3-13          2      15s

Откройте форму вашего Task; селектор должен показать Python 3.13 (Team Edition) и установить image в registry.example.com/internal/python:3.13.

#Советы по сопровождению

• Обновляйте пользовательский параметр, редактируя и повторно применяя его ConfigMap.
• Удаляйте параметр, удаляя только свой пользовательский ConfigMap; не трогайте ConfigMap с catalog.tekton.dev/source: system .