From 94d227149d7fff7f0db078c5f1cc4bc9ce391537 Mon Sep 17 00:00:00 2001 From: Guillaume Abrioux Date: Fri, 26 Mar 2021 18:05:48 +0100 Subject: [PATCH] defaults: add a comment about `igw_network` This add a quick documentation in ceph-defaults about `igw_network` Signed-off-by: Guillaume Abrioux (cherry picked from commit c5728bdc6351fe985e17b095cbd5871ef673dc29) --- group_vars/all.yml.sample | 8 ++++++++ group_vars/rhcs.yml.sample | 8 ++++++++ roles/ceph-defaults/defaults/main.yml | 8 ++++++++ 3 files changed, 24 insertions(+) diff --git a/group_vars/all.yml.sample b/group_vars/all.yml.sample index d4d28a0793..9efefa0dc7 100644 --- a/group_vars/all.yml.sample +++ b/group_vars/all.yml.sample @@ -722,6 +722,14 @@ dummy: #alertmanager_cluster_port: 9094 #alertmanager_conf_overrides: {} # igw +# +# `igw_network` variable is intended for allowing dashboard deployment with iSCSI node not residing in the same subnet than what is defined in `public_network`. +# For example: +# If the ceph public network is 2a00:8a60:1:c301::/64 and the iSCSI Gateway resides +# at a dedicated gateway network (2a00:8a60:1:c300::/64) (With routing between those networks). +# It means "{{ hostvars[item]['ansible_facts']['all_ipv4_addresses'] | ips_in_ranges(public_network.split(',')) | last | ipwrap }}" will be empty. +# As a consequence, this prevent from deploying dashboard with iSCSI node when it reside in a subnet different than `public_network`. +# Using `igw_network` make it possible, set it with the subnet used by your iSCSI node. #igw_network: "{{ public_network }}" diff --git a/group_vars/rhcs.yml.sample b/group_vars/rhcs.yml.sample index d395292403..9419f6161b 100644 --- a/group_vars/rhcs.yml.sample +++ b/group_vars/rhcs.yml.sample @@ -722,6 +722,14 @@ alertmanager_container_image: registry.redhat.io/openshift4/ose-prometheus-alert #alertmanager_cluster_port: 9094 #alertmanager_conf_overrides: {} # igw +# +# `igw_network` variable is intended for allowing dashboard deployment with iSCSI node not residing in the same subnet than what is defined in `public_network`. +# For example: +# If the ceph public network is 2a00:8a60:1:c301::/64 and the iSCSI Gateway resides +# at a dedicated gateway network (2a00:8a60:1:c300::/64) (With routing between those networks). +# It means "{{ hostvars[item]['ansible_facts']['all_ipv4_addresses'] | ips_in_ranges(public_network.split(',')) | last | ipwrap }}" will be empty. +# As a consequence, this prevent from deploying dashboard with iSCSI node when it reside in a subnet different than `public_network`. +# Using `igw_network` make it possible, set it with the subnet used by your iSCSI node. #igw_network: "{{ public_network }}" diff --git a/roles/ceph-defaults/defaults/main.yml b/roles/ceph-defaults/defaults/main.yml index 6c8a250544..c4ec5f9ae4 100644 --- a/roles/ceph-defaults/defaults/main.yml +++ b/roles/ceph-defaults/defaults/main.yml @@ -714,6 +714,14 @@ alertmanager_port: 9093 alertmanager_cluster_port: 9094 alertmanager_conf_overrides: {} # igw +# +# `igw_network` variable is intended for allowing dashboard deployment with iSCSI node not residing in the same subnet than what is defined in `public_network`. +# For example: +# If the ceph public network is 2a00:8a60:1:c301::/64 and the iSCSI Gateway resides +# at a dedicated gateway network (2a00:8a60:1:c300::/64) (With routing between those networks). +# It means "{{ hostvars[item]['ansible_facts']['all_ipv4_addresses'] | ips_in_ranges(public_network.split(',')) | last | ipwrap }}" will be empty. +# As a consequence, this prevent from deploying dashboard with iSCSI node when it reside in a subnet different than `public_network`. +# Using `igw_network` make it possible, set it with the subnet used by your iSCSI node. igw_network: "{{ public_network }}"