Gitiles
Code Review Sign In
osm.etsi.org / osm / devops / 32e2fa55e105d5b87e9d57012b35f205e0036d59
commit32e2fa55e105d5b87e9d57012b35f205e0036d59[log] [tgz]
authorAdam Israel <adam.israel@canonical.com>Wed Dec 14 22:50:51 2016 -0500
committerAdam Israel <adam.israel@canonical.com>Tue Dec 20 12:25:09 2016 -0500
tree064806f0300cb384713e3f7b12f8dff0bdb1e5f7
parent14e91c04c69eea5009f159c173de99dff0d5378b [diff]
Ping/pong charm

This is the Juju charm layer to build the pingpong charm

Change-Id: I732746a53ce6db0faa3e7e528cb60a60e0296afe
Signed-off-by: Adam Israel <adam.israel@canonical.com>
17 files changed
tree: 064806f0300cb384713e3f7b12f8dff0bdb1e5f7
  1. .gitignore
  2. Makefile
  3. README.md
  4. juju-env.sh
  5. layers/
README.md

Juju Charm usage and development

This document is intended to provide a brief overview of the components included in this repository as well as recommendations for how to develop, build, and publish charms.

Please read the develper geting started guide before proceeding.

Directory structure

.
├── builds
│   └── vpe-router
├── interfaces
├── layers
│   └── vpe-router
└── module-blueprints

The source code of a charm is referred to as a "layer". This layer is compiled into a charm and placed in the builds/ directory. Interfaces, currently unused in this context, extend relationships between applications.

Development workflow

Prepare your build environment

# Source the environment variables JUJU_REPOSITORY, INTERFACE_PATH, and
# LAYER_PATH, which are needed to build a charm. You could also place these
# in your $HOME/.bashrc
$ source juju-env.sh

Install the charm command, either via apt:

$ sudo apt install charm

or with snap

$ snap install charm --edge

To build a charm, simply run charm build inside of a layer.

$ cd $LAYER_PATH/vpe-router
$ charm build
$ charm deploy $JUJU_REPOSITORY/builds/vpe-router

Publishing to jujucharms.com

Publishing to the Juju Charm store requires a launchpad login. With that, login to jujucharms.com.

Next, you'll use the charm command to publish your compiled charm. This will put the charm into the store where it can be used by anyone with access.

For example, if I wanted to publish the latest version of the vpe-router charm:

Step 1: Upload the charm to the "unpublished" channel

$ cd $JUJU_REPOSITORY/builds
$ charm push vpe-router/ cs:~aisrael/vpe-router
url: cs:~aisrael/vpe-router-0
channel: unpublished

There are four channels to release a charm: edge, beta, candidate, and stable

$ charm release cs:~aisrael/vpe-router-0 --channel=edge
url: cs:~aisrael/vpe-router-0
channel: edge

The charm can then be deployed directly from the charm store:

$ juju deploy cs:~aisrael/vpe-router --channel=edge