IstioLifecycleManager

Proto: istio_lifecycle_manager.proto

Package: admin.gloo.solo.io

Types:

IstioClusterSelector

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.

IstioController

Field Description
waitForResourcesTimeout (string)

The amount of time to wait for resources in a component to become ready before giving up. Configured using a duration string. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as “300ms” or “2h45m”. Valid time units are “ns”, “us” (or “┬Ás”), “ms”, “s”, “m”, “h”.
imagePullSecrets (repeated k8s.io.api.core.v1.LocalObjectReference)

Names of image pull secrets to use to deploy the Istio controller. For more info, see the Kubernetes docs
resources (common.gloo.solo.io.Resources)

Override for resources allocated to the Istio controller deployment. For more info, see the Kubernetes docs
securityContext (k8s.io.api.core.v1.SecurityContext)

Override for the pod's security context. For more info, see the [Kubernetes documentation](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#securitycontext-v1-core
labels (repeated IstioController.LabelsEntry)

Kubernetes pod/deployment/service labels.
annotations (repeated IstioController.AnnotationsEntry)

Kubernetes pod/deployment/service annotations.
envVars (repeated k8s.io.api.core.v1.EnvVar)

Deployment environment variables. For more info, see the Kubernetes docs

IstioController.AnnotationsEntry

Field Description
key (string)

value (string)

IstioController.LabelsEntry

Field Description
key (string)

value (string)

IstioInstallation

Field Description
revision (string)

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

Clusters to install the Istio control planes in.
istioOperatorSpec (common.gloo.solo.io.IstioOperatorSpec)

IstioOperator specification for the control plane. For more info, see the Istio documentation.
istioController (IstioController)

Optional config used for tuning the deployment of the istio operator controller deployed to each workload cluster.
skipUpgradeValidation (bool)

Skip in-place upgrade change validation. It is highly recommended to use revision based workflows in production environments.

IstioLifecycleManagerSpec

Field Description
installations (repeated IstioInstallation)

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

IstioLifecycleManagerStatus

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.

IstioLifecycleManagerStatus.ClusterStatuses

Field Description
installations (repeated IstioLifecycleManagerStatus.ClusterStatuses.InstallationsEntry)

The Istio installations by revision.

IstioLifecycleManagerStatus.ClusterStatuses.InstallationStatus

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 (common.gloo.solo.io.IstioOperatorSpec)

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

IstioLifecycleManagerStatus.ClusterStatuses.InstallationsEntry

Field Description
key (string)

value (IstioLifecycleManagerStatus.ClusterStatuses.InstallationStatus)

IstioLifecycleManagerStatus.ClustersEntry

Field Description
key (string)

value (IstioLifecycleManagerStatus.ClusterStatuses)

IstioLifecycleManagerStatus.ClusterStatuses.InstallationStatus.State

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.