https://github.com/openstack/charm-openstack-loadbalancer

Juju Charm - OpenStack loadbalancer. Mirror of code maintained at opendev.org.
https://github.com/openstack/charm-openstack-loadbalancer

Last synced: 29 days ago
JSON representation

Juju Charm - OpenStack loadbalancer. Mirror of code maintained at opendev.org.

• Host: GitHub
• URL: https://github.com/openstack/charm-openstack-loadbalancer
• Owner: openstack
• License: apache-2.0
• Created: 2021-09-17T06:19:00.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2025-08-27T15:43:29.000Z (10 months ago)
• Last Synced: 2025-11-29T23:08:35.137Z (7 months ago)
• Language: Python
• Homepage: https://opendev.org/openstack/charm-openstack-loadbalancer
• Size: 50.8 KB
• Stars: 2
• Watchers: 7
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Copyright: copyright

Awesome Lists containing this project

README

          
# Overview

The openstack-loadbalancer charm deploys a loadbalancer that can load balance

traffic over a number of units of a service. The charm supports using vips

accross the loadbalancer units to provide HA.

# Usage

## Configuration

This section covers common and/or important configuration options. See file

`config.yaml` for the full list of options, along with their descriptions and

default values. See the [Juju documentation][juju-docs-config-apps] for details

on configuring applications.

#### `vips`

Sets the VIPs to use on the openstack-loadbalancer units to provide fault tolerant

access to a servce. The value should be a space seperated list of IPs.

## Deployment

The charm has `public`, `admin` and `internal` space bindings. These are the

spaces that the charm will create listeners on for ingress traffic. The charm

`vips` option should be used to provice an IP on each one of these network

spaces.

This charm needs to be related to the hacluster charm to manage vips and the

haproxy service.

    juju deploy -n 3 openstack-loadbalancer

    juju config openstack-loadbalancer vip="10.0.0.100 10.10.0.100 10.20.0.100"

    juju deploy hacluster openstack-loadbalancer-hacluster

    juju relate openstack-loadbalancer:ha openstack-loadbalancer-hacluster:ha

To provide a load balancer relate the charm to a service that supports the loadbalancer

interface.

    juju add-relation openstack-loadbalancer:loadbalancer ceph-dashboard:loadbalancer

# Documentation

The OpenStack Charms project maintains two documentation guides:

* [OpenStack Charm Guide][cg]: for project information, including development

  and support notes

* [OpenStack Charms Deployment Guide][cdg]: for charm usage information

# Bugs

Please report bugs on [Launchpad][lp-bugs-charm-openstack-loadbalancer].

[juju-docs-actions]: https://juju.is/docs/working-with-actions

[juju-docs-config-apps]: https://juju.is/docs/configuring-applications

[cg]: https://docs.openstack.org/charm-guide

[cdg]: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide

[lp-bugs-charm-openstack-loadbalancer]: https://bugs.launchpad.net/charm-openstack-loadbalancer