Skip to content

Conversation

jvoravong
Copy link

This pull request adds a new subsection to the kubectl quick reference guide:
"Aliases for Quick Response in Unknown Kubernetes Environments."

The goal is to provide a lightweight, reusable set of kubectl aliases for users operating in constrained, time-sensitive, or unfamiliar Kubernetes environments—such as during on-call incidents, ephemeral environments, or across diverse multicloud production setups (e.g., EKS, GKE, AKS, OpenShift).

This is my first time contributing to the Kubernetes documentation project. I've seen a recurring need for this kind of alias utility over time, and I’ve personally found it useful across environments with limited tooling or locked-down access to anything beyond the official Kubernetes resources.

If others find this helpful, I’d love to see it included as part of the quick-reference section. Let me know if anything is missing—happy to make adjustments.

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jul 3, 2025
@k8s-ci-robot
Copy link
Contributor

Welcome @jvoravong!

It looks like this is your first PR to kubernetes/website 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/website has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign nate-double-u for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added language/en Issues or PRs related to English language size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Jul 3, 2025
@k8s-ci-robot k8s-ci-robot requested review from reylejano and tengqm July 3, 2025 11:04
Copy link

netlify bot commented Jul 3, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit b30e9a6
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/686663b0cfb30e000822b9ca
😎 Deploy Preview https://deploy-preview-51497--kubernetes-io-main-staging.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.

@jvoravong
Copy link
Author

Copy link
Contributor

@lmktfy lmktfy left a comment

Choose a reason for hiding this comment

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

Thanks, but I disagree with merging this.

The aliases you suggest are a handy set but they are also quite opinionated, and different people might have their own opinions about what works best.

The explanatory paragraphs also aren't right for a quick reference.

I notice for example you use kubectl get events not kubectl events; another place where there might be contention is which container image registry to use for krun.

We also can't assume

Consider proposing a blog article with b these suggestions instead.

@jvoravong
Copy link
Author

Thanks for the feedback, totally fair. I often work in environments where only the Kubernetes.io docs are accessible, so a few more aliases somewhere in the official docs would really help in time-sensitive or restricted situations. I’ll get a change out with a smaller set focused on the least opinionated ones and see if that looks more feasible.

@lmktfy
Copy link
Contributor

lmktfy commented Jul 3, 2025

We might consider a change different page, but I don't think we would.
Ultimately, if your employer doesn't agree with letting you look at your set of useful aliases, talk to your employer. The Kubernetes docs are not the right place to store your notes.

The quick reference page is arguably already quite long. A careful bit of curation is, I think, more valuable.

@jvoravong
Copy link
Author

Thought on this for a bit, @lmktfy's feedback was useful. So I'm going to try out these other approaches.

Closing this PR in favor of these other approaches.

@jvoravong jvoravong closed this Jul 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants