stgkcli

Stg CLI
Node.js Command-Line Interface

Introduction

stg-cli is a powerful Node.js command-line interface (CLI) tool designed to simplify the initialization and management of applications within a defined pipeline configuration. It seamlessly integrates with GitHub Actions workflows locally and Docker, streamlining your development processes.

Installation

To use stg-cli, install it globally using npm:

npm install -g stg-cli

Commands

Initialization: Initialize the stg-cli npm package for your project to set up the required configuration files.

bash
$ stg-cli init

Start/Stop Applications: Manage the lifecycle of configured applications by starting or stopping them.
bash
$ stg-cli start <appid>
$ stg-cli stop <appid>

List Configured Applications: View a table of configured applications, displaying their IDs, names, statuses, paths, and UUIDs.
bash
$ stg-cli apps

Show Available Commands: Display a list of available commands and their usage.
bash
$ stg-cli -help

Docker Integration: Execute Docker commands as part of the workflow.

Usage
application.json
A filename CreateApplication.json is automatically create in inside the package in which we Define the properties of our applications.

Example:

{
  "applications": [
    {
      "id": "123",
      "name": "MyApp",
      "path": "/path/to/app",
      "uuid": "abc123def456"
    },
    // Add more applications as needed
  ]
}

onetab-pipeline.yml
Create a file named onetab-pipeline.yml in the root of your project. Define the GitHub Actions workflow for stg-cli.

Example:

yaml
Copy code
on:
  push:
    branches:
      - main
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v2
      # Add more steps as needed