From 9278969eec621f1521780d8b3afb2e5ef45eb189 Mon Sep 17 00:00:00 2001 From: Jim Halfpenny Date: Thu, 30 Jun 2022 15:19:40 +0100 Subject: [PATCH 1/4] Updated the getting started guide with fixes for latest versions of the operators and services. --- modules/ROOT/pages/getting_started.adoc | 36 +++++++++++-------------- 1 file changed, 16 insertions(+), 20 deletions(-) diff --git a/modules/ROOT/pages/getting_started.adoc b/modules/ROOT/pages/getting_started.adoc index 4ab7b7655..818e4325e 100644 --- a/modules/ROOT/pages/getting_started.adoc +++ b/modules/ROOT/pages/getting_started.adoc @@ -141,7 +141,7 @@ spec: replicas: 1 config: myidOffset: 10 - version: 3.5.8 + version: 3.8.0-stackable0 EOF ---- @@ -157,15 +157,12 @@ kind: KafkaCluster metadata: name: simple-kafka spec: - version: 2.8.1 + version: 2.8.1-stackable0 zookeeperConfigMapName: simple-kafka-znode brokers: roleGroups: brokers: replicas: 1 - selector: - matchLabels: - node: quickstart-1 --- apiVersion: zookeeper.stackable.tech/v1alpha1 kind: ZookeeperZnode @@ -206,24 +203,24 @@ kind: NifiCluster metadata: name: simple-nifi spec: - version: "1.15.0" + version: 1.16.3-stackable0.1.0 zookeeperConfigMapName: simple-nifi-znode - authenticationConfig: - method: - SingleUser: - adminCredentialsSecret: - name: nifi-admin-credentials-simple - autoGenerate: true - sensitivePropertiesConfig: - keySecret: nifi-sensitive-property-key - autoGenerate: true + config: + authentication: + method: + singleUser: + adminCredentialsSecret: nifi-admin-credentials-simple + autoGenerate: true + sensitiveProperties: + keySecret: nifi-sensitive-property-key + autoGenerate: true nodes: roleGroups: default: - selector: - matchLabels: - node: quickstart-1 config: + selector: + matchLabels: + kubernetes.io/os: linux log: rootLogLevel: INFO replicas: 1 @@ -274,13 +271,12 @@ kubectl exec -i -t simple-kafka-broker-brokers-0 -c kafka -- \ Created topic demo. ---- -Now let's check if it was actually created: +You should see the message, "Created topic demo." on the console. Now let's check to see if it was actually created: [source,bash] ---- kubectl exec -i -t simple-kafka-broker-brokers-0 -c kafka -- \ bin/kafka-topics.sh --bootstrap-server localhost:9092 --list -demo ---- === Apache NiFi From 726cf3b1ce50f7d103fb671a46f2590dad206ae7 Mon Sep 17 00:00:00 2001 From: Jim Halfpenny Date: Thu, 30 Jun 2022 17:45:23 +0100 Subject: [PATCH 2/4] Changed stackablectl command to use the 22.06 release --- modules/ROOT/pages/getting_started.adoc | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/modules/ROOT/pages/getting_started.adoc b/modules/ROOT/pages/getting_started.adoc index 818e4325e..a20c7625e 100644 --- a/modules/ROOT/pages/getting_started.adoc +++ b/modules/ROOT/pages/getting_started.adoc @@ -82,11 +82,11 @@ Install the Stackable command line utility xref:stackablectl::index.adoc[stackab === Installing Stackable Operators The Stackable operators are components that translate the service definitions deployed via Kubernetes into deploy services on the worker nodes. These can be installed on any node that has access to the Kubernetes control plane. In this example we will install them on the controller node. -Stackable operators are installed using stackablectl. Run the following commands to install the latest operator versions of ZooKeeper, Kafka and NiFi. +Stackable operators can be installed using stackablectl. Run the following commands to install ZooKeeper, Kafka and NiFi from the Stackable 22.06 release. [source,bash] ---- -stackablectl operator install zookeeper secret nifi kafka +stackablectl release install -i zookeeper -i kafka -i nifi -i secret 22.06 ---- .Using Helm instead @@ -103,21 +103,21 @@ Install the operators: [source,bash] ---- -helm install zookeeper-operator stackable-stable/zookeeper-operator --version=0.9.0 -helm install kafka-operator stackable-stable/kafka-operator --version=0.5.0 -helm install secret-operator stackable-stable/secret-operator --version=0.2.0 -helm install nifi-operator stackable-stable/nifi-operator --version=0.5.0 +helm install zookeeper-operator stackable-stable/zookeeper-operator --version=0.10.0 +helm install kafka-operator stackable-stable/kafka-operator --version=0.6.0 +helm install secret-operator stackable-stable/secret-operator --version=0.5.0 +helm install nifi-operator stackable-stable/nifi-operator --version=0.6.0 ---- ==== You can check which operators are installed using `stackablectl operator installed`: ---- -OPERATOR VERSION NAMESPACE STATUS LAST UPDATED -kafka 0.6.0-nightly default deployed 2022-06-16 13:51:05.661282811 +0200 CEST -nifi 0.6.0-nightly default deployed 2022-06-20 16:22:45.985504689 +0200 CEST -secret 0.5.0-nightly default deployed 2022-06-20 16:07:40.248027167 +0200 CEST -zookeeper 0.10.0-nightly default deployed 2022-06-16 13:50:51.497813301 +0200 CEST +OPERATOR VERSION NAMESPACE STATUS LAST UPDATED +kafka 0.6.0 default deployed 2022-06-30 17:01:17.552606 +0100 BST +nifi 0.6.0 default deployed 2022-06-30 17:01:31.895733 +0100 BST +secret 0.5.0 default deployed 2022-06-30 17:07:48.542761 +0100 BST +zookeeper 0.10.0 default deployed 2022-06-30 17:01:47.032154 +0100 BST ---- == Deploying Stackable Services From 98ee7845479205a2f6ff69fb77a937bc58c2bf59 Mon Sep 17 00:00:00 2001 From: Jim Halfpenny Date: Mon, 4 Jul 2022 12:10:39 +0100 Subject: [PATCH 3/4] Removed example command output that break Kafka topic test. --- modules/ROOT/pages/getting_started.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/modules/ROOT/pages/getting_started.adoc b/modules/ROOT/pages/getting_started.adoc index a20c7625e..13ca19e8d 100644 --- a/modules/ROOT/pages/getting_started.adoc +++ b/modules/ROOT/pages/getting_started.adoc @@ -268,7 +268,6 @@ First create the topic with the following command: ---- kubectl exec -i -t simple-kafka-broker-brokers-0 -c kafka -- \ bin/kafka-topics.sh --bootstrap-server localhost:9092 --create --topic demo -Created topic demo. ---- You should see the message, "Created topic demo." on the console. Now let's check to see if it was actually created: From e2703acf9e59c92af6d85fe10e1b8d44f24bf4e8 Mon Sep 17 00:00:00 2001 From: Jim Halfpenny Date: Tue, 5 Jul 2022 10:46:27 +0100 Subject: [PATCH 4/4] Removed obsolete reference to stackable-utils --- modules/ROOT/pages/getting_started.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/modules/ROOT/pages/getting_started.adoc b/modules/ROOT/pages/getting_started.adoc index 13ca19e8d..c4ddf231e 100644 --- a/modules/ROOT/pages/getting_started.adoc +++ b/modules/ROOT/pages/getting_started.adoc @@ -6,7 +6,6 @@ One of the best ways of getting started with a new platform is to try it out. An Firstly, let’s cover whether this *Getting Started* guide is right for you. This is intended as a learning tool to discover more about Stackable, its deployment and architecture. -* If you just want to get up and running quickly there is a quickstart script that will install services on a single node available in the https://github.com/stackabletech/stackable-utils[stackable-utils] repository on GitHub. * If you want to build a production cluster then this is not for you. This tutorial is to familiarise you with the Stackable architecture and is not a guide for building robust clusters. * This is intended for use in a private network or lab; it doesn't enable many security features such as authentication or encryption and should not be directly connected to the Internet. Be careful if you're deploying in the cloud as your instances may default to using public IPs.