Proto: istio_lifecycle_manager.proto




Field Description
name (string)

Name of the cluster to install Istio into. Must match the registered cluster name.
defaultRevision (bool)

Optional: Defaults to false. When set to true, the installation for this revision is applied as the active Istio installation in the cluster. Resources with the istio-injection=true label entry use this revision. You might change this setting for Istio installations during a canary upgrade. For more info, see the upgrade docs.
trustDomain (string)

Optional: By default, the trustDomain value is automatically set in the meshConfig by the installer to the name of each workload cluster. To override the trustDomain for each cluster, you can instead specify the override value in the trustDomain field, and include the value in the list of cluster names. For example, if you specify trustDomain: cluster1-trust-override in the operator spec, you then specify the cluster name (cluster1) and the trust domain (cluster1-trust-override) in the list of cluster names. Additionally, because Gloo requires multiple trust domains for east-west routing, the PILOT_SKIP_VALIDATE_TRUST_DOMAIN field is set to "true" by default. For more info, see the Istio documentation.


Field Description
revision (string)

Istio revision for this installation, such as ‘1-17’. Label workload resources with ‘$REVISION’ to use this installation. When set to auto, the default supported version of Gloo Istio is installed.
clusters (repeated IstioClusterSelector)

Clusters to install the Istio control planes in.
istioOperatorSpec (

IstioOperator specification for the control plane. For more info, see the Istio documentation.


Field Description
installations (repeated IstioInstallation)

List of Istio control plane installations. Any components that are NOT related to the control plane are ignored.


Field Description
clusters (repeated IstioLifecycleManagerStatus.ClustersEntry)

The status of each Istio installation that is being managed by Gloo Mesh, where the key is the cluster name of the installation.


Field Description
installations (repeated IstioLifecycleManagerStatus.ClusterStatuses.InstallationsEntry)

The Istio installations by revision.


Field Description
state (IstioLifecycleManagerStatus.ClusterStatuses.InstallationStatus.State)

The state of the Istio installation.
message (string)

A human readable message about the current state of the IstioInstallationInstance.
observedRevision (string)

The observed revision for the Istio installation.
observedOperator (

The Istio operator spec that is currently deployed for this revision.


Field Description
key (string)

value (IstioLifecycleManagerStatus.ClusterStatuses.InstallationStatus)


Field Description
key (string)

value (IstioLifecycleManagerStatus.ClusterStatuses)


The state of an Istio installation.

Name Number Description
PENDING 0 Waiting for resources to be installed or updated.
FAILED 1 Gloo Mesh server encountered a problem while attempting to install Istio.
INSTALLING_CONTROLLER 2 The controller is currently being installed.
CONTROLLER_INSTALL_FAILED 3 The controller failed to install.
INSTALLING_CONTROL_PLANE 4 The Istio control plane is currently being installed.
CONTROL_PLANE_INSTALL_FAILED 5 The Istio control plane failed to install.
HEALTHY 6 All Istio components are successfully installed and healthy.
UNHEALTHY 7 The Istio installation is no longer healthy.
ACTION_REQUIRED 8 The control plane IstioOperator resource is in an ‘ACTION_REQUIRED’ state. Check the logs of the IstioOperator deployment for more info.
UPDATING_CONTROL_PLANE 9 The control plane IstioOperator resource is in an ‘UPDATING’ state.
RECONCILING_CONTROL_PLANE 10 The control plane IstioOperator resource is in a ‘RECONCILING’ state.
UNKNOWN 11 The control plane installation state could not be determined.