Skip to content

Update certificates.md with cert rotation process #50557

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 2 commits into
base: main
Choose a base branch
from

Conversation

jayeshmahajan
Copy link
Contributor

Description

​To address Issue #30575 in the kubernetes/website repository, which pertains to documenting the requirements and recommended process for updating cluster certificates, need to create or modify specific documentation files within the repository.​
GitHub

📄 Target Documentation Files
Based on the nature of the issue, the following files are relevant candidates for updates:​

content/en/docs/setup/best-practices/certificates.md

This file discusses best practices for managing certificates in Kubernetes.​

Issue

#30575

Closes: # #30575

@k8s-ci-robot k8s-ci-robot added the language/en Issues or PRs related to English language label Apr 19, 2025
@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 natalisucks 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 cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Apr 19, 2025
Copy link

netlify bot commented Apr 19, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit a5c6b28
🔍 Latest deploy log https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/68070c0aa88e330008385569
😎 Deploy Preview https://deploy-preview-50557--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 site configuration.

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.

We shouldn't merge this as-is, because moving manifests for static Pods aside typically causes failure of that component. If we advise people to move then back then that helps a lot.


Overall, I recommend writing a new and brief (but accurate) task page.

content/en/docs/setup/best-practices/certificates.md can then link to the new page.

For clusters using static pods, follow these steps:

1. Replace the existing certificate files on disk (e.g., `/etc/kubernetes/pki/apiserver.crt`).
2. Temporarily move the manifest file for the component (e.g., `/etc/kubernetes/manifests/kube-apiserver.yaml`) to another directory.
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this will take the control plane offline unless there are further steps.

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/S Denotes a PR that changes 10-29 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants