Skip to content
Bazel rules for Python 3 Google App Engine and Google Cloud Functions deployment.
Python Shell
Branch: master
Clone or download

README.rst

Bazel Rules: Python 3 Google App Engine & Google Cloud Functions

This repository contains the Bazel (Starlark) rules to build Python 3 and deploy to Google App Engine and Google Cloud Functions.

Usage

There is a GAE app example and a GCF example in the examples directory.

Google App Engine (Python 3)

Put this in the BUILD file:

py_binary(
    name = "app",
    srcs = [
        "app.py",
    ],
)

py_app_engine(
    name = "app_deploy",
    src = ":app",
    descriptor = "app.yaml",
    entry = "app",
    requirements = [
        "flask",
    ],
)

and run:

examples$ bazel run //app_engine:app_deploy

Google Cloud Functions (Python 3)

Put this in the BUILD file:

py_binary(
    name = "hello",
    srcs = [
        "hello.py",
    ],
)

py_cloud_function(
    name = "hello_deploy",
    src = ":hello",
    entry = "hello",
)

and run:

examples$ bazel run //function:hello_deploy

Features

In the BUILD rule you can also specify:

PyPI (pip) requirements
either as a package list or pointing to a requirements.txt file
The GCP project name
if you don't want to use the default one used by gcloud
Version (App Engine only)
the version string of the GAE deployment
Deploy name (Cloud Functions only)
the name of the deployed function (in GCP) and also in the HTTP path
Pub/Sub topic trigger (Cloud Functions only)
if you want your function to be triggered by a Cloud Pub/Sub message
GCS bucket trigger (Cloud Functions only)
if you want your function to be triggered by events from a GCS bucket
General event trigger (Cloud Functions only)
if you want your function to be triggered by other event types
Memory in MiB (Cloud Functions only)
the default is 256 MiB but you can request more, up to 2,048 MiB
Timeout in seconds (Cloud Functions only)
the default is 60 s but you can request up to 540 s.

Requirements

This solution depends on these commands being available:

Your Bazel workspace should be set to generate a ZIP package for py_binary targets, by setting some parameters in the .bazelrc file, like this.

LICENSE

bazel_for_gcloud_python is released under the Apache 2.0 License.

You can’t perform that action at this time.