poco 0.99.6

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.

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.
• Git, SVN support out of the box.
• Project Catalog, Multiple Catalogues. Create your own project catalog. Organise your projects without additional tools.
• 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.

Global options

• -V, --verbose — Print more (e.g. merged docker compose config for up/down).
• -VV or --no-matrix — No matrix effect, show full output (for up/down). Implies verbose.
• -q, --quiet — Print less.
• --offline — Offline mode.
• --always-update — Project repository handle by user.

For poco up / poco down, a matrix-style effect runs by default; only the final result is shown. Set POCO_MATRIX=0 to disable the effect, or use -VV / --no-matrix to disable it and see the full log.

Documentation

All documentation is available on getpoco.io

• Documentation
• Install
• Tutorials
• Github, Gitlab Integration

Requirements

• Python 3.12.3 or newer (supported version: 3.14.3)
• Git or SVN
• SSH
• Docker (17.0.0 or higher version is recommended)
• Docker Compose V2 (plugin: docker compose), for compose support
• 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 your project to repo:

$:~ poco project add [<target-dir>] [<catalog>]

Publish your changes:

$:~ poco repo push

Stop your project:

$:~ poco stop

Kubernetes & Helm helpers

• kubectx — List or switch kubectl context: poco kubectx (list), poco kubectx <context> (switch).
• kubens — List or switch namespace: poco kubens (list), poco kubens <namespace> (set current context namespace).
• helm-repos — List Helm repositories: poco helm-repos.
• helm-list — List Helm releases: poco helm-list, poco helm-list --all-namespaces for all namespaces.

Requires kubectl and/or helm installed and configured.

Changelog

See CHANGELOG.md for release history. Recent: 0.99.6 — kubectx/kubens/helm helpers, matrix 20-line TTY-adaptive effect, verbose merged compose, -VV/--no-matrix.

Licence

MIT Copyright (c) 2017-present, Shiwaforce.com