Skip to content

Fix KubeEdge Version and Update WasmEdge Docs#227

Open
sachin21212121 wants to merge 1 commit intokubeedge:masterfrom
sachin21212121:docs/wasmedge-update
Open

Fix KubeEdge Version and Update WasmEdge Docs#227
sachin21212121 wants to merge 1 commit intokubeedge:masterfrom
sachin21212121:docs/wasmedge-update

Conversation

@sachin21212121
Copy link

Updated the WasmEdge + KubeEdge documentation to use a valid KubeEdge version (v1.21.0) and Improved consistency of variables and links to official docs

…ns and code improvements

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 benjaminhuo after the PR has been reviewed.
You can assign the PR to them by writing /assign @benjaminhuo 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
Contributor

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 focuses on updating the WasmEdge + KubeEdge integration documentation to align with a more recent and stable KubeEdge version (v1.21.0). The changes ensure that the provided installation and usage instructions are accurate and compatible with current KubeEdge features, while also improving the overall structure and clarity of the guide for better user experience.

Highlights

  • KubeEdge Version Update: The documentation has been updated to use KubeEdge v1.21.0 for all installation examples, ensuring compatibility with the latest features and container runtime configurations.
  • Documentation Clarity and Consistency: Improvements include the addition of YAML front matter, clear section separators, explicit language annotations for code blocks (e.g., bash, text), and consistent bolding of key terms for enhanced readability.
  • Updated External Links: Links to the official KubeEdge installation guide and the Kubelet logs feature documentation have been revised to point to the most current and relevant resources.
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 25, 2025
Copy link
Contributor

@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 pull request provides a much-needed update to the WasmEdge and KubeEdge integration documentation. The changes, including updating the KubeEdge version, using variables for consistency, fixing links, and improving formatting, significantly enhance the clarity and usability of the guide. I've added a couple of suggestions to make the shell commands more generic and user-friendly, which should further improve the reader's experience.

```bash
# Use a compatible KubeEdge version and specify the profile
KUBEEDGE_VERSION=v1.21.0
keadm init --advertise-address="THE-EXPOSED-IP" --profile version=${KUBEEDGE_VERSION} --kube-config=/root/.kube/config
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

The hardcoded path --kube-config=/root/.kube/config might not be suitable for all environments, as users may not be running as root or may have their kubeconfig file in a different location. It's better to omit this flag to let keadm use the default kubeconfig path ($HOME/.kube/config) or the KUBECONFIG environment variable. This makes the command more general, and users with a non-standard configuration can still add the flag back if needed.

Suggested change
keadm init --advertise-address="THE-EXPOSED-IP" --profile version=${KUBEEDGE_VERSION} --kube-config=/root/.kube/config
keadm init --advertise-address="THE-EXPOSED-IP" --profile version=${KUBEEDGE_VERSION}

Comment on lines +114 to +115
# Replace ${token} with the actual token obtained from 'keadm gettoken'
keadm join --cloudcore-ipport="THE-EXPOSED-IP":10000 --token=${token} --kubeedge-version=${KUBEEDGE_VERSION}
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

Using ${token} can be misleading, as it suggests a shell variable that should already be defined on the edge node. Since the token is generated on the cloud node and needs to be manually provided here, using a more explicit placeholder like <TOKEN> would be clearer for the user and reduce potential confusion.

Suggested change
# Replace ${token} with the actual token obtained from 'keadm gettoken'
keadm join --cloudcore-ipport="THE-EXPOSED-IP":10000 --token=${token} --kubeedge-version=${KUBEEDGE_VERSION}
# Replace <TOKEN> with the actual token obtained from 'keadm gettoken'
keadm join --cloudcore-ipport="THE-EXPOSED-IP":10000 --token=<TOKEN> --kubeedge-version=${KUBEEDGE_VERSION}

Comment on lines -133 to -182
Name: wasi-demo
Namespace: default
Priority: 0
Node: kubeedge-dev-linux-baoyue/192.168.1.123
Start Time: Mon, 06 Mar 2023 19:41:42 +0800
Labels: run=wasi-demo
Annotations: module.wasm.image/variant: compat-smart
Status: Succeeded
IP: 10.88.0.13
IPs:
IP: 10.88.0.13
IP: 2001:4860:4860::d
Containers:
wasi-demo:
Container ID: containerd://1e1df3ece5d3d67ead3375e82df039d617b9698e421be2a085eadbfe273b2a06
Image: hydai/wasm-wasi-example:with-wasm-annotation
Image ID: docker.io/hydai/wasm-wasi-example@sha256:525aab8d6ae8a317fd3e83cdac14b7883b92321c7bec72a545edf276bb2100d6
Port: <none>
Host Port: <none>
Args:
/wasi_example_main.wasm
50000000
State: Terminated
Reason: Completed
Exit Code: 0
Started: Mon, 06 Mar 2023 19:41:50 +0800
Finished: Mon, 06 Mar 2023 19:41:50 +0800
Ready: False
Restart Count: 0
Environment: <none>
Mounts:
/var/run/secrets/kubernetes.io/serviceaccount from kube-api-access-lznkt (ro)
Conditions:
Type Status
Initialized True
Ready False
ContainersReady False
PodScheduled True
Volumes:
kube-api-access-lznkt:
Type: Projected (a volume that contains injected data from multiple sources)
TokenExpirationSeconds: 3607
ConfigMapName: kube-root-ca.crt
ConfigMapOptional: <nil>
DownwardAPI: true
QoS Class: BestEffort
Node-Selectors: <none>
Tolerations: node.kubernetes.io/not-ready:NoExecute op=Exists for 300s
node.kubernetes.io/unreachable:NoExecute op=Exists for 300s
Events: <none>
Copy link
Member

Choose a reason for hiding this comment

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

I think we want to keep this, could you add it back?

Copy link
Author

Choose a reason for hiding this comment

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

sure, i will add it back

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.

3 participants