Skip to content

Commit

Permalink
add api water tracker workshop (#7)
Browse files Browse the repository at this point in the history
  • Loading branch information
katiesavage authored Dec 21, 2022
1 parent df129fa commit 7bfb0d8
Show file tree
Hide file tree
Showing 20 changed files with 1,099 additions and 2 deletions.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,7 @@ Welcome to the [Next Generation Team's Workshop Library](presentation.pptx), bui
2️⃣ | [Track your Water Consumption with .NET IoT](./full/track-water-consumption-iot-dotnet/) | Krzysztof Wicher and Katie Savage | 1 hour | Create an IoT project that will track your water consumption using weight sensors and an accelerometer | [🎥](https://aka.ms/studentzone-iot) | .NET, IoT, Azure |
2️⃣ | [Python HTTP API for use with GitHub Codespaces](./short/codespaces-project-template-py/) | Alfredo Deza | 35 minutes | Customize your Codespaces environment and get hands-on with a Python web app that serves an HTTP API using the [FastAPI](https://fastapi.tiangolo.com/) framework. | [🎥](https://www.youtube.com/watch?v=_i9Pywj3rSg) | Codespaces, Python, Azure |
2️⃣ | [Build a Minimal API with .NET 6](./full/intro-minapi/README.md) | Katie Savage | 1 hour | Build your first web API by building a Todo list. | [🎥](https://youtu.be/rGcVkQRP2t4) | .NET 6, SQLite, [Build a web API with minimal API, ASP.NET Core, and .NET 6](https://docs.microsoft.com/learn/modules/build-web-api-minimal-api/) |
2️⃣ | [Build an API for Water Consumption Tracking](./full/backend-api-water-tracker/README.md) | Chris Noring and Katie Savage | 1 hour | Build an API to serve data related to your water consumption. | [🎥](https://aka.ms/studentzone-apis) | [.NET SDK](https://dotnet.microsoft.com/download/dotnet/6.0?WT.mc_id=academic-78652-leestott), [Visual Studio Code](https://code.visualstudio.com/), [Azure Tools](https://code.visualstudio.com/docs/azure/extensions) |
2️⃣ | [Get Started with React](./full/intro-react/README.md) | Christopher Harrison | 1 hour | Learn how to create React components, add style, and use JSX. | [🎥](https://youtu.be/_id4QTDI5yg) | VS Code, Node, Git, [Getting started with React](https://docs.microsoft.com/learn/modules/react-get-started/?WT.mc_id=academic-56602-chrhar)|
2️⃣ | [Create Serverless Logic with Azure Functions](./full/azure-functions/README.md) | Ornella Altunyan | 45 mins | How to identify if an Azure function is right for your development needs, and how to create and use functions from the Azure portal | [🎥](https://youtu.be/ebiLaNQuP4g) | JavaScript or PowerShell, [Create serverless logic with Azure Functions](https://docs.microsoft.com/learn/modules/create-serverless-logic-with-azure-functions/?WT.mc_id=academic-56400-ornella) |
2️⃣ | [Get Started with Django](./full/django-get-started/README.md) | Christopher Harrison | 1-1.5 hours | Build a web app with Django | [🎥](https://youtu.be/H3dDiVNY_ks) | Python, [Get started with Django](https://docs.microsoft.com/learn/modules/django-get-started/?WT.mc_id=academic-56601-chrhar)|
Expand Down
60 changes: 60 additions & 0 deletions full/backend-api-water-tracker/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# Build an API for Water Consumption Tracking

## Module Source Link

[Build an API for Water Consumption Tracking, from the .NET Conf Student Zone 2022 Event](https://github.com/microsoft/dotnetconf-studentzone/tree/main/Add%20a%20backend%20to%20your%20website)

## Goals

In this workshop, we will discuss how to create an API to serve data from a database.

| **Goal** | Create an API to serve data related to water consumption |
| ----------------------------- | --------------------------------------------------------------------- |
| **What will you learn** | .NET APIs, Entity Framework |
| **What you'll need** | [.NET SDK](https://dotnet.microsoft.com/download/dotnet/6.0?WT.mc_id=academic-78652-leestott), [Visual Studio Code](https://code.visualstudio.com/), [Azure Tools](https://code.visualstudio.com/docs/azure/extensions)|
| **Duration** | 1 hour |
| **Microsoft Cloud Topics taught** | Azure |
| **Just want to try the app or see the solution?** | [Solution](solution) |
| **Slides** | [Powerpoint](slides.pdf)

## Video

[Train the Trainer Video](https://aka.ms/studentzone-apis)

## Pre-Learning

- [Tutorial Build a web API with minimal API, ASP.NET Core, and .NET 6](https://learn.microsoft.com/training/modules/build-web-api-minimal-api/?WT.mc_id=academic-78652-leestott)
- [Documentation: Create a minimal web API with ASP.NET Core](https://learn.microsoft.com/aspnet/core/tutorials/min-web-api?view=aspnetcore-6.0&tabs=visual-studio?WT.mc_id=academic-78652-leestott)

## Prerequisites
For specific instructions, go to [.NET Conf Student Zone 2022: Backend APIs](https://github.com/microsoft/dotnetconf-studentzone/blob/main/Add%20a%20backend%20to%20your%20website/README.md)

- [.NET SDK](https://dotnet.microsoft.com/download/dotnet/6.0?WT.mc_id=academic-78652-leestott)
- [Visual Studio Code](https://code.visualstudio.com/)
- [Azure Tools](https://code.visualstudio.com/docs/azure/extensions)
-
## What students will learn

*This workshop build on the activity in the [IoT Water Consumption Tracker Workshop](../track-water-consumption-iot-dotnet/) and [ML.NET Water Consumption Prediction Workshop](../ml-dotnet-water-tracker/). These workshops do not need to be completed before this workshop.*

In this workshop, you will learn how to take data from a database and serve it using an API. You will create the API and deploy it to the cloud.

## Workshop Milestones

For the full instructions go here: [.NET Conf Student Zone 2022: Backend APIs](https://github.com/microsoft/dotnetconf-studentzone/blob/main/Add%20a%20backend%20to%20your%20website/README.md)

1. Milestone 1: Transform a CSV into database tables
2. Milestone 2: Creat an API to serve data from a database
3. Milestone 3: Deploy an API to the cloud

## Next steps

- [Tutorial Build a web API with minimal API, ASP.NET Core, and .NET 6](https://learn.microsoft.com/training/modules/build-web-api-minimal-api/?WT.mc_id=academic-78652-leestott)


## Feedback

Be sure to give [feedback about this workshop](https://forms.office.com/r/MdhJWMZthR)!

[Code of Conduct](../CODE_OF_CONDUCT.md)

Binary file added full/backend-api-water-tracker/slides.pdf
Binary file not shown.
3 changes: 3 additions & 0 deletions full/backend-api-water-tracker/solution/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
.vscode
appsettings
appsettings*

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit 7bfb0d8

Please sign in to comment.