The first step of instructing a Banzai Cloud Pipeline instance — either the one of your organization, your own, or try.pipeline.banzai.cloud — is to log in. You have basically two options:
- Log in interactively with a web browser
- Log in using an API token
The easiest is the web browser flow, but for example if you don’t have or want to use interactive access to the host that will run the CLI, you may choose the API token method.
Interactive login with web browser 🔗︎
To start the procedure, type
banzai login
The command will ask for an endpoint, for example <your-pipeline-url>/pipeline
.
You can also preset it using the --endpoint
option.
After that, accept the offer for the interactive login, and follow the instructions: log in in the browser window just opened, and grant access to the CLI. After that, you can return to the console, and optionally create a permanent token. If you want to use the tool later, you should choose this, because the session tokens will expire soon (depending on the settings).
You may also connect to an endpoint that has insecure certificates. The tool will offer to accept the untrusted certificate, and pin its fingerprint.
At the end, when you have multiple organizations, you will be offered to select a default.
Login with an API token 🔗︎
Check the section about authentication for information about obtaining an API token.
Once you have a token ready, run:
banzai login --endpoint=https://your.endpoint.local/pipeline --token=$TOKEN
If you want to accept an insecure certificate in a non-interactive session, add the --skip-verify
flag as well.
Next steps 🔗︎
Once you have logged in, you can use the other Banzai CLI commands, for example to create a cluster.