CLI-Reference
Burla's CLI contains the following commands:
burla install
Install a self-hosted Burla instance in your Google Cloud project.burla login
Authenticate your machine.burla dashboard
Open / login to the Burla dashboard in your default browser.
The global arg --help
can be placed after any command or command group to see CLI documentation.
burla install
burla install
Install a self-hosted Burla instance in your Google Cloud project.
Running burla install
multiple times will update the existing installation with the latest version.
Description
Installs Burla inside the Google Cloud project that your gcloud CLI is currently pointing to. For a more user-friendly installation guide see: Installation: Self-Hosted
To view your current gcloud project run: gcloud config get project
To change your current gcloud project run: gcloud config set project <desired-project-id>
Prerequisites:
Have the gcloud CLI installed (how do I install the gcloud CLI?).
Be logged in to the gcloud CLI (how do I log in?) (
gcloud auth login
&gcloud auth application-default login
)Have a Google Cloud user account with at least the minimum required permissions to install Burla. Or: Just run
burla install
, if you're missing any permissions it will tell you which ones!
Here are three sets of permissions, each of which would authorize somebody to run burla install
:
Here is exactly what happens when burla install
is run:
We encourage you to check out _install.py in the client for even more specific installation details.
After Installing:
burla install
prints the following:
Success! To view your new dashboard run `burla dashboard`
Quickstart:
1. Start your cluster by hitting "⏻ Start" in the dashboard.
2. Import and call `remote_parallel_map`!
burla login
burla login
Authenticates the current machine through a Google OAuth consent screen.
Allows you to call remote_parallel_map
on Burla deployments where you're authorized to do so.
Description
Launches the "sign in with google" page in your default web browser. This gives our backend access to only your email and name according to your google account. See our privacy-policy to learn how we protect this information.
This is used to ensure that only people you have explicitly authorized have access to your Burla instance.
Once signed-in successfully, an auth-token is saved in the text file burla_credentials.json
. This file is stored in your operating system's recommended user data directory which is determined using the appdirs python library.
This token is refreshed each time the burla login
or burla dashboard
authorization flow is completed.
burla dashboard
burla dashboard
Launch and login to the Burla dashboard associated with your current Google Cloud project.
Allows you to call remote_parallel_map
and access the Burla dashboard in Burla deployments where you're authorized to do so.
Description
Runs the same OAuth authorization flow used in the burla login
command, but redirects the user to their current project's Burla dashboard, instead of the login success page.
The current project's Burla dashboard URL is discovered using the following command:
gcloud run services describe burla-main-service ...
When redirecting to this dashboard the client attaches an authentication cookie identifying the user to the dashboard. Only explicitly authorized users are allowed to view a Burla dashboard.
Like the burla login
command, this command also updates local authorization credentials stored in burla_credentials.json
, see the login command documentation for more info on these credentials.
Questions? Schedule a call with us, or email [email protected]. We're always happy to talk.
Last updated