Skip to content

docs: update install-with-keadm.md for KubeEdge v1.21#731

Closed
sachin21212121 wants to merge 1 commit intokubeedge:masterfrom
sachin21212121:docs/update-keadm-v1.21
Closed

docs: update install-with-keadm.md for KubeEdge v1.21#731
sachin21212121 wants to merge 1 commit intokubeedge:masterfrom
sachin21212121:docs/update-keadm-v1.21

Conversation

@sachin21212121
Copy link

This PR updates the install-with-keadm.md documentation based on feedback from PR #725

Changes include:

  1. Updated instructions for KubeEdge v1.21.

  2. Fixed all broken links (direct links to GitHub/KubeEdge docs).

  3. Removed redundant content and excessive blank lines.

  4. Corrected code block language formatting.

  5. Added “Deprecated Commands” sections for clarity.

  6. Simplified and clarified the introduction and prerequisites.

Signed-off-by: sachin21212121 <jhasachin0115@gmail.com>
@kubeedge-bot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
To complete the pull request process, please assign shelley-baoyue after the PR has been reviewed.
You can assign the PR to them by writing /assign @shelley-baoyue in a comment when ready.

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

Details 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

@gemini-code-assist
Copy link

Summary of Changes

Hello @sachin21212121, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly refines the install-with-keadm.md documentation, bringing it up-to-date with KubeEdge v1.21. The changes aim to enhance the clarity, accuracy, and maintainability of the installation guide by updating version-specific instructions, fixing broken links, and streamlining content based on community feedback.

Highlights

  • KubeEdge Version Update: Updated all installation instructions and command examples to reflect KubeEdge version v1.21.
  • Documentation Clarity: Simplified introductory sections, prerequisites, and removed redundant content for improved readability.
  • Broken Link Fixes: Addressed and corrected all broken links within the document, ensuring accurate references to GitHub and KubeEdge documentation.
  • Deprecated Commands: Introduced dedicated sections for deprecated 'keadm' commands for both cloud and edge setups, enhancing clarity on command usage.
  • Code Block Formatting: Corrected and standardized code block language formatting for better presentation and syntax highlighting.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@kubeedge-bot kubeedge-bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Sep 26, 2025
Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This is a great pull request that significantly improves the install-with-keadm.md documentation. The content is now much more concise, better structured, and easier to follow. Updating the commands to KubeEdge v1.21 and cleaning up the command outputs are excellent changes.

I've found a couple of broken links and a potential issue in one of the YAML examples. My detailed feedback is in the review comments. Once these minor issues are addressed, this documentation will be in great shape.

Comment on lines +177 to +202
spec:
affinity:
nodeAffinity:
requiredDuringSchedulingIgnoredDuringExecution:
nodeSelectorTerms:
- matchExpressions:
- key: kubernetes.io/hostname
operator: In
values:
- charlie-latest
hostNetwork: true
containers:
- name: metrics-server
image: metrics-server-kubeedge:latest
imagePullPolicy: Never
args:
- --cert-dir=/tmp
- --secure-port=4443
- --v=2
- --kubelet-insecure-tls
- --kubelet-preferred-address-types=InternalDNS,InternalIP,ExternalIP,Hostname
- --kubelet-use-node-status-port
ports:
- name: main-port
containerPort: 4443
protocol: TCP

Choose a reason for hiding this comment

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

high

The example deployment for metrics-server is missing the volumes and volumeMounts for the temporary directory, which is used by the --cert-dir=/tmp argument. This can cause the pod to fail if it's based on a minimal or scratch image without a writable /tmp directory. Please add the necessary volume configuration.

spec:
  affinity:
    nodeAffinity:
      requiredDuringSchedulingIgnoredDuringExecution:
        nodeSelectorTerms:
        - matchExpressions:
          - key: kubernetes.io/hostname
            operator: In
            values:
            - charlie-latest
  hostNetwork: true
  volumes:
  - name: tmp-dir
    emptyDir: {}
  containers:
  - name: metrics-server
    image: metrics-server-kubeedge:latest
    imagePullPolicy: Never
    volumeMounts:
    - name: tmp-dir
      mountPath: /tmp
    args:
      - --cert-dir=/tmp
      - --secure-port=4443
      - --v=2
      - --kubelet-insecure-tls
      - --kubelet-preferred-address-types=InternalDNS,InternalIP,ExternalIP,Hostname
      - --kubelet-use-node-status-port
    ports:
    - name: main-port
      containerPort: 4443
      protocol: TCP

### Helm Notes

3. `keadm init` by default, deploys CloudCore in container mode. If you want to deploy CloudCore as a binary, please refer to [`keadm deprecated init`](#keadm-deprecated-init).
Set flags `--set key=value` for CloudCore Helm chart. See [CloudCore Helm Charts README.md](https://github.com/kubeedge/kubeedge/tree/master/build/cloud/cloudcore).

Choose a reason for hiding this comment

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

medium

The link to the CloudCore Helm Charts README is broken and results in a 404 error. Please update it to point to the correct file for the v1.21 release.

Suggested change
Set flags `--set key=value` for CloudCore Helm chart. See [CloudCore Helm Charts README.md](https://github.com/kubeedge/kubeedge/tree/master/build/cloud/cloudcore).
Set flags `--set key=value` for CloudCore Helm chart. See [CloudCore Helm Charts README.md](https://github.com/kubeedge/kubeedge/blob/release-1.21/manifests/charts/cloudcore/README.md).

```
## Deploy Demo on Edge Nodes

Refer to [Deploy demo on edge nodes](https://kubeedge.io/docs/setup/deploy-demo/).

Choose a reason for hiding this comment

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

medium

This link to deploy a demo on edge nodes is broken. Please update it to point to the correct page and anchor.

Suggested change
Refer to [Deploy demo on edge nodes](https://kubeedge.io/docs/setup/deploy-demo/).
Refer to [Deploy demo on edge nodes](https://kubeedge.io/docs/setup/install-with-binary#deploy-demo-on-edge-nodes).

@sachin21212121 sachin21212121 deleted the docs/update-keadm-v1.21 branch September 26, 2025 08:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

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.

2 participants