fix(docs): Update getting-started script pre-26.3.0 (#123)

* chore: Add wait conditions to getting-started script

* chore: Add hint about port forward

* chore: Adjust discovery ListenerClass

When running the getting started script against a local kind cluster,
stackablectl will automatically choose the stable-nodes preset, which
works out of the box with both external-stable and external-unstable.

However, when using helm, the default preset (ephemeral-nodes) is used
and causes OpenSearch cluster pods to not start up, because kind doesn't
support LoadBalancers. This is the reason why we chose to do the less
invasive change, and change the ListenerClass to external-unstable.

Author: Techassi

docs/modules/opensearch/examples/getting_started/getting_started.sh

@@ -17,6 +17,9 @@ then
   exit 1
 fi
 
+echo "Waiting for node(s) to be ready..."
+kubectl wait node --all --for=condition=Ready --timeout=120s
+
 cd "$(dirname "$0")"
 
 case "$1" in
@@ -45,6 +48,9 @@ exit 1
 ;;
 esac
 
+# TODO: Remove once https://github.com/stackabletech/issues/issues/828 has been implemented (see that issue for details).
+until kubectl get crd opensearchclusters.opensearch.stackable.tech >/dev/null 2>&1; do echo "Waiting for CRDs to be installed" && sleep 1; done
+
 echo "Creating OpenSearch security plugin configuration"
 # tag::apply-security-config[]
 kubectl apply -f initial-opensearch-security-config.yaml
@@ -140,7 +146,7 @@ helm install opensearch-dashboards opensearch-dashboards \
     --wait
 # end::opensearch-dashboards[]
 
-echo "Starting port-forwarding of port 5601"
+echo "Starting port-forwarding of port 5601 (press Ctrl+C to exit early)"
 # tag::opensearch-dashboards-port-forwarding[]
 kubectl port-forward services/opensearch-dashboards 5601 > /dev/null 2>&1 &
 # end::opensearch-dashboards-port-forwarding[]

docs/modules/opensearch/examples/getting_started/getting_started.sh.j2

@@ -17,6 +17,9 @@ then
   exit 1
 fi
 
+echo "Waiting for node(s) to be ready..."
+kubectl wait node --all --for=condition=Ready --timeout=120s
+
 cd "$(dirname "$0")"
 
 case "$1" in
@@ -45,6 +48,9 @@ exit 1
 ;;
 esac
 
+# TODO: Remove once https://github.com/stackabletech/issues/issues/828 has been implemented (see that issue for details).
+until kubectl get crd opensearchclusters.opensearch.stackable.tech >/dev/null 2>&1; do echo "Waiting for CRDs to be installed" && sleep 1; done
+
 echo "Creating OpenSearch security plugin configuration"
 # tag::apply-security-config[]
 kubectl apply -f initial-opensearch-security-config.yaml
@@ -140,7 +146,7 @@ helm install opensearch-dashboards opensearch-dashboards \
     --wait
 # end::opensearch-dashboards[]
 
-echo "Starting port-forwarding of port 5601"
+echo "Starting port-forwarding of port 5601 (press Ctrl+C to exit early)"
 # tag::opensearch-dashboards-port-forwarding[]
 kubectl port-forward services/opensearch-dashboards 5601 > /dev/null 2>&1 &
 # end::opensearch-dashboards-port-forwarding[]

docs/modules/opensearch/examples/getting_started/opensearch.yaml

@@ -46,7 +46,7 @@ spec:
                 key: roles_mapping.yml
   nodes:
     roleConfig:
-      discoveryServiceListenerClass: external-stable
+      discoveryServiceListenerClass: external-unstable
     roleGroups:
       default:
         replicas: 3