ABCD Lite

ABCD Lite is a service designed for deploying applications to IIS websites. It can handle any application from static HTML/CSS/JS sites to heavy monolithic applications like Optimizely CMS. The main requirement is that your CI system can build the application and package the build result as an artifact.

Prerequisites

  1. Container registry with OCI Artifacts support. For more details, see the Container registry section.
  2. Administrator-level access to the server (for service installation).
  3. ABCD Lite license key (if not using the personal plan).
  4. Domain or subdomain (e.g., abcd.acme.com).
  5. The following IIS modules: URL Rewrite and Application Request Routing. Remember to enable ARR after installation.
  6. NSSM

Quick Start

  1. Register an account or set up a Container registry on your server. For more details, see the Container registry section.
  2. Download the latest stable release of ABCD Lite and place it in the target directory (e.g., C:\services\abcd-lite).
  3. Open PowerShell terminal in the directory with the executable file (e.g., C:\services\abcd-lite) and perform basic application configuration by running the following command: 
    ./abcd-lite.exe config generate
    Save the generated admin token in a secure location. This is the password for accessing the administrative interface.
  4. Create a new IIS site and specify all necessary parameters. For example:
    • Site name and host name: abcd.acme.com
    • Physical path: C:\services\abcd-lite\web
    • After adding the site, add HTTPS binding and certificate. You can use WinACME for this.
  5. Add your domain to the allowed_origins section of the configuration file.
  6. Run the executable manually using the command .\abcd-lite.exe run and navigate to the newly created site in your browser. Enter the admin password, check the console, and ensure there are no errors. Stop the file execution with Ctrl + C.
  7. Create a Windows service using the NSSM utility. Unfortunately, this is currently the only supported method for service installation.
  8. Start the service.