istio.io/istio@v0.0.0-20240520182934-d79c90f27776/manifests/charts/istio-control/istio-discovery/README.md (about)

     1  # Istiod Helm Chart
     2  
     3  This chart installs an Istiod deployment.
     4  
     5  ## Setup Repo Info
     6  
     7  ```console
     8  helm repo add istio https://istio-release.storage.googleapis.com/charts
     9  helm repo update
    10  ```
    11  
    12  _See [helm repo](https://helm.sh/docs/helm/helm_repo/) for command documentation._
    13  
    14  ## Installing the Chart
    15  
    16  Before installing, ensure CRDs are installed in the cluster (from the `istio/base` chart).
    17  
    18  To install the chart with the release name `istiod`:
    19  
    20  ```console
    21  kubectl create namespace istio-system
    22  helm install istiod istio/istiod --namespace istio-system
    23  ```
    24  
    25  ## Uninstalling the Chart
    26  
    27  To uninstall/delete the `istiod` deployment:
    28  
    29  ```console
    30  helm delete istiod --namespace istio-system
    31  ```
    32  
    33  ## Configuration
    34  
    35  To view support configuration options and documentation, run:
    36  
    37  ```console
    38  helm show values istio/istiod
    39  ```
    40  
    41  ### Profiles
    42  
    43  Istio Helm charts have a concept of a `profile`, which is a bundled collection of value presets.
    44  These can be set with `--set profile=<profile>`.
    45  For example, the `demo` profile offers a preset configuration to try out Istio in a test environment, with additional features enabled and lowered resource requirements.
    46  
    47  For consistency, the same profiles are used across each chart, even if they do not impact a given chart.
    48  
    49  Explicitly set values have highest priority, then profile settings, then chart defaults.
    50  
    51  As an implementation detail of profiles, the default values for the chart are all nested under `defaults`.
    52  When configuring the chart, you should not include this.
    53  That is, `--set some.field=true` should be passed, not `--set defaults.some.field=true`.
    54  
    55  ### Examples
    56  
    57  #### Configuring mesh configuration settings
    58  
    59  Any [Mesh Config](https://istio.io/latest/docs/reference/config/istio.mesh.v1alpha1/) options can be configured like below:
    60  
    61  ```yaml
    62  meshConfig:
    63    accessLogFile: /dev/stdout
    64  ```
    65  
    66  #### Revisions
    67  
    68  Control plane revisions allow deploying multiple versions of the control plane in the same cluster.
    69  This allows safe [canary upgrades](https://istio.io/latest/docs/setup/upgrade/canary/)
    70  
    71  ```yaml
    72  revision: my-revision-name
    73  ```