Быстрый старт

Содержание

Установка Tekton Results Предварительные требования Установка с использованием operator CRD Проверка работоспособности 1. Создайте ресурс TaskRun2. Дождитесь завершения выполнения задачи 3. Используйте CLI tkn-results для запроса результатов References

Установка Tekton Results

В этом документе объясняется, как установить Tekton Results с использованием существующей базы данных.

NOTE

В настоящее время встроенная база данных PostgreSQL не поддерживается, пожалуйста, используйте внешнюю базу данных.

О внешней базе данных см. раздел Using PostgreSQL from Data Services

TIP

Tekton Results поддерживает хранение логов в различных системах хранения. S3-совместимое объектное хранилище (например, AWS S3, Ceph, MinIO) сейчас является рекомендуемым решением для масштабируемого и надежного хранения логов. Для подробной настройки S3-хранилища см. S3 Storage Configuration Guide. Локальное хранилище PVC не рекомендуется для использования в продакшене.

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

В кластере должен быть установлен Tekton Pipelines.

TIP
В следующих инструкциях предполагается, что Results установлен в namespace tekton-pipelines по умолчанию.
Если вы установили его в другой namespace, замените tekton-pipelines на ваш namespace.
Создайте пароль root для базы данных.

Пользователи должны сгенерировать пароль root для базы данных и сохранить его в Kubernetes Secret перед установкой. По умолчанию Tekton Results ожидает, что этот Secret будет иметь следующие атрибуты:
- Namespace: tekton-pipelines
- Имя: tekton-results-postgres
- Содержит следующие поля:
  - POSTGRES_USER=<your_username>
  - POSTGRES_PASSWORD=<your_password>
Вы можете быстро создать Secret с помощью следующей команды:
kubectl create secret generic tekton-results-postgres --namespace="tekton-pipelines" --from-literal=POSTGRES_USER={POSTGRES} --from-literal=POSTGRES_PASSWORD={PASSWORD}
Сгенерируйте пару сертификат/ключ. Примечание: для этого можно использовать любое программное обеспечение для управления сертификатами!

Tekton Results ожидает, что пара сертификат/ключ будет храниться в TLS Kubernetes Secret с именем tekton-results-tls.
- Сгенерируйте новый самоподписанный сертификат
  openssl req -x509 \ -newkey rsa:4096 \ -keyout key.pem \ -out cert.pem \ -days 365 \ -nodes \ -subj "/CN=tekton-results-api-service.tekton-pipelines.svc.cluster.local" \ -addext "subjectAltName = DNS:tekton-results-api-service.tekton-pipelines.svc.cluster.local"
  TIP
  Если ваша версия openssl слишком старая и не поддерживает некоторые параметры, пожалуйста, обновите openssl с openssl binaries.
- Создайте новый TLS Secret из сертификата.
  kubectl create secret tls -n tekton-pipelines tekton-results-tls \ --cert=cert.pem \ --key=key.pem
(Только для быстрого старта) Создайте PVC, если вы используете устаревший тип хранилища File (не рекомендуется для продакшена).

WARNING
Локальное хранилище на основе PVC не рекомендуется для использования в продакшене. Рекомендуется использовать S3-совместимое объектное хранилище для масштабируемого и надежного хранения логов. Для настройки S3-хранилища см. S3 Storage Configuration Guide.

Если вам всё же нужно использовать PVC для тестирования:
cat <<EOF | kubectl create -f - apiVersion: v1 kind: PersistentVolumeClaim metadata: name: tekton-logs namespace: tekton-pipelines spec: accessModes: - ReadWriteOnce # Режим доступа, позволяющий чтение и запись с одного узла resources: requests: storage: 100Gi # Запрашиваемый объем хранилища EOF
- Пожалуйста, при необходимости отрегулируйте размер PVC.
- Примечание: требуется только при использовании устаревшего типа хранилища File.

Установка с использованием operator CRD

$ cat <<EOF | kubectl create -f -
apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  # Целевой namespace
  targetNamespace: tekton-pipelines
  result:
    # Адрес базы данных
    db_host: <database_host>
    db_port: 5432
    db_name: <database_name>
    # Использовать внешнюю базу данных
    is_external_db: true
    # секрет с информацией об аккаунте базы данных, созданный ранее
    db_secret_name: tekton-results-postgres
    # Основные настройки
    server_port: 8080
    # Отключить аутентификацию
    auth_disable: true
    db_enable_auto_migration: true
    log_level: debug
    # Использовать сервис хранения логов
    logs_api: true
    log_type: File
    logging_pvc_name: tekton-logs
    # logs_type: S3  # Рекомендуется: S3-совместимое хранилище для масштабируемого хранения логов
    # secret_name: tekton-results-s3-credentials  # Секрет с учетными данными S3
    logs_path: /logs
    logs_buffer_size: 92160
    # Для S3-хранилища PVC не требуется, в отличие от устаревшего File-хранилища
EOF

DETAILS

Все поля конфигурации Tekton Results находятся внутри spec.result ресурса TektonConfig.

db_host: Хост базы данных.
db_port: Порт базы данных.
db_name: Имя базы данных.
is_external_db: Использовать ли внешнюю базу данных.
- true: использовать внешнюю базу данных.
db_secret_name: Имя секрета с информацией об аккаунте базы данных.
- Это секрет, созданный на предыдущем шаге.
server_port: Порт сервера.
targetNamespace: Namespace, в котором развернут Results.
auth_disable: Отключить аутентификацию.
db_enable_auto_migration: Включить автоматическую миграцию базы данных.
log_level: Уровень логирования.
logs_api: Включить API логов.
- true: включить API логов.
logs_type: Тип логов.
- File: хранить логи в файлах (не рекомендуется для продакшена).
- S3: хранить логи в S3-совместимом объектном хранилище (например, AWS S3, Ceph, MinIO). Это рекомендуемый способ для масштабируемого и надежного хранения логов. Для подробной настройки см. S3 Storage Configuration Guide.
secret_name: Имя секрета с учетными данными S3. Для подробной настройки см. S3 Storage Configuration Guide.
logs_path: Путь к логам.
logs_buffer_size: Размер буфера логов.
logging_pvc_name: Имя PVC для хранения логов (требуется только при использовании устаревшего типа File).
- Это PVC, созданный на предыдущем шаге (не требуется для S3-хранилища).

TIP

Подробнее о настройке базы данных см. PostgreSQL Configuration

После развертывания вы увидите, что статус results-api / results-retention-policy-agent / results-watcher — Running

$ kubectl get pods -n tekton-pipelines

NAME                                                    READY   STATUS    RESTARTS   AGE
tekton-results-api-68bb657996-bb487                     1/1     Running   0          14s
tekton-results-retention-policy-agent-c6ff5575b-prczg   1/1     Running   0          14s
tekton-results-watcher-6d7c68f576-p2gbl                 1/1     Running   0          14s

Проверка работоспособности

Работу можно проверить с помощью простого taskrun.

1. Создайте ресурс `TaskRun`

$ cat <<'EOF' | kubectl create -f -
apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  name: hello
spec:
  taskSpec:
    steps:
      - name: hello
        image: alpine
        command: ["echo", "hello"]
EOF

NOTE

Для изолированных (air-gapped) сред замените образ alpine на другой, доступный в вашей сети.

2. Дождитесь завершения выполнения задачи

$ kubectl get taskruns.tekton.dev -n default -w

hello                                        Unknown     Pending     3s
hello                                        True        Succeeded   11s         0s

3. Используйте CLI tkn-results для запроса результатов

Подготовка CLI

tkn — это инструмент командной строки для взаимодействия с Tekton. Вы можете скачать его с официальной страницы.

Вам нужно собрать tkn-results с помощью golang.

# 1. Клонируйте репозиторий
git clone https://github.com/tektoncd/results.git

# 2. Перейдите в каталог проекта
cd results

# 3. Соберите бинарный файл
go build -o tkn-results ./cmd/tkn-results/main.go

# 4. Скопируйте бинарный файл в директорию из PATH

Запрос списка записей выполнения

$ tkn results --insecure records list default/results/-

default/results/209dcb81-e3c0-47cd-b082-d910e15702ae/records/209dcb81-e3c0-47cd-b082-d910e15702ae  tekton.dev/v1.TaskRun                   2025-02-19 16:17:11 +0800 CST           2025-02-19 16:17:21 +0800 CST
default/results/209dcb81-e3c0-47cd-b082-d910e15702ae/records/a750035d-0479-34a1-9db2-9a256b53243f  results.tekton.dev/v1alpha3.Log         2025-02-19 16:17:21 +0800 CST           2025-02-19 16:17:21 +0800 CST

Запрос одной записи выполнения

$ tkn results --insecure records get -o textproto default/results/209dcb81-e3c0-47cd-b082-d910e15702ae/records/209dcb81-e3c0-47cd-b082-d910e15702ae

name: "default/results/209dcb81-e3c0-47cd-b082-d910e15702ae/records/209dcb81-e3c0-47cd-b082-d910e15702ae"
id: "0805bbd0-e390-40dc-a1ea-f65ae9401930"
uid: "0805bbd0-e390-40dc-a1ea-f65ae9401930"
data: {
  type: "tekton.dev/v1.TaskRun"
  value: "{\"kind\": \"TaskRun\", \"spec\": {\"timeout\": \"1h0m0s\", \"taskSpec\": {\"steps\": [{\"name\": \"hello\", \"image\": \"152-231-registry.alauda.cn:60070/ops/ubuntu:latest\", \"command\": [\"echo\", \"hello\"], \"computeResources\": {}}]}, \"serviceAccountName\": \"default\"}, \"status\": {\"steps\": [{\"name\": \"hello\", \"imageID\": \"alpine\", \"container\": \"step-hello\", \"terminated\": {\"reason\": \"Completed\", \"exitCode\": 0, \"startedAt\": \"2025-02-19T08:17:20Z\", \"finishedAt\": \"2025-02-19T08:17:20Z\", \"containerID\": \"containerd://5e2cb72ca758fc976744b06b5ee97564bcc0958ca9cee2a54fdaab64323a1bf9\"}, \"terminationReason\": \"Completed\"}], \"podName\": \"hello-pod\", \"taskSpec\": {\"steps\": [{\"name\": \"hello\", \"image\": \"152-231-registry.alauda.cn:60070/ops/ubuntu:latest\", \"command\": [\"echo\", \"hello\"], \"computeResources\": {}}]}, \"startTime\": \"2025-02-19T08:17:10Z\", \"conditions\": [{\"type\": \"Succeeded\", \"reason\": \"Succeeded\", \"status\": \"True\", \"message\": \"All Steps have completed executing\", \"lastTransitionTime\": \"2025-02-19T08:17:21Z\"}], \"provenance\": {\"featureFlags\": {\"Coschedule\": \"workspaces\", \"MaxResultSize\": 4096, \"EnableAPIFields\": \"beta\", \"EnableArtifacts\": false, \"EnableParamEnum\": false, \"DisableCredsInit\": false, \"EnableStepActions\": true, \"SetSecurityContext\": false, \"AwaitSidecarReadiness\": true, \"EnableKeepPodOnCancel\": false, \"EnableTektonOCIBundles\": false, \"ResultExtractionMethod\": \"termination-message\", \"SendCloudEventsForRuns\": false, \"DisableAffinityAssistant\": false, \"EnableProvenanceInStatus\": true, \"EnforceNonfalsifiability\": \"none\", \"EnableCELInWhenExpression\": false, \"VerificationNoMatchPolicy\": \"ignore\", \"ScopeWhenExpressionsToTask\": false, \"RequireGitSSHSecretKnownHosts\": false, \"RunningInEnvWithInjectedSidecars\": true}}, \"completionTime\": \"2025-02-19T08:17:21Z\"}, \"metadata\": {\"uid\": \"209dcb81-e3c0-47cd-b082-d910e15702ae\", \"name\": \"hello\", \"labels\": {\"app.kubernetes.io/managed-by\": \"tekton-pipelines\"}, \"namespace\": \"default\", \"finalizers\": [\"results.tekton.dev/taskrun\", \"chains.tekton.dev\"], \"generation\": 1, \"annotations\": {\"results.tekton.dev/log\": \"default/results/209dcb81-e3c0-47cd-b082-d910e15702ae/logs/a750035d-0479-34a1-9db2-9a256b53243f\", \"chains.tekton.dev/signed\": \"true\", \"results.tekton.dev/record\": \"default/results/209dcb81-e3c0-47cd-b082-d910e15702ae/records/209dcb81-e3c0-47cd-b082-d910e15702ae\", \"results.tekton.dev/result\": \"default/results/209dcb81-e3c0-47cd-b082-d910e15702ae\", \"pipeline.tekton.dev/release\": \"8bfd3273cbe7776847884d7fa5004481e6be8f4a\"}, \"managedFields\": [{\"time\": \"2025-02-19T08:17:10Z\", \"manager\": \"kubectl-create\", \"fieldsV1\": {\"f:spec\": {\".\": {}, \"f:taskSpec\": {\".\": {}, \"f:steps\": {}}}}, \"operation\": \"Update\", \"apiVersion\": \"tekton.dev/v1\", \"fieldsType\": \"FieldsV1\"}, {\"time\": \"2025-02-19T08:17:21Z\", \"manager\": \"controller\", \"fieldsV1\": {\"f:metadata\": {\"f:finalizers\": {\"v:\\\"chains.tekton.dev\\\"\": {}}, \"f:annotations\": {\"f:chains.tekton.dev/signed\": {}, \"f:pipeline.tekton.dev/release\": {}}}}, \"operation\": \"Update\", \"apiVersion\": \"tekton.dev/v1\", \"fieldsType\": \"FieldsV1\"}, {\"time\": \"2025-02-19T08:17:21Z\", \"manager\": \"controller\", \"fieldsV1\": {\"f:status\": {\".\": {}, \"f:steps\": {}, \"f:podName\": {}, \"f:taskSpec\": {\".\": {}, \"f:steps\": {}}, \"f:artifacts\": {}, \"f:startTime\": {}, \"f:conditions\": {}, \"f:provenance\": {\".\": {}, \"f:featureFlags\": {\".\": {}, \"f:Coschedule\": {}, \"f:MaxResultSize\": {}, \"f:EnableAPIFields\": {}, \"f:EnableArtifacts\": {}, \"f:EnableParamEnum\": {}, \"f:DisableCredsInit\": {}, \"f:DisableInlineSpec\": {}, \"f:EnableStepActions\": {}, \"f:SetSecurityContext\": {}, \"f:AwaitSidecarReadiness\": {}, \"f:EnableKeepPodOnCancel\": {}, \"f:ResultExtractionMethod\": {}, \"f:SendCloudEventsForRuns\": {}, \"f:EnableKubernetesSidecar\": {}, \"f:DisableAffinityAssistant\": {}, \"f:EnableProvenanceInStatus\": {}, \"f:EnforceNonfalsifiability\": {}, \"f:EnableCELInWhenExpression\": {}, \"f:VerificationNoMatchPolicy\": {}, \"f:EnableConciseResolverSyntax\": {}, \"f:RequireGitSSHSecretKnownHosts\": {}, \"f:RunningInEnvWithInjectedSidecars\": {}}}, \"f:completionTime\": {}}}, \"operation\": \"Update\", \"apiVersion\": \"tekton.dev/v1\", \"fieldsType\": \"FieldsV1\", \"subresource\": \"status\"}, {\"time\": \"2025-02-19T08:17:21Z\", \"manager\": \"watcher\", \"fieldsV1\": {\"f:metadata\": {\"f:finalizers\": {\".\": {}, \"v:\\\"results.tekton.dev/taskrun\\\"\": {}}, \"f:annotations\": {\".\": {}, \"f:results.tekton.dev/log\": {}, \"f:results.tekton.dev/record\": {}, \"f:results.tekton.dev/result\": {}}}}, \"operation\": \"Update\", \"apiVersion\": \"tekton.dev/v1\", \"fieldsType\": \"FieldsV1\"}], \"resourceVersion\": \"1592422\", \"creationTimestamp\": \"2025-02-19T08:17:10Z\"}, \"apiVersion\": \"tekton.dev/v1\"}"
}
etag: "0805bbd0-e390-40dc-a1ea-f65ae9401930-1739953041309658421"
created_time: {
  seconds: 1739953031
  nanos: 16922000
}
create_time: {
  seconds: 1739953031
  nanos: 16922000
}
updated_time: {
  seconds: 1739953041
  nanos: 309658000
}
update_time: {
  seconds: 1739953041
  nanos: 309658000
}

Запрос списка логов

$ tkn results --insecure logs list default/results/-

default/results/209dcb81-e3c0-47cd-b082-d910e15702ae/logs/a750035d-0479-34a1-9db2-9a256b53243f  results.tekton.dev/v1alpha3.Log         2025-02-19 16:17:21 +0800 CST           2025-02-19 16:17:21 +0800 CST

Запрос одного лога

$ tkn results --insecure logs get -o textproto default/results/209dcb81-e3c0-47cd-b082-d910e15702ae/logs/a750035d-0479-34a1-9db2-9a256b53243f

content_type: "text/plain"
data: "[prepare] 2025/02/19 08:17:12 Entrypoint initialization\n\n[hello] hello\n\n"

#Быстрый старт

#Содержание

#Установка Tekton Results

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

#Установка с использованием operator CRD

#Проверка работоспособности

#1. Создайте ресурс TaskRun

#2. Дождитесь завершения выполнения задачи

#3. Используйте CLI tkn-results для запроса результатов

#Подготовка CLI

#Запрос списка записей выполнения

#Запрос одной записи выполнения

#Запрос списка логов

#Запрос одного лога

#References