IstioOperator Options

Configuration affecting Istio control plane installation version and shape.

IstioOperatorSpec

IstioOperatorSpec defines the desired installed state of Istio components. The spec is a used to define a customization of the default profile values that are supplied with each Istio release. Because the spec is a customization API, specifying an empty IstioOperatorSpec results in a default Istio component values.

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  profile: default
  hub: gcr.io/istio-testing
  tag: latest
  revision: 1-8-0
  meshConfig:
    accessLogFile: /dev/stdout
    enableTracing: true
  components:
    egressGateways:
    - name: istio-egressgateway
      enabled: true
FieldTypeDescriptionRequired
profilestring

Path or name for the profile e.g.

  • minimal (looks in profiles dir for a file called minimal.yaml)
  • /tmp/istio/install/values/custom/custom-install.yaml (local file path)

default profile is used if this field is unset.

No
installPackagePathstring

Path for the install package. e.g.

  • /tmp/istio-installer/nightly (local file path)
No
hubstring

Root for docker image paths e.g. docker.io/istio

No
tagTypeInterface

Version tag for docker images e.g. 1.7.2

No
namespacestring

Namespace to install control plane resources into. If unset, Istio will be installed into the same namespace as the IstioOperator CR. You must also set values.global.istioNamespace if you wish to install Istio in a custom namespace. If you have enabled CNI, you must exclude this namespace by adding it to the list values.cni.excludeNamespaces.

No
revisionstring

Identify the revision this installation is associated with. This option is currently experimental.

No
meshConfigTypeMapStringInterface

Config used by control plane components internally.

No
componentsIstioComponentSetSpec

Kubernetes resource settings, enablement and component-specific settings that are not internal to the component.

No
valuesTypeMapStringInterface

Overrides for default values.yaml. This is a validated pass-through to Helm templates. See the Helm installation options for schema details. Anything that is available in IstioOperatorSpec should be set above rather than using the passthrough. This includes Kubernetes resource settings for components in KubernetesResourcesSpec.

No
unvalidatedValuesTypeMapStringInterface

Unvalidated overrides for default values.yaml. Used for custom templates where new parameters are added.

No
addonComponentsmap<string, ExternalComponentSpec>

Deprecated. Users should manage the installation of addon components on their own. Refer to samples/addons for demo installation of addon components.

No

InstallStatus

Observed state of IstioOperator

FieldTypeDescriptionRequired
statusStatus

Overall status of all components controlled by the operator.

  • If all components have status NONE, overall status is NONE.
  • If all components are HEALTHY, overall status is HEALTHY.
  • If one or more components are RECONCILING and others are HEALTHY, overall status is RECONCILING.
  • If one or more components are UPDATING and others are HEALTHY, overall status is UPDATING.
  • If components are a mix of RECONCILING, UPDATING and HEALTHY, overall status is UPDATING.
  • If any component is in ERROR state, overall status is ERROR.
  • If further action is needed for reconciliation to proceed, overall status is ACTION_REQUIRED.
No
messagestring

Optional message providing additional information about the existing overall status.

No
componentStatusmap<string, VersionStatus>

Individual status of each component controlled by the operator. The map key is the name of the component.

No

IstioComponentSetSpec

IstioComponentSpec defines the desired installed state of Istio components.

FieldTypeDescriptionRequired
baseBaseComponentSpecNo
pilotComponentSpecNo
cniComponentSpecNo
istiodRemoteComponentSpecNo
ingressGatewaysGatewaySpec[]No
egressGatewaysGatewaySpec[]No

BaseComponentSpec

Configuration for base component.

FieldTypeDescriptionRequired
enabledTypeBoolValueForPB

Selects whether this component is installed.

No
k8sKubernetesResourcesSpec

Kubernetes resource spec.

No

ComponentSpec

Configuration for internal components.

FieldTypeDescriptionRequired
enabledTypeBoolValueForPB

Selects whether this component is installed.

No
namespacestring

Namespace for the component.

No
hubstring

Hub for the component (overrides top level hub setting).

No
tagTypeInterface

Tag for the component (overrides top level tag setting).

No
specTypeInterface

Arbitrary install time configuration for the component.

No
k8sKubernetesResourcesSpec

Kubernetes resource spec.

No

ExternalComponentSpec

Configuration for external components.

FieldTypeDescriptionRequired
enabledTypeBoolValueForPB

Selects whether this component is installed.

No
namespacestring

Namespace for the component.

No
specTypeInterface

Arbitrary install time configuration for the component.

No
chartPathstring

Chart path for addon components.

No
schemaAny

Optional schema to validate spec against.

No
k8sKubernetesResourcesSpec

Kubernetes resource spec.

No

GatewaySpec

Configuration for gateways.

FieldTypeDescriptionRequired
enabledTypeBoolValueForPB

Selects whether this gateway is installed.

No
namespacestring

Namespace for the gateway.

No
namestring

Name for the gateway.

No
labelmap<string, string>

Labels for the gateway.

No
hubstring

Hub for the component (overrides top level hub setting).

No
tagTypeInterface

Tag for the component (overrides top level tag setting).

No
k8sKubernetesResourcesSpec

Kubernetes resource spec.

No

KubernetesResourcesSpec

KubernetesResourcesConfig is a common set of k8s resource configs for components.

FieldTypeDescriptionRequired
affinityAffinity

k8s affinity. https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity

No
envEnvVar[]

Deployment environment variables. https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/

No
hpaSpecHorizontalPodAutoscalerSpec

k8s HorizontalPodAutoscaler settings. https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/

No
imagePullPolicystring

k8s imagePullPolicy. https://kubernetes.io/docs/concepts/containers/images/

No
nodeSelectormap<string, string>

k8s nodeSelector. https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector

No
podDisruptionBudgetPodDisruptionBudgetSpec

k8s PodDisruptionBudget settings. https://kubernetes.io/docs/concepts/workloads/pods/disruptions/#how-disruption-budgets-work

No
podAnnotationsmap<string, string>

k8s pod annotations. https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/

No
priorityClassNamestring

k8s priorityclassname. Default for all resources unless overridden. https://kubernetes.io/docs/concepts/configuration/pod-priority-preemption/#priorityclass

No
readinessProbeReadinessProbe

k8s readinessProbe settings. https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/ k8s.io.api.core.v1.Probe readiness_probe = 9;

No
replicaCountuint32

k8s Deployment replicas setting. https://kubernetes.io/docs/concepts/workloads/controllers/deployment/

No
resourcesResources

k8s resources settings. https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/#resource-requests-and-limits-of-pod-and-container

No
serviceServiceSpec

k8s Service settings. https://kubernetes.io/docs/concepts/services-networking/service/

No
strategyDeploymentStrategy

k8s deployment strategy. https://kubernetes.io/docs/concepts/workloads/controllers/deployment/

No
tolerationsToleration[]

k8s toleration https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/

No
serviceAnnotationsmap<string, string>

k8s service annotations. https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/

No
securityContextPodSecurityContext

k8s pod security context https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-pod

No
overlaysK8sObjectOverlay[]

Overlays for k8s resources in rendered manifests.

No

K8sObjectOverlay

Patch for an existing k8s resource.

FieldTypeDescriptionRequired
apiVersionstring

Resource API version.

No
kindstring

Resource kind.

No
namestring

Name of resource. Namespace is always the component namespace.

No
patchesPathValue[]

List of patches to apply to resource.

No

Affinity

See k8s.io.api.core.v1.Affinity.

FieldTypeDescriptionRequired
nodeAffinityNodeAffinityNo
podAffinityPodAffinityNo
podAntiAffinityPodAntiAffinityNo

ConfigMapKeySelector

See k8s.io.api.core.v1.ConfigMapKeySelector.

FieldTypeDescriptionRequired
localObjectReferenceLocalObjectReferenceNo
keystringNo
optionalboolNo

ClientIPConfig

See k8s.io.api.core.v1.ClientIPConfig.

FieldTypeDescriptionRequired
timeoutSecondsint32No

CrossVersionObjectReference

See k8s.io.api.autoscaling.v2beta2.CrossVersionObjectReference.

FieldTypeDescriptionRequired
kindstringNo
namestringNo
apiVersionstringNo

DeploymentStrategy

See k8s.io.api.apps.v1.DeploymentStrategy.

FieldTypeDescriptionRequired
typestringNo
rollingUpdateRollingUpdateDeploymentNo

EnvVar

See k8s.io.api.core.v1.EnvVar.

FieldTypeDescriptionRequired
namestringNo
valuestringNo
valueFromEnvVarSourceNo

EnvVarSource

See k8s.io.api.core.v1.EnvVarSource.

FieldTypeDescriptionRequired
fieldRefObjectFieldSelectorNo
resourceFieldRefResourceFieldSelectorNo
configMapKeyRefConfigMapKeySelectorNo
secretKeyRefSecretKeySelectorNo

ExecAction

See k8s.io.api.core.v1.ExecAction.

FieldTypeDescriptionRequired
commandstring[]No

ExternalMetricSource

See k8s.io.api.autoscaling.v2beta2.CrossVersionObjectReference.

FieldTypeDescriptionRequired
metricNamestringNo
metricSelectorLabelSelectorNo
targetValueTypeIntOrStringForPBNo
targetAverageValueTypeIntOrStringForPBNo

HTTPGetAction

See k8s.io.api.core.v1.HTTPGetAction.

FieldTypeDescriptionRequired
pathstringNo
portTypeIntOrStringForPBNo
hoststringNo
schemestringNo
httpHeadersHTTPHeader[]No

HTTPHeader

See k8s.io.api.core.v1.HTTPHeader.

FieldTypeDescriptionRequired
namestringNo
valuestringNo

HorizontalPodAutoscalerSpec

See k8s.io.api.autoscaling.v2beta1.HorizontalPodAutoscalerSpec.

FieldTypeDescriptionRequired
scaleTargetRefCrossVersionObjectReferenceNo
minReplicasint32No
maxReplicasint32No
metricsMetricSpec[]No

LocalObjectReference

See k8s.io.api.core.v1.LocalObjectReference.

FieldTypeDescriptionRequired
namestringNo

MetricSpec

See k8s.io.autoscaling.v2beta1.MetricSpec.

FieldTypeDescriptionRequired
typestringNo
objectObjectMetricSourceNo
podsPodsMetricSourceNo
resourceResourceMetricSourceNo
externalExternalMetricSourceNo

NodeAffinity

See k8s.io.api.core.v1.NodeAffinity.

FieldTypeDescriptionRequired
requiredDuringSchedulingIgnoredDuringExecutionNodeSelectorNo
preferredDuringSchedulingIgnoredDuringExecutionPreferredSchedulingTerm[]No

NodeSelector

See k8s.io.api.core.v1.NodeSelector.

FieldTypeDescriptionRequired
nodeSelectorTermsNodeSelectorTerm[]No

NodeSelectorTerm

See k8s.io.api.core.v1.NodeSelectorTerm.

FieldTypeDescriptionRequired
matchExpressionsNodeSelectorRequirement[]No
matchFieldsNodeSelectorRequirement[]No

NodeSelectorRequirement

See k8s.io.api.core.v1.NodeSelectorRequirement.

FieldTypeDescriptionRequired
keystringNo
operatorstringNo
valuesstring[]No

ObjectFieldSelector

See k8s.io.api.core.v1.ObjectFieldSelector.

FieldTypeDescriptionRequired
apiVersionstringNo
fieldPathstringNo

ObjectMeta

From k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta.

FieldTypeDescriptionRequired
namestringNo
namespacestringNo

ObjectMetricSource

See k8s.io.autoscaling.v2beta1.ObjectMetricSource.

FieldTypeDescriptionRequired
targetCrossVersionObjectReferenceNo
metricNamestringNo
targetValueTypeIntOrStringForPBNo
selectorLabelSelectorNo
averageValueTypeIntOrStringForPBNo

PodAffinity

See k8s.io.api.core.v1.PodAffinity.

FieldTypeDescriptionRequired
requiredDuringSchedulingIgnoredDuringExecutionPodAffinityTerm[]No
preferredDuringSchedulingIgnoredDuringExecutionWeightedPodAffinityTerm[]No

PodAntiAffinity

See k8s.io.api.core.v1.PodAntiAffinity.

FieldTypeDescriptionRequired
requiredDuringSchedulingIgnoredDuringExecutionPodAffinityTerm[]No
preferredDuringSchedulingIgnoredDuringExecutionWeightedPodAffinityTerm[]No

PodAffinityTerm

See k8s.io.api.core.v1.PodAntiAffinity.

FieldTypeDescriptionRequired
labelSelectorLabelSelectorNo
namespacesstring[]No
topologyKeystringNo

PodDisruptionBudgetSpec

See k8s.io.api.policy.v1beta1.PodDisruptionBudget.

FieldTypeDescriptionRequired
minAvailableuint32No
selectorLabelSelectorNo
maxUnavailableuint32No

PodsMetricSource

See k8s.io.api.core.v1.PodsMetricSource.

FieldTypeDescriptionRequired
metricNamestringNo
targetAverageValueTypeIntOrStringForPBNo
selectorLabelSelectorNo

PreferredSchedulingTerm

See k8s.io.api.core.v1.PreferredSchedulingTerm.

FieldTypeDescriptionRequired
weightint32No
preferenceNodeSelectorTermNo

ReadinessProbe

See k8s.io.api.core.v1.ReadinessProbe.

FieldTypeDescriptionRequired
execExecActionNo
httpGetHTTPGetActionNo
tcpSocketTCPSocketActionNo
initialDelaySecondsint32No
timeoutSecondsint32No
periodSecondsint32No
successThresholdint32No
failureThresholdint32No

ResourceFieldSelector

See k8s.io.api.core.v1..

FieldTypeDescriptionRequired
containerNamestringNo
resourcestringNo
divisorTypeIntOrStringForPBNo

ResourceMetricSource

See k8s.io.api.core.v1.ResourceMetricSource.

FieldTypeDescriptionRequired
namestringNo
targetAverageUtilizationint32No
targetAverageValueTypeIntOrStringForPBNo

Resources

See k8s.io.api.core.v1.ResourceRequirements.

FieldTypeDescriptionRequired
limitsmap<string, string>No
requestsmap<string, string>No

RollingUpdateDeployment

See k8s.io.api.apps.v1.RollingUpdateDeployment.

FieldTypeDescriptionRequired
maxUnavailableTypeIntOrStringForPBNo
maxSurgeTypeIntOrStringForPBNo

SecretKeySelector

See k8s.io.api.core.v1.SecretKeySelector.

FieldTypeDescriptionRequired
localObjectReferenceLocalObjectReferenceNo
keystringNo
optionalboolNo

ServiceSpec

See k8s.io.api.core.v1.ServiceSpec.

FieldTypeDescriptionRequired
portsServicePort[]No
selectormap<string, string>No
clusterIPstringNo
typestringNo
externalIPsstring[]No
sessionAffinitystringNo
loadBalancerIPstringNo
loadBalancerSourceRangesstring[]No
externalNamestringNo
externalTrafficPolicystringNo
healthCheckNodePortint32No
publishNotReadyAddressesboolNo
sessionAffinityConfigSessionAffinityConfigNo

ServicePort

See k8s.io.api.core.v1..

FieldTypeDescriptionRequired
namestringNo
protocolstringNo
portint32No
targetPortTypeIntOrStringForPBNo
nodePortint32No

SessionAffinityConfig

See k8s.io.api.core.v1.SessionAffinityConfig.

FieldTypeDescriptionRequired
clientIPClientIPConfigNo

TCPSocketAction

See k8s.io.api.core.v1.TCPSocketAction.

FieldTypeDescriptionRequired
portTypeIntOrStringForPBNo
hoststringNo

Toleration

See k8s.io.api.core.v1.Toleration.

FieldTypeDescriptionRequired
keystringNo
operatorstringNo
valuestringNo
effectstringNo
tolerationSecondsint64No

WeightedPodAffinityTerm

See k8s.io.api.core.v1.WeightedPodAffinityTerm.

FieldTypeDescriptionRequired
weightint32No
podAffinityTermPodAffinityTermNo

PodSecurityContext

See k8s.io.api.core.v1.PodSecurityContext.

FieldTypeDescriptionRequired
seLinuxOptionsSELinuxOptionsNo
runAsUserint64No
runAsNonRootboolNo
supplementalGroupsint64[]No
fsGroupint64No
runAsGroupint64No
sysctlsSysctl[]No
windowsOptionsWindowsSecurityContextOptionsNo
fsGroupChangePolicystringNo
seccompProfileSeccompProfileNo

SELinuxOptions

See k8s.io.api.core.v1.SELinuxOptions.

FieldTypeDescriptionRequired
userstringNo
rolestringNo
typestringNo
levelstringNo

Sysctl

See k8s.io.api.core.v1.Sysctl.

FieldTypeDescriptionRequired
namestringNo
valuestringNo

WindowsSecurityContextOptions

See k8s.io.api.core.v1.WindowsSecurityContextOptions.

FieldTypeDescriptionRequired
gmsaCredentialSpecNamestringNo
gmsaCredentialSpecstringNo
runAsUserNamestringNo

SeccompProfile

See k8s.io.api.core.v1.SeccompProfile.

FieldTypeDescriptionRequired
typestringNo
localhostProfilestringNo

TypeInterface

Synthetic type for generating Go structs. GOTYPE: interface{}

TypeMapStringInterface

Synthetic type for generating Go structs. GOTYPE: map[string]interface{}

TypeIntOrStringForPB

Synthetic type for generating Go structs. GOTYPE: *IntOrStringForPB

TypeBoolValueForPB

Synthetic type for generating Go structs. GOTYPE: *BoolValueForPB

InstallStatus.VersionStatus

VersionStatus is the status and version of a component.

FieldTypeDescriptionRequired
versionstringNo
statusStatusNo
errorstringNo

K8sObjectOverlay.PathValue

FieldTypeDescriptionRequired
pathstring

Path of the form a.[key1:value1].b.[:value2] Where [key1:value1] is a selector for a key-value pair to identify a list element and [:value] is a value selector to identify a list element in a leaf list. All path intermediate nodes must exist.

No
valueTypeInterface

Value to add, delete or replace. For add, the path should be a new leaf. For delete, value should be unset. For replace, path should reference an existing node. All values are strings but are converted into appropriate type based on schema.

No

k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector

A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects.

FieldTypeDescriptionRequired
matchLabelsmap<string, string>

matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is “key”, the operator is “In”, and the values array contains only “value”. The requirements are ANDed. +optional

No
matchExpressionsLabelSelectorRequirement[]

matchExpressions is a list of label selector requirements. The requirements are ANDed. +optional

No

InstallStatus.Status

Status describes the current state of a component.

NameDescription
NONE

Component is not present.

UPDATING

Component is being updated to a different version.

RECONCILING

Controller has started but not yet completed reconciliation loop for the component.

HEALTHY

Component is healthy.

ERROR

Component is in an error state.

ACTION_REQUIRED

Overall status only and would not be set as a component status. Action is needed from the user for reconciliation to proceed e.g. There are proxies still pointing to the control plane revision when try to remove an IstioOperator CR.

Was this information useful?
Do you have any suggestions for improvement?

Thanks for your feedback!