Skip to main content

Quick Start

This is only recommended if you have worked with Gitlab pipelines and are familiar with gitlab.com pipeline configurations. If not, please continue onto the next section to dive into the detail.

Copy Pipeline Template

  1. Copy the template ./pipelines/_template.yml into pipelines/ and rename it to a suitable name, e.g. app-platform-my-app.yml

  2. Find and replace all instances of my-app- with your app's name. This will rename all instances of the job names, and instances of where a job is needed in order to run.

  3. Find and replace all instance of [ apps/YOUR-DIR-HERE/**/*, apps/YOUR-FILE-HERE.ts ] with an array of files and/or directories. This will add an array of files that if a file is changed within the array, the job will be triggered.

  4. Set your apps base href by replacing all instances of /SOME_SUB_DIR/ with the sub-directory you want your app to be available on. e.g. https://login.secure.investec.com/my-app-sub-directory. If you don't know what it is, check what you are using when building your app, e.g. --base-href /my-app/

Take care

Be careful not to conflict with an existing app base href, always ensure your base href is unique

  1. Find and replace all instances of YOUR-DIR-HERE with your apps directory name, e.g. resulting in TARGET_PROJECT: app-platform-mmy-app.

  2. Configure the TARGET_URI to point to your sub-directory from step 4. You can do this by find and replace all instances of investec.com/my-app*.

  3. Lastly, find and replace all instances of TARGET_CF_URI: my-app and specify you same sub-directory from step 4, however make sure not to include and forward slashes.