Get information about the rack
convox rack
$ convox rack
Name test
Provider aws
Router router.0a1b2c3d4e5f.convox.cloud
Status running
Version 3.0.0
Install a new Rack
convox rack install <provider> <name> [option=value]...
$ convox rack install local dev
...
$ convox rack install aws production region=eu-west-1 node_type=t3.large
...
Output a Kubernetes configuration file for connecting to the underlying cluster
convox rack kubeconfig
$ convox rack kubeconfig
apiVersion: v1
clusters:
- cluster:
server: https://api.0a1b2c3d4e5f.convox.cloud/kubernetes/
name: kubernetes
contexts:
- context:
cluster: kubernetes
user: proxy
name: proxy@kubernetes
current-context: proxy@kubernetes
kind: Config
preferences: {}
users:
- name: proxy
user:
username: convox
password: abcdefghijklmnopqrstuvwxyz
Get logs for the rack
convox rack logs
$ convox rack logs
2020-02-10T13:37:22Z service/web/a55eb25e-90f5-4301-99fd-e35c91128592 ns=provider.aws at=SystemGet state=success elapsed=275.683
2020-02-10T13:37:22Z service/web/a55eb25e-90f5-4301-99fd-e35c91128592 id=8d3ec85dc324 ns=api at=SystemGet method="GET" path="/system" response=200 elapsed=276.086
2020-02-10T13:38:04Z service/web/a55eb25e-90f5-4301-99fd-e35c91128592 ns=provider.aws at=SystemGet state=success elapsed=331.824
2020-02-10T13:38:04Z service/web/a55eb25e-90f5-4301-99fd-e35c91128592 id=f492a0dce931 ns=api at=SystemGet method="GET" path="/system" response=200 elapsed=332.219
...
Transfer the management of a Rack from an individual user to an organization or vice versa.
note: rack name should be same
convox rack mv <from> <to>
$ convox rack mv dev acme/dev
moving rack dev to acme/dev... OK
$ convox rack mv acme/dev dev
moving rack acme/dev to dev... OK
List rack processes
convox rack ps
$ convox rack ps
ID APP SERVICE STATUS RELEASE STARTED COMMAND
api-9749b7ccb-29zh5 system api running 3.0.0.beta44 2 weeks ago api
api-9749b7ccb-29zh5 rack api running 3.0.0.beta44 2 weeks ago api
api-9749b7ccb-cg4hr system api running 3.0.0.beta44 2 weeks ago api
api-9749b7ccb-cg4hr rack api running 3.0.0.beta44 2 weeks ago api
atom-578cd48bfb-6tm7g rack atom running 3.0.0.beta44 2 weeks ago atom
atom-578cd48bfb-6tm7g system atom running 3.0.0.beta44 2 weeks ago atom
router-846b84d544-ndz76 rack router running 3.0.0.beta44 2 weeks ago router
router-846b84d544-ndz76 system router running 3.0.0.beta44 2 weeks ago router
List rack processes as well as essential system ones running on the Rack
convox rack ps --all
$ convox rack ps --all
ID APP SERVICE STATUS RELEASE STARTED COMMAND
api-9749b7ccb-29zh5 system api running 3.0.0.beta44 2 weeks ago api
api-9749b7ccb-29zh5 rack api running 3.0.0.beta44 2 weeks ago api
api-9749b7ccb-cg4hr system api running 3.0.0.beta44 2 weeks ago api
api-9749b7ccb-cg4hr rack api running 3.0.0.beta44 2 weeks ago api
atom-578cd48bfb-6tm7g rack atom running 3.0.0.beta44 2 weeks ago atom
atom-578cd48bfb-6tm7g system atom running 3.0.0.beta44 2 weeks ago atom
elasticsearch-0 rack elasticsearch running 3.0.0.beta44 2 weeks ago
elasticsearch-0 system elasticsearch running 3.0.0.beta44 2 weeks ago
elasticsearch-1 rack elasticsearch running 3.0.0.beta44 2 weeks ago
elasticsearch-1 system elasticsearch running 3.0.0.beta44 2 weeks ago
fluentd-p56dk rack fluentd running 3.0.0.beta44 2 weeks ago
fluentd-p56dk system fluentd running 3.0.0.beta44 2 weeks ago
fluentd-qrttw rack fluentd running 3.0.0.beta44 2 weeks ago
fluentd-qrttw system fluentd running 3.0.0.beta44 2 weeks ago
fluentd-zsv8f rack fluentd running 3.0.0.beta44 2 weeks ago
fluentd-zsv8f system fluentd running 3.0.0.beta44 2 weeks ago
redis-77b4f65c55-nbx89 rack redis running 3.0.0.beta44 2 weeks ago
redis-77b4f65c55-nbx89 system redis running 3.0.0.beta44 2 weeks ago
router-846b84d544-ndz76 rack router running 3.0.0.beta44 2 weeks ago router
router-846b84d544-ndz76 system router running 3.0.0.beta44 2 weeks ago router
List of attachable runtime integrations
convox rack runtimes
$ convox rack runtimes
ID TITLE
20e58437-fab7-4124-aa5a-2e5978f1149e 047979207916
Attach runtime integration to the rack
convox rack runtime attach <runtime_id>
$ convox rack runtime attach 20e58437-fab7-4124-aa5a-2e5978f11
OK
Uninstalls a Rack
convox rack uninstall <name>
$ convox rack uninstall my-rack
Upgrading modules...
Downloading github.com/convox/convox?ref=3.0.15 for system...
...
Destroy complete! Resources: 35 destroyed.
Updates a Rack to a new version.
convox rack update [version]
$ convox rack update
Upgrading modules...
Downloading github.com/convox/convox?ref=3.0.15 for system...
...
Apply complete! Resources: 1 added, 4 changed, 1 destroyed.
Outputs:
api = https://convox:password@api.dev.convox
provider = local
OK
Generates rack access credential
supported from: 3.14.1
convox rack access --role [role] --duration-in-hours [duration]
flags:
role: Access role for the credential. Allowed roles are: read or writeduration-in-hours: TTL for the credential. $ convox rack access --role read --duration-in-hours 1
RACK_URL=https://...
$ export RACK_URL=https://...
$ convox rack
Name v3-rack
Provider aws
Router router.convox
Status running
Version ...
Rotates the rack access key that is used for rack access credential. It will invalidate previous all the credential generated from convox rack access --role [role] --duration-in-hours [duration].
supported from: 3.14.1
convox rack access key rotate
$ convox rack access key rotate
OK
