Access

Description and operation

General

You sign in to the console in a browser. The kloudlite CLI signs in with a device code that you approve in the console. The SDKs use the CLI login of the computer they run on.

Your handle identifies your account in every address, for example alice/api for a repository. You choose it after the first sign-in.

Sign-in methods

A handle has 3 to 39 characters: lowercase letters, digits and -, with no - at the start or end. Accounts and teams share one set of handles.

Install

The install script puts kloudlite and kl-tui in ~/.local/bin and verifies each file against the release checksum. It supports macOS and Linux on x86_64 and arm64, and needs no administrator rights. kl-tui is not available on Linux arm64.

Tasks

Install kloudlite

Reason for the task: Install the CLI on your computer.

Job set-up

• Access: you.
• References: kloudlite.

Procedure

1. Run the install script.

   CLICopy

   curl -fsSL https://dev.kloudlite.io/install.sh | sh

2. If the script prints Add it to your PATH, run the export line it shows and add it to your shell profile.

Close-out

1. Run kloudlite --version. It prints the version.

Sign in with kloudlite

Reason for the task: Give the CLI and the SDKs a login for your account.

Job set-up

• Access: you. Only you can approve the code.
• References: kloudlite login.

Procedure

1. Run the login command. It opens the approval page in your browser.

   CLICopy

   kloudlite login

2. Make sure that the page shows the name of your computer, then select Approve.

Close-out

1. Make sure that the command prints Logged in as and your handle.

Sign out of kloudlite

Reason for the task: Remove the login from a computer.

Job set-up

• Access: you.
• References: kloudlite logout.

Procedure

1. Run the logout command. It revokes the login and deletes ~/.config/kloudlite/config.json.

   CLICopy

   kloudlite logout

Close-out

1. Make sure that the command prints Logged out.

Revoke a CLI login

Reason for the task: End the login of a computer that you no longer use.

Job set-up

• Access: you.
• References: GET /v1/cli/tokens, DELETE /v1/cli/tokens/{id}.

Procedure

1. Show your CLI logins. The name is the computer.

   PythonCopy

   from kloudlite import Kloudlitekl = Kloudlite()for t in kl.request("GET", "/v1/cli/tokens"):    print(t["id"], t["name"], t["expiresAt"])

   TypeScriptCopy

   import { Kloudlite } from "./index.ts";const kl = new Kloudlite();const tokens = (await kl.request("GET", "/v1/cli/tokens")) as { id: string; name: string; expiresAt: string }[];for (const t of tokens) console.log(t.id, t.name, t.expiresAt);

   GoCopy

   kl := kloudlite.New(kloudlite.Options{})var tokens []map[string]anyif err := kl.Request("GET", "/v1/cli/tokens", kloudlite.RequestOptions{Out: &tokens}); err != nil {    log.Fatal(err)}for _, t := range tokens {    fmt.Println(t["id"], t["name"], t["expiresAt"])}

   RubyCopy

   require_relative "kloudlite"kl = Kloudlite::Client.newkl.request("GET", "/v1/cli/tokens").each { |t| puts [t["id"], t["name"], t["expiresAt"]].join(" ") }

   JavaCopy

   var kl = new Kloudlite();System.out.println(kl.request("GET", "/v1/cli/tokens"));

   CLICopy

   kloudlite request GET /v1/cli/tokens

2. Delete the login. Replace ID with its id.

   PythonCopy

   kl.request("DELETE", "/v1/cli/tokens/ID")

   TypeScriptCopy

   await kl.request("DELETE", "/v1/cli/tokens/ID");

   GoCopy

   if err := kl.Request("DELETE", "/v1/cli/tokens/ID", kloudlite.RequestOptions{}); err != nil {    log.Fatal(err)}

   RubyCopy

   kl.request("DELETE", "/v1/cli/tokens/ID")

   JavaCopy

   kl.request("DELETE", "/v1/cli/tokens/ID");

   CLICopy

   kloudlite request DELETE /v1/cli/tokens/ID

Close-out

1. Show the logins again. Make sure that the id is gone.

Troubleshooting