Migrate Exploring Kubernetes Services tutorial from Meshery docs#1020
Conversation
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces a new Kubernetes tutorial section and a detailed hands-on guide for exploring Kubernetes Services using Meshery Playground and Kanvas. The tutorial covers the creation and management of ClusterIP, NodePort, and LoadBalancer services. The review feedback identifies several minor grammatical and clarity issues, including a redundant phrase in the description, unnecessary articles, missing prepositions, and incorrect hyphenation of 'pop-up'.
|
|
||
| ### Introduction | ||
|
|
||
| In this tutorial, we'll learn to implement Kubernetes **Services**, the resources responsible for exposing applications inside and outside the cluster. Using Meshery Playground, an interactive live cluster environment, we'll perform hands-on labs to gain practical experience with the Kubernetes Services, without writing any YAML. |
There was a problem hiding this comment.
Minor grammatical improvement: "the Kubernetes Services" can be simplified to "Kubernetes Services" for better flow.
| In this tutorial, we'll learn to implement Kubernetes **Services**, the resources responsible for exposing applications inside and outside the cluster. Using Meshery Playground, an interactive live cluster environment, we'll perform hands-on labs to gain practical experience with the Kubernetes Services, without writing any YAML. | |
| In this tutorial, we'll learn to implement Kubernetes **Services**, the resources responsible for exposing applications inside and outside the cluster. Using Meshery Playground, an interactive live cluster environment, we'll perform hands-on labs to gain practical experience with Kubernetes Services, without writing any YAML. |
There was a problem hiding this comment.
Fixed — the article was removed; now reads 'Kubernetes Services' without 'the'.
| Now switch to Operator mode, click on any component to view details(like type or selector) about the Service or the Pod. | ||
|  | ||
|
|
||
| Note that this service is mapped NodePort and is accessible on the **Node’s IP address**. |
There was a problem hiding this comment.
"mapped NodePort" is missing a preposition. It should be "mapped to a NodePort" for better readability.
| Note that this service is mapped NodePort and is accessible on the **Node’s IP address**. | |
| Note that this service is mapped to a NodePort and is accessible on the **Node’s IP address**. |
There was a problem hiding this comment.
Fixed — updated to 'mapped to a NodePort'.
|
There was a problem hiding this comment.
Pull request overview
This PR migrates the “Exploring Kubernetes Services with Meshery” tutorial into the Layer5 Docs Kanvas tutorial section, introducing a new Kubernetes tutorials subsection and adding URL aliases intended to preserve legacy links.
Changes:
- Added a new Kanvas Kubernetes tutorials section index page.
- Added the migrated Kubernetes Services tutorial page (ClusterIP, NodePort, LoadBalancer) with updated paths/aliases.
- Updated screenshot paths to the
/kanvas/tutorials/images/...convention.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 9 comments.
| File | Description |
|---|---|
| content/en/kanvas/tutorials/kubernetes/_index.md | Introduces the Kubernetes subsection under Kanvas tutorials. |
| content/en/kanvas/tutorials/kubernetes/kubernetes-services.md | Adds the migrated Services tutorial content, including aliases and updated image/link references. |
|
|
||
| In this tutorial, we'll learn to implement Kubernetes **Services**, the resources responsible for exposing applications inside and outside the cluster. Using Meshery Playground, an interactive live cluster environment, we'll perform hands-on labs to gain practical experience with Kubernetes Services, without writing any YAML. | ||
|
|
||
| > **NOTE:** If this is your first time working with Meshery Playground, consider starting with the [Exploring Kubernetes Pods with Meshery Playground](/kanvas/tutorials/kubernetes/kubernetes-pods) tutorial first or [Exploring Kubernetes Deployments with Meshery](/kanvas/tutorials/kubernetes/kubernetes-deployments). |
There was a problem hiding this comment.
Addressed — the links now point to the existing tutorial pages on docs.meshery.io rather than non-existent local paths.
There was a problem hiding this comment.
Addressed — the links now point to existing tutorial pages on docs.meshery.io rather than non-existent local paths.
| - Click **Kanvas** from the left menu to navigate to the [_Kanvas_ design](https://kanvas.new/extension/meshmap) page. | ||
|
|
||
|  | ||
|
|
There was a problem hiding this comment.
Fixed — all image URLs were updated to reference existing assets on docs.meshery.io instead of a non-existent local path.
There was a problem hiding this comment.
Fixed — all image URLs now reference existing assets on docs.meshery.io.
| ### Introduction | ||
|
|
||
| In this tutorial, we'll learn to implement Kubernetes **Services**, the resources responsible for exposing applications inside and outside the cluster. Using Meshery Playground, an interactive live cluster environment, we'll perform hands-on labs to gain practical experience with Kubernetes Services, without writing any YAML. | ||
|
|
||
| > **NOTE:** If this is your first time working with Meshery Playground, consider starting with the [Exploring Kubernetes Pods with Meshery Playground](/kanvas/tutorials/kubernetes/kubernetes-pods) tutorial first or [Exploring Kubernetes Deployments with Meshery](/kanvas/tutorials/kubernetes/kubernetes-deployments). | ||
|
|
||
|
|
||
| ### Prerequisites | ||
|
|
||
| - Basic understanding of containerization and Kubernetes concepts. | ||
| - Access to the _Meshery Playground_. If you don't have an account, sign up at [Meshery Playground](https://playground.meshery.io/). | ||
|
|
||
| ### Lab Scenario | ||
|
|
||
| Deploy a simple application or a simple Pod and expose it using ClusterIP, NodePort, and LoadBalancer services. Each service will route traffic to the pods via a common label selector. We’ll inspect the service details in Operator mode to confirm their types and behavior. | ||
|
|
||
| ### Objective | ||
|
|
||
| Learn how to create, manage, and explore _Kubernetes Services_ to expose applications within the context of a microservices architecture. | ||
|
|
||
| ### Steps | ||
|
|
There was a problem hiding this comment.
Fixed — top-level section headings were promoted to ## and sub-steps use ###, matching the existing Kanvas tutorial convention.
| - **Image**: `meshery/meshery-milestone:latest` | ||
| - **Name**: `meshery-milestone` | ||
|  | ||
|
|
There was a problem hiding this comment.
Fixed — the sub-bullets and screenshot are now indented under step 7.
There was a problem hiding this comment.
Fixed — the sub-bullets and screenshot are now indented under step 7.
| - **Port**: `80` | ||
| - **TargetPort**: `80` | ||
| - **NodePort**: `30091` (or leave blank to auto-assign). | ||
|  |
There was a problem hiding this comment.
Fixed — the Port/TargetPort/NodePort bullets and screenshot are now indented under step 4.
There was a problem hiding this comment.
Fixed — the Port/TargetPort/NodePort bullets and screenshot are now indented under step 4.
|
@copilot resolve the merge conflicts in this pull request |
Resolved in e030df9 by merging the latest |
Migrate the Exploring Kubernetes Services with Meshery tutorial to content/en/kanvas/tutorials/kubernetes/kubernetes-services.md. - Add hands-on tutorial covering ClusterIP, NodePort, and LoadBalancer service types using Meshery Playground and Kanvas - Preserve legacy URL aliases (/guides/tutorials/kubernetes-services, /kanvas/tutorials/kubernetes-services) - Use ## / ### heading hierarchy matching existing Kanvas tutorials - Add descriptive alt text on every screenshot for accessibility - Link screenshots to existing assets on docs.meshery.io - Add intro content to kubernetes/_index.md Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: Yi Nuo <218099172+yi-nuo426@users.noreply.github.com>
yi-nuo426
force-pushed
the
claude/migrate-k8s-tutorial-Rc5G2
branch
from
e030df9 to
0d2025f
Compare
Summary
Migrates the Exploring Kubernetes Services with Meshery tutorial from
meshery/meshery(docs/content/en/guides/tutorials/kubernetes/kubernetes-services.md) intolayer5io/docsundercontent/en/kanvas/tutorials/kubernetes/.content/en/kanvas/tutorials/kubernetes/_index.mdto introduce a Kubernetes section under the Kanvas tutorials.content/en/kanvas/tutorials/kubernetes/kubernetes-services.md, the migrated tutorial walking through ClusterIP, NodePort, and LoadBalancer service types in Meshery Playground./guides/tutorials/images/...to/kanvas/tutorials/images/...to match the existing Kanvas tutorial image convention.kubernetes-pods,kubernetes-deployments) to the anticipated/kanvas/tutorials/kubernetes/...paths so they resolve once the sister tutorials migrate over./guides/tutorials/kubernetes-services/guides/tutorials/kubernetes/kubernetes-services/kanvas/tutorials/kubernetes-servicesCompanion change
The source file is removed from
meshery/mesheryon the matching branch (claude/migrate-k8s-tutorial-Rc5G2).Follow-ups
/kanvas/tutorials/images/kubernetes-services/and/kanvas/tutorials/images/kubernetes-deployments/need to be copied frommeshery/meshery(docs/static/guides/tutorials/images/kubernetes-services/,docs/static/guides/tutorials/images/kubernetes-deployments/) into this repo's static path before the page renders fully.kubernetes-pods,kubernetes-deployments, etc.) referenced from this page will continue to 404 on the Layer5 site until they are migrated similarly.Test plan
hugo --quietbuilds without errors/kanvas/tutorials/kubernetes/kubernetes-services/renders end-to-end/guides/tutorials/kubernetes-servicesand/guides/tutorials/kubernetes/kubernetes-servicesredirect to the new pagestatic/kanvas/tutorials/images/kubernetes-services/Generated by Claude Code