Skip to content

docs: v.4 Tutorial fixes after testing#454

Open
izmalk wants to merge 26 commits intocanonical:mainfrom
izmalk:tutorial-fixes
Open

docs: v.4 Tutorial fixes after testing#454
izmalk wants to merge 26 commits intocanonical:mainfrom
izmalk:tutorial-fixes

Conversation

@izmalk
Copy link
Contributor

@izmalk izmalk commented Jan 15, 2026

Kafka VM v.4 tutorial manual testing and review/rewrite.

@izmalk izmalk self-assigned this Jan 15, 2026
izmalk added 17 commits January 20, 2026 00:18
commit 4752587
Author: Vladimir Izmalkov <48120135+izmalk@users.noreply.github.com>
Date:   Tue Jan 13 17:49:48 2026 +0000

    docs: Home page remodeling (canonical#448)

    * Home page remodeling
    * Update tutorial enumeration
    * Fixed broken links
    * Resolve Kafka links errors
    * Minor update
    Update Applications management to Client connections page.
    Then realize we can simplify into Connections management.
    * Fix upstream docs link from 4.0 to 4.1

commit 638717e
Author: Iman Enami <44609233+imanenami@users.noreply.github.com>
Date:   Tue Jan 13 10:06:27 2026 +0400

    [DPE-9033] chore: update TF provider to v1.0+ and TLS to 1/stable (canonical#442)
Signed-off-by: Vladimir Izmalkov <48120135+izmalk@users.noreply.github.com>
@izmalk izmalk marked this pull request as ready for review January 23, 2026 10:27
@izmalk izmalk changed the title v.4 Tutorial fixes after testing docs: v.4 Tutorial fixes after testing Jan 26, 2026
@izmalk izmalk added the documentation Improvements or additions to documentation label Jan 26, 2026
Copy link
Contributor

@marcoppenheimer marcoppenheimer left a comment

Choose a reason for hiding this comment

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

Approving to speed things along, left some todos that need addressing before merging.


```shell
juju show-secret --reveal cluster.kafka.app | yq '.. | ."admin-password"? // empty' | tr -d '"'
juju show-secret --reveal cluster.kafka.app | yq -r '.[].content["operator-password"]'
Copy link
Contributor

Choose a reason for hiding this comment

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

question: Why change this? It's fine, just curious.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

  1. It's no longer admin-password.
  2. The "empty" thing didn't work on my system (Ubuntu 24.04 LTS).
  3. The older syntax produced weird results for me. I don't remember exactly what was wrong. I think there were some excessive line breaks, or maybe it failed to find the field due to nested levels.


```shell
bootstrap_address=$(juju show-unit kafka/0 | yq '.. | ."public-address"? // empty' | tr -d '"')
bootstrap_address=$(juju show-unit kafka/0 | yq '.. | ."public-address"? // ""' | tr -d '"' | tr -d '\r\n' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
Copy link
Contributor

Choose a reason for hiding this comment

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

question: Same here, why change this? The proposed change is much more complicated.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think there were problems with invisible characters and/or line breaks included in the field and failing because of that.
If you don't like the complexity, I can spend some more time to optimise it.

First, create the Juju secret with the new password you wish to use:

```shell
juju add-secret internal-kafka-users admin=mynewpassword
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I've kept the admin here since I've tested the command myself and it worked that way. Do let me know if we need to change it here too.

@marcoppenheimer
Copy link
Contributor

Bump @marcoppenheimer @imanenami @zmraul

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants