Back to Envoy

Configuration: Static

docs/root/start/quick-start/configuration-static.rst

1.38.02.0 KB
Original Source

.. _start_quick_start_static:

Configuration: Static

To start Envoy with static configuration, you will need to specify :ref:listeners <start_quick_start_static_listeners> and :ref:clusters <start_quick_start_static_clusters> as :ref:static_resources <start_quick_start_static_static_resources>.

You can also add an :ref:admin <start_quick_start_admin> section if you wish to monitor Envoy or retrieve stats.

The following sections walk through the static configuration provided in the :download:demo configuration file <_include/envoy-demo.yaml> used as the default in the Envoy Docker container.

.. _start_quick_start_static_static_resources:

static_resources

The :ref:static_resources <envoy_v3_api_field_config.bootstrap.v3.Bootstrap.static_resources> contain everything that is configured statically when Envoy starts, as opposed to dynamically at runtime.

.. literalinclude:: _include/envoy-demo.yaml :language: yaml :linenos: :lines: 1-3 :emphasize-lines: 1 :caption: :download:envoy-demo.yaml <_include/envoy-demo.yaml>

.. _start_quick_start_static_listeners:

listeners

The example configures a :ref:listener <envoy_v3_api_file_envoy/config/listener/v3/listener.proto> on port 10000.

All paths are matched and routed to the service_envoyproxy_io :ref:cluster <start_quick_start_static_clusters>.

.. literalinclude:: _include/envoy-demo.yaml :language: yaml :linenos: :lines: 1-36 :emphasize-lines: 3-33 :caption: :download:envoy-demo.yaml <_include/envoy-demo.yaml>

.. _start_quick_start_static_clusters:

clusters

The service_envoyproxy_io :ref:cluster <envoy_v3_api_file_envoy/config/cluster/v3/cluster.proto> proxies over TLS to https://www.envoyproxy.io.

.. literalinclude:: _include/envoy-demo.yaml :language: yaml :lineno-start: 31 :lines: 31-53 :emphasize-lines: 5-23 :caption: :download:envoy-demo.yaml <_include/envoy-demo.yaml>