poco-ops 1.0.3
poco lets you catalogue and manage your Docker projects using simple YAML files to shorten the route from finding your project to initialising it in your environment.
License: Apache License 2.0

# POCO-OPS
[![Build Status](https://travis-ci.org/shiwaforce/poco-ops.svg?branch=master)](https://travis-ci.org/shiwaforce/poco-ops)
[![pypi](https://img.shields.io/pypi/v/poco-ops.svg)](https://pypi.python.org/pypi/poco-ops)
[![pypi](https://img.shields.io/pypi/pyversions/poco-ops.svg)](https://pypi.python.org/pypi/poco-ops)
[![Test Coverage](https://api.codeclimate.com/v1/badges/4e624a36306d3807572c/test_coverage)](https://codeclimate.com/github/shiwaforce/poco-lite/test_coverage)
[![Maintainability](https://api.codeclimate.com/v1/badges/4e624a36306d3807572c/maintainability)](https://codeclimate.com/github/shiwaforce/poco-lite/maintainability)

<p align="center">
  <img width="200" height="200" title="Poco Logo" src="https://raw.githubusercontent.com/shiwaforce/poco/master/logo.svg?sanitize=true"/>
</p>

**THIS IS THE LIGHTWEIGHT VERSION OF [POCO](https://pypi.python.org/pypi/poco).**


**Poco** helps to organise and manage Docker, Docker-Compose, Kubernetes projects of any complexity using simple YAML config files to shorten the route from finding your project to initialising it in your local environment.

- **Simple**. Configure, run and switch between projects with a very simple command line interface.     
- **Flexibility**. Manage, scale, maintain projects of any complexity with ease.
- **Configure Once, Use Everywhere**. Configure project once so the rest of your team will feel the value of zero configuration. 

## Features
- **Docker, Docker-Compose, Kubernetes, Helm** support out of the box.
- **Multiple Plans**. Create multiple plans for different environments or even environments for demo purposes. Switch between plans (environments) with ease.
- **Simple Config Files**. Poco helps to split config files, so it is easy to maintain and scale them any time.
- **Script Support (Hooks)**. Add additional scripts any time.


## Documentation
All documentation is available on [proco.app](https://proco.app)
- [Documentation](http://proco.app/documentation) 
- [Overview](http://proco.app/documentation/) 
- [Tutorials](http://proco.app/tutorials/) 
- [Github, Gitlab Integration](http://proco.app/documentation/third-party-integrations/) 


## Requirements
- Docker (17.0.0 or higher version is recommended)
- kubectl, for Kubernetes support
- helm, for helm functionality support

## Quick start
Install `poco`:
```
$:~ pip install poco
```

Init project:
```
$:~ mkdir my-project
$:~ cd my-project
$:~ poco init
```
`poco.yml` and `docker-compose.yml` example files will be created.

Start project:
```
$:~ poco up
```

Before adding your project to Poco Repo create new empty git repository,
add repository to your local Poco Repo config:
```
$:~ poco repo add <name> <git-url>
```

Now you can add you project to repo:
```
$:~ poco project add [<target-dir>] [<catalog>]
```

Publish your changes:
```
$:~ poco repo push
```

Stop your project:
```
$:~ poco stop
```

## Licence
[MIT](http://opensource.org/licenses/MIT)
Copyright (c) 2017-present, [Shiwaforce.com](https://www.shiwaforce.com/en)