非推奨APIの移行ガイド
Verrazzano APIの進化に伴い、APIは定期的に更新されます。APIが進化すると、古いAPIは非推奨になり、最終的には削除されます。このドキュメントには、非推奨APIバージョンを新しい安定したAPIバージョンに移行する際に知っておく必要のある情報が含まれています。
Verrazzano
Verrazzanoリソースのinstall.verrazzano.io/v1alpha1 APIバージョンは非推奨です。将来のリリースでは提供されなくなります。
- マニフェストとAPIクライアントが
install.verrazzano.io/v1beta1APIバージョン(1.4.0以降)を使用するように移行します。 - 既存のすべての永続オブジェクトには、新しいAPIを使用してアクセスできます。
install.verrazzano.io/v1beta1の重要な変更点
spec.components.ingressの名前がspec.components.ingressNGINXに変更されました。spec.components.kibanaの名前がspec.components.opensearchDashboardsに変更されましたspec.components.elasticsearchの名前がspec.components.opensearchに変更されましたspec.components.fluentd.elasticsearchSecretの名前がspec.components.fluentd.opensearchSecretに変更されましたspec.components.fluentd.elasticsearchURLの名前がspec.components.fluentd.opensearchURLに変更されましたstatus.instance.kibanaUrlの名前がstatus.instance.opensearchDashboardsUrlに変更されましたstatus.instance.elasticUrlの名前がstatus.instance.opensearchUrlに変更されましたspec.components.elasticsearch.installArgsのかわりにspec.components.opensearch.nodesを使用します。spec.components.ingress.nginxInstallArgsのかわりにspec.components.ingressNGINX.overridesを使用します。spec.components.istio.istioInstallArgsのかわりにspec.components.istio.overridesを使用します。spec.components.istio.ingressのかわりにspec.components.istio.overridesを使用します。spec.components.istio.egressのかわりにspec.components.istio.overridesを使用します。spec.components.keycloak.keycloakInstallArgsのかわりにspec.components.keycloak.overridesを使用します。spec.components.verrazzano.installArgsのかわりにspec.components.verrazzano.overridesを使用します。spec.components.verrazzano.overridesのかわりにspec.components.authProxy.overridesを使用します。
以前のVerrazzanoバージョンの同時インストール
Verrazzanoバージョン1.4.0以降をインストールした後で、それをアンインストールしないで1.4.0より前のVerrazzanoバージョンをインストールすると、次のエラーが発生します:
The CustomResourceDefinition "verrazzanos.install.verrazzano.io" is invalid: status.storedVersions[0]: Invalid value: "v1beta1": must appear in spec.versions
このエラーを解決するには、verrazzanos.install.verrazzano.ioカスタム・リソース定義を削除します:
$ kubectl delete customresourcedefinition verrazzanos.install.verrazzano.io