CRDのエンティティ名の変更

• ハッシュ化された命名: エンティティ名の一部がハッシュ化され、全体の長さが短縮されます
• 保持される情報: エンティティコメントがNetScalerでサポートされている場合、必要なKubernetes関連のメタデータはエンティティのコメントフィールドに保持されます
• 互換性の向上: 名前はNetScalerの文字制限に準拠し、完全なトレーサビリティを維持します

1. ハイフンをアンダースコアに置換: CRD名と名前空間内のすべてのハイフンは、エンティティ名ではアンダースコアに変換されます (GSLBエンティティを除く)。
   • 例: route-for-all → route_for_all
   • 例: other-namespace → other_namespace
2. LBvserverの命名を簡素化: 名前には一意性を確保するためのハッシュが含まれます。
   • 旧: k8s_crd_k8shttproute_route-for-all_other-namespace_0_lb
   • 新: k8s_c15_route_for_all_other_name_http_MFRGGZDFMY4TMZLDGE4TCMZWGIZQYNR2GEZDGNBVGY3TQOJQ
3. GSLBエンティティはハイフンを保持: GSLB関連エンティティ (gslbservicegroup, gslbvserver) はハイフンを保持します。
   • 例: cocacola-com は cocacola-com のままです (cocacola_comには変換されません)

アップグレードシナリオ

NetScaler Ingress Controllerをバージョン4.0.xからバージョン3.x.xにダウングレードする

1. すべてのCitrix CRDインスタンスをバックアップします。このコマンドは、すべての名前空間からすべてのCitrix CRDインスタンスを、適切なドキュメント区切り文字を含む単一のYAMLファイルにバックアップします。
   rm -f all_crd_instances.yaml
for crd in $(kubectl get crds -o jsonpath='{.items[*].metadata.name}' | tr ' ' '\n' | grep 'citrix.com'); do
echo "Getting instances for CRD: $crd"
kubectl get $crd --all-namespaces -o name | while read resource; do
    kubectl get $resource -o yaml
    echo "---"
done >> all_crd_instances.yaml
done
   バックアップファイルが作成されたことを確認します。
   ls -lh all_crd_instances.yaml
2. 次のコマンドを使用して、既存の展開からCRDインスタンスを削除します。
   kubectl delete -f all_crd_instances.yaml
3. NetScaler Ingress Controllerが削除イベントを処理し、関連リソースをクリーンアップできるようにします。
   kubectl logs -n <nsic-namespace> <nsic-pod-name> -f
4. NetScaler Ingress Controllerの展開を目的の3.x.xバージョンに更新して、NetScaler Ingress Controllerをダウングレードします。
   # Example: using Helm
helm upgrade nsic citrix/citrix-ingress-controller --version <3.x.x-version>
# Or: using kubectl
kubectl set image deployment/nsic nsic-container=<image:3.x.x-tag> -n <nsic-namespace>
5. ダウングレードされたNetScaler Ingress Controllerポッドが稼働し、準備が整ったら、バックアップされたCRDインスタンスを復元します。
   kubectl apply -f all_crd_instances.yaml