Jump to: navigation, search

Difference between revisions of "Magnum"

m (Summary)
(Meetings)
(48 intermediate revisions by 10 users not shown)
Line 1: Line 1:
= News =
+
Magnum is an OpenStack API service developed by the [[Teams/Containers|OpenStack Containers Team]] making container orchestration engines such as Docker Swarm, Kubernetes, and Apache Mesos available as first class resources in OpenStack.  Magnum uses Heat to orchestrate an OS image which contains Docker and Kubernetes and runs that image in either virtual machines or bare metal in a cluster configuration. Click below for a ~2 minute demo of how the Magnum CLI works.
  
* We [http://lists.openstack.org/pipermail/openstack-dev/2015-January/054848.html have announced] Magnum's first release, now [https://github.com/stackforge/magnum/releases/tag/m1 available for download].
+
<center>
* We are holding a [[Magnum/Midcycle|mid-cycle meet-up]] in San Francisco on March 2nd and 3rd 2015. Our [[Magnum/Midcycle|Midcycle]] page has details about the location, dates/times, a way to submit agenda items, and link to [https://www.eventbrite.com/e/magnum-midcycle-meetup-tickets-15673361446 RSVP].
+
[[File:Demo-Preview-Frame.png|none|link=https://vimeo.com/177327412|frame|400px]]
 +
</center>
  
= Summary =
+
__TOC__
  
Magnum is a new API service under development by the [[Teams/Containers|OpenStack Containers Team]] for OpenStack to make container management tools such as Docker and Kubernetes available as a first class resource in OpenStack. Magnum uses Heat to orchestrate an OS image which contains docker and kubernetes and runs that image in either virtual machines or bare metal in a cluster configuration.
+
= Getting Started / Download =
 +
To get started with Magnum, see: [http://docs.openstack.org/developer/magnum/dev/quickstart.html Our Quickstart Guide]
  
The project is under active development by our OpenStack Containers Team. We [[Meetings/Containers|meet weekly by IRC]]. Magnum's meetings are normally chaired by our PTL [https://launchpad.net/~aotto Adrian Otto].
+
Downloads:
 +
* [http://tarballs.openstack.org/magnum/ magnum]  
 +
* [http://tarballs.openstack.org/python-magnumclient/ python-magnumclient]
  
__TOC__
+
= Contributing =
 +
 
 +
The project is under active development by our OpenStack Containers Team. We [[Meetings/Containers|meet weekly by IRC]].
 +
 
 +
* We want you to [[Magnum/Contributing|contribute to Magnum]]!
 +
 
 +
= Architecture =
 +
 
 +
[[File:Magnum_architecture.png|center|800px|Magnum Architeture Diagram]]
 +
Cluster Create/Update/Delete
  
 
= Resources =
 
= Resources =
Line 23: Line 36:
 
** [https://review.openstack.org/#/q/status:open+magnum,n,z Gerrit Reviews]
 
** [https://review.openstack.org/#/q/status:open+magnum,n,z Gerrit Reviews]
 
* Code Repository
 
* Code Repository
** git clone git://git.openstack.org/stackforge/magnum
+
** git clone git://git.openstack.org/openstack/magnum
* Specification
+
* References
** [https://review.openstack.org/136103 Containers Service Spec]
+
**[[Magnum/Acronyms|Acronyms]]
 +
**[http://eavesdrop.openstack.org/irclogs/%23openstack-containers/ IRC Logs - OpenStack Containers]
 +
**[http://eavesdrop.openstack.org/meetings/containers/2016/ Meeting Minutes - OpenStack Containers]
  
 
= IRC =
 
= IRC =
Line 33: Line 48:
 
= Meetings =
 
= Meetings =
  
* The weekly Containers [[Meetings/Containers|IRC meeting]] is held on Tuesdays at 1600 UTC and 2200 UTC on alternating weeks [[Meetings/Containers|[schedule]]].
+
* The weekly Containers [[Meetings/Containers|IRC meeting]] is held on Tuesdays at 1600 UTC [https://calendar.google.com/calendar/ical/dl8ufmpm2ahi084d038o7rgoek%40group.calendar.google.com/public/basic.ics schedule].
* [http://eavesdrop.openstack.org/meetings/containers/2014/ 2014 Containers Meeting Archive]
+
* [http://eavesdrop.openstack.org/meetings/containers/2017/?C=M;O=D 2017 Containers Meeting Archive]
 +
* [http://eavesdrop.openstack.org/meetings/containers/2016/?C=M;O=D 2016 Containers Meeting Archive]
 +
 
 +
= Users =
 +
* [http://home.cern CERN] - details on the [http://openstack-in-production.blogspot.fr blog]
 +
* (your group or organization here)
  
 
= Frequently Asked Questions =
 
= Frequently Asked Questions =
 +
'''1) How is Magnum is different from Nova?'''
 +
 +
Magnum provides a purpose built API to manage application containers orchestration engines, which have a distinctly different life cycle and operations than Nova (machine) Instances. We actually use Nova instances to compose our Clusters.
 +
 +
'''2) How is Magnum different than Docker or Kubernetes?'''
 +
 +
Magnum offers an asynchronous API that's compatible with Keystone, and a complete multi-tenancy implementation. It does not perform orchestration internally, and instead relies on OpenStack Orchestration. Magnum does leverage both Kubernetes and Docker as components.
 +
 +
'''3) Is this the same thing as Nova-Docker?'''
 +
 +
No, Nova-Docker is a virt driver for Nova that allows containers to be created as Nova instances. This is suitable for use cases when you want to treat a container like a lightweight machine. Magnum provides container orchestration engine management that is beyond the scope of Nova's API, and implements its own API to surface these features in a way that is consistent with other OpenStack services. Containers started on Magnum Clusters are run on top of Nova instances that are created using Heat.
 +
 +
'''4) Who is Magnum for?'''
 +
 +
Magnum is for OpenStack cloud operators (public or private) who want to offer a self-service solution to provide a hosted containers service to their cloud users. Magnum simplifies the required integration with OpenStack, and allows for cloud users who can already launch cloud resources such as Nova Instances, Cinder Volumes, Trove Databases, etc. to also create container clusters (Clusters) to run applications in an environment that provides advanced features that are beyond the scope of existing cloud resources.
 +
 +
'''5) Will I get the same thing if I use the Docker resource in Heat?'''
 +
 +
No, the Docker Heat resource does not provide a resource scheduler, or a choice of container technology used. It is specific to Docker, and uses Glance to store container images. It does not currently allow for layered image features, which can cause containers to take longer to start than if layered images are used with a locally cached base image. Magnum leverages all of the speed benefits that Docker offers, and implements Kubernetes and Mesos as alternate choices to Docker Swarm for container orchestration.
 +
 +
'''6) What does multi-tenancy mean in Magnum (Is Magnum Secure)?'''
  
== Etherpad links ==
+
Resources such as Clusters are started by Magnum can only be viewed and accessed by users of the tenant that created them. Clusters are not shared, meaning that containers will not run on the same kernel as neighboring tenants. This is a key security feature that allows containers belonging to the same tenant to be tightly packed within the same Pods and Clusters, but runs separate kernels (in separate Nova Instances) between different tenants. This is different than using a system like Kubernetes without Magnum, which was originally designed to be used only by a single tenant, and leaves the security isolation design up to the implementer. Using Magnum provides the same level of security isolation as Nova provides when running Virtual Machines belonging to different tenants on the same compute nodes.

Revision as of 15:57, 4 September 2017

Magnum is an OpenStack API service developed by the OpenStack Containers Team making container orchestration engines such as Docker Swarm, Kubernetes, and Apache Mesos available as first class resources in OpenStack. Magnum uses Heat to orchestrate an OS image which contains Docker and Kubernetes and runs that image in either virtual machines or bare metal in a cluster configuration. Click below for a ~2 minute demo of how the Magnum CLI works.

Demo-Preview-Frame.png

Getting Started / Download

To get started with Magnum, see: Our Quickstart Guide

Downloads:

Contributing

The project is under active development by our OpenStack Containers Team. We meet weekly by IRC.

Architecture

Magnum Architeture Diagram

Cluster Create/Update/Delete

Resources

IRC

Our developers use IRC in #openstack-containers on freenode for development discussion.

Meetings

Users

  • CERN - details on the blog
  • (your group or organization here)

Frequently Asked Questions

1) How is Magnum is different from Nova?

Magnum provides a purpose built API to manage application containers orchestration engines, which have a distinctly different life cycle and operations than Nova (machine) Instances. We actually use Nova instances to compose our Clusters.

2) How is Magnum different than Docker or Kubernetes?

Magnum offers an asynchronous API that's compatible with Keystone, and a complete multi-tenancy implementation. It does not perform orchestration internally, and instead relies on OpenStack Orchestration. Magnum does leverage both Kubernetes and Docker as components.

3) Is this the same thing as Nova-Docker?

No, Nova-Docker is a virt driver for Nova that allows containers to be created as Nova instances. This is suitable for use cases when you want to treat a container like a lightweight machine. Magnum provides container orchestration engine management that is beyond the scope of Nova's API, and implements its own API to surface these features in a way that is consistent with other OpenStack services. Containers started on Magnum Clusters are run on top of Nova instances that are created using Heat.

4) Who is Magnum for?

Magnum is for OpenStack cloud operators (public or private) who want to offer a self-service solution to provide a hosted containers service to their cloud users. Magnum simplifies the required integration with OpenStack, and allows for cloud users who can already launch cloud resources such as Nova Instances, Cinder Volumes, Trove Databases, etc. to also create container clusters (Clusters) to run applications in an environment that provides advanced features that are beyond the scope of existing cloud resources.

5) Will I get the same thing if I use the Docker resource in Heat?

No, the Docker Heat resource does not provide a resource scheduler, or a choice of container technology used. It is specific to Docker, and uses Glance to store container images. It does not currently allow for layered image features, which can cause containers to take longer to start than if layered images are used with a locally cached base image. Magnum leverages all of the speed benefits that Docker offers, and implements Kubernetes and Mesos as alternate choices to Docker Swarm for container orchestration.

6) What does multi-tenancy mean in Magnum (Is Magnum Secure)?

Resources such as Clusters are started by Magnum can only be viewed and accessed by users of the tenant that created them. Clusters are not shared, meaning that containers will not run on the same kernel as neighboring tenants. This is a key security feature that allows containers belonging to the same tenant to be tightly packed within the same Pods and Clusters, but runs separate kernels (in separate Nova Instances) between different tenants. This is different than using a system like Kubernetes without Magnum, which was originally designed to be used only by a single tenant, and leaves the security isolation design up to the implementer. Using Magnum provides the same level of security isolation as Nova provides when running Virtual Machines belonging to different tenants on the same compute nodes.