Создание кластера

1
mws mclickhouse cluster create <имя кластера> \
2
  --active \
3
  --version "<номер версии>" \
4
  --shards '
5
    name: <имя шарда — sh>
6
    resources:
7
      vmType: <тип ВМ — например, vmTypes/gen-4-8>
8
      disk:
9
        size: <размер диска в гигабайтах — например, 20GB>
10
        type: <тип диска — NETWORK_STANDARD_SSD>
11
        iops: <количество IOPS — например, 1000>
12
    weight: 1
13
    instances:
14
      - name: <имя инстанса>
15
        zone: <зона доступности — ru-central1-a или ru-central1-b>
16
          count: <количество узлов — 1>
17
          endpoints:
18
            - address:
19
                spec:
20
                  subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
21
              externalAddress:
22
                ref: projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>  // При назначении зарезервированного IP
23
                spec: {}  // При назначении временного IP
24
  ' \
25
  --bootstrap-admin-username <имя администратора кластера> \
26
  --bootstrap-admin-password <пароль администратора кластера> \
27
  --maintenance-window-weekly-days <день для сервисного окна — например, MONDAY> \
28
  --maintenance-window-weekly-hour <время начала сервисного окна — от 0 до 23> \
29
  --backup-hour <время начала резервного копирования> \
30
  --backup-retain-period-days <срок хранения резервных копий в днях> \
31
  --config '{"<параметр>": <значение>, "<группа параметров>": {"<параметр>": <значение>, "<параметр>": <значение>}}'

1
mws mclickhouse cluster create <имя кластера> \
2
  --active \
3
  --version "<номер версии>" \
4
  --shards '
5
    name: <имя шарда — sh1>
6
    resources:
7
      vmType: <тип ВМ — например, vmTypes/gen-4-8>
8
      disk:
9
        size: <размер диска в гигабайтах — например, 20GB>
10
        type: <тип диска — NETWORK_STANDARD_SSD>
11
        iops: <количество IOPS — например, 1000>
12
    weight: 1
13
    instances:
14
      - zone: ru-central1-a
15
        count: <количество узлов в зоне доступности ru-central1-a — 1>
16
        endpoints:
17
          - address:
18
              spec:
19
                subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
20
          - externalAddress:
21
              ref: projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>  // При назначении зарезервированного IP
22
              spec: {}  // При назначении временного IP
23
      - zone: ru-central1-b
24
        count: <количество узлов в зоне доступности ru-central1-b — 1>
25
        endpoints:
26
          - address:
27
              spec:
28
                subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
29
  ' \
30
  --shards '
31
    name: <имя шарда — sh2>
32
    resources:
33
      vmType: <тип ВМ — например, vmTypes/gen-4-8>
34
      disk:
35
        size: <размер диска в гигабайтах — например, 20GB>
36
        type: <тип диска — NETWORK_STANDARD_SSD>
37
        iops: <количество IOPS — например, 1000>
38
    weight: 1
39
    instances:
40
      - zone: ru-central1-a
41
        count: <количество узлов в зоне доступности ru-central1-a — 1>
42
        endpoints:
43
          - address:
44
              spec:
45
                subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
46
          - externalAddress:
47
              ref: projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>  // При назначении зарезервированного IP
48
              spec: {}  // При назначении временного IP
49
      - zone: ru-central1-b
50
        count: <количество узлов в зоне доступности ru-central1-b — 1>
51
        endpoints:
52
          - address:
53
              spec:
54
                subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
55
          - externalAddress:
56
              ref: projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>  // При назначении зарезервированного IP
57
              spec: {}  // При назначении временного IP
58
  ' \
59
  --coordinator-resources-vm-type <тип ВМ — например, vmTypes/gen-2-8> \
60
  --coordinator-resources-disk-type <тип диска — NETWORK_STANDARD_SSD> \
61
  --coordinator-resources-disk-size <размер диска в гигабайтах — например, 20GB> \
62
  --coordinator-instances '
63
    count: <количество узлов ClickHouse Keeper в зоне доступности ru-central1-a — 1>
64
    zone: ru-central1-a
65
  ' \
66
  --coordinator-instances '
67
    count: <количество узлов ClickHouse Keeper в зоне доступности ru-central1-b — 2>
68
    zone: ru-central1-b
69
  ' \
70
  --bootstrap-admin-username <имя администратора кластера> \
71
  --bootstrap-admin-password <пароль администратора кластера> \
72
  --maintenance-window-weekly-days <день для сервисного окна — например, MONDAY> \
73
  --maintenance-window-weekly-hour <время начала сервисного окна — от 0 до 23> \
74
  --backup-hour <время начала резервного копирования> \
75
  --backup-retain-period-days <срок хранения резервных копий в днях> \
76
  --config '{"<параметр>": <значение>, "<группа параметров>": {"<параметр>": <значение>, "<параметр>": <значение>}}'

1
{
2
  "metadata": {
3
    "displayName": "<отображаемое имя кластера>"
4
  },
5
  "spec": {
6
    "active": <состояние кластера: true — запущен, false — остановлен>,
7
    "version": "25.3",
8
    "shards": [
9
      {
10
        "name": "имя шарда — sh",
11
        "resources": {
12
          "vmType": "<тип ВМ — например, vmTypes/gen-4-8>",
13
          "disk": {
14
            "size": "<размер диска в гигабайтах — например, 20GB>",
15
            "type": "<тип диска — NETWORK_STANDARD_SSD>",
16
            "iops": <количество IOPS — например, 1000>
17
          }
18
        },
19
        "weight": 1,
20
        "instances": [
21
          {
22
            "zone": "<зона доступности — ru-central1-a или ru-central1-b>",
23
            "count": 1,
24
            "endpoints": [
25
              {
26
                "address": {
27
                  "spec": {
28
                    "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
29
                  }
30
                },
31
                "externalAddress": {
32
                  "spec": {},  # При назначении временного IP
33
                  "ref": "projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>"  # При назначении зарезервированного IP
34
                }
35
              }
36
            ]
37
          }
38
        ]
39
      }
40
    ],
41
    "config": {
42
      "<параметр>": <значение>,
43
      "<группа параметров>": {
44
        "<параметр>": <значение>,
45
        "<параметр>": <значение>
46
      },
47
    },
48
    "bootstrapAdmin": {
49
      "username": "<имя администратора кластера>",
50
      "password": "<пароль администратора кластера>"
51
    },
52
    "maintenanceWindow": {
53
      "weekly": {
54
        "days": [
55
          "<день для сервисного окна — например, MONDAY>"
56
        ],
57
        "hour": "<время начала сервисного окна — от 0 до 23>"
58
      }
59
    },
60
    "backup": {
61
      "hour": <время начала резервного копирования>,
62
      "retainPeriodDays": <срок хранения резервных копий в днях>
63
    }
64
  }
65
}

1
{
2
  "metadata": {
3
    "displayName": "<отображаемое имя кластера>"
4
  },
5
  "spec": {
6
    "active": <состояние кластера: true — запущен, false — остановлен>,
7
    "version": "25.3",
8
    "shards": [
9
      {
10
        "name": "<имя шарда — sh1>",
11
        "resources": {
12
          "vmType": "<тип ВМ — например, vmTypes/gen-4-8>",
13
          "disk": {
14
            "size": "<размер диска в гигабайтах — например, 20GB>",
15
            "type": "<тип диска — NETWORK_STANDARD_SSD>",
16
            "iops": <количество IOPS — например, 1000>
17
          }
18
        },
19
        "weight": 1,
20
        "instances": [
21
          {
22
            "zone": "ru-central1-a",
23
            "count": <количество узлов в зоне доступности ru-central1-a — 1>,
24
            "endpoints": [
25
              {
26
                "address": {
27
                  "spec": {
28
                    "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
29
                  },
30
                  "externalAddress": {
31
                    "spec": {},  # При назначении временного IP
32
                    "ref": "projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>"  # При назначении зарезервированного IP
33
                  }
34
                }
35
              }
36
            ]
37
          },
38
          {
39
            "zone": "ru-central1-b",
40
            "count": <количество узлов в зоне доступности ru-central1-b — 1>,
41
            "endpoints": [
42
              {
43
                "address": {
44
                  "spec": {
45
                    "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
46
                  },
47
                  "externalAddress": {
48
                    "spec": {},  # При назначении временного IP
49
                    "ref": "projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>"  # При назначении зарезервированного IP
50
                  }
51
                }
52
              }
53
            ]
54
          }
55
        ]
56
      },
57
      {
58
        "name": "<имя шарда — sh2>",
59
        "resources": {
60
          "vmType": "<тип ВМ — например, vmTypes/gen-4-8>",
61
          "disk": {
62
            "size": "<размер диска в гигабайтах — например, 20GB>",
63
            "type": "<тип диска — NETWORK_STANDARD_SSD>",
64
            "iops": <количество IOPS — например, 1000>
65
          }
66
        },
67
        "weight": 1,
68
        "instances": [
69
          {
70
            "zone": "ru-central1-a",
71
            "count": <количество узлов в зоне доступности ru-central1-a — 1>,
72
            "endpoints": [
73
              {
74
                "address": {
75
                  "spec": {
76
                    "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
77
                  }
78
                },
79
                "externalAddress": {
80
                  "spec": {},  # При назначении временного IP
81
                  "ref": "projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>"  # При назначении зарезервированного IP
82
                }
83
              }
84
            ]
85
          },
86
          {
87
            "zone": "ru-central1-b",
88
            "count": <количество узлов в зоне доступности ru-central1-b — 1>,
89
            "endpoints": [
90
              {
91
                "address": {
92
                  "spec": {
93
                    "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
94
                  }
95
                },
96
                "externalAddress": {
97
                  "spec": {},  # При назначении временного IP
98
                  "ref": "projects/<имя проекта>/externalAddresses/<имя зарезервированного IP-адреса>"  # При назначении зарезервированного IP
99
                }
100
              }
101
            ]
102
          }
103
        ]
104
      }
105
    ],
106
    "coordinator": {
107
      "resources": {
108
        "vmType": "<тип ВМ — например, vmTypes/gen-2-8>",
109
        "disk": {
110
          "size": "<размер диска в гигабайтах — например, 20GB>",
111
          "type": "<тип диска — NETWORK_STANDARD_SSD>"
112
        }
113
      },
114
      "instances": [
115
        {
116
          "count": <количество узлов ClickHouse Keeper в зоне доступности ru-central1-a — 1>,
117
          "zone": "ru-central1-a"
118
        },
119
        {
120
          "count": <количество узлов ClickHouse Keeper в зоне доступности ru-central1-b — 2>,
121
          "zone": "ru-central1-b"
122
        }
123
      ]
124
    },
125
    "config": {
126
      "<параметр>": <значение>,
127
      "<группа параметров>": {
128
        "<параметр>": <значение>,
129
        "<параметр>": <значение>
130
      },
131
    },
132
    "bootstrapAdmin": {
133
      "username": "<имя администратора кластера>",
134
      "password": "<пароль администратора кластера>"
135
    },
136
    "maintenanceWindow": {
137
      "weekly": {
138
        "days": [
139
          "<день для сервисного окна — например, MONDAY>"
140
        ],
141
        "hour": "<время начала сервисного окна — от 0 до 23>"
142
      }
143
    },
144
    "backup": {
145
      "hour": <время начала резервного копирования>,
146
      "retainPeriodDays": <срок хранения резервных копий в днях>
147
    }
148
  }
149
}