Skip to content

Add blog article on 7 Common Kubernetes Pitfalls #49249

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 32 commits into
base: main
Choose a base branch
from

Conversation

lhajouji
Copy link
Contributor

Description

This is a request to create a blog post that walks readers through seven common Kubernetes pitfalls, which can trip up both beginners and experienced practitioners.

Thanks in advance for your consideration.

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. area/blog Issues or PRs related to the Kubernetes Blog subproject labels Dec 27, 2024
@k8s-ci-robot k8s-ci-robot added language/en Issues or PRs related to English language size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Dec 27, 2024
Copy link

netlify bot commented Dec 27, 2024

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 4e78ade
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/682520398d8cbf0008cbc40c
😎 Deploy Preview https://deploy-preview-49249--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.

@lhajouji lhajouji changed the title creating a new blog post seven-kubernetes-pitfalls-and-how-to-avoid [Blog] Creating a new blog post seven-kubernetes-pitfalls-and-how-to-avoid Dec 31, 2024
@siddhant-khisty
Copy link

siddhant-khisty commented Jan 3, 2025

Overall I think this blog's structure and. content look great.

One thing that I think can be imporved is adding some more description to the pitfalls of every section. For example, for the third point it would be great to provide some more context as to why the logs get lost after some time. Similarly more details for the reasons for the other pitfalls

@lhajouji
Copy link
Contributor Author

lhajouji commented Jan 3, 2025

Overall I think this blog's structure and. content look great.

One thing that I think can be imporved is adding some more description to the pitfalls of every section. For example, for the third point it would be great to provide some more context as to why the logs get lost after some time. Similarly more details for the reasons for the other pitfalls

@siddhant-khisty Thanks for the valuable review ! i'll try to add this detail.

Adding some context to the first pitfall.
@sftim
Copy link
Contributor

sftim commented Jan 31, 2025

@lhajouji, would you be willing to review an open blog PR? See this list of pull requests that might need a review?

I suggest you take a look at #49163, but any reviews are welcome.

If you can do that, it'll help with the overall backlog of articles pending review.

@lhajouji
Copy link
Contributor Author

lhajouji commented Feb 1, 2025

@lhajouji, would you be willing to review an open blog PR? See this list of pull requests that might need a review?

I suggest you take a look at #49163, but any reviews are welcome.

If you can do that, it'll help with the overall backlog of articles pending review.

Ok i'll take a look.

Copy link
Contributor

@graz-dev graz-dev left a comment

Choose a reason for hiding this comment

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

@lhajouji great pice and great insights.
I left some comments about our style guide.

lhajouji and others added 15 commits March 24, 2025 15:19
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
lhajouji and others added 8 commits March 24, 2025 15:25
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Graziano Casto <graziano.casto@outlook.com>
…oid.md

Co-authored-by: Tim Bannister <tim@scalefactory.com>
@sftim
Copy link
Contributor

sftim commented Mar 24, 2025

/retitle Add blog article on 7 Common Kubernetes Pitfalls

@k8s-ci-robot k8s-ci-robot changed the title [Blog] Creating a new blog post seven-kubernetes-pitfalls-and-how-to-avoid Add blog article on 7 Common Kubernetes Pitfalls Mar 24, 2025
Copy link
Contributor

@sftim sftim left a comment

Choose a reason for hiding this comment

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

Hi. Some more feedback.

Do you know how to squash commits? If you do, please do that after making your next changes.

**The Pitfall**: Jumping into complex service meshes, advanced CNI plugins, or multi-cluster traffic routing before you really grasp the basics of ClusterIP, NodePort, or a simple Ingress setup.

**How to Avoid It**:
- Start small: a Deployment, a Service, maybe a basic Ingress controller (like NGINX).
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: NGINX is not itself an ingress controller

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, i agree, i'll change it accordingly.

**The Pitfall**: Deploying the same YAML with the same resources and settings to dev, staging, and production. Different environments have different needs, traffic patterns, and sometimes secrets.

**How to Avoid It**:
- Use environment overlays or [kustomize](/docs/tasks/manage-kubernetes-objects/kustomization/) to maintain a shared base while customizing resource requests, replicas, or config for each environment.
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: better to link to https://kustomize.io/

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ok, i'll change it.

@lmktfy
Copy link
Contributor

lmktfy commented May 11, 2025

@lhajouji I offered some suggestions previously

You can reject them or let us know you don't think the fixes help, but even if you do, please do respond.

…oid.md

Co-authored-by: Tim Bannister <22591623+sftim@users.noreply.github.com>
@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 mrbobbytables 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

lhajouji and others added 5 commits May 15, 2025 00:57
…oid.md

Co-authored-by: Tim Bannister <22591623+sftim@users.noreply.github.com>
…oid.md

Co-authored-by: Tim Bannister <22591623+sftim@users.noreply.github.com>
…oid.md

Co-authored-by: Tim Bannister <22591623+sftim@users.noreply.github.com>
…oid.md

Co-authored-by: Tim Bannister <22591623+sftim@users.noreply.github.com>
…oid.md

Co-authored-by: Tim Bannister <22591623+sftim@users.noreply.github.com>
@lhajouji
Copy link
Contributor Author

lhajouji commented May 14, 2025

@lhajouji I offered some suggestions previously

You can reject them or let us know you don't think the fixes help, but even if you do, please do respond.

Hello @lmktfy,
Thanks for the suggestions! I agree with all the fixes and have already committed some of them. I’ll complete the rest shortly.

@lmktfy
Copy link
Contributor

lmktfy commented May 19, 2025

Once you're happy with this, please rebase against main and squash it down to 1 commit.

(let us know if you're not sure what that means, though - we can help)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/blog Issues or PRs related to the Kubernetes Blog subproject cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants