Docker is an tool. It can help you , , do and even .But even though Docker is a great tool, it has its own problems. amazing setup self-hosted PaaS scale things Android CI develop for IoT First of all — it’s not that easy to use. Mainly because there are so many different flags you can use during pretty much every step. Even after using it daily for the past few years, I still have to open the manual to remember how to correctly forward ports or how to set resource constraints. Then there’s a challenge of setting up an authentication, access control as well as ownership of the images and running containers. Right now you using Docker plugins, but it’s far from simple. And it doesn’t give you a way to define ownership. You can, of course, use labels or security opts to set the user. But you’d have to do that manually. can setup authorization And that’s if you know how to use Docker. In , we recently decided to migrate all our demos and services to Docker. Turns out it’s quite hard to teach people what Docker is and how to properly use it. And it’s even harder to make everyone set correct labels and security opts to make sure admins know e.g. who is responsible for container causing trouble. our research group And so I set out to create a better, simpler way of working with Docker. ! Simpler, faster, smaller and as user-friendly as ever. Update: Exoframe beta is out Meet Exoframe —a power armor for docker containers The idea behind Exoframe is quite simple — to help users tackle the aforementioned problems in a simple intuitive way with as little configuration as possible. Sort of, to give you a way to use it as a power armor to move those heavy docker containers around. Exoframe consists of two parts: and . Exoframe server Exoframe CLI Exoframe server is installed alongside your Docker on the remote server you want to use for deployment. It is essentially as a smart proxy for with authentication, access control and ownership features. Docker remote API Exoframe CLI is installed on your local machine and is used for all the common Docker tasks like building and deploying images using Exoframe server API. Exoframe server setup First, you will need to setup Exoframe server.Since your server should already be running docker, it’s quite easy to do: docker run -d \-p 3000:3000 \-v /var/run/docker.sock:/var/run/docker.sock:ro \-v /path/to/exoframe-folder:/root/.exoframe \exoframe/server This will start an Exoframe server, forward port 3000 to your host and init default Exoframe server config. Be sure to navigate to and adjust username and password in because default admin:admin pair is not exactly secure :)You can also configure additional server auth plugins (e.g. LDAP or your other corporate user DB) that can be used instead of config-based user list. /path/to/exoframe-folder server.config.yml Done. The server is ready to work! Exoframe CLI setup Next, you will need to setup Exoframe CLI on your local machine.Since Exoframe is written using Node.js, you will need to have Node.js (v6 or later) . Once you have it, simply execute npm install command to get Exoframe CLI: installed npm install exoframe -g Once install finishes, you can specify your server endpoint using the following command: exoframe endpoint :3000 http://your.server.url Then execute “ ” to authenticate on the server and you are ready to go! exoframe login Building and deploying an example project Now let’s see it in action! We are going to create, build and deploy a simple static HTML project.You can find all the steps explained below in one simple screencast on asciinema: _Short demo of Exoframe.js command line interface used to deploy Node.js project. Exoframe intends to do all the heavy…_asciinema.org Exoframe short demo First, create a new folder and add a new index.html file that has some content, e.g.: Then, execute “ ” and pick a name for your image (or just leave it as a default one): exoframe build Exoframe build command output At this point, Exoframe will automatically detect the project type and pick a suitable Dockerfile for it. Since we only have one file, Exoframe reasons that it might be suitable for basic Nginx image.This detection is done using the templating engine. Templates are simple Node.js packages that provide a set of methods to detect if a project is suitable for them, ignore files, add type-specific labels and ask a user for additional input if required. The output of the template is a complete Dockerfile that is used to build a project.You can find an example of Nginx template that is used in this case . index.html on GitHub Once the build is finished, you can get list of your owned images and services using “ ” command: exoframe list Exoframe list command output Now that you have built a new image, let’s deploy it.Simply execute “ ” and you will get a list of available images to deploy — no need to remember all of your image names: exoframe deploy Exoframe deploy images selection Once you’ve selected the image you want to deploy, Exoframe will ask what exactly do you want to do during the deployment — do your want to forward ports, specify restart policy, etc? Exoframe deploy feature selection In this case we only want to forward ports, so that’s what is selected in the screenshot above. After you hit enter, Exoframe will present you with additional inputs that will guide you through all of the selected actions, e.g. for ports input looks like this: Exoframe deploy port mapping example Note that Exoframe shows you inline how the port mappings should look and which of the ports is inside a container and on a host. As you can see, it also allows you to map multiple ports. After hitting enter, you will see a message that says the image was successfully deployed. You can now see your new service in a list that we have already called before using “ ”: exoframe list Exoframe list with full info about running service As you can see, the list now includes running service with full info about it — forwarded ports, status, template, name.If you open your browser at you should see the static HTML you’d created. html-test http://your.domain Now that you’ve seen that service works, let’s stop and remove it.You can use “ ” command to stop your running services and “ ” to remove stopped services. Once again, you don’t need to remember names of your services, if you don’t provide service name — Exoframe will present you with an interactive list: exoframe stop exoframe rm Exoframe stop command example Exoframe also provides a way to interact with images from registries.Using “ ” will pull given image from docker registry.You can then get list of all locally available registry images by executing “ ” command: exoframe pull <image> exoframe list public Exoframe registry images list Deployment of the images from registry can be done by executing deploy command with an additional image argument, e.g.: Exoframe deployment of registry image After that running services can be managed in the same manner as shown above. Conclusion Exoframe is still in its alpha stage and some features are missing here and there. But I’ve been already using it to manage and deploy a set of demos on my own servers and it made my life a lot easier. . Free. Licensed under MIT.Any feedback you might have is highly appreciated. Exoframe is available now on GitHub
