Skip to main content

Build, deploy, and configure the StorPool Juju charms

Project description

storpool-charms-manage - deploy the StorPool OpenStack integration Juju charms
==============================================================================

Overview
--------

The `storpool-charms-manage` package and the `spcharms_manage` tool are
used to deploy the Juju charms needed for the StorPool integration with
the OpenStack charms bundle.


Deploying pre-built charms
--------------------------

The fastest way to get the StorPool charms up and running is to use one of
the pre-packaged versions uploaded [as releases to the GitHub repository.][releases]
Once the release archive has been downloaded and extracted, change into
the newly-created `storpool-charms-<YYYYMMDD>-<series>` directory and run:

spcharms_manage deploy

Make sure that you do this from a shell that has been properly set up for
access to the Juju cluster; the easiest way to test this is to run
the `juju status` command beforehand and check that it displays the correct
machines, applications, and units. If the StorPool charms have previously been
installed on the Juju cluster, then `./storpool-charms.py undeploy` will need to
be executed first.

After the charms have been deployed to the Juju cluster, they will still need
to be configured; please [contact StorPool][support] for information about
the charms configuration.


Building the charms
-------------------

To get the latest version of the StorPool charms, follow this procedure.

1. Check out the current version of the charms:

`spcharms_manage.py checkout`

2. Build the charms (make sure the `charm-tools` Ubuntu package is installed):

`spcharms_manage.py build`

3. Deploy the newly-built charms:

`spcharms_manage.py deploy`

4. At a later point, fetch the latest StorPool updates from the GitHub repositories:

`spcharms_manage.py pull && spcharms_manage.py build`


Using the storpool.charms.manage modules
----------------------------------------

The modules in the storpool.charms.manage namespace may be used by Python
programs not only to build and deploy the StorPool charms, but also to
configure them, even if they have been deployed in a different way, taking
into account the current deployment of the OpenStack charms in a Juju
cluster. The `storpool.charms.manage.juju` module's
`get_storpool_config_data()` and `get_charm_config_data()` functions will
provide dictionaries with values that may later be incorporated into
text or YAML configuration snippets:

from storpool.charms.manage import config as sconfig
from storpool.charms.manage import juju as sjuju

cfg = sconfig.Config(space='storpool', repo_auth='username:password')
status = sjuju.get_status(cfg)

spcfg = sjuju.get_storpool_config_data(cfg, status)
for hostname, data in spcfg.items():
print('Host {name}: StorPool ID {oid}'
.format(name=hostname, oid=data['SP_OURID']))

charmcfg = sjuju.get_charm_config_data(cfg, status, spcfg, [])

The storpool.charms.manage modules are fully typed.

Contact us
----------

Please feel free to [contact StorPool][support] for any additional information or
for assistance with any problems.

Copyright and License
---------------------

Copyright (c) 2018 StorPool
All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


[releases]: https://github.com/storpool/storpool-charms/releases
[support]: mailto:support@storpool.com


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

storpool_charms_manage-0.1.0.tar.gz (16.5 kB view details)

Uploaded Source

Built Distribution

storpool_charms_manage-0.1.0-py3-none-any.whl (25.6 kB view details)

Uploaded Python 3

File details

Details for the file storpool_charms_manage-0.1.0.tar.gz.

File metadata

  • Download URL: storpool_charms_manage-0.1.0.tar.gz
  • Upload date:
  • Size: 16.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.6

File hashes

Hashes for storpool_charms_manage-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a7cf31fba7b536236b6d6142bc2da98952d906b66181ebc06e7c62c8cb6d633e
MD5 e19e54fee0f859a7496c556315fe285c
BLAKE2b-256 5190c67ab6edb1c24264d3f3c1e9b6f13520fc0bd5a59784db3ef471d724cf88

See more details on using hashes here.

File details

Details for the file storpool_charms_manage-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: storpool_charms_manage-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 25.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.6

File hashes

Hashes for storpool_charms_manage-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6512a52c4e24e28210a08ab6dfed74735678cff466be1ba7544ccbe1262aac33
MD5 37f0c4ed81c7b32d94f5c2d4cd05d59f
BLAKE2b-256 3c736d7984f22115383c61dbe3c32cd9934236ee6d3e3fe6530edb2c15999e1b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page