IKuznetsov: Новая страница: «Распространение меток сборки позволяет передавать метаданные сборки и версии внедренн...»

2025-12-03T17:26:05Z

Новая страница: «Распространение меток сборки позволяет передавать метаданные сборки и версии внедренн...»

Новая страница

Распространение меток сборки позволяет передавать метаданные сборки и версии внедренному ЕдиномуАгенту для вновь развёрнутых подов. Эта информация затем отображается в разделе «'''Свойства и теги'''» на страницах объектов.

== Как это работает ==
Вы можете ссылаться на [https://kubernetes.io/docs/tasks/inject-data-application/environment-variable-expose-pod-information/#use-pod-fields-as-values-for-environment-variables значение поля метаданных в переменной среды].
{| class="wikitable"
|env:

- name: MY_POD_NAMESPACE

valueFrom:

fieldRef:

fieldPath: metadata.namespace
|}
Затем ЕдиныйАгент внедряется во вновь развернутые поды и собирает метаданные, предоставленные через переменные среды.

== Включение распространения меток сборки ==
Чтобы включить распространение меток сборки, необходимо установить для <code>feature.astromkey.com/label-version-detection</code> значение <code>true</code> в '''DynaKube'''. Обратите внимание: поскольку для включения распространения меток сборки требуется внедрение веб-перехватчика, это работает только с развёртываниями <code>applicationMonitoring</code> и .<code>cloudNativeFullStack</code>
{| class="wikitable"
|apiVersion: astromkey.com/v1beta5

kind: DynaKube

metadata:

name: dynakube

namespace: astromkey

annotations:

feature.astromkey.com/label-version-detection: "true"

...

spec:

oneAgent:

cloudNativeFullStack: {}
|}

== Действия по умолчанию ==

* Переменная окружения <code>DT_RELEASE_VERSION</code> получает значение из <code>metadata.labels['app.kubernetes.io/version']</code>.
* Переменная окружения <code>DT_RELEASE_PRODUCT</code> получает значение из <code>metadata.labels['app.kubernetes.io/part-of']</code>.

Например, если в вашем приложении есть следующий под:
{| class="wikitable"
|apiVersion: v1

kind: Pod

metadata:

...

labels:

app.kubernetes.io/version: "1.0.0"

app.kubernetes.io/part-of: "store"

spec:

...
|}
значение меток добавляется к переменным окружения внедренных контейнеров:
{| class="wikitable"
|apiVersion: v1

kind: Pod

metadata:

...

labels:

app.kubernetes.io/version: "1.0.0"

app.kubernetes.io/part-of: "Store"

spec:

...

containers:

- name: app

...

env:

- name: "DT_RELEASE_VERSION"

valueFrom:

fieldRef:

fieldPath: metadata.labels['app.kubernetes.io/version']

- name: "DT_RELEASE_PRODUCT"

valueFrom:

fieldRef:

fieldPath: metadata.labels['app.kubernetes.io/part-of']
|}
Если переменные среды <code>DT_RELEASE_VERSION</code> или <code>DT_RELEASE_PRODUCT</code> уже установлены в контейнере до внедрения ЕдиногоАгента, они не будут перезаписаны.

== Параметры конфигурации ==
Вы можете аннотировать свое пространство имен, чтобы предоставить дополнительные сопоставления или переопределить значения по умолчанию для подов в этом пространстве имен.

* Каждый ключ аннотации сопоставляется с определенной переменной среды.
* Каждое значение аннотации — это справочный путь в <code>fieldPath</code>.
* Доступная информация для <code>fieldPath</code> та же самая, что и для <code>[https://kubernetes.io/docs/concepts/workloads/pods/downward-api/#downwardapi-fieldRef fieldRef]</code>.

Пример перезаписи значений по умолчанию для <code>version</code> и <code>product</code>, а также включения <code>stage</code> и <code>build-version</code>:
{| class="wikitable"
|annotations:

mapping.release.astromkey.com/version: "metadata.annotations['my-version']"

mapping.release.astromkey.com/product: "metadata.labels['app.kubernetes.io/name']"

mapping.release.astromkey.com/stage: "metadata.namespace"

mapping.release.astromkey.com/build-version: "metadata.labels['release.astromkey.com/stage']"
|}
Каждая из этих аннотаций настраивает отдельную переменную среды:
{| class="wikitable"
|<code>mapping.release.astromkey.com/version</code>
|Содержит <code>fieldPath</code> используемый для <code>DT_RELEASE_VERSION</code>.

Если эта аннотация отсутствует, сопоставление возвращается к действию по умолчанию .
|-
|<code>mapping.release.astromkey.com/product</code>
|Содержит <code>fieldPath</code> используемый для <code>DT_RELEASE_PRODUCT</code>.

Если эта аннотация отсутствует, сопоставление возвращается к действию по умолчанию.
|-
|<code>mapping.release.astromkey.com/stage</code>
|Содержит <code>fieldPath</code> используемый для <code>DT_RELEASE_STAGE</code>.
|-
|<code>mapping.release.astromkey.com/build-version</code>
|Содержит <code>fieldPath</code> используемый для <code>DT_RELEASE_BUILD_VERSION</code>.
|}
Значения не проверяются Ключ-АСТРОМ Operator или веб-перехватчиком, поэтому убедитесь, что они действительны.

Настройка распространения меток сборки - История изменений

IKuznetsov: Новая страница: «Распространение меток сборки позволяет передавать метаданные сборки и версии внедренн...»