Skip to content

Commit

Permalink
added mkdocs settings
Browse files Browse the repository at this point in the history
  • Loading branch information
rishabkumar7 committed Dec 15, 2023
1 parent bc9f08d commit 62864a3
Show file tree
Hide file tree
Showing 3 changed files with 87 additions and 0 deletions.
6 changes: 6 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
.venv
__pycache__
venv

# macOS internals
.DS_Store
49 changes: 49 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Cloud Resume API with AWS

AWS Lambda Resume API Challenge

Welcome to the AWS Lambda Resume API Challenge. A project where you will have the opportunity to build and deploy a serverless API using AWS Lambda and DynamoDB, integrated with GitHub Actions. The primary goal? Construct an API that can serve resume data in JSON format.

## Challenge Objective 🎯

Your task is to create a Lambda function that fetches resume data stored in DynamoDB and return it in JSON format. To level up the challenge, integrate GitHub Actions to automatically deploy updates to your Lambda function whenever you push to your repository.

## Key Requirements

- DynamoDB Table: Set up a table named Resumes containing sample resume data.
- Lambda Function: Fetch and return resume data based on an id.
- API Gateway/Function URLs: Integrate API Gateway for your Lambda Function or use Function URLs to make you Lambda Function accessible.
- GitHub Actions: Automatically package and deploy your Lambda function on every push to the repository.

**Bonus**: Use the AWS CDK or Serverless Framework for infrastructure as code! And API Gateway to make you Resume API accessible over the internet.

## Getting Started 🚀

Set Up AWS: If you haven't already, sign up for an AWS account and set up your credentials. Remember, always use AWS secrets and never expose them in your code.

Create a JSON Resume: Use [this schema](https://jsonresume.org/schema/) to create your own JSON resume.
Create AWS Resources: Deploy the needed AWS services - DynamoDB and Lambda Function.
Create Your Workflow: Use the provided template as a guide, but feel free to innovate!
Test Everything: Ensure your API works as expected and the GitHub Actions deploy smoothly.

## Submission Guidelines 📥

Ensure all your code is in a GitHub repository.
Make sure your README has detailed instructions on how to run and test your API.
Write a blog post sharing the things you learned during building this project.

Once you're ready to submit, create a pull request to this repository.
Add your name, github repo URL and the resume API URL to the table in `submissions.md` file.
In your pull request, provide a summary of what you've done and any additional features or functionalities you've added.

All the submission can be found [here](/submissions).

## Completion Criteria 🏆

- Functionality: Does the API work? Does the deployment succeed via GitHub Actions?
- Code Quality: Is the code clean, well-organized, and documented?
- Innovation: Did you add any extra features or use any unique methods?

## Acknowledgements 👏

Thank you to everyone who decides to participate. Community challenges like this are a great way to learn, improve, and demonstrate your skills. I can't wait to see what you build!
32 changes: 32 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
site_name: Cloud Resume API

theme:
name: material
# Fonts

font:
text: Noto Sans

# icons
icon:
repo: fontawesome/brands/git-alt

palette:
- primary: indigo

# Palette toggle for light mode
- scheme: default
toggle:
icon: material/lightbulb
name: Switch to dark mode

# Palette toggle for dark mode
- scheme: slate
toggle:
icon: material/lightbulb-outline
name: Switch to light mode

# Repo details
repo_url: https://github.com/rishabkumar7/aws-resume-api

# Plugins

0 comments on commit 62864a3

Please sign in to comment.