Table of Contents
The first step to start using Space Cloud is setting it up. Space Cloud requires several components to be running for proper functions. The most important components are:
Luckily, we don’t have to interact with these components directly. Space Cloud ships with a utility named
space-cli which bootstraps a cluster for us.
If you just want to use the
Gatewaycomponent of Space Cloud directly, you can follow this guide instead.
The first step is downloading
space-cli. You can download a version for your particular platform:
Unzip the compressed archive.
For Linux / Mac:
unzip space-cli.zip && chmod +x space-cli
For Windows: Right-click on the archive and select
To make sure if the space-cli binary is correct, type the following command from the directory where you downloaded space-cli:
For Linux / Mac:
The above command will print the
Optionally, you can copy the
space-clibinary to your environment path variable for global usage.
We can set up all Space Cloud components using a single command.
./space-cli setup --dev
setup command selects
Docker as a target by default and runs all the containers required to setup Space Cloud. On successful installation it generates an output similar to this one:
INFO Setting up space cloud on Docker INFO Starting container space-cloud-gateway... INFO Starting container space-cloud-runner... INFO Space Cloud (id: "local-admin") has been successfully setup! :D INFO You can visit mission control at http://localhost:4122/mission-control INFO Your login credentials: [username: "local-admin"; key: "kUkqBffI1ISR"]
Verify the installation run the following docker command:
docker ps --filter=name=space-cloud
You should see an output similar to this!
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 1263f8ab1372 spaceuptech/runner "./app start" About a minute ago Up About a minute space-cloud-runner 35f820b550c7 spaceuptech/gateway "./app run" About a minute ago Up About a minute 0.0.0.0:4122->4122/tcp space-cloud-gateway
Awesome! We just started Space Cloud using Docker. Next step would be to set up a project to use Space Cloud in your preferred language.
Feel free to check out various capabilities of