Skip to content

Conversation

@timothyb89
Copy link
Contributor

Backport of #62697 for branch/v18


Improve Ansible AWX documentation

This resolves a few TODOs in the Ansible AWX guide now that the required features have been released and available for a decent amount of time.

  • The guide now recommends tctl tokens configure-kube instead of showing steps only for static_jwks. The old steps have been moved to an alternate flow in the troubleshooting section, as a manual fallback.
  • We now recommend using tbot-distroless as it has a copy-binaries helper that removes the need for a debug image.
  • We no longer recommend disabling ControlMaster, as we fixed a bug preventing its use.

Closes #59619

* Improve Ansible AWX documentation

This resolves a few TODOs in the Ansible AWX guide now that the
required features have been released and available for a decent amount
of time.

- The guide now recommends `tctl tokens configure-kube` instead of
  showing steps only for `static_jwks`. The old steps have been moved
  to an alternate flow in the troubleshooting section, as a manual
  fallback.
- We now recommend using `tbot-distroless` as it has a `copy-binaries`
  helper that removes the need for a debug image.
- We no longer recommend disabling `ControlMaster`, as we fixed a bug
  preventing its use.

Closes #59619

* Small tweaks and clarifications

Added a note about `kubectl` contexts, expanded on token creation,
and clarified a few sentences.

* Add `kubectl` access to the awx cluster as a prereq
@timothyb89 timothyb89 added the no-changelog Indicates that a PR does not require a changelog entry label Jan 10, 2026
@github-actions
Copy link

github-actions bot commented Jan 10, 2026

Amplify deployment status

Branch Commit Job ID Status Preview Updated (UTC)
timothyb89/v18/awx-docs-improvements HEAD 1 ✅SUCCEED timothyb89-v18-awx-docs-improvements 2026-01-10 00:47:56

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

Labels

backport documentation no-changelog Indicates that a PR does not require a changelog entry size/sm

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants