Skip to content

istioctl proxy-config bootstrap

istioctl proxy-config bootstrap is a command used to inspect the bootstrap configuration of an Envoy proxy within a service mesh^[custom-bootstrap__README.md#L36-37]. This tool is primarily utilized for debugging and verification to ensure that a proxy has loaded the intended configuration parameters^[custom-bootstrap__README.md#L36-37].

Retrieving Configuration

To view the active bootstrap configuration for a specific proxy instance, the command requires the name of the target pod^[custom-bootstrap__README.md#L36-37]. The syntax for the command is as follows^[custom-bootstrap__README.md#L36-37]:

[istioctl](<./istioctl.md>) proxy-config bootstrap <POD-NAME>

Configuration Customization

The bootstrap configuration applied to a proxy can be customized by overriding the default settings^[custom-bootstrap__README.md#L43-44]. This is often achieved by creating a ConfigMap resource containing the custom configuration and applying it to the cluster^[custom-bootstrap__README.md#L6-7].

To activate the custom configuration for a specific service, an annotation sidecar.istio.io/bootstrapOverride must be added to the Pod, referencing the name of the ConfigMap^[custom-bootstrap__README.md#L13-15].

Merging Behavior

When a custom configuration is applied, it is passed to the Envoy proxy via the --config-yaml flag^[custom-bootstrap__README.md#L43-44]. The resulting configuration is a merge between the provided custom settings and the default Envoy bootstrap configuration^[custom-bootstrap__README.md#L46-48]. The merging logic follows these rules^[custom-bootstrap__README.md#L46-48]:

  • Singular values: Custom values will replace the default values.
  • Repeated values: Custom values will be appended to the default values.

Sources

  • custom-bootstrap__README.md