This setup is to be used when you will be deploying your application into your own test and production systems, whether they are on-premise or in the Cloud and using GitLab for the git distribution repository.
Also see Setup for Test & Production Systems (Target is a LANSA Stack in AWS) and Setup for Test & Production Systems GitLab (single Target instance).
Deployment to Test, and especially to Production, should be a controlled act from a specific machine that is solely used for build and deployment.
A GitLab Runner is used to connect GitLab to the Target System. This means that it is not required for the Target System to be opened up to the Internet.
Only the very latest Web technology is supported. WAMs and older technologies are not supported, though older technologies may be configured to work. If you wish to use older technologies you will need to enter into a beta agreement with LANSA. Please contact LANSA Support for more details.
First some set up is required. It requires manual configuration. As such you require some skills in using Git, GitLab, and the Windows command line to configure it correctly. If you are an existing GitLab user it should not be difficult for you to do this successfully. It is also preferable that you have used Git Extensions previously.
You will need to create the central git repository and install and set up the target system. This is done on a one to one basis. That is, each Build Machine has its own central git repository and target system. Thus environments are isolated from each other and, once configured, can use DevOps deployment at any time without conflicting with other deployed applications.
Here is a summary of the steps involved. Click on the links for more detail:
Before you Start non-AWS On the Target System, open port 80 and port 22. Setup git security.
Central Git Repository Setup Simply create an empty git repo in your git server of choice. Examples have been provided for GitHub.
Install a new instance of Visual LANSA with all EPCs applied, and choose the options to install git, Git Extensions and Deployment Automation. This is the 'Build Machine'. Note that the Visual LANSA install will not contain the Deployment Automation option until a release after EPC142030. Until such time Connect the GitHub Repository to the Development Machine.
Set up the Target system with a WebServer and an application environment using an standard MSI and run your application on the target. This involves cloning the LANSA Cookbook repository to obtain access to the PowerShell scripts, and then executing one of them. Any partition may be used.
Deploy Your Application. Click the Deploy button.
When you upgrade your IDE build machine to a new LANSA release, also 11.6 Update the WebServer Installation to the latest LANSA Release.