CostManagement Docs
  • Русский

    • Установка

    В этой статье будет рассмотрено, как установить компоненты, необходимые для учета и выставления счетов.

    Содержание

    Предварительные требованияУстановка плагина Cost Management Server через консольПредварительные требованияПроцедураУстановка плагина Cost Management Server через YAMLПредварительные требованияПроцедураУстановка плагина Cost Management Essentials через консольПредварительные требованияПроцедураУстановка плагина Cost Management Essentials через YAMLПредварительные требованияУстановка плагина Cost Management Agent через консольПредварительные требованияПроцедураУстановка плагина Cost Management Agent через YAMLПредварительные требованияПроцедура

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

    • Скачайте последнюю версию плагина Cost Management с Custom Portal и загрузите его на платформу через violet.

    • Cost Management Server, Cost Management Essentials и Cost Management Agent работают совместно, обеспечивая общую функциональность учета и выставления счетов на платформе. Серверный компонент поддерживает возможности хранения данных, связанных с учетом и выставлением счетов, а клиентский компонент отвечает за сбор данных и функции выставления счетов.

    • Cost Management Server поддерживает развертывание в любом кластере, но платформа в настоящее время поддерживает развертывание только одного сервера. Не развертывайте несколько серверов, так как это может привести к аномальным проблемам, таким как дублирование данных.

    • Компонент Cost Management Server использует ClickHouse в качестве решения для хранения данных. Вы можете либо установить плагин ACP Log Storage with Clickhouse, предоставляемый платформой, либо самостоятельно установить ClickHouse для интеграции.

    • Cost Management Essentials должен интегрироваться с компонентом Cost Management Server.

    • Компонент Cost Management Agent требует, чтобы в соответствующем кластере был установлен компонент мониторинга ACP Monitor with Prometheus. Пожалуйста, убедитесь, что этот компонент успешно установлен заранее.

    Установка плагина Cost Management Server через консоль

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

    • Компонент Cost Management Server Plugin использует ClickHouse в качестве решения для хранения данных. Вы можете либо установить плагин ACP Log Storage with Clickhouse, предоставляемый платформой, либо самостоятельно установить ClickHouse для интеграции.

    Процедура

    1. Войдите в кластер, где установлен плагин ACP Log Storage with Clickhouse, и получите информацию для интеграции с ClickHouse:

      # Получить адрес подключения Clickhouse
kubectl get feature log-center -o jsonpath='{.spec.accessInfo.clickhouse.address}'

# Получить имя пользователя и пароль Clickhouse:
kubectl get secret -n cpaas-system clickhouse-basic-auth -o jsonpath={.data.username}|base64 -d
kubectl get secret -n cpaas-system clickhouse-basic-auth -o jsonpath={.data.password}|base64 -d

    2. В левой навигационной панели нажмите Marketing Place > Plugin Management.

    3. Выберите кластер, в который планируете установить плагин.

    4. Найдите плагин Cost Management Server и нажмите кнопку Install в правой панели действий.

    5. Настройте соответствующие параметры согласно следующему описанию.

      ПараметрОписание
      Clickhouse AddressУкажите адрес подключения к Clickhouse
      Clickhouse Cluster NameИмя кластера Clickhouse; по умолчанию для Clickhouse, созданного платформой, — replicated.
      Clickhouse Secret NameУкажите Secret с именем пользователя и паролем Clickhouse
      Currency UnitВыберите валюту для отображения расходов

    6. Нажмите Install.

    Установка плагина Cost Management Server через YAML

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

    • Компонент Cost Management Server Plugin использует ClickHouse в качестве решения для хранения данных. Вы можете либо установить плагин ACP Log Storage with Clickhouse, предоставляемый платформой, либо самостоятельно установить ClickHouse для интеграции.

    Процедура

    1. Проверьте доступные версии

      Убедитесь, что плагин опубликован, проверив наличие ресурсов ModulePlugin и ModuleConfig в кластере global:

      # kubectl get moduleplugin | grep cost-server
cost-server                       30h
# kubectl get moduleconfig | grep cost-server
cost-server-v4.1.0                30h

      Это означает, что ModulePlugin cost-server существует в кластере, и версия v4.1.0 опубликована.

    2. Создайте ModuleInfo

      Создайте ресурс ModuleInfo для установки плагина без параметров конфигурации:

      kind: ModuleInfo
apiVersion: cluster.alauda.io/v1alpha1
metadata:
  name: global-cost-server
  labels:
    cpaas.io/cluster-name: global
    cpaas.io/module-name: cost-server
    cpaas.io/module-type: plugin
spec:
  version: v4.1.0
  config:
    global:
      clickhouse:
        address: https://xxx.xxx.xxx.xxx:xx/clickhouse
        authSecret: clickhouse-basic-auth
        cluster: replicated
      currency: CNY(¥)

      Справка по полям YAML (cost-server):

      Путь поляОписание
      metadata.labels.cpaas.io/cluster-nameИмя целевого кластера, в котором установлен плагин.
      metadata.labels.cpaas.io/module-nameДолжно быть cost-server.
      metadata.labels.cpaas.io/module-typeДолжно быть plugin.
      metadata.nameИмя ModuleInfo (например, <cluster>-cost-server).
      spec.versionВерсия плагина для установки.
      spec.config.global.clickhouse.addressАдрес подключения к Clickhouse.
      spec.config.global.clickhouse.authSecretSecret с именем пользователя и паролем Clickhouse.
      spec.config.global.clickhouse.clusterИмя кластера Clickhouse; по умолчанию для Clickhouse, созданного платформой, — replicated.
      spec.config.global.currencyВалюта для отображения расходов. Поддерживаются: CNY(¥)/USD($)/THB(฿)/RUB(₽)/AUD(AU$)/CAD(CA$)/CHF(Fr.)/DKK(kr.)/EUR(€)/GBP(£)/IDR(Rp)/INR(₹)/JPY(JP¥)/HKD(HK)/SGD(SG$)

    3. Проверьте установку

      Поскольку имя ModuleInfo меняется при создании, найдите ресурс по метке, чтобы проверить статус и версию плагина:

      kubectl get moduleinfo -l cpaas.io/module-name=cost-server
NAME                                             CLUSTER         MODULE            DISPLAY_NAME     STATUS    TARGET_VERSION   CURRENT_VERSION   NEW_VERSION
global-e671599464a5b1717732c5ba36079795          global          cost-server       cost-server      Running   v4.1.0           v4.1.0            v4.1.0

      Объяснение полей:

      • NAME: имя ресурса ModuleInfo
      • CLUSTER: кластер, в котором установлен плагин
      • MODULE: имя плагина
      • DISPLAY_NAME: отображаемое имя плагина
      • STATUS: статус установки; Running означает успешную установку и работу
      • TARGET_VERSION: версия, предназначенная для установки
      • CURRENT_VERSION: версия до установки
      • NEW_VERSION: последняя доступная версия для установки

    Установка плагина Cost Management Essentials через консоль

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

    • Плагин Cost Management Essentials должен интегрироваться с компонентом Cost Management Server. Поэтому сначала необходимо установить плагин Cost Management Server.

    Процедура

    1. В левой навигационной панели нажмите Marketing Place > Plugin Management.

    2. Выберите кластер global.

    3. Найдите плагин Cost Management Server и нажмите кнопку Install в правой панели действий.

    4. Выберите имя кластера, в котором установлен плагин Cost Management Server.

    5. Нажмите Install.

    Установка плагина Cost Management Essentials через YAML

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

    • Плагин Cost Management Essentials должен интегрироваться с компонентом Cost Management Server. Поэтому сначала необходимо установить плагин Cost Management Server.

    1. Проверьте доступные версии

      Убедитесь, что плагин опубликован, проверив наличие ресурсов ModulePlugin и ModuleConfig в кластере global:

      # kubectl get moduleplugin | grep cost-api
cost-api                       30h
# kubectl get moduleconfig | grep cost-api
cost-api-v4.1.0                30h

      Это означает, что ModulePlugin cost-api существует в кластере, и версия v4.1.0 опубликована.

    2. Создайте ModuleInfo

      Создайте ресурс ModuleInfo для установки плагина без параметров конфигурации:

      kind: ModuleInfo
apiVersion: cluster.alauda.io/v1alpha1
metadata:
  name: global-cost-api
  labels:
    cpaas.io/cluster-name: global
    cpaas.io/module-name: cost-api
    cpaas.io/module-type: plugin
spec:
  version: v4.1.0
  config:
    crossClusterDependency:
      costServer: business-1

      Справка по полям YAML (cost-api):

      Путь поляОписание
      metadata.labels.cpaas.io/cluster-nameДолжно быть global.
      metadata.labels.cpaas.io/module-nameДолжно быть cost-api.
      metadata.labels.cpaas.io/module-typeДолжно быть plugin.
      metadata.nameИмя ModuleInfo (например, <cluster>-cost-api).
      spec.versionВерсия плагина для установки.
      spec.config.crossClusterDependency.costServerИмя кластера, в котором установлен плагин Cost Management Server

    3. Проверьте установку

      Поскольку имя ModuleInfo меняется при создании, найдите ресурс по метке, чтобы проверить статус и версию плагина:

      kubectl get moduleinfo -l cpaas.io/module-name=cost-api
NAME                                             CLUSTER         MODULE            DISPLAY_NAME     STATUS    TARGET_VERSION   CURRENT_VERSION   NEW_VERSION
global-e671599464a5b1717732c5ba36079795          global          cost-api          cost-api         Running   v4.1.0           v4.1.0            v4.1.0

      Объяснение полей:

      • NAME: имя ресурса ModuleInfo
      • CLUSTER: кластер, в котором установлен плагин
      • MODULE: имя плагина
      • DISPLAY_NAME: отображаемое имя плагина
      • STATUS: статус установки; Running означает успешную установку и работу
      • TARGET_VERSION: версия, предназначенная для установки
      • CURRENT_VERSION: версия до установки
      • NEW_VERSION: последняя доступная версия для установки

    Установка плагина Cost Management Agent через консоль

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

    • Компонент плагина Cost Management Agent требует, чтобы в соответствующем кластере был установлен компонент мониторинга ACP Monitor with Prometheus. Пожалуйста, убедитесь, что этот компонент успешно установлен заранее.

    • Плагин Cost Management Agent должен интегрироваться с компонентом Cost Management Server. Поэтому сначала необходимо установить плагин Cost Management Server.

    Процедура

    1. В левой навигационной панели нажмите Marketing Place > Plugin Management.

    2. Выберите кластер, в который необходимо установить этот плагин.

    3. Найдите плагин Cost Management Agent и нажмите кнопку Install в правой панели действий.

    4. Выберите имя кластера, в котором установлен плагин Cost Management Server.

    5. Нажмите Install.

    Установка плагина Cost Management Agent через YAML

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

    • Компонент плагина Cost Management Agent требует, чтобы в соответствующем кластере был установлен компонент мониторинга ACP Monitor with Prometheus. Пожалуйста, убедитесь, что этот компонент успешно установлен заранее.

    • Плагин Cost Management Agent должен интегрироваться с компонентом Cost Management Server. Поэтому сначала необходимо установить плагин Cost Management Server.

    Процедура

    1. Проверьте доступные версии

      Убедитесь, что плагин опубликован, проверив наличие ресурсов ModulePlugin и ModuleConfig в кластере global:

      # kubectl get moduleplugin | grep cost-agent
cost-agent                       30h
# kubectl get moduleconfig | grep cost-agent
cost-agent-v4.1.0                30h

      Это означает, что ModulePlugin cost-agent существует в кластере, и версия v4.1.0 опубликована.

    2. Создайте ModuleInfo

      Создайте ресурс ModuleInfo для установки плагина без параметров конфигурации:

      kind: ModuleInfo
apiVersion: cluster.alauda.io/v1alpha1
metadata:
  name: global-cost-agent
  labels:
    cpaas.io/cluster-name: global
    cpaas.io/module-name: cost-agent
    cpaas.io/module-type: plugin
spec:
  version: v4.1.0
  config:
    crossClusterDependency:
      costServer: business-1

      Справка по полям YAML (cost-agent):

      Путь поляОписание
      metadata.labels.cpaas.io/cluster-nameИмя целевого кластера, в котором установлен плагин.
      metadata.labels.cpaas.io/module-nameДолжно быть cost-agent.
      metadata.labels.cpaas.io/module-typeДолжно быть plugin.
      metadata.nameИмя ModuleInfo (например, <cluster>-cost-agent).
      spec.versionВерсия плагина для установки.
      spec.config.crossClusterDependency.costServerИмя кластера, в котором установлен плагин Cost Management Server

    3. Проверьте установку

      Поскольку имя ModuleInfo меняется при создании, найдите ресурс по метке, чтобы проверить статус и версию плагина:

      kubectl get moduleinfo -l cpaas.io/module-name=cost-agent
NAME                                             CLUSTER         MODULE            DISPLAY_NAME     STATUS    TARGET_VERSION   CURRENT_VERSION   NEW_VERSION
global-e671599464a5b1717732c5ba36079795          global          cost-agent        cost-agent       Running   v4.1.0           v4.1.0            v4.1.0