Skip to content

Commit a14fc07

Browse files
committed
simplify to single node
1 parent 3263187 commit a14fc07

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

modules/ROOT/pages/getting_started.adoc

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -24,26 +24,19 @@ Kind offers a very quick and easy way to bootstrap your Kubernetes infrastructur
2424

2525
If you don't already have Docker then visit https://docs.docker.com/get-docker/[Docker Website] to find out how to install Docker. Kind is a single executable that performs the tasks of installing and configuring Kubernetes for you within Docker containers. The https://kind.sigs.k8s.io/docs/user/quick-start/[Kind Website] has instructions for installing Kind on your system.
2626

27-
Once you have both of these installed then you can build a Kubernetes cluster in Docker. We're going to create a 2 node cluster to test out Stackable, one node hosting the Kubernetes control plane and the other hosting the Stackable services.
27+
Once you have both of these installed then you can build a Kubernetes cluster in Docker. We're going to create a simple, single node cluster to test out Stackable, with the one node hosting both the Kubernetes control plane and the Stackable services.
2828

2929
[source, bash]
3030
----
31-
kind create cluster --name quickstart --config - << EOF
32-
---
33-
kind: Cluster
34-
apiVersion: kind.x-k8s.io/v1alpha4
35-
nodes:
36-
- role: control-plane
37-
- role: worker
38-
EOF
31+
kind create cluster --name quickstart
3932
----
4033

4134
=== Installing Kubernetes using K3s
4235
K3s provides a quick way of installing Kubernetes. On your control node run the following command to install K3s:
4336

4437
[source,bash]
4538
----
46-
curl -sfL https://get.k3s.io | sh -s - --node-label 'node=quickstart-1' --write-kubeconfig-mode 644
39+
curl -sfL https://get.k3s.io | sh -s - --write-kubeconfig-mode 644
4740
----
4841

4942
So long as you have an Internet connection K3s will download and automatically configure a simple Kubernetes environment.
@@ -64,7 +57,14 @@ To check if everything worked as expected you can use `kubectl cluster-info` to
6457
----
6558
Kubernetes control plane is running at https://127.0.0.1:6443
6659
CoreDNS is running at https://127.0.0.1:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
67-
Metrics-server is running at https://127.0.0.1:6443/api/v1/namespaces/kube-system/services/https:metrics-server:/proxy
60+
----
61+
62+
If you set up your cluster using K3s you will additionally see the metrics server:
63+
64+
----
65+
Kubernetes control plane is running at https://127.0.0.1:6443
66+
CoreDNS is running at https://127.0.0.1:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
67+
Metrics-server is running at https://127.0.0.1:6443/api/v1/namespaces/kube-system/services/https:metrics-server:https/proxy
6868
----
6969

7070
== Installing Stackable
@@ -298,31 +298,31 @@ To get the IP address we need to connect to (in this case `172.18.0.2`), run:
298298

299299
[source,bash]
300300
----
301-
kubectl get nodes --selector=kubernetes.io/hostname=quickstart-worker -o wide
301+
kubectl get nodes -o wide
302302
----
303303
----
304-
NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME
305-
quickstart-worker Ready <none> 25m v1.25.3 172.18.0.2 <none> Ubuntu 22.04.1 LTS 5.14.0-1052-oem containerd://1.6.9
304+
NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME
305+
quickstart-control-plane Ready control-plane 9m59s v1.25.3 172.18.0.2 <none> Ubuntu 22.04.1 LTS 5.14.0-1052-oem containerd://1.6.9
306306
----
307307

308308

309-
With the following command we get the port (in this case `30247`):
309+
With the following command we get the port (in this case `31931`):
310310

311311
[source,bash]
312312
----
313313
kubectl get svc simple-nifi
314314
----
315315

316316
----
317-
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
318-
simple-nifi NodePort 10.96.88.205 <none> 8443:30166/TCP 8m5s
317+
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
318+
simple-nifi NodePort 10.96.82.80 <none> 8443:31931/TCP 7m51s
319319
----
320320

321-
Browse to the address of your Kubernetes node on port `30166` e.g. https://172.18.0.2:30166/nifi and you should see the NiFi login screen.
321+
Browse to the address of your Kubernetes node on port `31931` e.g. https://172.18.0.2:31931/nifi and you should see the NiFi login screen.
322322

323323
image:nifi_login_screen.png[The Apache NiFi web interface login screen]
324324

325-
The Apache NiFi operator will automatically generate the admin user credentials with a random password and store it as a Kubernetes secret in order to provide some security out of the box. You can retrieve this password for the `admin` user with the following kubectl command.
325+
If a password has not been specified for the admin user the Apache NiFi operator will automatically generate the admin user credentials with a random password and store it as a Kubernetes secret in order to provide some security out of the box. In the example above we have provided our own secret, but you can retrieve and confirm this password for the `admin` user with the following kubectl command.
326326

327327
[source,bash]
328328
----

0 commit comments

Comments
 (0)