johnpapa / serverless-thank-you

Say thank you to everyone who takes the time to create and discus or a pull request in your Github repository, using Azure Functions

Say thank you to GitHub issue creators

Say thank you to everyone who takes the time to create an issue in your Github repository, using serverless technology.

Have you ever contributed to an OSS project on GitHub, perhaps creating an issue, and instantly received a reply? Wouldn't it be nice if that reply to your issue thanked you? This challenge is to automate creating holiday themed "thank you" replies to all issues created in one or more of your GitHub repositories.

The holiday season is a time for smiling more and taking the time to say thank you to those around us. Say thank you to everyone who takes the time to create an issue in your Github repository, using serverless technology.

You can use any technologies you prefer to solve this challenge. The solution included here uses GitHub, VS Code, and Azure Functions.

Enjoy your challenge and Happy Holidays!

-- John Papa

Resources and Tools 🚀

Tools

• Visual Studio Code
• Azure Functions Extension
• Azure Functions Core Tools
• Free Azure Trial

Docs

• Azure Functions docs - Webhooks

• GitHub - Create a Personal Access Token

• GitHub - Webhook documentation

• GitHub API - IssuesEvent Reference

• Octokit - GitHub REST API client for JavaScript and Docs

• Learn - Monitor GitHub events by using a webhook with Azure Functions

Getting Started 🔥

Here is how you can execute this application locally.

1. Install the tools

   • Visual Studio Code
   • Azure Functions Extension
   • Azure Functions Core Tools

2. Clone this repository

   git clone https://github.com/simonaco/serverless-challenges.git
   cd serverless-challenges/week-2/challenge-9/serverless-thank-you

3. Install the npm packages

   npm install

4. Rename local.settings.example.json to local.settings.json and paste your Personal Access Token from GitHub into the githubKey setting's value.

5. Run the app

   npm start

6. Make a POST request to your endpoint http://localhost:7071/api/SayThankYou sending the sample request JSON found in the file sample.json

   Hint - you can use Postman, Insomnia, or any HTTP tool to make the request.

Next Steps 🏃

Learn more about serverless with Free Training!

• ✅ [Serverless Free Courses](https://docs.microsoft.com/learn/browse/?term=azure functions&WT.mc_id=javascript-0000-jopapa)

Additional Resources ⭐️

Some additional awesome serverless resources

• ✅ Azure Functions documentation
• ✅ Azure SDK for JavaScript Documentation
• ✅ Create your first function using Visual Studio Code
• ✅ Free E-Book - Azure Serverless Computing Cookbook, Second Edition

I have doubts ... What do I do

If you have any doubts about the challenges, feel free to open an ISSUE HERE. As soon as possible we will be answering any questions/doubts that you may have!