Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/riotkit-org/riotkit-harbor

Complete compose environment, from development to production with service discovery and health checking. Kubernetes features on Compose scale, with Compose simplicity
https://github.com/riotkit-org/riotkit-harbor

ansible development-environment docker-compose docker-environment docker-framework docker-gen docker-template environment environment-template fabric8 infrastructure-as-code infrastructure-automation jwilder kubernetes letsencrypt nginx-proxy project-template riotkit-harbor rkd service-discovery

Last synced: about 2 months ago
JSON representation

Complete compose environment, from development to production with service discovery and health checking. Kubernetes features on Compose scale, with Compose simplicity

Awesome Lists containing this project

README 

        
RiotKit's Harbor

================



.. image:: https://readthedocs.org/projects/riotkit-docker-template/badge/?version=latest

	:alt: Documentation Status

	:target: https://environment.docs.riotkit.org/en/latest/



.. image:: http://www.repostatus.org/badges/latest/active.svg

	:alt: Project Status: Active – The project has reached a stable, usable state and is being actively developed.

	:target: http://www.repostatus.org/#active



.. image:: https://img.shields.io/github/v/release/riotkit-org/riotkit-harbor?include_prereleases

	:target: https://img.shields.io/github/v/release/riotkit-org/riotkit-harbor?include_prereleases

	:alt: Github Release



.. image:: https://img.shields.io/badge/Made%20with-Python-1f425f.svg

	:target: https://img.shields.io/badge/Made%20with-Python-1f425f.svg

	:alt: Made with Python



.. image:: https://img.shields.io/pypi/l/rkd-harbor.svg

	:target: https://img.shields.io/pypi/l/rkd-harbor.svg

	:alt: License



.. image:: https://travis-ci.com/riotkit-org/riotkit-harbor.svg?branch=master

	:target: https://travis-ci.com/riotkit-org/riotkit-harbor

	:alt: Travis CI



.. image:: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square

	:target: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square

	:alt: PRs welcome



.. image:: https://img.shields.io/github/issues-pr/riotkit-org/riotkit-harbor.svg

	:target: https://img.shields.io/github/issues-pr/riotkit-org/riotkit-harbor.svg

	:alt: PRs open



.. image:: https://img.shields.io/github/issues/riotkit-org/riotkit-harbor.svg

	:target: https://img.shields.io/github/issues/riotkit-org/riotkit-harbor.svg

	:alt: Issues open



:code:`docker-compose` based framework for building production-like environments - developing and testing on your local computer, deploying to your server or cluster from shell or from CI.



Demo: https://asciinema.org/a/348698



Notice

^^^^^^



This project will be in the future replaced by "Space Harbor", which is successor of Harbor.

Why? We started Harbor project as lightweight and elastic replacement for Kubernetes usage in tiny scale (for smaller services like blogs, forums etc.)

but recently we researched usage of a lightweight Kubernetes distribution which fits very well for tiny scale and does not require an extra development

of Python code.



We will support bugfixes fixes to Harbor till 01.01.2023, please consider migration to https://github.com/riotkit-org/k3s-space-harbor as soon as it will be

announced stable.



Harbor

^^^^^^



Is Kubernetes or OKD too big overhead or not suitable for your environment?

"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""



Is standard docker-compose too primitive to use in production?

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""



Harbor fits perfectly, while providing some of Kubernetes-like solutions in docker-compose!

"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""



**Features:**



- Service discovery (pins containers into WWW domains by labelling)

- Deployment strategies: compose's standard, recreation, and **rolling-updates (zero-downtime updates)**

- Automatic Letsencrypt SSL

- Standardized directory structures and design patterns

- Ready to use snippets of code and solutions (one command to install database, Wordpress or other application from our repository)

- Ansible integration to prepare your production/testing server and deploy updates in extremely intuitive way



**Roadmap:**



**Harbor 2.1**



- Init containers support (basing on Kubernetes idea) (`#5 `_)

- delayed-request update strategy (minimum-downtime deployment with holding all HTTP requests waiting for new application) (`#11 `_)

- Webhook handling update daemon to trigger container and git updates (`#10 `_)



Read documentation for more: https://environment.docs.riotkit.org/en/latest/?badge=latest

"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""



Changelog

---------



Harbor 2.0

""""""""""



- Service upgrade strategies: Compose-native, recreation, rolling-updates

- Rewrite from Makefile to Python

- Containers startup priority

- Maintenance mode is now not only global, but also per domain

- Development mode now supports not only .localhost domains, but also \*.xip.io



From authors

------------



We are grassroot activists for social change, so we created this software while we were helping those fantastic initiatives:



- RiotKit (https://riotkit.org)

- International Workers Association (https://iwa-ait.org)

- Anarchistyczne FAQ (http://anarchizm.info) a translation of Anarchist FAQ (https://theanarchistlibrary.org/library/the-anarchist-faq-editorial-collective-an-anarchist-faq)

- Federacja Anarchistyczna (http://federacja-anarchistyczna.pl)

- Związek Syndykalistów Polski (https://zsp.net.pl) (Polish section of IWA-AIT)

- Komitet Obrony Praw Lokatorów (https://lokatorzy.info.pl)

- Solidarity Federation (https://solfed.org.uk)

- Priama Akcia (https://priamaakcia.sk)



Special thanks to `Working Class History `_ for very powerful samples that we could use in our unit tests.