カスタムリソース定義のバージョン管理

ストレージのバージョン変更

ストレージ版は v1 であり、これは以下のことを意味します：

• v1beta1 を使用してリソースを作成すると、 Kubernetes または OpenShift が、保存時に自動的にそれらを v1 に変換します。
• v1beta1 として保存されている既存のリソースはすべて、アクセスされた際に自動的に v1 に変換されます。
• これにより、シームレスな互換性と将来的な移行経路が確保されます。

APIバージョンの対応状況

以下の重要なポイントは、SIPEnvironment およびすべてのサービスコンポーネント（ IVServiceGroup、 PromisingServiceGroup、 OptimizerServiceGroup、 UtilityServiceGroup、OMSGateway、 CertificateManager ）に適用されます

• v1beta1 で導入されたすべての機能および設定は、 v1 でも引き続き完全にサポートされています。
• 既存の設定は、 v1 に自動的に引き継がれます。
• 機能の互換性を確保するために、手動での介入は不要です。

ユーザー・アクション

新しい環境について

• すべての新しいカスタムリソースには、 v1 のAPIバージョンを使用してください。
• 最新のスキーマや機能については、『 v1 』APIドキュメントを参照してください。
• 例:

  apiVersion: apps.sip.ibm.com/v1
  kind: IVServiceGroup
  metadata:
    name: my-iv-service
  spec:
    # Your configuration here

既存の環境について

• 現時点では、特に必要な措置はありません。 現在ご利用中の v1beta1 のリソースは、引き続き正常に機能します。
• Kubernetes あるいは、 OpenShift を使用すれば、バージョンの変換が自動的に行われます。
• 長期的なサポートを充実させるため、カスタムリソースのYAMLファイルを更新し、 v1 を使用することをお勧めします。
• CI/CD パイプライン： v1 API のバージョンを参照するように、自動化スクリプトを更新してください。

CI/CDおよび GitOps のワークフロー向け

カスタムリソースをバージョン管理システムや自動化パイプラインで管理している場合は：

1. apps.sip.ibm.com/v110.0.2604.2 リリースにアップグレードする前に、フィールドの apiVersion 値を から apps.sip.ibm.com/v1beta1 に変更してください。
2. 変更内容は、まず本番環境以外の環境で確認およびテストを行ってください。
3. v1beta1 のすべてのフィールドは v1 でサポートされているため、スキーマの変更は必要ありません。

バージョンの非推奨化スケジュール

• v1beta1 この機能はサポートされていますが、非推奨となっており、今後のリリースで削除される予定です。
• v1 これは現在の安定版であり、すべての導入環境での使用が推奨されています。