In LifeTime, deployment of an application's tagged version takes a version of the application from one environment and deploys it in another. Just select the tagged version of the application and LifeTime deploys it in the exact development state in which it was tagged.
Here's an example of deploying applications in LifeTime.
Deploy a Web and a Mobile Application
In this example, two applications are being developed in the Development environment:
- A mobile app (MyApp)
- A web application (MyWebApp)
A milestone is reached and the applications are ready to be tested by Quality. They are tagged as follows:
- The mobile app is tagged with version 0.2
- The web application is tagged wih version 0.3
To deploy both applications to Quality, do the following:
Click the Deploy... button between Development and Quality.
Choose Add Applications to select the applications to deploy. You can also Add All Applications to the deployment plan.
If you chose Add Applications in the previous step, search for the applications to deploy. You can filter by applications with differences or search by the application name.
Select the applications to deploy and click the Add to Deployment Plan button.
In the deploy options, select DEPLOY 0.2 for MyApp and DEPLOY 0.3 for MyWebApp:
Click VALIDATE NOW to validate the deployment in Quality:
Note: If LifeTime detects any changes in the applications included in the plan either in the source or in the target environment, it will show a Refresh Applications sticker that you can click to refresh the applications included in the plan.
The deploy is OK (all green). Click CONTINUE to move on:
Type the Deployment Notes and click the Deploy Now button to execute the deployment:
When the deployment finishes, both applications have the same tagged version in both environments.
If the deployment finishes successfully, a "Reuse Plan" link appears in the deployment plan progress screen. You can reuse a deployment plan to get faster deployments.
If the deployment is aborted, a "Retry Plan" link appears in the deployment plan progress screen. Retrying the plan creates a copy of the original plan and allows you to customize it before running it again.
Note: If you're deploying a mobile app that is already configured to generate the mobile app package, be aware that some changes you do in your application might cause the generation of a new application package. For example, changing the icon or the main color of the application.
Check here all the situations that require the user to install a new application package.
Deploying to a different target environment
If you have several pipelines in your OutSystems infrastructure you may need to choose a specific target environment, belonging to a different pipeline, when deploying applications.
To change the target environment of a deployment do the following:
Click the Deploy... button on the right of the source environment name.
For example, if we want to deploy an app from Development to Quality P2, the source environment is Development.
Press Cancel when asked to choose one or more applications to deploy. You will select the desired target environment first.
Open the target environment dropdown by clicking its name (Quality P1 in our example).
Select the desired target environment in the pop-up menu. In our example, we selected Change environment to Quality P2.
Proceed as described in the previous section by adding apps to the deployment plan, validating the plan, and starting the deployment.
Refresh Applications in the Deployment Plan
After creating a deployment plan and adding applications to it, OutSystems notifies you if there are any relevant changes in the source or target environments related to the applications included in the plan.
The detected changes include:
- In the source environment, publishing/moving a module of an application included in the plan
- In the target environment, publishing/moving any module of an application
- In the source/target environment, tagging a version of an application included in the plan
When any of these changes is detected, a Refresh Applications sticker appears under the page title heading of the deployment plan creation screen:
To refresh the applications in the current plan, click Refresh Applications.
The refresh operation does the following:
- The versions displayed in the deployment plan's source and target environments are updated.
- Applications with the "Tag & Deploy" option selected will be deployed with the most recent code.
- Any new tags created outside the plan are shown in the deployment options and can be selected for deployment.
- All deployment options previously selected are kept, except if they are no longer available.