speedctl
Your friendly command line tool for working with Speedscale cloud.

About

The speedctl CLI tool is used to interact with the Speedscale cloud, and requires an active Speedscale subscription. If you don't have an account with Speedscale the speedscale CLI tool is fully free, with a limited set of functionality.
speedctl is the Speedscale API. Use speedctl to programmatically get reports, create snapshots, update configs, etc.

Version

You may want to double check what version you are running, that can be accomplished with the simple version command. It will also show when it was compiled so you can decide if you need an update.
1
speedctl version
Copied!
The output looks like this:
1
speedctl version v0.5.5 compiled at 2021-05-13T18:41:31+0000
Copied!

Update

Here is how to download a new version, it will update the binary in your ~/.speedscale directory.
1
curl -sL https://downloads.speedscale.com/speedctl/install | sh
Copied!
The output looks like this:
1
Checking if you are running the latest speedctl.
2
* Comparing checksum...
3
* The checksum was different.
4
Downloading speedctl-darwin...
5
% Total % Received % Xferd Average Speed Time Time Time Current
6
Dload Upload Total Spent Left Speed
7
100 40.7M 100 40.7M 0 0 22.7M 0 0:00:01 0:00:01 --:--:-- 22.7M
8
Download complete!
9
* Comparing checksum...
10
* The checksum was the same.
11
speedctl was successfully installed πŸŽ‰
Copied!

Help

You can figure out what commands are available by adding --help to the end of the current command. For example just running help itself will have this kind of output (don't be surprised if yours is different, new features pop up all the time):
1
speedctl --help
Copied!
The output looks like this:
1
speedctl handles common operations for deploying, and maintaining, and interacting
2
with Speedscale resources and services. Most commands are run in conjunction with kubectl.
3
​
4
Usage:
5
speedctl [command]
6
​
7
Available Commands:
8
act Execute scenario actions manually
9
check Prints config to help make sure that the config file syntax is correct
10
completion Generates completion scripts for bash or zsh
11
controlplane Deploys Speedscale control plane services
12
creds Deploys ONLY credentials
13
delete Deletes resources from Speedscale database
14
generator Deploys generator ONLY with dependent services
15
get Retrieve resources from Speedscale database
16
help Help about any command
17
init Initializes speedctl configuration
18
inject Inject Speedscale sidecar to Kubernetes pod resources
19
operator Deploys the Speedscale operator to a cluster
20
put Insert resources into Speedscale database
21
report Manages report artifacts in the Speedscale datastore
22
responder Deploys responder ONLY with dependent services
23
snapshot Manages snapshot artifacts in the Speedscale datastore
24
tenantinfo Retrieves tenant info from Speedscale service
25
testconfig Manages test config artifacts in the Speedscale datastore
26
tokenconfig Manages token config artifacts in the Speedscale datastore
27
uninject Uninject Speedscale sidecar from Kubernetes pod resources
28
version Prints current version
29
​
30
Flags:
31
--app-url string URL of the speedscale app
32
--config string Config file (default ${HOME}/.speedscale/config.yaml)
33
-c, --context string Uses a specific context from those listed in ${HOME}/.speedscale/config.yaml
34
-h, --help help for speedctl
35
-v, --verbose Verbose output
36
​
37
Use "speedctl [command] --help" for more information about a command.
Copied!

Flags

Note that the flags can be used to modify the command that is being sent. Each different command has it's own flags, for example here is how to get more information about the init command:
1
speedctl init --help
Copied!
The output looks like this:
1
Initializes speedctl by authorizing your account and downloading your account config.yaml file
2
​
3
Usage:
4
speedctl init [flags]
5
​
6
Aliases:
7
init, initialize, bootstrap
8
​
9
Flags:
10
-f, --force Force install with default values
11
-h, --help help for init
Copied!
Note that there is just one option which is --force which automatically supplies all the defaults if you don't want to answer all the questions from the init command.
Last modified 1mo ago
Export as PDF
Copy link