Cloud-factory NPM

`cloud-factory` - Construct Utilities

A CLI Utility to Manage Software-Defined State

cloud-factory is a commandline application that provides ci-cd capabilities, code extensions, and overall utilities for cloud-related management and development.

In order to begin, open a node.js capable console and then run the following command:

npx --yes cloud-factory@latest --help

Schemas

Usage

There exists a few different ways to run cloud-factory, depending on the context.

Development Usage

While locally developing, the application can be started via the start command located in package.json:

# Start
npm run start

# Help
npm run start -- --help

# Environment Sub-Command Example
npm run start -- environment

Note: a -- is required between the run-script command, and CLI input. This is due to limitations around npm, and parsing input.

NPX Global Usage

npx runs against the most recently-published NPM package.

# Start
npx --yes cloud-factory@latest

# Help
npx --yes cloud-factory@latest ? [--] --help

# Environment Sub-Command Example
npx --yes cloud-factory@latest ? [--] environment

Note: the --yes flag is only required to bypass the install prompt. Once installed, the --yes flag can be optionally included without prompt.

NPM System Usage

cloud-factory can optionally be installed globally to any npm-capable system.

First, run npm install --global cloud-factory. Then, cloud-factory can be used similar to any other installed executable:

# Installation
npm install --global cloud-factory@latest

# Start
cloud-factory

# Help
cloud-factory --help

# Environment Sub-Command Example
cloud-factory environment

Example(s) - A Lambda Deployment

The following example deploys a single Lambda function, but includes, implicitly, the following resources:

Lambda Function
A Lambda Layer
API Gateway
X-Ray Enablement
Log-Groups
SSM Parameter(s)

Note, the only requirement would be a Lambda Function, but for the sake of demonstration, the example includes a Lambda Layer, too.

All other resources are defined dynamically by cloud-factory.

Define and create a new directory
- mkdir -p example
- cd example
Clone source(s)
1. Lambda Function
  - git clone https://github.com/cloud-hybrid/lambda-function-concept.git ./test-function
2. Lambda Layer
  - git clone https://github.com/cloud-hybrid/lambda-layer-concept.git ./library/test-layer

Define a factory.json file:

{
    "name": "Concept",
    "organization": "Cloud-Vault",
    "environment": "Development"
}

i.e.

cat << "EOF" > factory.json
{
    "name": "Concept",
    "organization": "Cloud-Vault",
    "environment": "Development"
}
EOF

Ensure the current directory takes the following shape:

example
  ├── factory.json
  ├── test-function
  └── library
      └── test-layer

With the current-working-directory set to example, run:
```
npx --yes cloud-factory@latest ci-cd initialize --debug
```
- Feel free to omit the --debug flag. It's only included for verbosity and understanding
Verify that a distribution folder was created.

Synthesize the state + source code:

npx --yes cloud-factory@latest ci-cd synthesize --debug

Deploy the lambda function + layer:

npx --yes cloud-factory@latest ci-cd deploy --debug

A hyperlink will be provided upon successful completion. With reference to the example, navigating to https://v41dkt0ik0.execute-api.us-east-2.amazonaws.com/development/test-function will then provide a JSON response body containing information about the package, and the lambda function's layer.

Synopsis

mkdir -p example && cd "${_}"

git clone https://github.com/cloud-hybrid/lambda-function-concept.git ./test-function

git clone https://github.com/cloud-hybrid/lambda-layer-concept.git ./library/test-layer

cat << "EOF" > factory.json
{
    "name": "Concept",
    "organization": "Cloud-Vault",
    "environment": "Development"
}
EOF

npx --yes cloud-factory@latest --version

npx cloud-factory ci-cd initialize  --debug
npx cloud-factory ci-cd synthesize  --debug
npx cloud-factory ci-cd deploy      --debug

[[ "${?}" == "0" ]] && echo "Successfully Deployed"