Getting Started

Quickstart:

Burla is currently exclusive to Google Cloud !

This quickstart assumes you have installed and setup the Google Cloud (gcloud) CLI.

  1. Run pip install Burla

  2. Run burla install

  3. Run burla login to open your new cluster dashboard.

  4. Hit the ⏻ Start button to turn the cluster on.

  5. Run the code below!

from burla import remote_parallel_map

def my_function(my_input):
    print("I'm running on remote computer in the cloud!")
    
remote_parallel_map(my_function, [1, 2, 3])


Installation (self-hosted)

Self-Hosted Burla is currently exclusive to Google Cloud.

We fully intend to support AWS, Azure, and on-prem deployments, but don't yet. We offer fully-managed Burla deployments for those not on GCP.

1. Ensure gcloud is setup and installed:

If you haven't, install the gcloud CLI, and login using application-default credentials.

Ensure gcloud is pointing at the project you wish to install Burla inside:

  • To view your current gcloud project run: gcloud config get project

  • To change your current gcloud project run: gcloud config set project <NEW-PROJECT-ID>

2. Run the burla install command:

Run pip install burla then run burla install.

What permissions does my Google Cloud account need to run burla install ?

If you don't have permissions, run the command anyway, and it will tell you which ones you need!

To run burla install you'll need permission to run these gcloud commands:

  • gcloud services enable ...

  • gcloud compute firewall-rules create ...

  • gcloud secrets create ...

  • gcloud firestore databases create ...

  • gcloud run deploy ...

I've listed the exact required permissions for the burla install command in it's CLI doc.

3. Start a machine and run the quickstart!

  1. Open your new cluster dashboard!

    • Run the command: burla login This command will open your dashboard in the default browser. Please login using the same account you used to authenticate gcloud, this restriction ensures only you the installer can access your new dashboard.

  2. Hit the ⏻ Start button in the dashboard to turn the cluster on. By default this starts one 4-CPU node. If inactive for >5 minutes this node will shut itself off.

  3. Run the example!

from burla import remote_parallel_map

def my_function(my_input):
    print("I'm running on remote computer in the cloud!")
    
remote_parallel_map(my_function, [1, 2, 3])


Installation (fully-managed)

How to use Burla without a Google Cloud account.

Currently, Fully-Managed deployments are manually created on an individual basis.

We fully intend to make this process 100% self-serve, but haven't yet. For now, simply email us!

Instructions:

  1. E-Mail [email protected] or schedule a meeting here: cal.com/jakez

  2. I'll reply as quickly as possible with further instructions!

FAQ:

Security:

Managed Burla deployments are created in separate projects each in a separate VPC. By default Burla deployments allow access only to those in the authorized-user list in your settings tab, which means we can't actually observe your instance without explicitly manually modifying your database.

How do I pay?

We piggyback off of existing Google Cloud billing infrastructure to track costs coming from your instance (Google Cloud project) and simply foreward you the bill through Stripe Billing.

How much does it cost?

We charge a simple 2x multiple whatever charges originate from your instance according to Google Cloud billing, this equates to about $0.08 per cpu-hour.


Questions? Schedule a call with us, or email [email protected]. We're always happy to talk.

Last updated