非推奨のAPIバージョンからの移行
Verrazzano APIの進化に伴い、APIは定期的に更新されます。APIが進化すると、古いAPIは非推奨になり、最終的には削除されます。このドキュメントには、非推奨APIバージョンを新しい安定したAPIバージョンに移行する際に知っておく必要のある情報が含まれています。
Verrazzano
Verrazzanoリソースのinstall.verrazzano.io/v1alpha1
APIバージョンは非推奨です。将来のリリースでは提供されなくなります。
- マニフェストとAPIクライアントが
install.verrazzano.io/v1beta1
APIバージョン(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
マルチクラスタ
clusters.verrazzano.io/v1alpha1
の一部であるマルチクラスタ・ラッパーAPIの一部は非推奨であり、Verrazzano v2.0.0で削除されます。削除されるAPIは次のとおりです:
- MultiClusterComponent -
core.oam/dev/v1alpha2
コンポーネント・リソースに置き換える必要があります。 - MultiClusterConfigMap -
core.oam/dev/v1alpha2
コンポーネント・リソースに置き換える必要があります。 - MultiClusterSecret - Kubernetesシークレットで置き換えらる必要があり、MultiClusterApplicationConfigurationリソースの
spec.secrets
で参照されます。