Snap package for Glance
Go to file
James Page a270b48ea0 Misc updates
Add aliases for glance-manage -> glance.manage.

Update requirements and bindep to use snapcraft from packages until
installation from git is functional.

Change-Id: Idc7032404a46e2a6877aceb02632e7305dbc281d
2017-01-04 09:18:36 +00:00
snap Rename conf folder to snap 2016-11-23 09:18:28 +00:00
.gitignore Add basic tox configuration for building the snap 2016-11-21 11:21:27 +00:00
.gitreview Add misc bits of baseline scaffolding 2016-11-22 15:49:24 +00:00
CONTRIBUTING.rst Add misc bits of baseline scaffolding 2016-11-22 15:49:24 +00:00
LICENSE Add misc bits of baseline scaffolding 2016-11-22 15:49:24 +00:00
README.md More README tidy 2016-11-23 09:23:37 +00:00
bindep.txt Misc updates 2017-01-04 09:18:36 +00:00
requirements.txt Misc updates 2017-01-04 09:18:36 +00:00
snapcraft.yaml Misc updates 2017-01-04 09:18:36 +00:00
tox.ini Fixup tox configurations to support use of build test in gate 2016-11-23 10:07:48 +00:00

README.md

Glance Snap

This repository contains the source code of the snap for the OpenStack Image service, Glance.

Installing this snap

The glance snap can be installed directly from the snap store:

sudo snap install [--edge] glance

Configuring Glance

Snaps run in an AppArmor and seccomp confined profile, so don't read configuration from /etc/glance on the hosting operating system install.

This snap supports configuration via the $SNAP_COMMON writable area for the snap:

etc
├── glance
│   ├── glance-api.conf
│   └── glance-registry.conf
└── glance.conf.d
    ├── database.conf
    ├── glance-snap.conf
    └── keystone.conf

The glance daemons (api and registry) can be configured in a few ways.

Firstly each daemon will detect and read etc/glance/glance-<daemon>.conf if it exists so you can just place all configuration in the file for each daemon.

Alternatively all daemons will load all configuration files from etc/glance.conf.d - in the above example, database and keystone authtoken configuration is shared across both daemons using configuration snippets in separate files in etc/glance.conf.d.

For reference, $SNAP_COMMON is typically located under /var/snap/glance/common.

Managing Glance

Currently all snap binaries must be run as root; for example, to run the glance-manage binary use:

sudo glance.manage

Restarting Glance services

To restart all glance services:

sudo systemctl restart snap.glance.*

or use the individual service name:

sudo systemctl restart snap.glance.api
sudo systemctl restart snap.glance.registry

Building the Glance snap

Simply clone this repository and then install and run snapcraft:

git clone https://github.com/openstack-snaps/snap-glance
sudo apt install snapcraft
cd glance
snapcraft

Support

Please report any bugs related to this snap on Launchpad.

Alternatively you can find the OpenStack Snap team in #openstack-snaps on Freenode IRC.