Horizon deep dive. Matthias Runge Software Engineer May 18th, 2015

Transcription

1 Horizon deep dive Matthias Runge Software Engineer May 18th, 2015

2 Agenda 1 Overview and introduction 2 Going deeper... 3 Configuration 4 Extending Horizon 5 Troubleshooting

3 Section 1 Overview and introduction

4 Let s talk about hats Horizon core contributor Fedora, RDO, and Red Hat OpenStack Platform package maintainer Open Source enthusiast

5 Horizon key facts wsgi application running in Apache httpd implemented in python using Django framework part of OpenStack since the early days end user interface for OpenStack cloud platform stateless, doesn t use a database

6 Project features instances images, volumes projects network configuration stacks, databases, hadoop

7 Admin features identity (organized in a additional dashboard) quotas, flavors hypervisor metering data networks and router configuration

8 Features not included in Horizon cloud infrastructure configuration setup related options deployment of nodes, storages,... hardware vendor specific additions

9 Section 2 Going deeper...

10 Horizon requirements Django describes itself as web framework for perfectionists with deadlines implemented in Python very active upstream releases about every 9 months announces deprecations two releases in advance in general

11 Static file handling django-compressor combines and compresses static files uses {% compress %} and {% endcompress %} filters or translates files pluggable django static files./manage.py collectstatic./manage.py compress python-xstatic-foo

12 django openstack auth pluggable authentication backend authenticates a user against Keystone creates a user object from keystone provided data retrieves an initial token used for permission checks

13 OpenStack related libraries OpenStack API clients python-*client provide an client to access related rest API using the same ways as cli tools interact with underlying services

14

15 What s new in Kilo? about 34 blueprints implemented in default install: 3 visible changes Heat UI improvement Wizards for Data processing UI Glance metadata definitions Admin UI under the hood, more changes Client-side re-implementation session on Thursday

16 Section 3 Configuration

17 Most likely to configure for horizon keystone(s) to contact ALLOWED HOSTS

18 ALLOWED HOSTS setting Warning ALLOWED HOSTS = [ *, ] Better ALLOWED_HOSTS = ['.example.com', 'horizon.corp.com',] What? performs checks on host header

19 Other config options /etc/openstack-dashboard/local settings WEBROOT = /dashboard OPENSTACK API VERSIONS OPENSTACK SSL NO VERIFY, OPENSTACK SSL CACERT LOGGING HORIZON CONFIG service specific options like for keystone: can edit user

20 Cache and session store Cache CACHES = { 'default': { 'BACKEND': 'django.core.cache.backends.memcached.memcachedcache', 'LOCATION': ' :11211', } } Session # SESSION_ENGINE = 'django.contrib.sessions.backends.signed_cookies' SESSION_ENGINE = 'django.contrib.sessions.backends.cached_db'

21 Policy files Allowing or forbidding... e.g allow or disallow users to upload images to glance even works for single projects policy checked separately from service policy config

22 Section 4 Extending Horizon

23 Extending or customizing Horizon Several ways fork the repo and change source code directly add a customized panel or dashboard Useful info templates, templatetags styles django static file handling python-xstatic-foo

24 Adding a new dashboard or panel mkdir openstack_dashboard/dashboards/mydashboard./run_tests.sh -m startdash mydashboard \ --target openstack_dashboard/dashboards/mydashboard mkdir openstack_dashboard/dashboards/mydashboard/mypanel./run_tests.sh -m startpanel mypanel \ --dashboard=openstack_dashboard.dashboards.mydashboard \ --target=openstack_dashboard/dashboards/mydashboard/mypanel

25 Customizing Look using the new theming feature customizing by adding a theme dashboard

26 Configuration based changes adding or removing dashboards and panels adding panels to different dashboards examples in openstack dashboard/enabled Example: Disabling panels or dashboards # The slug of the panel to be added to HORIZON_CONFIG. Required. PANEL = 'info' # The slug of the dashboard the PANEL associated with. Required. PANEL_DASHBOARD = 'admin' # The slug of the panel group the PANEL is associated with. PANEL_GROUP = 'admin' REMOVE_PANEL = True

27 Section 5 Troubleshooting

28 Troubleshooting First steps 1 does it work in nova? 2 set DEBUG = True 3 enable debugging for specific services 4 if it s a bug: we need a reproducer 5 if possible, catch a stack trace

29 Horizon upstream #horizon on freenode tag s with [Horizon] when contacting bugs: please report them! new features are implemented via blueprint process launchpad, but not for questions weekly meetings, alternating times, Wed, either 12 UTC or 20 UTC watch for announcements

30 The end. Thanks for listening.