If you have not already installed
epinio follow these links
In this tutorial, you will learn how to create a namespace and how to push, list and delete an application in it.
Push an application
Clone the sample app
If you just want an application that works use the one inside the sample-app directory.
You can copy it to your system with the following commands:
git clone https://github.com/epinio/epinio.git
The first task to perform after Epinio installation, is to login with the
epinio login -u admin 'https://epinio.127.0.0.1.sslip.io'
# Trust the certificate by pressing 'y' and 'enter'
If your local Kubernetes cluster restarts, Epinio stays installed and the certificates are still valid, so you don't have to login again.
You can confirm that you're logged in by checking the Epinio settings:
epinio settings show
Push an app
There are two ways to push an application:
- You can provide an Application Manifest which contains the required configuration for the applications.
epinio push manifest.yaml
- You can provide the configuration as parameters in which case the parameter
--nameis mandatory. Because of the default route the name has to be unique across all namespaces.
epinio push --name sample --path sample-app
Note that the
--path parameter is optional. If not specified the current working directory will be used. Always ensure that the chosen directory contains a supported application.
If you want to know what applications are supported in Epinio, please read the notes about supported applications.
We also provide information about the more advanced git model.
Note: If you want to know the details of the
process, please read the detailed push docs
Check that your application is working
After the application has been pushed, a unique URL is printed which you can use to access your application. If you don't have this URL available anymore you can find it again by running:
epinio app show sample
("Routes" is the part your are looking for)
Go ahead and open the application route in your browser!
List all commands
To see all the applications you have deployed use the following command:
epinio apps list
Delete an application
To delete the application you just deployed run the following command:
epinio delete sample
Create a separate namespace
If you want to keep your various application separated, you can use the concept of namespaces. Create a new namespace with this command:
epinio namespace create newspace
To start deploying application to this new namespace you have to "target" it:
epinio target newspace
After this and until you target another namespace, whenever you run
epinio push you will be deploying to this new namespace.