Renamed getting-started.sh -> getting_started.sh (#561)

# Description

Test doesn't work _yet_, but the renaming and test adaptions work on a custom cluster/locally.

Follow up ticket: #569

Author: Felix Hennig

docs/modules/kafka/examples/getting_started/getting-started.sh renamed to docs/modules/kafka/examples/getting_started/getting_started.sh

@@ -25,22 +25,24 @@ echo "Adding 'stackable-dev' Helm Chart repository"
 # tag::helm-add-repo[]
 helm repo add stackable-dev https://repo.stackable.tech/repository/helm-dev/
 # end::helm-add-repo[]
+echo "Updating Helm repositories"
+helm repo update
 echo "Installing Operators with Helm"
 # tag::helm-install-operators[]
-helm install --wait commons-operator stackable-dev/commons-operator --version 0.5.0-nightly
-helm install --wait secret-operator stackable-dev/secret-operator --version 0.6.0-nightly
-helm install --wait zookeeper-operator stackable-dev/zookeeper-operator --version 0.13.0-nightly
-helm install --wait kafka-operator stackable-dev/kafka-operator --version 0.9.0-nightly
+helm install --wait commons-operator stackable-dev/commons-operator --version 0.0.0-dev
+helm install --wait secret-operator stackable-dev/secret-operator --version 0.0.0-dev
+helm install --wait zookeeper-operator stackable-dev/zookeeper-operator --version 0.0.0-dev
+helm install --wait kafka-operator stackable-dev/kafka-operator --version 0.0.0-dev
 # end::helm-install-operators[]
 ;;
 "stackablectl")
 echo "installing Operators with stackablectl"
 # tag::stackablectl-install-operators[]
 stackablectl operator install \
-  commons=0.5.0-nightly \
-  secret=0.6.0-nightly \
-  zookeeper=0.13.0-nightly \
-  kafka=0.9.0-nightly
+  commons=0.0.0-dev \
+  secret=0.0.0-dev \
+  zookeeper=0.0.0-dev \
+  kafka=0.0.0-dev
 # end::stackablectl-install-operators[]
 ;;
 *)
@@ -59,23 +61,23 @@ echo "Installing ZNode from kafka-znode.yaml"
 kubectl apply -f kafka-znode.yaml
 # end::install-znode[]
 
-sleep 5
+sleep 15
 
 echo "Awaiting ZooKeeper rollout finish"
 # tag::watch-zookeeper-rollout[]
-kubectl rollout status --watch statefulset/simple-zk-server-default
+kubectl rollout status --watch --timeout=5m statefulset/simple-zk-server-default
 # end::watch-zookeeper-rollout[]
 
 echo "Install KafkaCluster from kafka.yaml"
 # tag::install-kafka[]
 kubectl apply -f kafka.yaml
 # end::install-kafka[]
 
-sleep 5
+sleep 15
 
 echo "Awaiting Kafka rollout finish"
 # tag::watch-kafka-rollout[]
-kubectl rollout status --watch statefulset/simple-kafka-broker-default
+kubectl rollout status --watch --timeout=5m statefulset/simple-kafka-broker-default
 # end::watch-kafka-rollout[]
 
 echo "Starting port-forwarding of port 9092"
@@ -85,7 +87,7 @@ kubectl port-forward svc/simple-kafka 9092 2>&1 >/dev/null &
 PORT_FORWARD_PID=$!
 trap "kill $PORT_FORWARD_PID" EXIT
 
-sleep 5
+sleep 15
 
 echo "Creating test data"
 # tag::kcat-create-data[]

docs/modules/kafka/examples/getting_started/getting-started.sh.j2 renamed to docs/modules/kafka/examples/getting_started/getting_started.sh.j2

@@ -25,6 +25,8 @@ echo "Adding '{{ helm.repo_name }}' Helm Chart repository"
 # tag::helm-add-repo[]
 helm repo add {{ helm.repo_name }} {{ helm.repo_url }}
 # end::helm-add-repo[]
+echo "Updating Helm repositories"
+helm repo update
 echo "Installing Operators with Helm"
 # tag::helm-install-operators[]
 helm install --wait commons-operator {{ helm.repo_name }}/commons-operator --version {{ versions.commons }}
@@ -59,23 +61,23 @@ echo "Installing ZNode from kafka-znode.yaml"
 kubectl apply -f kafka-znode.yaml
 # end::install-znode[]
 
-sleep 5
+sleep 15
 
 echo "Awaiting ZooKeeper rollout finish"
 # tag::watch-zookeeper-rollout[]
-kubectl rollout status --watch statefulset/simple-zk-server-default
+kubectl rollout status --watch --timeout=5m statefulset/simple-zk-server-default
 # end::watch-zookeeper-rollout[]
 
 echo "Install KafkaCluster from kafka.yaml"
 # tag::install-kafka[]
 kubectl apply -f kafka.yaml
 # end::install-kafka[]
 
-sleep 5
+sleep 15
 
 echo "Awaiting Kafka rollout finish"
 # tag::watch-kafka-rollout[]
-kubectl rollout status --watch statefulset/simple-kafka-broker-default
+kubectl rollout status --watch --timeout=5m statefulset/simple-kafka-broker-default
 # end::watch-kafka-rollout[]
 
 echo "Starting port-forwarding of port 9092"
@@ -85,7 +87,7 @@ kubectl port-forward svc/simple-kafka 9092 2>&1 >/dev/null &
 PORT_FORWARD_PID=$!
 trap "kill $PORT_FORWARD_PID" EXIT
 
-sleep 5
+sleep 15
 
 echo "Creating test data"
 # tag::kcat-create-data[]

docs/modules/kafka/examples/getting_started/install-operator-output.txt

@@ -1,6 +1,6 @@
 # tag::stackablectl-install-operators-output[]
-[INFO ] Installing commons operator in version 0.5.0-nightly
-[INFO ] Installing secret operator in version 0.6.0-nightly
-[INFO ] Installing zookeeper operator in version 0.13.0-nightly
-[INFO ] Installing kafka operator in version 0.9.0-nightly
+[INFO ] Installing commons operator in version 0.0.0-dev
+[INFO ] Installing secret operator in version 0.0.0-dev
+[INFO ] Installing zookeeper operator in version 0.0.0-dev
+[INFO ] Installing kafka operator in version 0.0.0-dev
 # end::stackablectl-install-operators-output[]

docs/modules/kafka/pages/getting_started/first_steps.adoc

@@ -25,7 +25,7 @@ and apply it:
 
 [source,bash]
 ----
-include::example$getting_started/getting-started.sh[tag=install-zookeeper]
+include::example$getting_started/getting_started.sh[tag=install-zookeeper]
 ----
 
 Create a file `kafka-znode.yaml` with the following content:
@@ -39,7 +39,7 @@ and apply it:
 
 [source,bash]
 ----
-include::example$getting_started/getting-started.sh[tag=install-znode]
+include::example$getting_started/getting_started.sh[tag=install-znode]
 ----
 
 === Kafka
@@ -54,7 +54,7 @@ include::example$getting_started/kafka.yaml[]
 and apply it:
 
 ----
-include::example$getting_started/getting-started.sh[tag=install-kafka]
+include::example$getting_started/getting_started.sh[tag=install-kafka]
 ----
 
 This will create the actual Kafka instance.
@@ -81,37 +81,37 @@ simple-zk-server-default             3/3     7m
 Then, create a port-forward for the Kafka Broker:
 
 ----
-include::example$getting_started/getting-started.sh[tag=port-forwarding]
+include::example$getting_started/getting_started.sh[tag=port-forwarding]
 ----
 
 Create a file containing some data:
 
 ----
-include::example$getting_started/getting-started.sh[tag=kcat-create-data]
+include::example$getting_started/getting_started.sh[tag=kcat-create-data]
 ----
 
 Write that data:
 
 ----
-include::example$getting_started/getting-started.sh[tag=kcat-write-data]
+include::example$getting_started/getting_started.sh[tag=kcat-write-data]
 ----
 
 Read that data:
 
 ----
-include::example$getting_started/getting-started.sh[tag=kcat-read-data]
+include::example$getting_started/getting_started.sh[tag=kcat-read-data]
 ----
 
 Check the content:
 
 ----
-include::example$getting_started/getting-started.sh[tag=kcat-check-data]
+include::example$getting_started/getting_started.sh[tag=kcat-check-data]
 ----
 
 And clean up:
 
 ----
-include::example$getting_started/getting-started.sh[tag=kcat-cleanup-data]
+include::example$getting_started/getting_started.sh[tag=kcat-cleanup-data]
 ----
 
 You successfully created a Kafka cluster and produced and consumed data.

docs/modules/kafka/pages/getting_started/installation.adoc

@@ -18,7 +18,7 @@ After you have installed stackablectl, run the following command to install all
 
 [source,bash]
 ----
-include::example$getting_started/getting-started.sh[tag=stackablectl-install-operators]
+include::example$getting_started/getting_started.sh[tag=stackablectl-install-operators]
 ----
 
 The tool will show
@@ -36,14 +36,14 @@ You can also use Helm to install the operators. Add the Stackable Helm repositor
 
 [source,bash]
 ----
-include::example$getting_started/getting-started.sh[tag=helm-add-repo]
+include::example$getting_started/getting_started.sh[tag=helm-add-repo]
 ----
 
 Then install the Stackable Operators:
 
 [source,bash]
 ----
-include::example$getting_started/getting-started.sh[tag=helm-install-operators]
+include::example$getting_started/getting_started.sh[tag=helm-install-operators]
 ----
 
 Helm will deploy the operators in a Kubernetes Deployment and apply the CRDs for the Apache Kafka service (as well as the CRDs for the required operators). You are now ready to deploy Apache Kafka in Kubernetes.

docs/templating_vars.yaml

@@ -3,7 +3,7 @@ helm:
   repo_name: stackable-dev
   repo_url: https://repo.stackable.tech/repository/helm-dev/
 versions:
-  commons: 0.5.0-nightly
-  secret: 0.6.0-nightly
-  zookeeper: 0.13.0-nightly
-  kafka: 0.9.0-nightly
+  commons: 0.0.0-dev
+  secret: 0.0.0-dev
+  zookeeper: 0.0.0-dev
+  kafka: 0.0.0-dev