diskimage-builder/elements/svc-map
Michael Kerrin 730e7bd76e Handle extra spaces in merge-svc-map-files
During internal testing we are getting the following error from
merge-svc-map-files
File "/tmp/image.K2MYCphY/hooks/extra-data.d/10-merge-svc-map-files", line 54, in main
    with open(data_path, 'r') as dataFile:
IOError: [Errno 21] Is a directory: '...diskimage-builder/elements/svc-map'

Somehow IMAGE_ELEMENT contains a extra white space that manifests itself
as an element without a name. It is very hard to find where this is coming from so
instead this patch makes merge-svc-map-files more robost to this situation

Change-Id: Id1500ead8a77d691408617dcdc4e095bc5775be8
2014-10-20 18:16:39 +01:00
..
bin Add svc-map element. 2014-09-26 12:00:38 -04:00
extra-data.d Handle extra spaces in merge-svc-map-files 2014-10-20 18:16:39 +01:00
tests Add svc-map element. 2014-09-26 12:00:38 -04:00
README.md Add svc-map element. 2014-09-26 12:00:38 -04:00

Map service names to distro specific services.

Provides the following:

  • bin/svc-map

    usage: svc-map [-h] SERVICE

    Translate service name to distro specific name.

    optional arguments: -h, --help show this help message and exit

  • Any element may create its own svc-map YAML config file using the one of 3 sections for the distro/family/ and or default. The family is set automatically within svc-map based on the supplied distro name. Families include:

    • redhat: includes centos, fedora, and rhel distros
    • debian: includes debian and ubuntu distros
    • suse: includes the opensuse distro

    The most specific section takes priority. Example for Nova and Glance (NOTE: default is using the common value for redhat and suse families)

    The key used for the service name should always be the same name used for the source installation of the service. The svc-map script will check for the source name against systemd and upstart and return that name if it exists instead of the mapped name.

    Example format for Nova:

    nova-api: default: openstack-nova-api debian: nova-api nova-cert: default: openstack-nova-cert debian: nova-cert nova-compute: default: openstack-nova-compute debian: nova-compute nova-conductor: default: openstack-nova-conductor debian: nova-conductor nova-consoleauth: default: openstack-nova-console debian: nova-console

    Example format for Glance

    glance-api: debian: glance-api default: openstack-glance-api glance-reg: debian: glance-reg default: openstack-glance-registry

    If the distro is of the debian family the combined services file would be:

     nova-cert: nova-cert
     nova-compute: nova-compute
     glance-api: glance-api
     nova-conductor: nova-conductor
     nova-api: nova-api
     glance-reg: glance-reg
     nova-consoleauth: nova-console
    

    If the distro is of the suse or redhat families the combined services file would be:

     nova-cert: openstack-nova-cert
     nova-compute: openstack-nova-compute
     glance-reg: openstack-glance-registry
     nova-conductor: openstack-nova-conductor
     glance-api: openstack-glance-api
     nova-consoleauth: openstack-nova-console
     nova-api: openstack-nova-api
    

    Example commands using this format:

    svc-map nova-compute

    Returns: openstack-nova-compute

    svc-map nova-compute

    Returns: openstack-nova-compute

    svc-map nova-compute

    Returns: nova-compute

  • This output can be used to filter what other tools actually install (install-services can be modified to use this for example)

  • If you pass more than one service argument, the result for each service is printed on its own line.

  • Individual svc-map files live within each element. For example if you have created an Apache element your svc-map YAML file should be created at elements/apache/svc-map.