In this section of the Quickstart we'll explore how to manage applications using the Web UI. Feel free to jump to the Managing Applications Using The CLI if you prefer using a terminal instead.
Application management through Shipa's Web UI is as easy as visiting the section "Applications" in the left menu and deploying your first application to a given environment. The only prerequisites to achieve such an operation are to have:
- A previously connected Cluster to your account. Connecting Clusters
- A previously created Environment to use as the target of your deployment. Environment Management
Please open the Shipa Web UI and select Applications from the left-hand menu.
Click the Create (+) icon (or use the keyboard shortcut Shift ⇧ + 1).
Type hello-shipa as the Name of the application, select the Environment you want to use as your deployment target, and choose the Team owning the application. Scroll down and provide the Docker image of your preference as the Image URL, or simply click Test with sample image to use a sample application we hosted for the convenience of this example (docker.io/shipasoftware/hello-shipa:latest).
Take into consideration that the container images provided, need to be hosted in the registry of your choice and that they can be either publicly accessible or private to your organization. If your image is public, you will not need to provide any further information for Shipa to use it. However, if your image is private, please select Private registry as the Deployment Source, so new fields are added to the form and you can enter the corresponding username and password to access the image.
If you are unsure of whether your image is private or public, simply click the button "Validate Image", so Shipa can determine if it has access or not to it to use it.
Once, all mandatory fields, are filled out, simply click the button Deploy at the bottom of your modal window, and the deployment process will start in the background.
When the process is finished, the UI will display a successful notification describing that the process was completed correctly, and your new application will appear as part of the list.
To ensure that your application is running successfully, display all the details of your app by clicking its name (hello-shipa) in the list. Once done, you should see all the information that Shipa collects from your application (status, Metadata, Metrics, Units, Lifecycle, etc).
Shipa generates a public URL for each application that is deployed through it, so you can immediately access its content and verify if the app is behaving as it should. To test that your application is running, click on the URL exposed by Shipa on the right side of the screen and verify that the content is right.
When clicking the URL of your app, a new tab should open on your browser displaying the actual content of your running application.
Feel free to explore the rest of the information generated by Shipa and start supporting your application with ease.
Please visit the Application Management section of the docs for more info.
Updated 4 months ago
You can choose to continue the quickstart and explore how to manage applications using the CLI. Alternatively, feel free to explore Dev Guide, Ops Guide, or Architecture sections of the docs available in the left-hand menu.