istio_lifecycle_manager.proto

Package : admin.enterprise.mesh.gloo.solo.io

Top

istio_lifecycle_manager.proto

Table of Contents

IstioLifecycleManagerSpec

Field Type Label Description
clusters []admin.enterprise.mesh.gloo.solo.io.IstioLifecycleManagerSpec.Cluster repeated The clusters where the Istio should be installed.
installations []admin.agent.enterprise.mesh.gloo.solo.io.Installation repeated List of Istio installation. It is recommended to include gateways separated from the control plane spec. The Istio version across the installations must also be the same.
istioInstallationRetries int32 Number of times to retry if an installation fails. Leave unset to disable retries.
upgradeStrategy admin.enterprise.mesh.gloo.solo.io.IstioLifecycleManagerSpec.UpgradeStrategy Optional Istio upgrade settings.
uninstallRevisions []string repeated List of Istio revisions that Gloo Mesh should uninstall. The uninstall will only be done if the revision was originally installed by the same IstioLifecycleManager. Associated revisions can be seen in the IstioLifecycleManager's status.

IstioLifecycleManagerSpec.Cluster

Field Type Label Description
name string The name of the cluster that Istio should be installed in. This should matched the registered cluster name.
trustDomain string [Optional] The trust domain value that should be set for this cluster's Istio installations. This value will be set in the installation's mesh config. (See https://istio.io/latest/docs/reference/config/istio.mesh.v1alpha1) Defaults to the cluster's name.

IstioLifecycleManagerSpec.UpgradeStrategy

Field Type Label Description
alwaysUseCanaryUpgrade bool When upgrading Istio, always do it via a canary upgrade (install new version of Istio alongside the existing version). By default, Gloo Mesh will use canary upgrades for minor version upgrades but will do an in place upgrade for patch version upgrades.
automateRevisionUninstalls bool Attempt to uninstall inactive revisions after a canary upgrade automatically.

IstioLifecycleManagerStatus

Field Type Label Description
observedGeneration int64 The most recent generation observed in the the IstioLifecycleManager metadata. If the observedGeneration does not match metadata.generation, Gloo Mesh has not processed the most recent version of this resource.
state admin.enterprise.mesh.gloo.solo.io.IstioLifecycleManagerStatus.State The current state of the IstioLifecycleManager.
message string A human readable message about the current state of the IstioLifecycleManager.
istioInstallationStatuses []admin.enterprise.mesh.gloo.solo.io.IstioLifecycleManagerStatus.IstioInstallationStatusesEntry repeated The status of each Istio installation that is being managed by Gloo Mesh, where the key is the concatenation of the cluster, name, and namespace for the created IstioInstallationInstance and the value is the installation's status.

IstioLifecycleManagerStatus.InstallationStatuses

Field Type Label Description
active admin.enterprise.mesh.gloo.solo.io.IstioLifecycleManagerStatus.InstallationStatuses.InstallationStatus The Istio installation that is considered active. This is the stable, pre-upgrade installation.
canary admin.enterprise.mesh.gloo.solo.io.IstioLifecycleManagerStatus.InstallationStatuses.InstallationStatus The pending Istio installation that was created as part of a canary upgrade. The canary will become the active installation when the active installation is uninstalled.

IstioLifecycleManagerStatus.InstallationStatuses.InstallationStatus

Field Type Label Description
state admin.agent.enterprise.mesh.gloo.solo.io.IstioInstallationInstanceStatus.State State of the Istio installation
generatedRevision string The revision that Gloo Mesh created for the Istio installation
lastObservedInstallations []admin.agent.enterprise.mesh.gloo.solo.io.Installation repeated List of the last observed Istio installations

IstioLifecycleManagerStatus.IstioInstallationStatusesEntry

Field Type Label Description
key string
value admin.enterprise.mesh.gloo.solo.io.IstioLifecycleManagerStatus.InstallationStatuses

IstioLifecycleManagerStatus.State

The state of the IstioInstallation.

Name Number Description
PENDING 0 Waiting for the Istio installation to be processed.
ACCEPTED 1 Finished processing the Istio installation successfully.
FAILED 2 Failed while processing the Istio installation parameters.
ACTION_REQUIRED 3 Manual action is needed for managing the Istio installation(s).