@soft-artel/ci 2.3.86 → 2.3.87

package/.env

@@ -0,0 +1,21 @@
+GITLAB_PASS=6e8beec72b4a70da5f3c474d379a988b
+GITLAB_API_TOKEN=glpat-6zU_zXo2YNpNzLbPmqW4
+
+CI_REGISTRY=docker.gitlab.soft-artel.com
+CI_REGISTRY_USER=gitlab
+CI_REGISTRY_PASSWORD=6e8beec72b4a70da5f3c474d379a988b
+
+CI_STAGES=["alpha","prod"]
+REPORTER={"token":"476910302:AAFnYmMiPDaVnnwlaMhHP0Rl9MATtiwLha8","chat_id":49385041}
+
+CI_COMMIT_REF_NAME=dev-new-ci
+
+CI_PROJECT_ID=593
+CI_PROJECT_NAME=api
+CI_PROJECT_NAMESPACE=onlc
+CI_PROJECT_PATH=onlc/api
+CI_PROJECT_URL=https://gitlab.soft-artel.com/onlc/api
+CI_PROJECT_DIR=~/dev/onlc/api
+
+CI_REGISTRY_IMAGE=docker.gitlab.soft-artel.com/onlc/api
+K8S_ALPHA_CONFIG=~/dev/onlc/cluster/_alpha/k8s-config

package/.eslintcache

@@ -0,0 +1 @@
+[{"/Users/nailine/dev/soft-artel/ci/k8s/App.ts":"1","/Users/nailine/dev/soft-artel/ci/k8s/DockerImage.ts":"2","/Users/nailine/dev/soft-artel/ci/k8s/Node.ts":"3","/Users/nailine/dev/soft-artel/ci/libs/Exception.ts":"4","/Users/nailine/dev/soft-artel/ci/libs/Git.ts":"5","/Users/nailine/dev/soft-artel/ci/libs/Gitlab.ts":"6","/Users/nailine/dev/soft-artel/ci/libs/Jira.ts":"7","/Users/nailine/dev/soft-artel/ci/libs/Project.ts":"8","/Users/nailine/dev/soft-artel/ci/libs/Reporter.ts":"9","/Users/nailine/dev/soft-artel/ci/libs/Shell.ts":"10","/Users/nailine/dev/soft-artel/ci/libs/helpers.ts":"11","/Users/nailine/dev/soft-artel/ci/sa-ci-k8s.ts":"12","/Users/nailine/dev/soft-artel/ci/sa-ci-xcode.ts":"13","/Users/nailine/dev/soft-artel/ci/upd_pkg.ts":"14","/Users/nailine/dev/soft-artel/ci/libs/prototype.ts":"15"},{"size":4698,"mtime":1652861430718,"results":"16","hashOfConfig":"17"},{"size":3793,"mtime":1652966777654,"results":"18","hashOfConfig":"17"},{"size":3665,"mtime":1652966777654,"results":"19","hashOfConfig":"17"},{"size":440,"mtime":1651661936152,"results":"20","hashOfConfig":"17"},{"size":4647,"mtime":1652832751376,"results":"21","hashOfConfig":"17"},{"size":2248,"mtime":1652832760383,"results":"22","hashOfConfig":"17"},{"size":6116,"mtime":1652686877487,"results":"23","hashOfConfig":"17"},{"size":5033,"mtime":1652966777655,"results":"24","hashOfConfig":"17"},{"size":4567,"mtime":1652966777656,"results":"25","hashOfConfig":"17"},{"size":2518,"mtime":1652686877488,"results":"26","hashOfConfig":"17"},{"size":2460,"mtime":1652686877488,"results":"27","hashOfConfig":"17"},{"size":7217,"mtime":1652966845329,"results":"28","hashOfConfig":"17"},{"size":6723,"mtime":1652795720765,"results":"29","hashOfConfig":"17"},{"size":561,"mtime":1651661936151,"results":"30","hashOfConfig":"17"},{"size":6248,"mtime":1651661936151,"results":"31","hashOfConfig":"17"},{"filePath":"32","messages":"33","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"13qgkga",{"filePath":"34","messages":"35","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"36","messages":"37","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"38","messages":"39","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"40","messages":"41","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"42","messages":"43","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"44","messages":"45","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"46","messages":"47","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"48","messages":"49","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"50","messages":"51","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"52","messages":"53","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"54","messages":"55","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"56","messages":"57","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"58","messages":"59","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"60","messages":"61","errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"/Users/nailine/dev/soft-artel/ci/k8s/App.ts",[],"/Users/nailine/dev/soft-artel/ci/k8s/DockerImage.ts",[],"/Users/nailine/dev/soft-artel/ci/k8s/Node.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/Exception.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/Git.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/Gitlab.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/Jira.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/Project.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/Reporter.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/Shell.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/helpers.ts",[],"/Users/nailine/dev/soft-artel/ci/sa-ci-k8s.ts",[],"/Users/nailine/dev/soft-artel/ci/sa-ci-xcode.ts",[],"/Users/nailine/dev/soft-artel/ci/upd_pkg.ts",[],"/Users/nailine/dev/soft-artel/ci/libs/prototype.ts",[]]

package/.eslintignore

@@ -0,0 +1,4 @@
+/node_modules
+/_publish
+/static
+/_doc

package/.eslintrc

@@ -0,0 +1,246 @@
+{
+	"env": { "es6": true, "node": true, "mocha": true, "browser": false },
+	"parser": "@typescript-eslint/parser",
+	"plugins": ["@typescript-eslint", "prettier", "import"],
+	"extends": ["plugin:@typescript-eslint/recommended", "plugin:prettier/recommended"],
+	"ignorePatterns": ["node_modules/", "dist/"],
+	"parserOptions": {
+		"project": "tsconfig.json",
+		"sourceType": "module"
+	},
+	"rules": {
+		// @typescript-eslint
+		"@typescript-eslint/member-delimiter-style": [
+			"error",
+			{
+				"multiline": { "delimiter": "semi", "requireLast": true },
+				"singleline": { "delimiter": "semi", "requireLast": false }
+			}
+		],
+		"@typescript-eslint/adjacent-overload-signatures": "error",
+		"@typescript-eslint/array-type": "error",
+		"@typescript-eslint/ban-types": "error",
+		"@typescript-eslint/brace-style": "error",
+		"@typescript-eslint/explicit-module-boundary-types": "off",
+		// "@typescript-eslint/camelcase": ["error", { "properties": "never", "allow": ["^[A-Za-z][a-zA-Za-z]+_[A-Za-z]+$"] }],
+		// "@typescript-eslint/class-name-casing": "error",
+		"@typescript-eslint/comma-spacing": "error",
+		"@typescript-eslint/consistent-type-assertions": "error",
+		"@typescript-eslint/consistent-type-definitions": ["error", "interface"],
+		"@typescript-eslint/default-param-last": "error",
+		"@typescript-eslint/func-call-spacing": "error",
+		// "@typescript-eslint/interface-name-prefix": ["error", { "prefixWithI": "never" }],
+		// "@typescript-eslint/member-naming": "error",
+		// "@typescript-eslint/naming-convention": "error",
+		"@typescript-eslint/no-array-constructor": "error",
+		"@typescript-eslint/no-dupe-class-members": "error",
+		"@typescript-eslint/no-extra-non-null-assertion": "error",
+		"@typescript-eslint/no-extra-semi": "error",
+		"@typescript-eslint/no-for-in-array": "error",
+		"@typescript-eslint/no-misused-new": "error",
+		"@typescript-eslint/no-namespace": "error",
+		"@typescript-eslint/no-non-null-asserted-optional-chain": "error",
+		"@typescript-eslint/no-require-imports": "error",
+		"@typescript-eslint/no-this-alias": "error",
+		"@typescript-eslint/no-unnecessary-type-assertion": "error",
+		"@typescript-eslint/no-unused-expressions": ["error", { "allowTernary": true }],
+		"@typescript-eslint/no-use-before-define": "off",
+		"@typescript-eslint/no-var-requires": "error",
+		"@typescript-eslint/prefer-as-const": "error",
+		"@typescript-eslint/prefer-for-of": "error",
+		"@typescript-eslint/prefer-function-type": "error",
+		"@typescript-eslint/prefer-includes": "error",
+		"@typescript-eslint/prefer-namespace-keyword": "error",
+		"@typescript-eslint/prefer-optional-chain": "error",
+		"@typescript-eslint/prefer-regexp-exec": "error",
+		"@typescript-eslint/prefer-string-starts-ends-with": "error",
+		"@typescript-eslint/quotes": ["error", "single", { "avoidEscape": true, "allowTemplateLiterals": true }],
+		"@typescript-eslint/require-await": "error",
+		"@typescript-eslint/semi": ["error", "always"],
+		"@typescript-eslint/space-before-function-paren": ["error", { "asyncArrow": "always", "anonymous": "never", "named": "never" }],
+		"@typescript-eslint/triple-slash-reference": "error",
+		"@typescript-eslint/type-annotation-spacing": "error",
+
+		// @typescript-eslint:warn
+		"@typescript-eslint/indent": [
+			"warn",
+			"tab",
+			{
+				"SwitchCase": 1,
+				"FunctionDeclaration": { "parameters": "first" },
+				"FunctionExpression": { "parameters": "first" }
+			}
+		],
+		"@typescript-eslint/member-ordering": [
+			"warn",
+			{
+				"default": [
+
+
+					
+					"abstract-field",
+					"static-field",
+					"instance-field",
+					"abstract-method",
+					"static-method",
+					"constructor",
+					"instance-method"
+				]
+			}
+		],
+
+		// @typescript-eslint:off
+		"@typescript-eslint/await-thenable": "off",
+		"@typescript-eslint/ban-ts-ignore": "off",
+		"@typescript-eslint/explicit-function-return-type": "off",
+		"@typescript-eslint/explicit-member-accessibility": ["off", { "accessibility": "explicit" }],
+		"@typescript-eslint/no-empty-function": "off",
+		"@typescript-eslint/no-empty-interface": "off",
+		"@typescript-eslint/no-explicit-any": "off",
+		"@typescript-eslint/no-inferrable-types": ["off", { "ignoreProperties": true }],
+		"@typescript-eslint/no-misused-promises": "off",
+		"@typescript-eslint/no-unused-vars": "error",
+		"@typescript-eslint/unbound-method": "off",
+		"@typescript-eslint/unified-signatures": "off",
+		"@typescript-eslint/no-non-null-assertion": "off",
+
+		// import
+		"import/no-deprecated": "error",
+		"import/no-extraneous-dependencies": "error",
+		"import/order": [
+			"error",
+			{
+				"groups": [
+					["builtin", "external", "internal", "unknown"],
+					["parent", "sibling", "index"]
+				],
+				"newlines-between": "always"
+			}
+		],
+
+		// prefer-arrow
+		"prefer-arrow/prefer-arrow-functions": "off",
+
+		// eslint
+		"arrow-body-style": "error",
+		"comma-dangle": ["error", "always-multiline"],
+		"constructor-super": "error",
+		"curly": ["error", "multi-line"],
+		"dot-notation": "error",
+		"eol-last": "error",
+		"eqeqeq": "error",
+		"guard-for-in": "error",
+		"linebreak-style": ["error", "unix"],
+		"max-len": [
+			"error",
+			{
+				"code": 200,
+				"comments": 160,
+				"tabWidth": 2,
+				"ignoreComments": true,
+				"ignoreStrings": true,
+				"ignoreRegExpLiterals": true,
+				"ignoreTrailingComments": true,
+				"ignoreTemplateLiterals": true
+			}
+		],
+		"new-parens": "error",
+		"no-caller": "error",
+		"no-cond-assign": "error",
+		"no-debugger": "error",
+		"no-duplicate-case": "error",
+		"no-duplicate-imports": "error",
+		"no-eval": "error",
+		"no-extra-bind": "error",
+		"no-fallthrough": "error",
+		"no-multiple-empty-lines": "error",
+		"no-new-func": "error",
+		"no-new-wrappers": "error",
+		"no-restricted-imports": ["error", "rxjs/Rx"],
+		"no-return-await": "error",
+		"no-sparse-arrays": "error",
+		"no-throw-literal": "error",
+		"no-trailing-spaces": [
+			"error",{
+				"skipBlankLines": true
+			}
+		],
+		"no-undef-init": "error",
+		"no-unsafe-finally": "error",
+		"no-unused-expressions": "error",
+		"no-unused-labels": "error",
+		"no-var": "error",
+		"object-shorthand": "error",
+		"prefer-const": "error",
+		"prefer-object-spread": "error",
+		"prefer-rest-params": "error",
+		"prefer-spread": "error",
+		"quote-props": ["error", "consistent-as-needed"],
+		"radix": "error",
+		"space-in-parens": "error",
+		"spaced-comment": "error",
+		"unicode-bom": ["error", "never"],
+		"use-isnan": "error",
+
+		// eslint:warn
+		"no-restricted-globals": "warn",
+		"object-curly-newline": [
+			"warn",
+			{
+				"ObjectExpression": { "multiline": true, "minProperties": 4, "consistent": true },
+				"ImportDeclaration": { "multiline": true, "consistent": true },
+				"ExportDeclaration": { "multiline": true, "minProperties": 2, "consistent": true }
+			}
+		],
+
+
+		// prettier
+		"prettier/prettier": "off",
+		"semi": "off",
+		// "prettier/prettier": [
+		// 	"warn",
+		// 	{
+		// 		"endOfLine": "lf",
+		// 		"printWidth": 140,
+		// 		"semi": true,
+		// 		"singleQuote": true,
+		// 		"tabWidth": 2,
+		// 		"trailingComma": "all",
+		// 		"useTabs": true,
+		// 		"bracketSpacing": true,
+		// 		"proseWrap": "never"
+		// 	}
+		// ],
+		
+		// eslint:off
+		"array-element-newline": ["off", { "multiline": true, "minItems": 1 }],
+		"arrow-parens": ["off", "as-needed"],
+		"camelcase": "off",
+		"complexity": "off",
+		"id-blacklist": "off",
+		"id-match": "off",
+		"max-classes-per-file": "off",
+		"no-array-constructor": "off",
+		"no-bitwise": "off",
+		"no-console": "error",
+		"no-empty-function": "off",
+		"no-empty": "error",
+		"no-invalid-this": "off",
+		"no-shadow": ["off", { "hoist": "all" }],
+		"no-underscore-dangle": "off",
+		"no-unused-vars": "off",
+		"no-use-before-define": "off",
+		"one-var": ["off", "never"],
+		"require-await": "off",
+		"space-before-function-paren": [
+			"off",
+			{
+				"anonymous": "never",
+				"asyncArrow": "always",
+				"named": "never"
+			}
+		],
+		"valid-typeof": "off",
+		"no-implicit-coercion": "error"
+	}
+}

package/.gitlab-ci.yml

@@ -0,0 +1,12 @@
+stages:
+ - package
+
+public_sa-ci:
+ stage: package
+ only:
+   - release
+ script:
+  - 'sh ./_publish.sh'
+  - 'npm update -g @soft-artel/ci'
+ tags:
+  - ansible

package/README.md

@@ -0,0 +1,33 @@
+# CI/CD System
+
+
+
+#GitLab CI Variables in Group: 
+
+ #GitLab CI Variables in Project: 
+ - `STAGES_STATE` = {
+   "alpha": "1.0.0",
+   "prod": "1.0.0"
+}
+
+ - `LAST_BUILD` = 0
+
+ 		const k8s_tpl_fileName = 'app.k8s.yaml';
+		const k8s_spec_fileName = 'app.k8s.json';
+
+
+export interface Config {
+
+	group?: string
+	name?:  string
+
+	rootPath?:  string
+
+	appsPath?:  string
+
+	sharedPaths?: string[];
+	ignorePaths?: string[];
+
+	appFile?: string
+
+}

package/_publish.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+echo "Publishing v$(cat ./package.json | grep version | grep -o '[0-9\.]\+')"
+
+rm -rf _dist
+npm i --production
+npm run build
+
+echo "Build succseed!"
+
+cd _dist
+npm publish

package/package.json

@@ -7,7 +7,7 @@
       "url": "http://gitlab.soft-artel.com/soft-artel/ci.git"
    },
    "name": "@soft-artel/ci",
-   "version": "2.3.86",
+   "version": "2.3.87",
    "main": "sa-ci-k8s.js",
    "bin": {
       "sa-ci-k8s-build": "./commands/k8s-build.js",
@@ -21,7 +21,7 @@
       "lint+fix": "eslint --cache \"./**/*.ts\" --fix",
       "sa-commit": "sa-commit -a -p",
       "build": "rm -rf _dist && tsc -p tsconfig.json && cp package.json _dist/",
-      "pub": "ts-node ./src/commands/incrementBuild && npm run build && cd _dist && npm publish && sa-commit -a -p"
+      "pub": "ts-node ./src/commands/incrementBuild && sh _publish.sh && sa-commit -a -p"
    },
    "dependencies": {
       "axios": "1.7.2",

package/src/Project.ts

@@ -0,0 +1,286 @@
+import { promises as fsAsync } from 'fs';
+import { OptionValues} from 'commander';
+
+import { log } from './utils/Logger'
+import Shell from './utils/Shell';
+
+import { capitalizeFirstLetter, checkEnvVars, htmlToMd, resolvePath } from './utils/helpers';
+
+import Gitlab from './services/Gitlab';
+import { Reporter } from './services/Reporter';
+import { Exception } from './utils/Exception';
+
+const ENV = process.env;
+
+export type RunCommandHandler = ( prj: Project, reporter: Reporter, opts: OptionValues, config: Config ) => Promise<any>
+
+
+export interface Config {
+
+	group?: string
+	name?:  string
+
+	rootPath?:  string
+
+	appsPath?:  string
+
+	sharedPaths?: string[];
+	ignorePaths?: string[];
+
+	appFile?: string
+
+}
+
+
+export class Project {
+
+	// ENV FROM GitLab Runner  ---------------
+	isRunner = ENV.CI_JOB_ID !== undefined;
+
+	id = (Number(ENV.CI_PROJECT_ID as unknown as number || 0));
+	path = ENV.CI_PROJECT_PATH || '';  // <group>/<project>
+	url  = ENV.CI_PROJECT_URL || '';   // http://<gitlab>/<group>/<project>
+
+	name = ENV.CI_PROJECT_NAME || '';
+	group = ENV.CI_PROJECT_NAMESPACE || '';
+
+	// Common proporties ---------------
+	rootPath: string = '';
+
+	build = 0;
+	version = '0.0.0';
+	stage: string = ENV.CI_COMMIT_REF_NAME || 'dev';
+
+	$stagesState: Record<string, string> = {};
+
+	job = {
+
+		id: ENV.CI_JOB_ID,
+		name: ENV.CI_JOB_NAME || 'No Job',
+		step: ENV.CI_JOB_STAGE || 'build',
+		branch: ENV.CI_COMMIT_REF_NAME || 'dev',
+    
+		url: ENV.CI_JOB_URL || '',
+		pipline: ENV.CI_PIPELINE_URL || '',
+    
+		user: {
+			ID: ENV.GITLAB_USER_ID || '',
+			login: ENV.GITLAB_USER_LOGIN || '',
+			name: ENV.GITLAB_USER_NAME 	 || '',
+			email: ENV.GITLAB_USER_EMAIL || '',
+		},
+
+		commit:{
+			title: ENV.CI_COMMIT_TITLE || '',
+			author: {
+				name: (ENV.CI_COMMIT_AUTHOR || ' < ').split('<')[0],
+				email: ((ENV.CI_COMMIT_AUTHOR || ' < ').split('<')[1] || ' ').replace('>', ''),
+			},
+			hash: '',
+			url: `${ ENV.CI_PROJECT_URL }/-/commit/${ ENV.CI_COMMIT_SHA }`,
+		},
+
+	};
+
+	// --------------
+
+	static async run( opts: OptionValues, runHandler: RunCommandHandler, chekEnv?: string[] ){
+
+		const ciPkg = JSON.parse( await Shell.cat( __dirname +'/package.json' ) || "{}" );
+		log.info( 'Soft-Artel CI v' + ciPkg?.version || 'undefined')
+
+		let reporter: Reporter | undefined;
+
+		try {
+
+				// ------------------
+				// Проверяем установленыли переменные!
+
+				checkEnvVars( ['STAGES_STATE', 'REPORTER', 'LAST_BUILD'] );
+
+				if( chekEnv ){
+					checkEnvVars( chekEnv )
+				}
+
+				// ------------------
+				// Инициализируемся
+				log.dbg( 'Command run opts', opts )
+
+				const prj = new Project(opts.path, opts.stage);
+
+				const reporterOpts = JSON.parse( ENV.REPORTER! );
+				reporterOpts.postTitle = opts.scheme;
+
+				// Get current version of project
+				// 1. JS and TS projects - package.json
+				// 2. XCode ?
+
+				if( await Shell.test('-e', prj.rootPath +'/package.json' ) ){
+				
+					const pkg = JSON.parse(await Shell.cat( prj.rootPath +'/package.json' ) || 'no package.json file!');
+					const pkgBuild =  Number(pkg.version.split('.')[2]);
+	
+					prj.build = prj.build < pkgBuild ? pkgBuild : prj.build;
+					prj.version = `${ pkg.version.split('.').splice(0, 2).join('.') }.${ prj.build }`;	
+
+				}
+				else if( await Shell.test('-e', 'XCODE PROJECT PAH' ) ){
+
+					const scheme = opts.scheme || 'iOS';
+	
+					const xcodeVersion = await Shell.exec(`xcodebuild -showBuildSettings -scheme ${ scheme } | grep MARKETING_VERSION | tr -d 'MARKETING_VERSION = '`, { silent: true });
+					const xcodeBuild   =  Number(await Shell.exec(`xcodebuild -showBuildSettings -scheme ${ scheme } | grep CURRENT_PROJECT_VERSION | tr -d 'CURRENT_PROJECT_VERSION = '`, { silent: true }));
+				
+					prj.build = prj.build < xcodeBuild ? xcodeBuild : prj.build;
+					prj.version = `${ xcodeVersion }.${ prj.build }`;
+
+				}
+				else{
+
+					// Not found any allowed platform
+					throw new Exception( 'package.json or xcode project not found on path:' + prj.rootPath )
+
+				}
+				
+				reporter = new Reporter(prj, reporterOpts);
+
+
+				if( await Shell.test('-e', prj.rootPath +'/ci-config.json' ) ){
+				
+					const config = JSON.parse(await Shell.cat( prj.rootPath +'/ci-config.json' ) || 'no ci-config.json file!');
+
+					prj.rootPath = config.rootPath || prj.rootPath
+					prj.group 	 = config.group 	 || prj.group
+					prj.name		 = config.name 		 || prj.name
+
+					// Запускаем команду
+					return await runHandler(prj, reporter, opts, config as Config);
+
+				}
+				else{
+					// Not found any allowed platform
+					throw new Exception( 'ci-config.json not found on path:' + prj.rootPath )
+
+				}
+
+
+
+		} catch(e){
+
+			log.error(e);
+
+			if(reporter){
+				try {
+					await reporter.fail(e);
+				} catch(e2){
+					log.error(e2);
+				}
+		
+			}
+
+			process.exit(1);
+			
+		}
+
+	}
+
+	// --------------
+
+	constructor(workdir: string | undefined, stage?: string){
+		this.rootPath = resolvePath(workdir || ENV.CI_PROJECT_DIR || Shell.pwd().toString());
+		this.stage = stage || this.stage
+
+		this.$stagesState = JSON.parse( ENV.STAGES_STATE! );
+
+		log.dbg('STAGES STATE', this.$stagesState );
+
+		this.build   =  Number(ENV.LAST_BUILD) || 0;
+
+		this.version =  '0.0.' + this.build; // Mast init later! [depends fom platform]
+
+		Shell.cd(this.rootPath);
+		log.dbg(`[${this.stage}, ${this.version}] `+this.rootPath);
+	}
+
+	// --------------
+
+	get shortVersion(){
+		return this.version.split('.').splice(0, 2).join('.');
+	}
+
+	get prevVersion(){
+		const pV = this.$stagesState[ this.stage ];
+		return pV !== '0.0.0' ? pV : undefined;
+	}
+
+	// --------------
+
+	incrementBuild(newBuild?: number){
+		if (newBuild) {
+			this.build = newBuild;
+		} else {
+			this.build += 1;
+		}
+		this.version = `${ this.shortVersion }.${ this.build}`;
+	}
+	
+	// --------------
+	
+	async saveGitLabBuild(){
+		await Gitlab.saveVariable(this, 'LAST_BUILD', this.build);
+	}
+
+	// ----------------
+	
+	async saveGitLabStagesVersions(){
+		this.$stagesState[ this.stage ] = this.version;
+		await Gitlab.saveVariable(this, 'STAGES_STATE', JSON.stringify(this.$stagesState, null, 3));
+	}
+
+	// --------------
+
+	async updateChangeLog(whatsNewHtml: string, filename = 'CHANGELOG.md') {
+
+		const filePath = `${ this.rootPath}/${ filename }`;
+
+		let title = `# ${ capitalizeFirstLetter(this.group) }: **${ this.name.toUpperCase() }**`;
+
+		log.info(`Update ${filename}:\n${title}`);
+
+		let changeLog = await Shell.cat(filePath, {silent:true, ignoreError:true}) || '';
+		const lines = changeLog.split('\n');
+
+		if(Array.isArray(lines) && lines.length > 1){
+			title = lines.shift() || title;
+			changeLog = lines.join('\n');
+		}
+                  
+		const dateTime = new Date().toLocaleString('ru-RU', {
+			weekday: 'long',
+			year: 'numeric',
+			month: 'short',
+			day: 'numeric',
+			timeZone: 'Europe/Moscow',
+			hour12: false,
+			hour: 'numeric',
+			minute: 'numeric',
+		});
+
+		const whatsNewMd = htmlToMd(whatsNewHtml);
+
+		changeLog = `${ title }
+## **${ this.version }**
+${ capitalizeFirstLetter(dateTime) }
+
+${ whatsNewMd }
+ 
+ 
+ 
+ 
+${ changeLog }
+`;
+
+		await fsAsync.writeFile(filePath, changeLog, { encoding: 'utf8', flag: 'w+'});
+	}
+
+}