This guide covers the basics of using a Helion Stackato PaaS. To follow along, you will need:
If you want to run your own Helion Stackato micro cloud system for local development and testing, download a copy of the Helion Stackato VM and follow the setup instructions in the Admin Guide.
The web interface for Helion Stackato is called the Management Console. You can use it to:
To use it, open the API Endpoint URL (for example,
in your favorite browser. Log in with the username and password that have
been set up for you on the system.
The interface should be mostly self-explanatory. It exposes most of the
functionality you have access to as an end user, but to deploy your own
applications from source code on your local machine you will need to
stackato CLI client.
stackato client is used for pushing applications to
Helion Stackato and interacting with the system from the command line.
The Helion Stackato Client Command Reference has a full list of commands and options.
To connect the
stackato client to the PaaS, use the
command to specify the API Endpoint URL. This is normally the hostname
prepended with "api." for example:
$ stackato target <api.stacka.to> Target: https://api.stacka.to organization: <none> Space: <none> Successfully targeted to [https://api.stacka.to]
Once you have successfully targeted Helion Stackato, you must authenticate
stackato login with the credentials that have been created for
$ stackato login <email@example.com> Attempting login to [https://api.stacka.to] Password: \*\*\*\*\*\*\*\* Successfully logged into [https://api.stacka.to]
If you are logging in for the first time, your user account will not automatically choose an organization and Space for deployment.
To set the organization you belong to:
$ stackato switch-org <org-name> Switching to organization <org-name> ... OK Unsetting current space ... OK Target: https://api.stacka.to organization: <org-name> Space: <none>
To set the Space you want to deploy applications to:
$ stackato switch-space dev Switching to organization <org-name> ... OK Switching to space dev ... OK Target: https://api.stacka.to organization: test-org Space: dev
The steps for deploying applications will vary slightly depending on the language or framework used, but the basic command is as follows:
$ stackato push --as [<appname>]
By default, the client will take application code from your current working directory and push it to Helion Stackato for further staging and configuration, prompting for additional configuration information as necessary.
Numerous sample applications are available from Helion Stackato-Apps on Github, each with a README.md file showing how to deploy it on Helion Stackato.
Many of these have manifest.yml configuration
files, so you can skip the interactive prompts by using the
$ stackato push -n [<appname>]
The output of
stackato push will show the URL of the running
application. Paste this URL into a web browser to try the application
$ stackato open [<appname>]
Documentation on configuring applications in specific languages and frameworks is available in the Deploying Apps section.