@@ -389,6 +389,14 @@ the table are linked to more details elsewhere in the user guide.
389
389
+---------------------------------------+--------------------+---------------+
390
390
| `boot_volume_type `_ | see below | see below |
391
391
+---------------------------------------+--------------------+---------------+
392
+ | `master_volume_size `_ | see below | see below |
393
+ +---------------------------------------+--------------------+---------------+
394
+ | `master_volume_type `_ | see below | see below |
395
+ +---------------------------------------+--------------------+---------------+
396
+ | `worker_volume_size `_ | see below | see below |
397
+ +---------------------------------------+--------------------+---------------+
398
+ | `worker_volume_type `_ | see below | see below |
399
+ +---------------------------------------+--------------------+---------------+
392
400
| `etcd_volume_size `_ | etcd storage | 0 |
393
401
| | volume size | |
394
402
+---------------------------------------+--------------------+---------------+
@@ -502,6 +510,18 @@ the table are linked to more details elsewhere in the user guide.
502
510
+---------------------------------------+--------------------+---------------+
503
511
| `fixed_subnet_cidr `_ | see below | "" |
504
512
+---------------------------------------+--------------------+---------------+
513
+ | `extra_network `_ | see below | "" |
514
+ +---------------------------------------+--------------------+---------------+
515
+ | `extra_subnet `_ | see below | "" |
516
+ +---------------------------------------+--------------------+---------------+
517
+ | `extra_security_group `_ | see below | see below |
518
+ +---------------------------------------+--------------------+---------------+
519
+ | `octavia_provider `_ | see below | amphora |
520
+ +---------------------------------------+--------------------+---------------+
521
+ | `octavia_lb_algorithm `_ | see bellow | ROUND_ROBIN |
522
+ +---------------------------------------+--------------------+---------------+
523
+ | `octavia_lb_healthcheck `_ | see bellow | true |
524
+ +---------------------------------------+--------------------+---------------+
505
525
506
526
.. _cluster :
507
527
@@ -1200,13 +1220,42 @@ _`admission_control_list`
1200
1220
_`boot_volume_size `
1201
1221
This label overrides the default_boot_volume_size of instances which is
1202
1222
useful if your flavors are boot from volume only. The default value is 0,
1203
- meaning that cluster instances will not boot from volume.
1223
+ meaning that cluster instances will not boot from volume unless
1224
+ master_volume_size or worker_volume_size is defined. This label has
1225
+ lower priority than abovementioned and can be overridden by them.
1226
+ Current precedence is master/worker_volume_size, boot_volume_size,
1227
+ default_boot_volume_size.
1228
+
1204
1229
1205
1230
_`boot_volume_type `
1206
1231
This label overrides the default_boot_volume_type of instances which is
1207
1232
useful if your flavors are boot from volume only. The default value is '',
1208
1233
meaning that Magnum will randomly select a Cinder volume type from all
1209
- available options.
1234
+ available options unless master_volume_type or worker_volume_type are set.
1235
+ Current precedence is master/worker_volume_type, boot_volume_type,
1236
+ default_boot_volume_type.
1237
+
1238
+ _`master_volume_size `
1239
+ This labed can be used to define different volume size for master nodes than
1240
+ set in boot_volume_size. Master_volume_size will be set to boot_volume_size
1241
+ if not defined, fallback to default_boot_volume_size if the latter is
1242
+ missing. If neither is defined master nodes will not boot
1243
+ from volume.
1244
+
1245
+ _`master_volume_type `
1246
+ This label can be used to override volume type of master nodes if defined.
1247
+ Otherwise boot_volume_type value will be used.
1248
+
1249
+ _`worker_volume_size `
1250
+ This labed can be used to define different volume size for worker nodes than
1251
+ set in boot_volume_size. worker_volume_size will be set to boot_volume_size
1252
+ if not defined, fallback to default_boot_volume_size if the latter is
1253
+ missing. If neither is defined worker nodes will not boot
1254
+ from volume.
1255
+
1256
+ _`worker_volume_type `
1257
+ This label can be used to override volume type of worker nodes if defined.
1258
+ Otherwise boot_volume_type value will be used.
1210
1259
1211
1260
_`etcd_volume_size `
1212
1261
This label sets the size of a volume holding the etcd storage data.
@@ -1264,13 +1313,14 @@ _`container_infra_prefix`
1264
1313
1265
1314
Images that might be needed if 'monitoring_enabled' is 'true':
1266
1315
1267
- * quay.io/prometheus/alertmanager:v0.20.0
1268
- * docker.io/squareup/ghostunnel:v1.5.2
1269
- * docker.io/jettech/kube-webhook-certgen:v1.0.0
1270
- * quay.io/coreos/prometheus-operator:v0.37.0
1271
- * quay.io/coreos/configmap-reload:v0.0.1
1272
- * quay.io/coreos/prometheus-config-reloader:v0.37.0
1273
- * quay.io/prometheus/prometheus:v2.15.2
1316
+ * quay.io/prometheus/alertmanager:v0.21.0
1317
+ * docker.io/jettech/kube-webhook-certgen:v1.5.0
1318
+ * quay.io/prometheus-operator/prometheus-operator:v0.44.0
1319
+ * docker.io/jimmidyson/configmap-reload:v0.4.0
1320
+ * quay.io/prometheus-operator/prometheus-config-reloader:v0.44.0
1321
+ * quay.io/prometheus/prometheus:v2.22.1
1322
+ * quay.io/prometheus/node-exporter:v1.0.1
1323
+ * docker.io/directxman12/k8s-prometheus-adapter:v0.8.2
1274
1324
1275
1325
Images that might be needed if 'cinder_csi_enabled' is 'true':
1276
1326
@@ -1434,37 +1484,48 @@ _`cinder_csi_plugin_tag`
1434
1484
<https://hub.docker.com/r/k8scloudprovider/cinder-csi-plugin/tags> `_.
1435
1485
Train default: v1.16.0
1436
1486
Ussuri default: v1.18.0
1487
+ Yoga default: v1.23.0
1437
1488
1438
1489
_`csi_attacher_tag `
1439
1490
This label allows users to override the default container tag for CSI attacher.
1440
1491
For additional tags, `refer to CSI attacher page
1441
1492
<https://quay.io/repository/k8scsi/csi-attacher?tab=tags> `_.
1442
1493
Ussuri-default: v2.0.0
1494
+ Yoga-default: v3.3.0
1443
1495
1444
1496
_`csi_provisioner_tag `
1445
1497
This label allows users to override the default container tag for CSI provisioner.
1446
1498
For additional tags, `refer to CSI provisioner page
1447
1499
<https://quay.io/repository/k8scsi/csi-provisioner?tab=tags> `_.
1448
1500
Ussuri-default: v1.4.0
1501
+ Yoga-default: v3.0.0
1449
1502
1450
1503
_`csi_snapshotter_tag `
1451
1504
This label allows users to override the default container tag for CSI snapshotter.
1452
1505
For additional tags, `refer to CSI snapshotter page
1453
1506
<https://quay.io/repository/k8scsi/csi-snapshotter?tab=tags> `_.
1454
1507
Ussuri-default: v1.2.2
1508
+ Yoga-default: v4.2.1
1455
1509
1456
1510
_`csi_resizer_tag `
1457
1511
This label allows users to override the default container tag for CSI resizer.
1458
1512
For additional tags, `refer to CSI resizer page
1459
1513
<https://quay.io/repository/k8scsi/csi-resizer?tab=tags> `_.
1460
1514
Ussuri-default: v0.3.0
1515
+ Yoga-default: v1.3.0
1461
1516
1462
1517
_`csi_node_driver_registrar_tag `
1463
1518
This label allows users to override the default container tag for CSI node
1464
1519
driver registrar. For additional tags, `refer to CSI node driver registrar
1465
1520
page
1466
1521
<https://quay.io/repository/k8scsi/csi-node-driver-registrar?tab=tags> `_.
1467
1522
Ussuri-default: v1.1.0
1523
+ Yoga-default: v2.4.0
1524
+
1525
+ -`csi_liveness_probe_tag `
1526
+ This label allows users to override the default container tag for CSI
1527
+ liveness probe.
1528
+ Yoga-default: v2.5.0
1468
1529
1469
1530
_`keystone_auth_enabled `
1470
1531
If this label is set to True, Kubernetes will support use Keystone for
@@ -1635,6 +1696,33 @@ _`fixed_subnet_cidr`
1635
1696
specified an existing fixed_subnet during cluster creation.
1636
1697
Ussuri default: 10.0.0.0/24
1637
1698
1699
+ _`extra_network `
1700
+ Optional additional network name or UUID to add to cluster nodes.
1701
+ When not specified, additional networks are not added. Optionally specify
1702
+ 'extra_subnet' if you wish to use a specific subnet on the network.
1703
+ Default: ""
1704
+
1705
+ _`extra_subnet `
1706
+ Optional additional subnet name or UUID to add to cluster nodes.
1707
+ Only used when 'extra_network' is defined.
1708
+ Default: ""
1709
+
1710
+ _`extra_security_group `
1711
+ Optional additional group name or UUID to add to network port.
1712
+ Only used when 'extra_network' is defined.
1713
+ Default: cluster node default security group.
1714
+
1715
+ _`octavia_provider `
1716
+ Octavia provider driver to be used for creating load balancers.
1717
+
1718
+ _`octavia_lb_algorithm `
1719
+ Octavia Octavia lb algorithm to use for LoadBalancer type service
1720
+ Default: ROUND_ROBIN
1721
+
1722
+ _`octavia_lb_healthcheck `
1723
+ If true, enable Octavia load balancer healthcheck
1724
+ Default: true
1725
+
1638
1726
External load balancer for services
1639
1727
-----------------------------------
1640
1728
@@ -2723,7 +2811,6 @@ _`calico_tag`
2723
2811
Victoria default: v3.13.1
2724
2812
Wallaby default: v3.13.1
2725
2813
2726
-
2727
2814
Besides, the Calico network driver needs kube_tag with v1.9.3 or later, because
2728
2815
Calico needs extra mounts for the kubelet container. See `commit
2729
2816
<https://github.com/projectatomic/atomic-system-containers/commit/54ab8abc7fa1bfb6fa674f55cd0c2fa0c812fd36> `_
@@ -3035,6 +3122,39 @@ for the COE types is summarized as follows:
3035
3122
| rexray | unsupported | supported | supported |
3036
3123
+--------+-------------+-------------+-------------+
3037
3124
3125
+ Labels can be used to customize nodes boot volume at creation time:
3126
+
3127
+ - boot_volume_type
3128
+ - boot_volume_size
3129
+
3130
+ These define volume type and size used for boot media of node vm, and they can
3131
+ be further overriden by:
3132
+
3133
+ - master_volume_type
3134
+ - master_volume_size
3135
+ - worker_volume_type
3136
+ - worker_volume_size
3137
+
3138
+ Current precedence is:
3139
+ - master_volume_size / worker_volume_size
3140
+ - boot_volume_size
3141
+ - default_boot_volume_size
3142
+
3143
+ Labels shown above allow user to use different storage types and sizes for
3144
+ master and worker nodes. They can be used independently of each other
3145
+ for ex. boot_volume_type to define type of storage to use for both master
3146
+ and worker vms, along with master_volume_size and worker_volume_size
3147
+ setting size of their boot volumes. Another example would be usage of
3148
+ boot_volume_size to define size of both master and worker, with different
3149
+ storage types for them set by master_volume_type and worker_volume_type.
3150
+ It's possible to use any combination of the above.
3151
+
3152
+ If either master_volume_type or worker_volume_type is missing,
3153
+ boot_volume_type will be used instead. A random volume type from Cinder will
3154
+ be used if none of those options is set. In case of master_volume_size or
3155
+ worker_volume_size missing value for boot_volume_size is used. If neither
3156
+ is defined instances will not be volume based.
3157
+
3038
3158
Following are some examples for using Cinder as persistent storage.
3039
3159
3040
3160
Using Cinder in Kubernetes
0 commit comments