dead07444c
This adds another serial console type socat support. Change-Id: Ic443d050790aee2ea2e27daf165310f8e292fda7 Implements: bp socat-console
183 lines
5.2 KiB
Python
183 lines
5.2 KiB
Python
# Copyright 2015 OpenStack Foundation
|
|
# 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.
|
|
|
|
from oslo_config import cfg
|
|
|
|
serial_console_group = cfg.OptGroup(
|
|
"serial_console",
|
|
title="The serial console options",
|
|
help="""
|
|
The serial console feature allows you to connect to a guest.""")
|
|
|
|
opts = [
|
|
cfg.URIOpt('shellinabox_base_url',
|
|
default='http://127.0.0.1:8866/',
|
|
help="""
|
|
The URL an end user would use to connect to the ``mogan-shellinaboxproxy``
|
|
service.
|
|
|
|
The ``mogan-shellinaboxproxy`` service is called with this token enriched URL
|
|
and establishes the connection to the proper server.
|
|
|
|
Possible values:
|
|
|
|
* <scheme><IP-address><port-number>
|
|
|
|
Services which consume this:
|
|
|
|
* ``mogan-engine``
|
|
|
|
Interdependencies to other options:
|
|
|
|
* The IP address must be identical to the address to which the
|
|
``mogan-shellinaboxproxy`` service is listening (see option
|
|
``shellinaboxproxy_host``in this section).
|
|
* The port must be the same as in the option ``shellinaboxproxy_port`` of this
|
|
section.
|
|
"""),
|
|
|
|
# TODO(macsz) check if WS protocol is still being used
|
|
cfg.URIOpt('socat_base_url',
|
|
default='ws://127.0.0.1:8867/',
|
|
help="""
|
|
The URL an end user would use to connect to the ``mogan-socatproxy`` service.
|
|
|
|
The ``mogan-socatproxy`` service is called with this token enriched URL
|
|
and establishes the connection to the proper server.
|
|
|
|
Related options:
|
|
|
|
* The IP address must be identical to the address to which the
|
|
``mogan-socatproxy`` service is listening (see option ``socatproxy_host``
|
|
in this section).
|
|
* The port must be the same as in the option ``socatproxy_port`` of this
|
|
section.
|
|
* If you choose to use a secured websocket connection, then start this option
|
|
with ``wss://`` instead of the unsecured ``ws://``. The options ``cert``
|
|
and ``key`` in the ``[DEFAULT]`` section have to be set for that.
|
|
"""),
|
|
]
|
|
|
|
cli_opts = [
|
|
cfg.IPOpt('shellinaboxproxy_host',
|
|
default='0.0.0.0',
|
|
help="""
|
|
The IP address which is used by the ``mogan-shellinaboxproxy`` service to
|
|
listen for incoming requests.
|
|
|
|
The ``mogan-shellinaboxproxy`` service listens on this IP address for incoming
|
|
connection requests to servers which expose shellinabox serial console.
|
|
|
|
Possible values:
|
|
|
|
* An IP address
|
|
|
|
Services which consume this:
|
|
|
|
* ``mogan-shellinaboxproxy``
|
|
|
|
Interdependencies to other options:
|
|
|
|
* Ensure that this is the same IP address which is defined in the option
|
|
``shellinabox_base_url`` of this section or use ``0.0.0.0`` to listen on
|
|
all addresses.
|
|
"""),
|
|
|
|
cfg.PortOpt('shellinaboxproxy_port',
|
|
default=8866,
|
|
min=1,
|
|
max=65535,
|
|
help="""
|
|
The port number which is used by the ``mogan-shellinaboxproxy`` service to
|
|
listen for incoming requests.
|
|
|
|
The ``mogan-shellinaboxproxy`` service listens on this port number for incoming
|
|
connection requests to servers which expose shellinabox serial console.
|
|
|
|
Possible values:
|
|
|
|
* A port number
|
|
|
|
Services which consume this:
|
|
|
|
* ``mogan-shellinaboxproxy``
|
|
|
|
Interdependencies to other options:
|
|
|
|
* Ensure that this is the same port number which is defined in the option
|
|
``shellinabox_base_url`` of this section.
|
|
"""),
|
|
|
|
cfg.IPOpt('socatproxy_host',
|
|
default='0.0.0.0',
|
|
help="""
|
|
The IP address which is used by the ``mogan-socatproxy`` service to
|
|
listen for incoming requests.
|
|
|
|
The ``mogan-socatproxy`` service listens on this IP address for incoming
|
|
connection requests to servers which expose socat serial console.
|
|
|
|
Possible values:
|
|
|
|
* An IP address
|
|
|
|
Services which consume this:
|
|
|
|
* ``mogan-socatproxy``
|
|
|
|
Interdependencies to other options:
|
|
|
|
* Ensure that this is the same IP address which is defined in the option
|
|
``socat_base_url`` of this section or use ``0.0.0.0`` to listen on
|
|
all addresses.
|
|
"""),
|
|
|
|
cfg.PortOpt('socatproxy_port',
|
|
default=8867,
|
|
min=1,
|
|
max=65535,
|
|
help="""
|
|
The port number which is used by the ``mogan-socatproxy`` service to
|
|
listen for incoming requests.
|
|
|
|
The ``mogan-socatproxy`` service listens on this port number for incoming
|
|
connection requests to servers which expose socat serial console.
|
|
|
|
Possible values:
|
|
|
|
* A port number
|
|
|
|
Services which consume this:
|
|
|
|
* ``mogan-socatproxy``
|
|
|
|
Interdependencies to other options:
|
|
|
|
* Ensure that this is the same port number which is defined in the option
|
|
``socat_base_url`` of this section.
|
|
"""),
|
|
]
|
|
|
|
opts.extend(cli_opts)
|
|
|
|
|
|
def register_opts(conf):
|
|
conf.register_group(serial_console_group)
|
|
conf.register_opts(opts, group=serial_console_group)
|
|
|
|
|
|
def register_cli_opts(conf):
|
|
conf.register_cli_opts(cli_opts, group=serial_console_group)
|