meshery / meshery

Meshery, the cloud native manager
https://meshery.io
Apache License 2.0
5.1k stars 1.59k forks source link

[Docs] Tutorials: "Hello Kubernetes" with Dapr #11011

Open leecalcote opened 1 month ago

leecalcote commented 1 month ago

This child issue is related to "[Playground] Learning Paths: Cloud Native tutorials with Meshery Playground #9832". See this issue for more context.

Current State

Meshery Docs are in need of new tutorials with hands-on labs. In this tutorial, we will explore how to use Meshery Playground, an interactive live cluster environment, to perform hands-on labs for managing Kubernetes deployments. Meshery is a powerful tool that simplifies the adoption and operation of cloud and cloud native technologies. Meshery Playground provides a safe and isolated environment for learning and experimenting with these technologies.

Desired State

GOAL: Recreate the Dapr Hello Kubernetes tutorial using Meshery.

  1. Take the following sample and refactor in context of Meshery Playground.
  2. Instead of kubectl commands use Meshery UI and MeshMap as the primary mechanisms for users to perform tasks in the labs. Put CLI commands inside of <details><summary></summary></details> as an alternative reference.
  3. Reference existing Meshery Designs from the Meshery Catalog both as starting point and/or as a finished example of the lab.
  4. As needed, take screenshots or video recordings to enrich the content.
Example Tutorial Format ```yaml --- layout: default title: Exploring Kubernetes Deployments with Meshery Playground abstract: Learn Kubernetes Deployments with Meshery Playground permalink: guides/tutorials/kubernetes-deployments redirect_from: guides/tutorials/kubernetes-deployments/ type: guide category: tutorial language: en abstract: "In this tutorial, we will explore Kubernetes Deployments using Meshery Playground, an interactive live cluster environment, to perform hands-on labs for deploying and managing applications." --- Introduction: In this tutorial, we will delve into the world of Kubernetes Deployments, a key resource for managing and scaling containerized applications. Utilizing Meshery Playground, an interactive live cluster environment, we'll conduct hands-on labs to gain practical experience in deploying and managing applications using Kubernetes Deployments. Prerequisites: - Basic understanding of Kubernetes concepts. - Meshery Playground access. If you don't have an account, sign up at [Meshery Playground](https://meshery.layer5.io/play). Lab Scenario: Deploying and Scaling a Microservices Application Objective: Learn how to use Kubernetes Deployments to deploy and scale a microservices-based application. ### Steps: #### 1. **Accessing Meshery Playground:** - Log in to the [Meshery Playground](https://meshery.layer5.io/play) using your credentials. - Navigate to the Meshery Playground dashboard. #### 2. **Deploying a Microservices Application:** - Deploy a sample microservices application with multiple components using Kubernetes Deployments. \```bash # Deploying a sample microservices application mesheryctl pattern apply -f https://raw.githubusercontent.com/example/microservices-app-deployment.yaml \``` #### 3. **Scaling Deployments:** - Explore how to scale individual components of the microservices application by adjusting the replicas in the Deployment configuration. \```bash kubectl scale deployment --replicas=3 \``` #### 4. **Updating Deployments:** - Learn how to update the microservices application by rolling out changes to the Deployment. \```bash kubectl set image deployment/ =new-image:tag \``` #### 5. **Rollback Deployments:** - Understand the process of rolling back changes in case of issues or errors during an update. \```bash kubectl rollout undo deployment/ \``` #### 6. **Monitoring and Troubleshooting Deployments:** - Utilize Meshery Playground to monitor the status of Deployments and troubleshoot common issues. #### 7. **Clean-Up:** - Delete the Deployments and associated resources after completing the lab. \```bash mesheryctl pattern delete -f https://raw.githubusercontent.com/example/microservices-app-deployment.yaml \``` #### 8. **Saving and Sharing:** - Save your scenario in Meshery Playground for future reference. - Share your Deployment scenarios with the Meshery community for collaborative learning. ### Conclusion Congratulations! You've successfully completed the lab on exploring Kubernetes Deployments using Meshery Playground. This hands-on experience has equipped you with practical knowledge on deploying, scaling, updating, and monitoring applications in a Kubernetes environment. Continue exploring more scenarios in the Meshery Playground to enhance your skills in container orchestration. {% include related-content.html type="tutorials" %} ```

Contributor Guides and Handbook

Emmanjr commented 1 month ago

@leecalcote I would like to work on this as well