- What is an app?
An app is a Docker image that can be mounted inside projects using one of the integrated technologies. Persistent storage can be assigned to an app to keep data in a defined volume path when the app is stopped.
Apps are presented as cards displaying some basic information, such as the name (a), the current status (b), and the technology (c) of the app.
The apps available in a project are specified in your organization’s Technology Catalog.
By default, the page opens when you click the app name of the desired card in the project’s app library.
|For more information about the project’s app library and app cards, see About Apps introduction.|
The first part of the page (1) provides general information about the app, such as the name and description, the last instance status, the start date of the app, the version used, details about the runtime, and app settings.
You also have information about the logs of the app. You can choose to display All logs, Only standard logs or Only error logs, and you can download them.
The second part of the page (2) provides information about the exposed ports, persistent storage, and the technology used.
The first part of the page (1) provides general information about the status of the app, such as its current status, creation date, version, release note, and runtime details.
The second part of the page (2) provides a timeline of the app activities.
You can see the different steps your app has gone through and who initiated actions, such as launching, stopping, or upgrading the app.
You can view the logs for each of these steps by clicking See logs (3). A window opens displaying the logs for the selected action. From here you can choose to display All logs, Only standard logs or Only error logs, and you can download them.
- What is a version?
A version is a single iteration of a job, pipeline, or app. Each new update is stored as a version, enabling you to roll back to previous iterations and keep track of successive changes.
Whenever you upgrade an app (1), a new version of that app is created and automatically defined as the version.
All versions are saved and remain accessible: they are listed on the right side of the page (2). You can view the information of a version by selecting it in the list.
You can switch back and forth between versions as required by selecting a version from the list and clicking Rollback to this version (3). This action of rolling back to another version of the app will make the selected version the new version.
You can also define a version as major to highlight the most stable version of an app.
Select a version from the list and click Set as major version (4) to label the version as Major version. Sparks will appear in front of the major version. Similarly, click Unset as a major version to remove the label from a version.
By default, the page opens on the version of the app currently in use which is tagged with the badge.
The first part of the page (5) provides general information about the version, such as the release note, the creation date and creator, and either the runtime context if it’s an app from the Saagie catalog, or the Docker image if it’s a custom app.
The second part of the page (6) provides information about exposed ports and persistent storage, if there is one attached to the app.
- What is a storage?
A storage is persistent and can be allocated to an app to retain data in a defined volume path.
Storage can be unlinked or deleted by clicking the kebab menu (1). However, you cannot unlink or delete a storage attached to a version of an app that is in use and displays the Current status.
|If you want to roll back to a version of an app that was using an unlinked or deleted storage, you will have to reattach it to a storage. To do this, click the desired version of the app from its Versions page and follow the instructions provided by Saagie.|
New storage can be allocated by upgrading your app (2): this will create a new version of the app linked to the added storage.
|You can also access and manage all project storage from the Storage page of the project.|