使用外接中间件服务¶

本文描述如何使用第三方中间服务，包含：mysql、redis、elasticsearch、S3Storage。

使用外接数据库¶

前置说明¶

DCE 5.0 产品模块中内置了 MySQL 数据库来存储数据，但是安装器支持了使用外接 MySQL、Kingbase、PostgreSQL 三种数据库外接的方式
下述示例脚本仅用于演示目的，实际应用中应该根据具体的需求进行修改，例如数据库名称、用户名、密码等，并且可以将以下语句拆分至不同的 DBMS 执行

外接 MySql 操作步骤¶

准备一个 MySQL 数据库，并且具有创建数据库、创建用户、授予权限的权限。

连接到 MySQL 数据库，执行如下 SQL，完成 database、用户的创建并授予对应权限。

# ghippo apiserver
CREATE DATABASE ghippo CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'ghippo' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON ghippo.* TO 'ghippo';

# ghippo keycloak
CREATE DATABASE keycloak CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'keycloak' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON keycloak.* TO 'keycloak';

# ghippo audit
CREATE DATABASE audit CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'audit' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON audit.* TO 'audit';

# kpanda
CREATE DATABASE kpanda CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'kpanda' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON kpanda.* TO 'kpanda';

# set sort_buffer_size (used for clusterpedia)
SET GLOBAL sort_buffer_size=8*1024*1024;
SET SESSION sort_buffer_size=8*1024*1024;

# skoala
CREATE DATABASE skoala CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'skoala' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON skoala.* TO 'skoala';

# amamba
CREATE DATABASE amamba CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'amamba' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON amamba.* TO 'amamba';

# insight
CREATE DATABASE insight CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'insight' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON insight.* TO 'insight';

# ipavo
CREATE DATABASE ipavo CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'ipavo' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON ipavo.* TO 'ipavo';

# kcollie
CREATE DATABASE kcollie CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'kcollie' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON kcollie.* TO 'kcollie';

# gmagpie
CREATE DATABASE gmagpie CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'gmagpie' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON gmagpie.* TO 'gmagpie';

# dowl
CREATE DATABASE dowl CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'dowl' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON dowl.* TO 'dowl';

在集群配置文件 clusterConfig.yaml 中，配置 externalMiddlewares.database 参数，假设数据库访问地址为 localhost:3306；不同的数据库类型有不同的 dataSourceName 配置格式，参阅 GORM 文档连接到数据库。

apiVersion: provision.daocloud.io/v1alpha4
kind: ClusterConfig
metadata:
  creationTimestamp: null
spec:
  ..............
  externalMiddlewares:
    database:
      kpanda:
        - dbDriverName: "mysql"
          # Please refer https://gorm.io/docs/connecting_to_the_database.html
          dataSourceName: "kpanda:password@tcp(localhost:3306)/dbname"
          # readwrite(default) or readonly
          accessType: readwrite
          # The maximum number of open connections to the database.
          # maxOpenConnections: 100
          # The maximum number of connections in the idle connection pool.
          # maxIdleConnections: 10
          # The maximum amount of time a connection may be reused.
          # connectionMaxLifetimeSeconds: 3600
          # The maximum amount of time a connection may be idle.
          # connectionMaxIdleSeconds: 1800
      ghippoApiserver:
        - dbDriverName: "mysql"
          dataSourceName: "ghippo:password@tcp(localhost:3306)/ghippo"
      ghippoKeycloak:
        - dbDriverName: "mysql"
          dataSourceName: "keycloak:password@tcp(localhost:3306)/keycloak"
      ghippoAuditserver:
        - dbDriverName: "mysql"
          dataSourceName: "audit:password@tcp(localhost:3306)/audit"
      skoala:
        - dbDriverName: "mysql"
          dataSourceName: "skoala:password@tcp(172.30.41.0:3308)/skoala"
      amamba:
        - dbDriverName: "mysql"
          dataSourceName: "amamba:password@tcp(172.30.41.0:3308)/amamba"
      insight:
        - dbDriverName: "mysql"
          dataSourceName: "insight:password@tcp(172.30.41.0:3308)/insight"
      ipavo:
        - dbDriverName: "mysql"
          dataSourceName: "ipavo:password@tcp(172.30.41.0:3308)/ipavo"
      kcollie:
        - dbDriverName: "mysql"
          dataSourceName: "kcollie:password@tcp(172.30.41.0:3308)/kcollie"
      gmagpie:
        - dbDriverName: "mysql"
          dataSourceName: "gmagpie:password@tcp(172.30.41.0:3308)/gmagpie"
      dowl:
        - dbDriverName: "mysql"
          dataSourceName: "dowl:password@tcp(172.30.41.0:3308)/dowl"

完成上述配置后，可以继续执行部署 DCE 5.0 商业版。

外接 Kingbase 数据库操作步骤¶

准备一个 Kingbase 数据库，并且具有创建数据库、创建用户、授予权限的权限。

连接到 Kingbase 数据库，执行如下 SQL，完成 database、用户的创建并授予对应权限。

CREATE DATABASE ghippo;
CREATE USER ghippo WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE ghippo TO ghippo;

CREATE DATABASE keycloak;
CREATE USER keycloak WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE keycloak TO keycloak;

CREATE DATABASE audit;
CREATE USER audit WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE audit TO audit;

CREATE DATABASE kpanda;
CREATE USER kpanda WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE kpanda TO kpanda;

CREATE DATABASE skoala;
CREATE USER skoala WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE skoala TO skoala;

CREATE DATABASE amamba;
CREATE USER amamba WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE amamba TO amamba;

CREATE DATABASE insight;
CREATE USER insight WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE insight TO insight;

CREATE DATABASE ipavo;
CREATE USER ipavo WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE ipavo TO ipavo;

CREATE DATABASE kcollie;
CREATE USER kcollie WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE kcollie TO kcollie;

CREATE DATABASE gmagpie;
CREATE USER gmagpie WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE gmagpie TO gmagpie;

CREATE DATABASE dowl;
CREATE USER dowl WITH encrypted password 'password';
GRANT ALL PRIVILEGES ON DATABASE dowl TO dowl;

在集群配置文件 clusterConfig.yaml 中，配置 externalMiddlewares.database 参数，假设 Kingbase数据库访问地址为 172.30.41.2:54321；不同的数据库类型有不同的 dataSourceName 配置格式，详见文档 https://gorm.io/docs/connecting_to_the_database.html

apiVersion: provision.daocloud.io/v1alpha4
kind: ClusterConfig
metadata:
  creationTimestamp: null
spec:
  ..............
  externalMiddlewares:
    database:
      kpanda:
        - dbDriverName: "kingbase"
          # Please refer https://gorm.io/docs/connecting_to_the_database.html
          dataSourceName: "host=172.30.41.2 user=kpanda password=password dbname=kpanda port=54321"
          # readwrite(default) or readonly
          accessType: readwrite
          # The maximum number of open connections to the database.
          # maxOpenConnections: 100
          # The maximum number of connections in the idle connection pool.
          # maxIdleConnections: 10
          # The maximum amount of time a connection may be reused.
          #connectionMaxLifetimeSeconds: 3600
          # The maximum amount of time a connection may be idle.
          # connectionMaxIdleSeconds: 1800
      ghippoApiserver:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=ghippo password=password dbname=ghippo port=54321"
      ghippoKeycloak:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=keycloak password=password dbname=keycloak port=54321"
      ghippoAuditserver:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=audit password=password dbname=audit port=54321"
      skoala:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=skoala password=password dbname=skoala port=54321"
      amamba:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=amamba password=password dbname=amamba port=54321"
      insight:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=insight password=password dbname=insight port=54321"
      ipavo:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=ipavo password=password dbname=ipavo port=54321"
      kcollie:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=kcollie password=password dbname=kcollie port=54321"
      gmagpie:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=gmagpie password=password dbname=gmagpie port=54321"
      dowl:
        - dbDriverName: "kingbase"
          dataSourceName: "host=172.30.41.2 user=dowl password=password dbname=dowl port=54321"

完成上述配置后，可以继续执行部署 DCE 5.0 商业版。

外接 PostgreSQL 数据库操作步骤¶

准备一个 PostgreSQL 数据库，并且具有创建数据库、创建用户、授予权限的权限。
连接到 PostgreSQL 数据库，执行如下 SQL，完成 database、用户的创建并授予对应权限。

CREATE USER ghippo WITH encrypted password 'password';
CREATE DATABASE ghippo OWNER ghippo;
GRANT ALL PRIVILEGES ON DATABASE ghippo TO ghippo;

CREATE USER keycloak WITH encrypted password 'password';
CREATE DATABASE keycloak OWNER keycloak;
GRANT ALL PRIVILEGES ON DATABASE keycloak TO keycloak;

CREATE USER audit WITH encrypted password 'password';
CREATE DATABASE audit OWNER audit;
GRANT ALL PRIVILEGES ON DATABASE audit TO audit;

CREATE USER kpanda WITH encrypted password 'password';
CREATE DATABASE kpanda OWNER kpanda;
GRANT ALL PRIVILEGES ON DATABASE kpanda TO kpanda;

CREATE USER skoala WITH encrypted password 'password';
CREATE DATABASE skoala OWNER skoala;
GRANT ALL PRIVILEGES ON DATABASE skoala TO skoala;

CREATE USER amamba WITH encrypted password 'password';
CREATE DATABASE amamba OWNER amamba;
GRANT ALL PRIVILEGES ON DATABASE amamba TO amamba;

CREATE USER insight WITH encrypted password 'password';
CREATE DATABASE insight OWNER insight;
GRANT ALL PRIVILEGES ON DATABASE insight TO insight;

CREATE USER ipavo WITH encrypted password 'password';
CREATE DATABASE ipavo OWNER ipavo;
GRANT ALL PRIVILEGES ON DATABASE ipavo TO ipavo;

CREATE USER kcollie WITH encrypted password 'password';
CREATE DATABASE kcollie OWNER kcollie;
GRANT ALL PRIVILEGES ON DATABASE kcollie TO kcollie;

CREATE USER gmagpie WITH encrypted password 'password';
CREATE DATABASE gmagpie OWNER gmagpie;
GRANT ALL PRIVILEGES ON DATABASE gmagpie TO gmagpie;

CREATE USER dowl WITH encrypted password 'password';
CREATE DATABASE dowl OWNER dowl;
GRANT ALL PRIVILEGES ON DATABASE dowl TO dowl;

修改 clusterConfig.yaml 关于数据库的配置，假设数据库访问地址为 172.30.41.2:5432；不同的数据库类型有不同的 dataSourceName 配置格式，详见文档 https://gorm.io/docs/connecting_to_the_DATABASE.html

apiVersion: provision.daocloud.io/v1alpha4
kind: ClusterConfig
metadata:
  creationTimestamp: null
spec:
  ..............
  externalMiddlewares:
    database:
      kpanda:
        - dbDriverName: "postgres"
          # Please refer https://gorm.io/docs/connecting_to_the_database.html
          dataSourceName: "host=172.30.41.2 user=kpanda password=password dbname=kpanda port=5432"
          # readwrite(default) or readonly
          accessType: readwrite
          # The maximum number of open connections to the database.
          # maxOpenConnections: 100
          # The maximum number of connections in the idle connection pool.
          # maxIdleConnections: 10
          # The maximum amount of time a connection may be reused.
          # connectionMaxLifetimeSeconds: 3600
          # The maximum amount of time a connection may be idle.
          # connectionMaxIdleSeconds: 1800
      ghippoApiserver:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=ghippo password=password dbname=ghippo port=5432"
      ghippoKeycloak:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=keycloak password=password dbname=keycloak port=5432"
      ghippoAuditserver:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=audit password=password dbname=audit port=5432"
      skoala:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=skoala password=password dbname=skoala port=5432"
      amamba:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=amamba password=password dbname=amamba port=5432"
      insight:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=insight password=password dbname=insight port=5432"
      ipavo:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=ipavo password=password dbname=ipavo port=5432"
      kcollie:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=kcollie password=password dbname=kcollie port=5432"
      gmagpie:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=gmagpie password=password dbname=gmagpie port=5432"
      dowl:
        - dbDriverName: "postgres"
          dataSourceName: "host=172.30.41.2 user=dowl password=password dbname=dowl port=5432"

完成上述配置后，可以继续执行部署 DCE 5.0 商业版。

使用外接 Redis¶

操作步骤如下：

在集群配置文件 clusterConfig.yaml 中，配置 externalMiddlewares.redis 参数：
```
apiVersion: provision.daocloud.io/v1alpha4
kind: ClusterConfig
metadata:
spec:
  ..........
  externalMiddlewares:
    redis:
      kpanda: "redis://:password@localhost:6379"
  ..........
```
Note
- 支持 Redis Standalone、Redis Sentinel、Redis Cluster 三种模式
- Standalone URL 格式为：redis://[[user]:password@]host[:port][/db-number][?option=value]
- Sentinel URL 格式为：redis+sentinel://[[user]:password@]host1[:port1][,host2[:port2]]/master-name[/db-number][?option=value]
- Cluster URL 格式为：redis://[[user]:password@]host1[:port1]?addr=host2[:port2][&addr=host3:[port3][&option=value]] 或 rediss://[[user]:password@]host1[:port1]?addr=host2[:port2][&addr=host3:[port3][&option=value]]
- 目前仅有容器管理产品模块使用到了 Redis 组件
完成上述配置后，可以继续执行部署 DCE 5.0 商业版。

使用外接 Elasticsearch¶

Note

使用外接 Elasticsearch 时需要注意：若外接 Elasticsearch 未开启 TLS，则需要在 Insight 的 Helm 参数中 logging:output 中将 TLS 设置为 off。

操作步骤如下：

在集群配置文件 clusterConfig.yaml 中，配置 externalMiddlewares.elasticsearch 参数：

apiVersion: provision.daocloud.io/v1alpha4
kind: ClusterConfig
metadata:
spec:
  ..........
  externalMiddlewares:
    elasticsearch:
      insight:
        endpoint: "https://xx.xx.xx.xx:9200"
        # basic auth
        username: "username"
        password: "password"
  ..........

Note

目前仅有可观测产品模块使用到了 Elasticsearch 组件。如果使用外接中间件后，不建议使用 7 节点模式下的 worker 节点，不然占用资源。

完成上述配置后，可以继续执行部署 DCE 5.0 商业版。

使用外接 S3Storage¶

操作步骤如下：

在集群配置文件 clusterConfig.yaml 中，配置 externalMiddlewares.S3Storage 参数：

apiVersion: provision.daocloud.io/v1alpha4
kind: ClusterConfig
metadata:
spec:
  ..........
  externalMiddlewares:
    S3Storage:
      default:
        endpoint: "https://xx.xx.xx.xx:9200"
        # Set if you dont want to verify the certificate.
        insecure: true
        bucket: "bucketname"
        accessKey: "YOUR-ACCESS-KEY-HERE"
        secretKey: "YOUR-SECRET-KEY-HERE"
  ..........

完成上述配置后，可以继续执行部署 DCE 5.0 商业版。

使用外接 kafka¶

操作步骤如下：

在集群配置文件 clusterConfig.yaml 中，配置 externalMiddlewares.elasticsearch 参数：

apiVersion: provision.daocloud.io/v1alpha4
kind: ClusterConfig
metadata:
spec:
  ..........
  externalMiddlewares:
    kafka:
      brokers:
          - host1:9092
          - host2:9092
        # the username and password of kafka is not necessary
        username: "username"
        password: "password"
  ..........

Note

目前仅有可观测产品模块使用到了 Kafka 组件。

完成上述配置后，可以继续执行部署 DCE 5.0 商业版。

使用外接中间件服务¶

使用外接数据库¶

前置说明¶

外接 MySql 操作步骤¶

外接 Kingbase 数据库操作步骤¶

外接 PostgreSQL 数据库操作步骤¶

使用外接 Redis¶

使用外接 Elasticsearch¶

使用外接 S3Storage¶

使用外接 kafka¶

评论