Atomic App is a reference implementation of the Nulecule specification. Packaged Atomic App containers are "Nuleculized" and each component of the package is a "Nulecule".
Atomic App is used to bootstrap packaged container environments and run them on multiple container orchestrators. It is designed from the ground-up to be portable and provider pluggable.
A "packaged installer" for all container-based environments and applications. Replace all those bash and Ansible scripts with one container-based deployment tool.
Target multiple providers: Specify the provider you want the Atomic App to run on. It supports Kubernetes, OpenShift, Mesos+Marathon and Docker.
Inherit already packaged containers: Create composite applications by referencing other Nulecule-compliant applications. For example, plugging in an alternative well-orchestrated database in another referenced container image.
Fetch and run entire environments: Use
atomicapp runto run pre-packaged Nuleculized containers.
Installing Atomic App
git clone https://github.com/projectatomic/atomicapp && cd atomicapp sudo make install
export RELEASE=0.6.4 wget https://github.com/projectatomic/atomicapp/releases/download/$RELEASE/atomicapp-$RELEASE.tar.gz tar -xvf atomicapp-$RELEASE.tar.gz && cd atomicapp-$RELEASE sudo make install
This README contains some high level overview information on Atomic App. The detailed documentation for Atomic App resides in the docs directory. The index provided conveniently links to each section below:
- Quick start
- Getting started
- Nulecule file
- File handling
- Specification coverage
An extended guide on the
Nulecule file format is also available.
Atomic App can be used to launch a cluster of containers (application servers, databases, etc.).
For a list of already packaged examples, visit the nulecule-library repo.
We currently support:
- OpenShift 3
- Marathon (Mesos)
Providers represent various deployment targets. They can be added by placing the artifact within the respective in
artifacts/ folder. For example, placing
For a detailed description of all providers available see docs/providers.md.
Contributing to Atomic App
First of all, awesome! We have a development guide to help you get started!
If you have any issues or get stuck, feel free to open a GitHub issue or reach us at our communication channels (see below).
See REQUIREMENTS.md for a list of current Atomic App dependencies.
Want to view the specification and contribute to changes? See the Nulecule spec for more information.
- IRC: #nulecule on irc.freenode.net
- Mailing List: email@example.com
- Weekly IRC Nulecule meeting: Monday's @ 0930 EST / 0130 UTC
- Weekly SCRUM Container-Tools meeting: Wednesday's @ 0830 EST / 1230 UTC on Bluejeans
Copyright (C) 2016 Red Hat Inc.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see http://www.gnu.org/licenses/.
The GNU Lesser General Public License is provided within the file lgpl-3.0.txt.