Skip to content

docs: add tctl and Terraform methods for creating Access Lists - #69407

Open
kimlisa wants to merge 1 commit into
masterfrom
lisa/update-doc-acl
Open

docs: add tctl and Terraform methods for creating Access Lists#69407
kimlisa wants to merge 1 commit into
masterfrom
lisa/update-doc-acl

Conversation

@kimlisa

@kimlisa kimlisa commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

part of https://github.com/gravitational/teleport.e/issues/8271

Updates the doc on access list. The custom, jit, and standing access list creating guides now also adds guides to create list through tctl and terraform.

🛑 TODO:

@kimlisa kimlisa added no-changelog Indicates that a PR does not require a changelog entry no-test-plan Bypasses the test plan validation bot labels Aug 6, 2026
@kimlisa
kimlisa requested review from r0mant and smallinsky August 6, 2026 06:48
@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Amplify deployment status

Branch Commit Job ID Status Preview Updated (UTC)
lisa/update-doc-acl a0f51ee 2 ✅SUCCEED lisa-update-doc-acl 2026-08-06 07:15:18

Preview links for changed docs pages

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bb73863f81

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread docs/pages/identity-governance/access-lists/custom-access-list.mdx
@kimlisa
kimlisa force-pushed the lisa/update-doc-acl branch from bb73863 to a0f51ee Compare August 6, 2026 07:08
@@ -0,0 +1,2 @@
`tctl acl create` was introduced in `tctl` v18.10.3. On earlier versions of
`tctl`, use the Web UI.

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.

In the JIT and Standing guides: the Terraform tab points to a Web UI step that no longer exists in the docs. In both jit-access-list.mdx and standing-access-list.mdx, the new Terraform tab says:

"On earlier versions of tctl, use the Web UI instead: the guided flow mirrors your input as a Terraform module, which you can copy at the final Deployment step."

But the Web UI tab in this same diff was rewritten to drop the old "Deploy the Access List" section entirely; it now just says "click Create Access List Now." There's no more mention of a Terraform-copy option at the Deployment step anywhere in the Web UI tab. So a reader on an old tctl version who follows that fallback instruction won't find what they're told to look for.

Either the Web UI Deployment step still has a "copy Terraform" option and that needs to stay documented in the webui tab, or it doesn't and this fallback sentence is stale and needs rewriting. I have Version: 18.10.3 nd am not sure how to roll my own cluster back to an earlier version to test it out.

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

Labels

documentation no-changelog Indicates that a PR does not require a changelog entry no-test-plan Bypasses the test plan validation bot size/md

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants