werf
  • Быстрый старт
  • Документация
  • Самоучитель по Kubernetes
  • О проекте
    • Публикации
    • Каналы обновлений
    • История изменений
  • Russian
    • English
    • Russian
✕
Присоединяйтесь к англоязычному сообществу в Slack CNCF
Шаг 1:
Получить приглашение в Slack CNCF
Шаг 2:
Войти в канал #werf
Мы выбрали Slack от CNCF, т.к. там зарегистрировано самое большое количество Kubernetes-энтузиастов.
  1. v2
  2. Справочник
  3. werf.yaml
Версия: 2
  • latest
  • 2-rock-solid 2.16.1+fix1
  • 2-stable 2.16.1+fix1
  • 2-ea 2.16.2
  • 2-beta 2.16.3
  • 2-alpha 2.17.0
  • 1.2-rock-solid 1.2.330
  • 1.2-stable 1.2.333
  • 1.2-ea 1.2.333
  • 1.2-beta 1.2.333
  • 1.2-alpha 1.2.333
  • 1.1-rock-solid 1.1.36
  • 1.1-stable 1.1.36
  • 1.1-ea 1.1.36
  • 1.1-beta 1.1.36
  • 1.1-alpha 1.1.36
  • Быстрый старт
  • Использование
    • Конфигурация проекта
      • Обзор
      • Гитерминизм
    • Сборка
      • Обзор
      • Образы и зависимости
      • Конфигурация образов Stapel
        • Обзор
        • Базовый образ
        • Добавление исходного кода из git-репозиториев
        • Пользовательские инструкции
        • Импортирование из образов
        • Инструкции Dockerfile
        • Ускорение сборки и уменьшение размера за счёт монтирования
      • Сборочный процесс
    • Развертывание
      • Обзор
      • Чарты и зависимости
      • Шаблоны
      • Параметризация шаблонов
      • Разные окружения
      • Порядок развертывания
      • Планирование
      • Сценарии развертывания
      • Отслеживание ресурсов
      • Управление релизами
    • Дистрибуция
      • Обзор
      • Образы
      • Бандлы и чарты
    • Очистка
      • Очистка container registry
      • Автоматическая очистка хоста
    • Интеграция с CI/CD-системами
  • Справочник
    • werf.yaml
    • Шаблонизатор werf.yaml
    • werf-giterminism.yaml
    • Аннотации для деплоя
    • Интерфейс командной строки
      • Overview of command groups
      • Delivery commands
        • werf converge
        • werf plan
        • werf dismiss
        • werf bundle
          • werf bundle apply
          • werf bundle copy
          • werf bundle publish
          • werf bundle render
      • Cleaning commands
        • werf cleanup
        • werf purge
      • Helper commands
        • werf ci-env
        • werf build
        • werf export
        • werf run
        • werf kube-run
        • werf compose
          • werf compose config
          • werf compose down
          • werf compose run
          • werf compose up
        • werf slugify
        • werf render
      • Low-level management commands
        • werf config
          • werf config graph
          • werf config list
          • werf config render
        • werf managed-images
          • werf managed-images add
          • werf managed-images ls
          • werf managed-images rm
        • werf host
          • werf host cleanup
          • werf host purge
        • werf helm
          • werf helm create
          • werf helm dependency
            • werf helm dependency build
            • werf helm dependency list
            • werf helm dependency update
          • werf helm env
          • werf helm get
            • werf helm get all
            • werf helm get hooks
            • werf helm get manifest
            • werf helm get metadata
            • werf helm get notes
            • werf helm get values
          • werf helm get-autogenerated-values
          • werf helm get-namespace
          • werf helm get-release
          • werf helm history
          • werf helm install
          • werf helm lint
          • werf helm list
          • werf helm package
          • werf helm plugin
            • werf helm plugin install
            • werf helm plugin list
            • werf helm plugin uninstall
            • werf helm plugin update
          • werf helm pull
          • werf helm registry
            • werf helm registry login
            • werf helm registry logout
          • werf helm repo
            • werf helm repo add
            • werf helm repo index
            • werf helm repo list
            • werf helm repo remove
            • werf helm repo update
          • werf helm rollback
          • werf helm search
            • werf helm search hub
            • werf helm search repo
          • werf helm secret
            • werf helm secret decrypt
            • werf helm secret encrypt
            • werf helm secret file
              • werf helm secret file decrypt
              • werf helm secret file edit
              • werf helm secret file encrypt
            • werf helm secret generate-secret-key
            • werf helm secret rotate-secret-key
            • werf helm secret values
              • werf helm secret values decrypt
              • werf helm secret values edit
              • werf helm secret values encrypt
          • werf helm show
            • werf helm show all
            • werf helm show chart
            • werf helm show crds
            • werf helm show readme
            • werf helm show values
          • werf helm status
          • werf helm template
          • werf helm test
          • werf helm uninstall
          • werf helm upgrade
          • werf helm verify
          • werf helm version
        • werf cr
          • werf cr login
          • werf cr logout
        • werf kubectl
          • werf kubectl alpha
          • werf kubectl annotate
          • werf kubectl api-resources
          • werf kubectl api-versions
          • werf kubectl apply
            • werf kubectl apply edit-last-applied
            • werf kubectl apply set-last-applied
            • werf kubectl apply view-last-applied
          • werf kubectl attach
          • werf kubectl auth
            • werf kubectl auth can-i
            • werf kubectl auth reconcile
            • werf kubectl auth whoami
          • werf kubectl autoscale
          • werf kubectl certificate
            • werf kubectl certificate approve
            • werf kubectl certificate deny
          • werf kubectl cluster-info
            • werf kubectl cluster-info dump
          • werf kubectl completion
          • werf kubectl config
            • werf kubectl config current-context
            • werf kubectl config delete-cluster
            • werf kubectl config delete-context
            • werf kubectl config delete-user
            • werf kubectl config get-clusters
            • werf kubectl config get-contexts
            • werf kubectl config get-users
            • werf kubectl config rename-context
            • werf kubectl config set
            • werf kubectl config set-cluster
            • werf kubectl config set-context
            • werf kubectl config set-credentials
            • werf kubectl config unset
            • werf kubectl config use-context
            • werf kubectl config view
          • werf kubectl cordon
          • werf kubectl cp
          • werf kubectl create
            • werf kubectl create clusterrole
            • werf kubectl create clusterrolebinding
            • werf kubectl create configmap
            • werf kubectl create cronjob
            • werf kubectl create deployment
            • werf kubectl create ingress
            • werf kubectl create job
            • werf kubectl create namespace
            • werf kubectl create poddisruptionbudget
            • werf kubectl create priorityclass
            • werf kubectl create quota
            • werf kubectl create role
            • werf kubectl create rolebinding
            • werf kubectl create secret
              • werf kubectl create secret docker-registry
              • werf kubectl create secret generic
              • werf kubectl create secret tls
            • werf kubectl create service
              • werf kubectl create service clusterip
              • werf kubectl create service externalname
              • werf kubectl create service loadbalancer
              • werf kubectl create service nodeport
            • werf kubectl create serviceaccount
            • werf kubectl create token
          • werf kubectl debug
          • werf kubectl delete
          • werf kubectl describe
          • werf kubectl diff
          • werf kubectl drain
          • werf kubectl edit
          • werf kubectl events
          • werf kubectl exec
          • werf kubectl explain
          • werf kubectl expose
          • werf kubectl get
          • werf kubectl kustomize
          • werf kubectl label
          • werf kubectl logs
          • werf kubectl options
          • werf kubectl patch
          • werf kubectl plugin
            • werf kubectl plugin list
          • werf kubectl port-forward
          • werf kubectl proxy
          • werf kubectl replace
          • werf kubectl rollout
            • werf kubectl rollout history
            • werf kubectl rollout pause
            • werf kubectl rollout restart
            • werf kubectl rollout resume
            • werf kubectl rollout status
            • werf kubectl rollout undo
          • werf kubectl run
          • werf kubectl scale
          • werf kubectl set
            • werf kubectl set env
            • werf kubectl set image
            • werf kubectl set resources
            • werf kubectl set selector
            • werf kubectl set serviceaccount
            • werf kubectl set subject
          • werf kubectl taint
          • werf kubectl top
            • werf kubectl top node
            • werf kubectl top pod
          • werf kubectl uncordon
          • werf kubectl version
          • werf kubectl wait
      • Other commands
        • werf synchronization
        • werf completion
        • werf version
  • Ресурсы
    • Шпаргалка
    • Миграция с v1.2 на v2.0
    • Сравнение с другими решениями
    • Телеметрия
Source

werf.yaml

0 --- # Секция мета-информации
...
1 project: string ! # Уникальное имя проекта приложения
2 configVersion: int ! # Версия конфигурации. На данный момент поддерживается единственная версия 1
3 build: # Общие настройки сборки
...
4   platform: [ string, ... ] # Общий список целевых платформ для всех образов (например ['linux/amd64', 'linux/arm64', 'linux/arm/v8'])
5 deploy: # Настройки выката
...
6   helmChartDir: string # Путь до директории helm чарта проекта (значение по умолчанию .helm)
7   helmChartConfig: # Переопределить конфигурацию в Chart.yaml
...
8     appVersion: string # Переопределить appVersion в Chart.yaml (значение по умолчанию )
9   helmRelease: string # Шаблон имени релиза (значение по умолчанию [[ project ]]-[[ env ]])
10   helmReleaseSlug: bool # Слагификация имени релиза (значение по умолчанию true)
11   namespace: string # Шаблон Kubernetes namespace (значение по умолчанию [[ project ]]-[[ env ]])
12   namespaceSlug: bool # Слагификация Kubernetes namespace (значение по умолчанию true)
13 cleanup: # Настройка удаления неактульных образов
...
14   disableKubernetesBasedPolicy: bool # Отключить политику очистки, которая позволяет не удалять запущенные в Kubernetes образы из container registry
15   disableGitHistoryBasedPolicy: bool # Отключить политику очистки, которая позволяет не удалять образы с учётом пользовательских политик по истории Git (keepPolicies)
16   disableBuiltWithinLastNHoursPolicy: bool # Отключить политику очистки, которая позволяет не удалять образы, собранные в рамках заданного периода времени (keepImagesBuiltWithinLastNHours)
17   keepImagesBuiltWithinLastNHours: uint # Минимальное количество часов, которое должно пройти с момента сборки образа (значение по умолчанию 2)
18   keepPolicies: # Набор политик для выборки актуальных образов, используя историю Git
19   - references: # Набор references, который будет использоваться при сканировании
20       branch: string || /REGEXP/ # Множество git origin веток
21       tag: string || /REGEXP/ # Множество git origin тегов
22       limit: # Набор правил, по которым можно ограничить описанное множество references, основываясь на времени создания git-тега или активности в git-ветке
23         last: int # Выборка последних n references из определённого в branch/tag множества (значение по умолчанию -1)
24         in: duration string # Выборка git-тегов, которые были созданы в указанный период, или git-веток с активностью в рамках периода. Также для определённого множества branch/tag
25         operator: And || Or # Определяет какие references будут результатом политики, те которые удовлетворяют оба условия или любое из них (значение по умолчанию And)
26     imagesPerReference: # Лимит искомых образов для каждого reference из множества
27       last: int # Количество искомых образов для каждого reference (значение по умолчанию -1)
28       in: duration string # Период, в рамках которого необходимо выполнять поиск образов
29 gitWorktree: # Настройки связанные с работой werf с рабочей директорией git проекта
...
30   forceShallowClone: bool # Принудительно позволить werf использовать shallow clone несмотря на ограничения данного подхода
31   allowUnshallow: bool # Разрешить процессу werf автоматически преобразовать shallow clone проекта в полный clone в процессе сборки по необходимости (значение по умолчанию true)
32   allowFetchOriginBranchesAndTags: bool # Разрешить процессу werf автоматически скачать новые ветки и теги из origin в процессе cleanup по необходимости (значение по умолчанию true)
33 --- # Секция Dockerfile image: может использоваться произвольное количество секций
...
34 image: string || [ string, ... ] ! # Одно или несколько уникальных имён для образа
35 final: bool # Пометить образ как финальный (значение по умолчанию true). Подробнее здесь
36 dockerfile: string ! # Путь к Dockerfile относительно директории контекста
37 staged: bool # Включить послойное кеширование Dockerfile-инструкций в container registry
38 context: string # Путь к контексту внутри папки проекта
39 platform: [ string, ... ] # Список целевых платформ для данного образа (например ['linux/amd64', 'linux/arm64', 'linux/arm/v8'])
40 contextAddFiles: [ string, ... ] # Добавление нехранящихся в git файлов и директорий в сборочный контекст. Пути должны быть относительно директории контекста
41 target: string # Конкретная стадия Dockerfile (по умолчанию — последняя, подобно docker build --target)
42 args: { name string: value string, ... } # Переменные для ARG Dockerfile-инструкций (подобно docker build --build-arg)
43 addHost: [ string, ... ] # Установить связь host-to-IP (host:ip) (подобно docker build --add-host)
44 network: string # Сетевой режим для инструкций RUN во время сборки (подобно docker build --network)
45 ssh: string # Сокет агента SSH или ключи для сборки (подобно docker build --ssh) (DEPRECATED). Подробнее здесь
46 secrets: # Секреты, используемые при сборке образа. В одном экземпляре можно использовать только одну из следующих опций: env, src или value. Подробнее здесь
47 - id: string # Уникальный идентификатор секрета (обязателен только для секретов типа value)
48   env: string # Секрет из переменной окружения
49   src: string # Секрет из файла по указанному пути
50   value: string # Произвольное строковое значение
51 dependencies: # Образы-зависимости для текущего образа
...
52 - image: string # Имя зависимого образа, который должен быть собран до сборки текущего образа
53   imports: # Определить аргументы для импорта информации о зависимом образе в текущий образ используя Dockerfile build-args (опционально)
54   - type: string # Тип импортируемой информации об образе: ImageName, ImageDigest, ImageRepo или ImageTag
55     targetBuildArg: string # Имя аргумента (Dockerfile build-args), который будет содержать указанный тип информации об образе
56 --- # Секция Stapel image: может использоваться произвольное количество секций
...
57 image: string || [ string, ... ] ! # Одно или несколько уникальных имён для образа
58 artifact: string # Уникальное имя артефакта (DEPRECATED). Подробнее здесь
59 final: bool # Пометить образ как финальный (значение по умолчанию true). Подробнее здесь
60 platform: [ string, ... ] # Список целевых платформ для данного образа (например ['linux/amd64', 'linux/arm64', 'linux/arm/v8'])
61 from: string # Имя и тег базового образа. Подробнее здесь
62 fromLatest: bool # Использование актуального базового образа (без кеширования). Подробнее здесь
63 fromImage: string # Использование образа из werf.yaml в качестве базового. Подробнее здесь
64 fromArtifact: string # Использование образа артефакта из werf.yaml в качестве базового (DEPRECATED)
65 fromCacheVersion: string # Версия кеша. Подробнее здесь
66 disableGitAfterPatch: bool # Отключение актуализации исходников Git (стадии gitCache, gitLatestPatch). Подробнее здесь
67 git: # Набор директив для добавления исходных файлов из git-репозиториев (как репозитория проекта, так и любого другого). Подробнее здесь
...
68 - url: string # Адрес git-репозитория. Подробнее здесь
69   branch: string # Имя ветки. Подробнее здесь
70   commit: string # Коммит
71   tag: string # Имя тега
72   add: string # Исходный путь в репозитории. Подробнее здесь
73   to: string # Путь назначения в образе. Подробнее здесь
74   owner: string # Имя или UID владельца. Подробнее здесь
75   group: string # Имя или GID группы. Подробнее здесь
76   includePaths: [ glob, ... ] # Глобы добавления. Подробнее здесь
77   excludePaths: [ glob, ... ] # Глобы исключения. Подробнее здесь
78   stageDependencies: # Настройка перевыполнения сборочных инструкций при изменениях определённых файлов в репозитории. Подробнее здесь
79     install: [ glob, ... ] # Глобы стадии install
80     beforeSetup: [ glob, ... ] # Глобы стадии beforeSetup
81     setup: [ glob, ... ] # Глобы стадии setup
82 secrets: # Секреты, используемые при сборке образа. В одном экземпляре можно использовать только одну из следующих опций: env, src или value. Подробнее здесь
83 - id: string # Уникальный идентификатор секрета (обязателен только для секретов типа value)
84   env: string # Секрет из переменной окружения
85   src: string # Секрет из файла по указанному пути
86   value: string # Произвольное строковое значение
87 shell: # Shell сборочные инструкции. Подробнее здесь
...
88   beforeInstall: [ string, ... ] # Команды для стадии beforeInstall. Подробнее здесь
89   install: [ string, ... ] # Команды для стадии install. Подробнее здесь
90   beforeSetup: [ string, ... ] # Команды для стадии beforeSetup. Подробнее здесь
91   setup: [ string, ... ] # Команды для стадии setup. Подробнее здесь
92   cacheVersion: string # Общая версия кеша. Подробнее здесь
93   beforeInstallCacheVersion: string # Версия кеша для стадии beforeInstall. Подробнее здесь
94   installCacheVersion: string # Версия кеша для стадии install. Подробнее здесь
95   beforeSetupCacheVersion: string # Версия кеша для стадии beforeSetup. Подробнее здесь
96   setupCacheVersion: string # Версия кеша для стадии setup. Подробнее здесь
97 ansible: # Ansible сборочные инструкции. Подробнее здесь
...
98   beforeInstall: [ task, ... ] # Задания для стадии beforeInstall. Подробнее здесь
99   install: [ task, ... ] # Задания для стадии install. Подробнее здесь
100   beforeSetup: [ task, ... ] # Задания для стадии beforeSetup. Подробнее здесь
101   setup: [ task, ... ] # Задания для стадии setup. Подробнее здесь
102   cacheVersion: string # Общая версия кеша. Подробнее здесь
103   beforeInstallCacheVersion: string # Версия кеша для стадии beforeInstall. Подробнее здесь
104   installCacheVersion: string # Версия кеша для стадии install. Подробнее здесь
105   beforeSetupCacheVersion: string # Версия кеша для стадии beforeSetup. Подробнее здесь
106   setupCacheVersion: string # Версия кеша для стадии setup. Подробнее здесь
107 docker: # Набор директив для изменения манифеста образа. Подробнее здесь
...
108   exactValues: bool # Включить использование незаэкранированных символов (например кавычки и пробелы) в значениях опций. Опция имеет действие только при использовании docker-server backend, и не влияет на работу buildah backend.
109   USER: string # Имя пользователя (или UID) и опционально пользовательская группа (или GID). Подробнее здесь
110   WORKDIR: string # Рабочая директория. Подробнее здесь
111   VOLUME: [ string, ... ] # Точки монтирования. Подробнее здесь
112   ENV: { name string: value string, ... } # Переменные окружения. Подробнее здесь
113   LABEL: { name string: value string, ... } # Метаданные. Подробнее здесь
114   EXPOSE: [ string, ... ] # Описание сетевых портов, которые будут прослушиваться в запущенном контейнере. Подробнее здесь
115   ENTRYPOINT: string | [ string, ... ] # Команда по умолчанию, которая будет выполнена при запуске контейнера (форма записи shell или exec). Подробнее здесь
116   CMD: string | [ string, ... ] # Аргументы по умолчанию для ENTRYPOINT (форма записи shell или exec). Подробнее здесь
117   HEALTHCHECK: string # Инструкции, которые Docker может использовать для проверки работоспособности запущенного контейнера. Подробнее здесь
118 mount: # Точки монтирования. Подробнее здесь
...
119 - from: tmp_dir || build_dir # Имя служебной директории
120   fromPath: string # Абсолютный или относительный путь до произвольного файла на хосте
121   to: string # Абсолютный путь в образе
122 import: # Импортирование из образов. Подробнее здесь
...
123 - artifact: string # Имя артефакта, из которого выполнять копирование файлов (DEPRECATED)
124   image: string # Имя образа, из которого выполнять копирование файлов
125   stage: string # Имя стадии, из которой выполнять копирование файлов (по умолчанию последняя)
126   before: string # Выбор стадии импортирования файлов при сборке, до стадии install или setup
127   after: string # Выбор стадии импортирования файлов при сборке, после стадии install или setup
128   add: string # Абсолютный путь до файла или директории в выбранном образе
129   to: string # Абсолютный путь в конечном образе. По умолчанию соответствует пути add
130   owner: string # Имя или UID владельца
131   group: string # Имя или GID группы
132   includePaths: [ glob, ... ] # Глобы добавления
133   excludePaths: [ glob, ... ] # Глобы исключения
134 dependencies: # Образы-зависимости для текущего образа
...
135 - image: string # Имя зависимого образа, который должен быть собран до сборки текущего образа
136   before: string # Выбор стадии перед которой должна быть импортирована информация об образе (требуется указать install или setup). Указанные переменные окружения будут доступны в пользовательских стадиях после указанной данной директивой стадии.
137   after: string # Выбор стадии после которой должна быть импортирована информация об образе (требуется указать install или setup). Указанные переменные окружения будут доступны в пользовательских стадиях после указанной данной директивой стадии.
138   imports: # Определить аргументы для импорта информации о зависимом образе в текущий образ используя переменные окружения (опционально)
139   - type: string # Тип импортируемой информации об образе: ImageName, ImageDigest, ImageRepo или ImageTag
140     targetEnv: string # Имя переменной окружения, которая будет содержать указанный тип информации об образе
cncf logo
werf — проект категории sandbox в Cloud Native Computing Foundation
flant logo
Проект werf был изначально создан в компании «Флант»
У The Linux Foundation® (TLF) есть зарегистрированные товарные знаки и организация использует их. Список товарных знаков TLF см. в Trademark Usage.
Дата генерации сайта: 18.12.2024, 19:52 +0300