Рекомендации по пакету Helm

Helm — это менеджер пакетов для Kubernetes, который помогает упростить управление жизненным циклом приложений. Пакеты Helm называются диаграммами и состоят из файлов конфигурации и шаблонов YAML. После выполнения операции Helm диаграммы отображаются в файлах манифеста Kubernetes, чтобы активировать соответствующие действия жизненного цикла приложения. Для наиболее эффективной интеграции с Azure Operator Service Manager следуйте приведенным ниже рекомендациям при разработке диаграмм Helm.

Устаревшие требования для registryPath и imagePullSecrets

Диспетчер служб Azure использует службу Диспетчера сетевых функций Azure для развертывания контейнерных сетевых функций (CNFs). С помощью устаревшего метода Диспетчер сетевых функций Azure заменяет контейнер и значения контейнера registryPathimagePullSecrets Service Manager Оператора Azure в операцию Helm во время развертывания сетевых функций.

Пример устаревшего метода

В следующем шаблоне развертывания Helm показан пример того, как вы должны предоставлять registryPath и imagePullSecrets:

apiVersion: apps/v1 
kind: Deployment 
metadata: 
  name: nginx-deployment 
  labels: 
    app: nginx 
spec: 
  replicas: 3 
  selector: 
    matchLabels: 
      app: nginx 
  template: 
    metadata: 
      labels: 
        app: nginx 
    spec: 
      {{- if .Values.global.imagePullSecrets }} 
      imagePullSecrets: {{ toYaml .Values.global.imagePullSecrets | nindent 8 }} 
      {{- end }} 
      containers: 
      - name: contosoapp 
        image:{{ .Values.global.registryPath }}/contosoapp:1.14.2 
        ports: 
        - containerPort: 80

В следующем values.yaml шаблоне показан пример предоставления и registryPath значенийimagePullSecrets:

global: 
   imagePullSecrets: [] 
   registryPath: ""

В следующем values.schema.json файле показан пример определения и registryPath значенийimagePullSecrets:

{ 
  "$schema": "http://json-schema.org/draft-07/schema#", 
  "title": "StarterSchema", 
  "type": "object", 
  "required": ["global"], 
  "properties": { 
      "global" : {
          "type": "object",
          "properties": {
              "registryPath": {"type": "string"}, 
              "imagePullSecrets": {"type": "string"}, 
          }
          "required": [ "registryPath", "imagePullSecrets" ], 
      } 
   } 
}

В следующей версии определения сетевой функции (полезные данные запроса NFDV) показан пример того, как можно указать registryPath значения и imagePullSecrets значения при развертывании:

"registryValuesPaths": [ "global.registryPath" ], 
"imagePullSecretsValuesPaths": [ "global.imagePullSecrets" ],

В предыдущих примерах:

Значение registryPath задано без префикса, например https:// или oci://. При необходимости определите префикс в пакете Helm.
imagePullSecrets и registryPath должен быть предоставлен во время подключения NFDV.

Другие вопросы

При использовании устаревшего метода рассмотрите следующие рекомендации.

Избегайте ссылок на внешний реестр

Ссылки на внешний реестр могут вызвать проблемы с проверкой. Например, если deployment.yaml используется жестко закодированный путь к реестру или ссылки на внешний реестр, проверка завершается ошибкой.

Выполнение ручной проверки

Просмотрите спецификации образов и контейнеров, чтобы убедиться, что образы имеют префикс registryPath и imagePullSecrets заполнены следующим secretNameобразом:

 helm template --set "global.imagePullSecrets[0].name=<secretName>" --set "global.registry.url=<registryPath>" <release-name> <chart-name> --dry-run

Ниже приведен еще один пример:

 helm install --set "global.imagePullSecrets[0].name=<secretName>" --set "global.registry.url=<registryPath>" <release-name> <chart-name> --dry-run
 kubectl create secret <secretName> regcred --docker-server=<registryPath> --dockerusername=<regusername> --docker-password=<regpassword>

Использование репозитория статических образов и тегов

Каждая диаграмма Helm должна содержать репозиторий статических образов и теги. Статические значения задаются одним из следующих методов:

В строке image
Без values.yamlпредоставления этих значений в NFDV

NFDV должен сопоставляться со статическим набором диаграмм и изображений Helm. Вы обновляете диаграммы и изображения только путем публикации нового NFDV, как показано в следующих примерах:

 image: "{{ .Values.global.registryPath }}/contosoapp:1.14.2"

 image: "{{ .Values.global.registryPath }}/{{ .Values.image.repository }}:{{ .Values.image.tag}}"
 
YAML values.yaml
image:
  repository: contosoapp
  tag: 1.14.2

 image: http://myUrl/{{ .Values.image.repository }}:{{ .Values.image.tag}}

Требования injectArtifactStoreDetails для реестраPath и imagePullSecrets

В некоторых случаях сторонние диаграммы Helm могут не соответствовать требованиям Azure Operator Service Manager для registryPath. В этих случаях можно injectArtifactStoreDetails избежать внесения изменений в пакеты Helm.

С injectArtifactStoreDetails включенным методом веб-перехватчика используется для внедрения правильных registryPath и imagePullSecrets динамических операций pod. Этот метод переопределяет значения, настроенные в пакете Helm. Вы по-прежнему должны использовать юридические фиктивные значения, где registryPath и imagePullSecrets ссылаются, как правило, в global разделе values.yaml.

В следующем values.yaml примере показано, как предоставить registryPath и imagePullSecrets значения для совместимости с подходом injectArtifactStoreDetails :

global: 
   registryPath: "azure.io"
   imagePullSecrets: ["abc123"]

Примечание.

Если registryPath в базовом пакете Helm осталось пустым, развертывание сетевой службы сайта (SNS) завершается сбоем во время скачивания образа.

Использование метода injectArtifactStoreDetails

Чтобы включитьinjectArtifactStoreDetails, задайте installOptions параметр в разделе roleOverridesресурса true NF, как показано в следующем примере:

resource networkFunction 'Microsoft.HybridNetwork/networkFunctions@2023-09-01' = {
  name: nfName
  location: location
  properties: {
    nfviType: 'AzureArcKubernetes'
    networkFunctionDefinitionVersionResourceReference: {
      id: nfdvId
      idType: 'Open'
    }
    allowSoftwareUpdate: true
    nfviId: nfviId
    deploymentValues: deploymentValues
    configurationType: 'Open'
    roleOverrideValues: [
      // Use inject artifact store details feature on test app 1
      '{"name":"testapp1", "deployParametersMappingRuleProfile":{"helmMappingRuleProfile":{"options":{"installOptions":{"atomic":"false","wait":"false","timeout":"60","injectArtifactStoreDetails":"true"},"upgradeOptions": {"atomic": "false", "wait": "true", "timeout": "100", "injectArtifactStoreDetails": "true"}}}}}'
    ]
  }
}

Примечание.

Пакет диаграмм Helm по-прежнему должен предоставлять правильный формат registryPath и imagePullSecrets значения.

Требования к реестру кластера для registryPath и imagePullSecrets

В реестре кластеров образы копируются из реестра контейнеров Azure в локальный репозиторий Docker в кластере Nexus Kubernetes. Метод веб-перехватчика используется для динамического внедрения правильных registryPath значений и imagePullSecrets значений во время операций pod. Этот метод переопределяет значения, настроенные в пакете Helm. Вы по-прежнему должны использовать юридические фиктивные значения, где registryPath и imagePullSecrets ссылаются, как правило, в global разделе values.yaml.

В следующем values.yaml примере показано, как предоставить registryPath и imagePullSecrets значения для совместимости с подходом реестра кластера:

global: 
   registryPath: "azure.io"
   imagePullSecrets: ["abc123"]

Примечание.

Если registryPath в базовом пакете Helm осталось пустым, развертывание SNS завершается сбоем во время скачивания образа.

Дополнительные сведения об использовании реестра кластеров см. в документации по концепции.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-10-13

Рекомендации по пакету Helm

Рекомендации по registryPath и imagePullSecrets

Сводка по методам registryPath и imagePullSecrets

Устаревшие требования для registryPath и imagePullSecrets

Пример устаревшего метода

Другие вопросы

Избегайте ссылок на внешний реестр

Выполнение ручной проверки

Использование репозитория статических образов и тегов

Требования injectArtifactStoreDetails для реестраPath и imagePullSecrets

Использование метода injectArtifactStoreDetails

Требования к реестру кластера для registryPath и imagePullSecrets

Рекомендации по неизменяемости ограничений

Рекомендации по объявлению и использованию CRD

Рекомендации по тегам версии образа

Рекомендации по последовательному упорядочению nfApplication

Использование dependsOnProfile

Частые ошибки в работе с dependsOnProfile

Обратная связь

Дополнительные ресурсы