Zun

Zun (ex. Higgins) is the OpenStack Containers service. It aims to provide an API service for running application containers without the need to manage servers or clusters.

= News =


 * 2016-04-20 According to the discussion in the OpenStack Austin design summit, we are going to create a new project (which is Higgins) for providing OpenStack container service. The Magnum project (another OpenStack project for containers) will focus on deployment and management of Container Orchestration Engines (COEs).
 * 2016-06-07 We renamed the project from "Higgins" to "Zun"

= Resources =
 * Launchpad Project Pages
 * Zun Launchpad Project
 * Bug Tracker
 * Code Repository
 * http://git.openstack.org/cgit/openstack/zun
 * Design Spec
 * https://review.openstack.org/#/c/365754/ The sandbox approach
 * Etherpads
 * https://etherpad.openstack.org/p/container-management-service
 * https://etherpad.openstack.org/p/zun-architecture-decisions
 * https://etherpad.openstack.org/p/zun-container-state-management
 * https://etherpad.openstack.org/p/zun-container-image
 * https://etherpad.openstack.org/p/zun-ocata-planning
 * https://etherpad.openstack.org/p/zun-core-api
 * https://etherpad.openstack.org/p/zun-image-api
 * https://etherpad.openstack.org/p/zun-container-composition
 * https://etherpad.openstack.org/p/zun-nfv-use-cases
 * https://etherpad.openstack.org/p/zun-multihost-problems

= Mailing List = Mailing list discussion for this team is on the OpenStack Developers Mailing List. Prepend the topic tag [Zun] to your subject line depending on the category of your inquiry.
 * Subscribe to openstack-dev@lists.openstack.org
 * Mailing List Archives

= IRC = Our developers use IRC in  on freenode for development discussion.

= Meetings = The Zun team holds public meetings. We meet in  on Tuesday on the following schedule:

Agenda for 2018-05-01 0300 UTC

 * Roll Call
 * Announcement
 * Review Action Items
 * Blueprints
 * OpenStack as a virtual Kubernetes node (assignee: kevinz)
 * #link https://blueprints.launchpad.net/zun/+spec/zun-connector-for-k8s
 * Introduce quota for containers (assignee: kiennt26)
 * #link https://blueprints.launchpad.net/zun/+spec/quota-support
 * Manage the reverse disk for container images (assignee: fengshengqin)
 * #link https://blueprints.launchpad.net/zun/+spec/manage-container-image-disk
 * Bugs
 * Interactive exec via proxy (assignee: hongbin)
 * #link https://bugs.launchpad.net/zun/+bug/1735076
 * Open Discussion

Previous Meetings

 * 2018 ZunTeam Meeting Archive
 * 2017 ZunTeam Meeting Archive
 * 2016 Zun Team Meeting Archive
 * 2016 Higgins Team Meeting Archive

= Architecture =


 * Zun API: Process REST requests and validate inputted parameters.
 * Zun Compute: Launch containers and manage compute resources in localhost.
 * Keystone: Authenticate incoming requests.
 * Neutron: Provide networking for containers.
 * Glance: An option to store container images (another option is DockerHub).
 * Kuryr: A Docker network plugin for connecting containers to neutron networks.



= Frequently Asked Questions = 1) What is the relationship between Zun and Magnum?

Zun and Magnum are two independent projects. Zun aims to provide API service for managing containerized applications, while Magnum provides APIs to provision and manage Container Orchestration Engine (COEs), such as Kubernetes.

2) Who is Zun for? In comparison, who is Magnum for?

Zun is for users who want to create and manage containers as OpenStack-managed resource. Containers managed by Zun are supposed to be integrated well with other OpenStack resources, such as Neutron network and Cinder volume. Users are provided a simplified APIs to manage containers without the need to explore the complexities of different container technologies. Magnum is for users who want a self-service solution to provision and manage a Kubernetes (or other COEs) cluster.

3) What is the difference between Zun and nova-docker?

Nova-docker allows accessing containers via Nova's API, while Zun is not bounded by Nova's API.

4) Does Zun compete with Kubernetes (or other COEs)?

No. Zun and Kubernetes are complementary. In fact, Zun team is actively working on a Kubernetes integration feature. See this blueprint for details.