Skip to content

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

Merged
NickLarsenNZ merged 3 commits intomainfrom
fix/getting-started-pre-26.3.0
Mar 12, 2026
Merged

fix(docs): Update getting-started script pre-26.3.0#123
NickLarsenNZ merged 3 commits intomainfrom
fix/getting-started-pre-26.3.0

Conversation

@Techassi
Copy link
Member

Check and Update Getting Started Script

Part of stackabletech/issues#826

This getting-started script was technically fine as is (it ran through without any issues), but I still opted to include both waiting conditions, because it generally a good thing to do going forward.

Copy link
Member

@adwk67 adwk67 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This hangs when using the helm install (stackablectl works fine):

Events:
  Type     Reason            Age                   From               Message
  ----     ------            ----                  ----               -------
...
MountVolume.SetUp failed for volume "pvc-f096ca69-82f2-43c4-8a6f-9e02c103f8bf" : rpc error: code = Unavailable desc = listener has no addresses yet
  Warning  FailedMount       41s (x9 over 4m50s)   kubelet            MountVolume.SetUp failed for volume "pvc-9de1bb0c-f73a-40b3-9671-ea9d83f68923" : rpc error: code = FailedPrecondition desc = failed to parse pod details: PodListeners.v1alpha1.listeners.stackable.tech/pod-7d2401dc-ca8a-45fa-a5a5-a34881a68726.default has no addresses for listener discovery-service-listener yet

I'll try again

@adwk67 adwk67 moved this from Development: Waiting for Review to Development: In Review in Stackable Engineering Mar 11, 2026
@adwk67
Copy link
Member

adwk67 commented Mar 11, 2026

This hangs when using the helm install (stackablectl works fine):
...

OK, I need to helm install the listener-op with --set preset=stable-nodes on kind

Fix

Either change

helm install --wait listener-operator oci://oci.stackable.tech/sdp-charts/listener-operator --version 0.0.0-dev

by appending --preset=stable-nodes (in getting_started.sh/.sh.j2)

or

change discoveryServiceListenerClass: external-stable --> external-unstable in opensearch.yaml.

@Techassi
Copy link
Member Author

Techassi commented Mar 12, 2026

In my opinion, the second approach is the better one. What do you think @adwk67?

@adwk67
Copy link
Member

adwk67 commented Mar 12, 2026

In my opinion, the second approach is the better one. What do you think @adwk67?

Yes, I agree - that's cleaner and less invasive.

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.
@NickLarsenNZ
Copy link
Member

NickLarsenNZ commented Mar 12, 2026

Personally I would have gone with the preset, and made sure there's a note in the getting started docs to help the reader make the right choice for themselves (a comment in the yaml could do the same too).

Copy link
Member

@NickLarsenNZ NickLarsenNZ left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM (see my earlier comment).

@NickLarsenNZ NickLarsenNZ added this pull request to the merge queue Mar 12, 2026
@NickLarsenNZ NickLarsenNZ moved this from Development: In Review to Development: Done in Stackable Engineering Mar 12, 2026
Merged via the queue into main with commit 65e1c96 Mar 12, 2026
10 checks passed
@NickLarsenNZ NickLarsenNZ deleted the fix/getting-started-pre-26.3.0 branch March 12, 2026 09:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Development: Done

Development

Successfully merging this pull request may close these issues.

3 participants