GOBLET
Goblet is a framework for writing serverless rest apis in python in google cloud. It allows you to quickly create and deploy python apis backed by cloudfunctions.
It provides:
- A command line tool for creating, deploying, and managing your api
- A decorator based API for integrating with GCP API Gateway, Storage, Cloudfunctions, PubSub, Scheduler, and other GCP services.
- Local environment for your api endpoints
- Dynamically generated openapispec
- Support for multiple stages
You can create Rest APIs:
from goblet import Goblet, jsonify
app = Goblet(function_name="goblet_example")
@app.route('/home')
def home():
return {"hello": "world"}
@app.route('/home/{id}', methods=["POST"])
def post_example(id: int) -> List[int]:
return jsonify([id])
Once you've written your code, you just run goblet deploy and Goblet takes care of deploying your app.
$ goblet deploy -l us-central1
...
https://api.uc.gateway.dev
$ curl https://api.uc.gateway.dev/home
{"hello": "world"}
Installation
To install goblet, open an interactive shell and run:
pip install goblet-gcp
Make sure to have the correct services enabled in your gcp project depending on what you want to deploy
api-gateway, cloudfunctions, storage, pubsub, scheduler
You will also need to install gcloud cli for authentication
QuickStart
In this tutorial, you'll use the goblet command line utility to create and deploy a basic REST API. This quickstart uses Python 3.7. You can find the latest versions of python on the Python download page.
To install Goblet, we'll first create and activate a virtual environment in python3.7:
$ python3 --version
Python 3.7.3
$ python3 -m venv venv37
$ . venv37/bin/activate
Next we'll install Goblet using pip:
python3 -m pip install goblet-gcp
You can verify you have goblet installed by running:
$ goblet --help
Usage: goblet [OPTIONS] COMMAND [ARGS]...
...
Credentials
Before you can deploy an application, be sure you have credentials configured. You should run gcloud auth application-default login and sign in to the desired project.
When setting the defaut location note that api-gateway is only available in asia-east1, europe-west1, us-east-1 and us-central1.
Creating Your Project
create your project directory, which should include an main.py and a requirements.txt. Make sure requirements.txt includes goblet-gcp
$ ls -la
drwxr-xr-x .goblet
-rw-r--r-- main.py
-rw-r--r-- requirements.txt
You can ignore the .goblet directory for now, the two main files we'll focus on is app.py and requirements.txt.
Let's take a look at the main.py file:
from goblet import Goblet
app = Goblet(function_name="goblet_example")
@app.route('/home')
def home():
return {"hello": "world"}
This app will deploy an api with endpoint /home.
Running Locally
Running your functions locally for testing and debugging is easy to do with goblet. First set a local param in the goblet class
from goblet import Goblet
app = Goblet(function_name="goblet_example", local='test')
Then run goblet local test and replace test with whatever variable you decide to use. Now you can hit your functions endpoint at localhost:8080 with your routes.
Deploying
Let's deploy this app. Make sure you're in the app directory and run goblet deploy making sure to specify the desired location:
$ goblet deploy -l us-central1
INFO:goblet.deployer:zipping function......
INFO:goblet.deployer:uploading function zip to gs......
INFO:goblet.deployer:function code uploaded
INFO:goblet.deployer:creating cloudfunction......
INFO:goblet.deployer:deploying api......
INFO:goblet.deployer:api successfully deployed...
INFO:goblet.deployer:api endpoint is goblet-example-yol8sbt.uc.gateway.dev
You now have an API up and running using API Gateway and cloudfunctions:
$ curl https://goblet-example-yol8sbt.uc.gateway.dev/home
{"hello": "world"}
Try making a change to the returned dictionary from the home() function. You can then redeploy your changes by running golet deploy.
Next Steps
You've now created your first app using goblet. You can make modifications to your main.py file and rerun goblet deploy to redeploy your changes.
At this point, there are several next steps you can take.
Docs - Goblet Documentation
If you're done experimenting with Goblet and you'd like to cleanup, you can use the goblet destroy command making sure to specify the desired location, and Goblet will delete all the resources it created when running the goblet deploy command.
$ goblet destroy -l us-central1
INFO:goblet.deployer:destroying api gateway......
INFO:goblet.deployer:api configs destroying....
INFO:goblet.deployer:apis successfully destroyed......
INFO:goblet.deployer:deleting google cloudfunction......
INFO:goblet.deployer:deleting storage bucket......
Docs
Blog Posts
Building Python Serverless Applications on GCP
Tutorial: Publishing GitHub Findings to Security Command Center
Examples
Issues
Please file any issues, bugs or feature requests as an issue on our GitHub page.
Github Action
Roadmap
☐ Generate Openapi clients
☐ Firestore trigger
☐ Firebase trigger
☐ Cloud Tasks trigger
☐ Cloud Endpoints trigger
Want to Contribute
If you would like to contribute to the library (e.g. by improving the documentation, solving a bug or adding a cool new feature) submit a pull request.
Want to Support
Based on chalice
![[FEATURE REQUEST] Build/Push docker image to external registry](https://avatars.githubusercontent.com/u/30596165?v=4)
![[Secret Manager] Secret Manager Integration](https://avatars.githubusercontent.com/u/3811703?v=4)
![[Cloudrun backend] Missing None. Make sure you are in the correct directoty and this file exists](https://avatars.githubusercontent.com/u/26479919?v=4)
2.5k Feb 17, 2021
9k Jan 1, 2023
10 Jan 25, 2022
6.7k Dec 27, 2022
8 Dec 16, 2021
162 Dec 26, 2022
2 Dec 2, 2021
264 Dec 31, 2022
264 Dec 31, 2022
30 Mar 5, 2022
6.6k Jan 7, 2023
3.8k Jan 2, 2023
74 Dec 30, 2022
2 Jan 4, 2022
24.7k Jan 3, 2023
1k Jan 4, 2023
294 Jan 4, 2023