examples/charms/layers/simple/README.md

   1 Example from https://osm.etsi.org/gitweb/?p=osm/devops.git;a=tree;f=charms/layers/simple;h=bdf2957b5a5f6342bf24e3a675c21634d6064e3a;hb=HEAD
   2
   3 # Overview
   4
   5 This is an example charm as demonstrated in the OSM [Hackfest](https://osm.etsi.org/wikipub/index.php/OSM_workshops_and_events) series.
   6
   7 This is intended to provide a well-documented example of the proxy charm written by Hackfest participants.
   8
   9 # Prerequisites
  10
  11 There are two ways that you can exercise this charm: install the latest stable release of OSM or use Juju directly.
  12
  13 The workshop materials and tutorials cover using charms as part of OSM. You can follow that approach, but this README will focus on using Juju directly. We highly recommend that vendors and charm developers use this approach for the initial development of the charm.
  14
  15 ## Ubuntu 16.04 or higher
  16
  17 We recommend using Ubuntu 16.04 or higher for the development and testing of charms. It is assumed that you have installed Ubuntu either on physical hardware or in a Virtual Machine.
  18
  19 ## Install LXD and Juju
  20
  21 We will be installing the required software via snap. Snaps are containerised software packages, preferred because they are easy to create and install, will automatically update to the latest stable version, and contain bundled dependencies.
  22
  23 ```
  24 snap install lxd
  25 snap install juju
  26 snap install charm
  27 ```
  28
  29 # Usage
  30
  31
  32 ## Known Limitations and Issues
  33
  34 This not only helps users but gives people a place to start if they want to help
  35 you add features to your charm.
  36
  37 # Configuration
  38
  39 The configuration options will be listed on the charm store, however If you're
  40 making assumptions or opinionated decisions in the charm (like setting a default
  41 administrator password), you should detail that here so the user knows how to
  42 change it immediately, etc.
  43
  44 # Contact Information
  45
  46 ## Upstream Project Name
  47
  48   - Upstream website
  49   - Upstream bug tracker
  50   - Upstream mailing list or contact information
  51   - Feel free to add things if it's useful for users
  52
  53
  54 [service]: http://example.com
  55 [icon guidelines]: https://jujucharms.com/docs/stable/authors-charm-icon