Introduction

Onetab-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 onetab-cli, install it globally using npm:

npm install -g onetab-cli

Commands

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

bash
$ onetab-cli init

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

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

Kill Service: Terminate the CI/CD service completely or for a specific project.

To kill the CI/CD service completely:
bash
$ onetab-cli kill

To kill the CI/CD service for a specific project:
bash
$ onetab-cli kill <appid>

Show Version: Display the version number of the onetab-cli tool.
bash
$ onetab-cli -v

Show Available Commands: Display a list of available commands and their usage.
bash
$ onetab-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 onetab-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