/docs/reference/ Recent content in Reference on Verrazzano Enterprise Container Platform Hugo -- gohugo.io /docs/reference/api/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/reference/api/ /docs/reference/migration/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/reference/migration/ <p>As the Verrazzano API evolves, APIs are periodically updated. When APIs evolve, the old API is deprecated and eventually removed. This document contains information that you need to know when migrating from deprecated API versions to newer and more stable API versions.</p> <h2 id="verrazzano">Verrazzano</h2> <p>The <code>install.verrazzano.io/v1alpha1</code> API version of Verrazzano resources is deprecated and will no longer be served in a future release.</p> <ul> <li>Migrate manifests and API clients to use the <code>install.verrazzano.io/v1beta1</code> API version, available since 1.4.0.</li> <li>All existing persisted objects are accessible using the new API.</li> </ul> <h4 id="notable-changes-in-installverrazzanoiov1beta1">Notable Changes In <code>install.verrazzano.io/v1beta1</code></h4> <ul> <li><code>spec.components.ingress</code> is renamed to <code>spec.components.ingressNGINX</code>.</li> <li><code>spec.components.kibana</code> is renamed to <code>spec.components.opensearchDashboards</code></li> <li><code>spec.components.elasticsearch</code> is renamed to <code>spec.components.opensearch</code></li> <li><code>spec.components.fluentd.elasticsearchSecret</code> is renamed to <code>spec.components.fluentd.opensearchSecret</code></li> <li><code>spec.components.fluentd.elasticsearchURL</code> is renamed to <code>spec.components.fluentd.opensearchURL</code></li> <li><code>status.instance.kibanaUrl</code> is renamed to <code>status.instance.opensearchDashboardsUrl</code></li> <li><code>status.instance.elasticUrl</code> is renamed to <code>status.instance.opensearchUrl</code></li> <li>Use <code>spec.components.opensearch.nodes</code> instead of <code>spec.components.elasticsearch.installArgs</code>.</li> <li>Use <code>spec.components.ingressNGINX.overrides</code> instead of <code>spec.components.ingress.nginxInstallArgs</code>.</li> <li>Use <code>spec.components.istio.overrides</code> instead of <code>spec.components.istio.istioInstallArgs</code>.</li> <li>Use <code>spec.components.istio.overrides</code> instead of <code>spec.components.istio.ingress</code>.</li> <li>Use <code>spec.components.istio.overrides</code> instead of <code>spec.components.istio.egress</code>.</li> <li>Use <code>spec.components.keycloak.overrides</code> instead of <code>spec.components.keycloak.keycloakInstallArgs</code>.</li> <li>Use <code>spec.components.verrazzano.overrides</code> instead of <code>spec.components.verrazzano.installArgs</code>.</li> <li>Use <code>spec.components.authProxy.overrides</code> instead of <code>spec.components.authProxy.kubernetes</code>.</li> </ul> <h4 id="co-installing-previous-verrazzano-versions">Co-installing previous Verrazzano versions</h4> <p>After installing Verrazzano version 1.4.0 or later, and not uninstalling it <em>before</em> installing versions of Verrazzano prior to 1.4.0, will result in the following error:</p> <pre tabindex="0"><code>The CustomResourceDefinition &#34;verrazzanos.install.verrazzano.io&#34; is invalid: status.storedVersions[0]: Invalid value: &#34;v1beta1&#34;: must appear in spec.versions </code></pre><p>To resolve this error, delete the <code>verrazzanos.install.verrazzano.io</code> Custom Resource Definition:</p> <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>$ kubectl delete customresourcedefinition verrazzanos.install.verrazzano.io </span></span></code></pre></div>