Skip to content

rpk cloud auth token reference#605

Merged
kbatuigas merged 3 commits into
mainfrom
DOC-2218-add-rpk-cloud-auth-token
May 29, 2026
Merged

rpk cloud auth token reference#605
kbatuigas merged 3 commits into
mainfrom
DOC-2218-add-rpk-cloud-auth-token

Conversation

@kbatuigas
Copy link
Copy Markdown
Contributor

@kbatuigas kbatuigas commented May 29, 2026

Description

Related: redpanda-data/docs#1723

This pull request adds documentation for the new rpk cloud auth token command and updates related references throughout the documentation. The main changes include creating a dedicated reference page for the command, updating the navigation, and ensuring that relevant guides link to the new documentation.

Documentation additions and updates:

  • Added a new reference page for the rpk cloud auth token command at modules/reference/pages/rpk/rpk-cloud/rpk-cloud-auth-token.adoc.
  • Updated the navigation in modules/ROOT/nav.adoc to include the new rpk-cloud-auth-token reference.
  • Updated SQL authentication documentation in modules/sql/pages/connect-to-sql/authenticate.adoc to link to the new reference page for rpk cloud auth token.
  • Updated SQL getting started guides (modules/sql/pages/get-started/sql-quickstart.adoc and modules/sql/pages/get-started/deploy-sql-cluster.adoc) to reference the new rpk cloud auth token documentation when instructing users to retrieve a temporary authentication token.

Build configuration:

  • Updated the local-antora-playbook.yml to use the correct branch (DOC-2218-add-reference-for-rpk-cloud-auth-token) for the documentation source, ensuring the new reference page is included in local builds.

Resolves https://github.com/redpanda-data/documentation-private/issues/
Review deadline:

Page previews

Checks

  • New feature
  • Content gap
  • Support Follow-up
  • Small fix (typos, links, copyedits, etc)

@kbatuigas kbatuigas requested a review from a team as a code owner May 29, 2026 17:24
@netlify
Copy link
Copy Markdown

netlify Bot commented May 29, 2026

Deploy Preview for rp-cloud ready!

Name Link
🔨 Latest commit 9bdc7fd
🔍 Latest deploy log https://app.netlify.com/projects/rp-cloud/deploys/6a19e13d12d45e000849d4b6
😎 Deploy Preview https://deploy-preview-605--rp-cloud.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 29, 2026

Review Change Stack

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2846a2fb-17f2-4f2b-9b31-7bcb91f3f5a5

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

This PR adds a new reference documentation page for the rpk cloud auth token command to the Redpanda Cloud documentation. The changes consist of: creating the reference page that includes content from a shared partial; updating the Antora build configuration to track the feature branch; adding a navigation entry to expose the page; and updating three SQL documentation pages to cross-reference the new page instead of using inline code formatting for token retrieval instructions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • redpanda-data/cloud-docs#485: Both PRs modify local-antora-playbook.yml to adjust Antora content.sources git branch configuration for the documentation build.
  • redpanda-data/cloud-docs#463: Both PRs change local-antora-playbook.yml's content.sources git-branch filters for the local Antora content source.
  • redpanda-data/cloud-docs#462: Both PRs modify Antora configuration and navigation setup (local-antora-playbook.yml and modules/ROOT/nav.adoc) to wire in new documentation from feature branches.

Suggested reviewers

  • andresaristizabal
  • deniscoady
  • Mateoc
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'rpk cloud auth token reference' directly and concisely describes the main change: adding documentation and reference for the new rpk cloud auth token command.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description check ✅ Passed The PR description is comprehensive and includes most required information, with clear documentation of changes, page previews, and related context. However, the issue number placeholder remains unfilled and no review deadline is specified.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch DOC-2218-add-rpk-cloud-auth-token

Comment @coderabbitai help to get the list of available commands and usage tips.

Comment thread local-antora-playbook.yml Outdated
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@local-antora-playbook.yml`:
- Line 18: The branches list contains a non-standard branch entry
'DOC-2218-add-reference-for-rpk-cloud-auth-token' which fails branch validation;
edit the branches array (the "branches" key in local-antora-playbook.yml) to
replace that offending ref with an allowed branch (e.g., main) so the entry
becomes a valid ref among the existing items (ensure the rest of the list
elements like v/*, shared, site-search remain unchanged).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 342d3455-9739-4c64-9427-e831b5733964

📥 Commits

Reviewing files that changed from the base of the PR and between d2bd7b7 and a94f05f.

📒 Files selected for processing (6)
  • local-antora-playbook.yml
  • modules/ROOT/nav.adoc
  • modules/reference/pages/rpk/rpk-cloud/rpk-cloud-auth-token.adoc
  • modules/sql/pages/connect-to-sql/authenticate.adoc
  • modules/sql/pages/get-started/deploy-sql-cluster.adoc
  • modules/sql/pages/get-started/sql-quickstart.adoc

Comment thread local-antora-playbook.yml Outdated
branches: HEAD
- url: https://github.com/redpanda-data/documentation
branches: [main, v/*, shared, site-search]
branches: ['DOC-2218-add-reference-for-rpk-cloud-auth-token', v/*, shared, site-search]
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical | ⚡ Quick win

Revert non-standard branch in playbook to pass branch validation.

This line introduces a branch value that violates the allowed branch policy and is already failing CI (check-branches). Replace it with an allowed ref (typically main) for mergeable config.

Suggested fix
-    branches: ['DOC-2218-add-reference-for-rpk-cloud-auth-token', v/*, shared, site-search]
+    branches: [main, v/*, shared, site-search]
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
branches: ['DOC-2218-add-reference-for-rpk-cloud-auth-token', v/*, shared, site-search]
branches: [main, v/*, shared, site-search]
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@local-antora-playbook.yml` at line 18, The branches list contains a
non-standard branch entry 'DOC-2218-add-reference-for-rpk-cloud-auth-token'
which fails branch validation; edit the branches array (the "branches" key in
local-antora-playbook.yml) to replace that offending ref with an allowed branch
(e.g., main) so the entry becomes a valid ref among the existing items (ensure
the rest of the list elements like v/*, shared, site-search remain unchanged).

Copy link
Copy Markdown
Contributor

@micheleRP micheleRP left a comment

Choose a reason for hiding this comment

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

lgtm!

@kbatuigas kbatuigas merged commit db07bbb into main May 29, 2026
5 checks passed
@kbatuigas kbatuigas deleted the DOC-2218-add-rpk-cloud-auth-token branch May 29, 2026 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants