OCPeasy - Command Line Interface

Introduction

OCPeasy consists in a CLI to facilitate the deployment of OpenShift applications, generating the configuration based on your project requirements.

Pre-requisites (Development)

• Poetry is required to develop and test locally the CLI.

curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python -

Appendix

The default install poetry location is ~/.poetry/bin/poetry

In order to add poetry binary to your $PATH environment variable, add the line below into your .zshrc (or equivalent)

export PATH=$PATH:$HOME/.poetry/bin

• pre-commit is required to ensure linting (with flake8) and formatting (with black) are applied before each commit

make config_precommit

Get started

Prerequisites (end user):

• oc corresponding to the version used by OpenShift server (https://docs.openshift.com/container-platform/4.1/release_notes/versioning-policy.html)

User guide:

https://www.ocpeasy.org

Roadmap

• Configuring Tests/Linting
• Generate Project yaml ocpeasy.yml
• Generate Stage folder <rootProject>/<.ocpeasy>/<stage>/[stagesFiles].yml
• Supporting CLI invocation from ocpeasy directly
• Schema based validation
• Supporting environment variables
• Composing existing stages with modules (e.g.: Databases, Caches, Messaging Queue, other applications etc...)
• Support SSH Keys for cloning (read: https://stackoverflow.com/questions/28291909/gitpython-and-ssh-keys)

Changelog

• 8MAR2021 - Configure Dockerfile path from CLI
• 2MAR2021 - Initial CLI Version

License

Copyright 2021 ocpeasy

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.