{"id":833,"date":"2018-12-06T23:09:41","date_gmt":"2018-12-06T23:09:41","guid":{"rendered":"https:\/\/www.appservgrid.com\/paw93\/?p=833"},"modified":"2018-12-06T23:50:34","modified_gmt":"2018-12-06T23:50:34","slug":"docker-app-and-cnab-docker-blog","status":"publish","type":"post","link":"https:\/\/www.appservgrid.com\/paw93\/index.php\/2018\/12\/06\/docker-app-and-cnab-docker-blog\/","title":{"rendered":"Docker App and CNAB – Docker Blog"},"content":{"rendered":"

Docker App is a new tool we spoke briefly about back at DockerCon US 2018<\/a>. We\u2019ve been working on `docker-app` to make container applications simpler to share and easier to manage across different teams and between different environments, and we open sourced it so you can already download Docker App from GitHub at https:\/\/github.com\/docker\/app<\/a>.<\/p>\n

In talking to others about problems they\u2019ve experienced sharing and collaborating on the broad area we call \u201capplications\u201d we came to a realisation: it\u2019s a more general problem that others have been working on too. That\u2019s why we\u2019re happy to collaborate with Microsoft on the new Cloud Native Application Bundle <\/i><\/b>(CNAB) specification<\/a>.<\/p>\n

\"Multi-Service<\/p>\n

Today\u2019s cloud native applications typically use different technologies, each with their own toolchain. Maybe you\u2019re using ARM templates and Helm charts, or CloudFormation and Compose, or Terraform and Ansible. There is no single solution in the market for defining and packaging these multi-service, multi-format distributed applications.<\/p>\n

CNAB is an open source, cloud-agnostic specification for packaging and running distributed applications that aims to solve some of these problems. CNAB unifies the management of multi-service, distributed applications across different toolchains into a single all-in-one packaging format.<\/p>\n

The draft specification is available at cnab.io<\/a> and we\u2019re actively looking both for folks interested in contributing to the spec itself, and to people interested in building tools around the specification. The latest release of Docker App is one such tool that implements the current CNAB spec. That means it can be used to both build CNAB bundles for Compose (which can then be used with any other CNAB client), and also to install, upgrade and uninstall any other CNAB bundle.<\/p>\n

Sharing CNAB bundles on Docker Hub<\/b><\/h3>\n

One of the limitations of standalone Compose files is that they cannot be shared on Docker Hub or Docker Trusted Registry. Docker App solves this issue too. Here\u2019s a simple Docker application which launches a very simple Prometheus stack:<\/p>\n

version: 0.1.0
\nname: monitoring
\ndescription: A basic prometheus stack
\nmaintainers:
\n– name: Gareth Rushgrove
\nemail: garethr@docker.com
\n—
\nversion: ‘3.7’<\/p>\n

services:
\nprometheus:
\nimage: prom\/prometheus:$
\nports:
\n– $:9090<\/p>\n

alertmanager:
\nimage: prom\/alertmanager:$
\nports:
\n– $:9093
\n—<\/p>\n

ports:
\nprometheus: 9090
\nalertmanager: 9093
\nversions:
\nprometheus: latest
\nalertmanager: latest<\/p>\n

With that saved as `monitoring.dockerapp` we can now build a CNAB and share that on Docker Hub.<\/p>\n

$ docker-app push –namespace <your-namespace><\/p>\n

Now on another machine we can still interact with the shared application. For instance let\u2019s use the `inspect` command to get information about our application:<\/p>\n

$ docker-app inspect <your-namespace>\/monitoring:0.1.0
\nmonitoring 0.1.0<\/p>\n

Maintained by: Gareth Rushgrove <garethr@docker.com><\/p>\n

A basic prometheus stack<\/p>\n

Services (2) Replicas Ports Image
\n———— ——– —– —–
\nprometheus 1 9090 prom\/prometheus:latest
\nalertmanager 1 9093 prom\/alertmanager:latest<\/p>\n

Parameters (4) Value
\n————– —–
\nports.alertmanager 9093
\nports.prometheus 9090
\nversions.alertmanager latest
\nversions.prometheus latest<\/p>\n

All the information from the Compose file is stored with the CNAB on Docker Hub, and if you notice, it\u2019s also parameterized, so values can be substituted at runtime to fit the deployment requirements. We can install the application directly from Docker Hub as well:<\/p>\n

docker-app install <your-namespace>\/monitoring:0.1.0 –set ports.alertmanager=9095<\/p>\n

Installing a Helm chart using Docker App<\/b><\/h3>\n

One question that has come up in the conversations we\u2019ve had so far is how `docker-app` and now CNAB relates to Helm charts. The good news is that they all work great together! Here is an example using `docker-app` to install a CNAB bundle that packages a Helm chart. The following example uses the `hellohelm` example from the CNAB example bundles.<\/p>\n

$ docker-app install -c local bundle.json
\nDo install for hellohelm
\nhelm install –namespace hellohelm -n hellohelm \/cnab\/app\/charts\/alpine
\nNAME: hellohelm
\nLAST DEPLOYED: Wed Nov 28 13:58:22 2018
\nNAMESPACE: hellohelm
\nSTATUS: DEPLOYED<\/p>\n

RESOURCES:
\n==> v1\/Pod
\nNAME AGE
\nhellohelm-alpine 0s<\/p>\n

Next steps<\/b><\/h3>\n

If you\u2019re interested in the technical details of the CNAB specification, either to see how it works under the hood or to maybe get involved in the specification work or building tools against it, you can find the spec at cnab.io<\/a>.<\/p>\n

If you\u2019d like to get started building applications with Docker App you can download the latest release from github.com\/docker\/app<\/a> and check out some of the examples provided in the repository.
\nSource<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Docker App is a new tool we spoke briefly about back at DockerCon US 2018. We\u2019ve been working on `docker-app` to make container applications simpler to share and easier to manage across different teams and between different environments, and we open sourced it so you can already download Docker App from GitHub at https:\/\/github.com\/docker\/app. In … <\/p>\n

Continue reading “Docker App and CNAB – Docker Blog”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-833","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/833","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/comments?post=833"}],"version-history":[{"count":1,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/833\/revisions"}],"predecessor-version":[{"id":874,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/833\/revisions\/874"}],"wp:attachment":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/media?parent=833"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/categories?post=833"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/tags?post=833"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}