Deprecation Notes¶

Considering continuous reorganization and enhancement of Mirantis OpenStack for Kubernetes (MOSK), certain components are deprecated and eventually removed from the product. This section provides the following details about the deprecated and removed functionality that may potentially impact existing MOSK deployments:

The MOSK release version in which deprecation is announced
The final MOSK release version in which a deprecated component is present
The MOSK release version in which a deprecated component is removed

Tungsten Fabric API v1alpha1¶

Deprecated	MOSK 24.2
Unsupported	MOSK 24.3
Details	Instead of v1alpha1, MOSK introduces support for the API v2 for the Tungsten Fabric Operator. The new version of the Tungsten Fabric Operator API aligns with the OpenStack Controller API and provides better interface for advanced configurations. In MOSK 24.1, the API v2 is available only for the new product deployments with Tungsten Fabric. Since 24.2, MOSK API v2 becomes default for new product deployments and includes the ability to convert existing v1alpha1 `TFOperator` to v2 during update. For details, refer to Convert v1alpha1 TFOperator custom resource to v2.

Deprecated

MOSK 24.2

Unsupported

MOSK 24.3

Details

Instead of v1alpha1, MOSK introduces support for the API v2 for the Tungsten Fabric Operator. The new version of the Tungsten Fabric Operator API aligns with the OpenStack Controller API and provides better interface for advanced configurations.

In MOSK 24.1, the API v2 is available only for the new product deployments with Tungsten Fabric.

Since 24.2, MOSK API v2 becomes default for new product deployments and includes the ability to convert existing v1alpha1 TFOperator to v2 during update. For details, refer to Convert v1alpha1 TFOperator custom resource to v2.

MetalLBConfigTemplate object¶

Deprecated	MOSK 24.2
Unsupported	MOSK 24.3
Details	Deprecated the `MetalLBConfigTemplate` object. Use the `MetalLBConfig` object instead. Existing `MetalLBConfigTemplate` objects and related `Subnet` objects are automatically migrated to `MetallbConfig` during MOSK cluster update to 24.2.

Deprecated

MOSK 24.2

Unsupported

MOSK 24.3

Details

Deprecated the MetalLBConfigTemplate object. Use the MetalLBConfig object instead.

Existing MetalLBConfigTemplate objects and related Subnet objects are automatically migrated to MetallbConfig during MOSK cluster update to 24.2.

SubnetPool object¶

Deprecated	MOSK 24.2
Unsupported	MOSK 24.3
Details	Deprecated the `SubnetPool` object along with automated subnet creation using `SubnetPool`. Existing configurations that use the `SubnetPool` object in `L2Template` will be automatically migrated to `Subnet` objects during cluster update to MOSK 24.2. As a result of migration, existing `Subnet` objects will be referenced in `L2Template` objects instead of `SubnetPool`. If you still require this feature, contact Mirantis support for further information.

Deprecated

MOSK 24.2

Unsupported

MOSK 24.3

Details

Deprecated the SubnetPool object along with automated subnet creation using SubnetPool.

Existing configurations that use the SubnetPool object in L2Template will be automatically migrated to Subnet objects during cluster update to MOSK 24.2. As a result of migration, existing Subnet objects will be referenced in L2Template objects instead of SubnetPool.

If you still require this feature, contact Mirantis support for further information.

Tungsten Fabric analytics services¶

Deprecated	MOSK 24.1
Unsupported	MOSK 24.2
Details	Tungsten Fabric analytics services, primarily designed for collecting various metrics from the Tungsten Fabric services, is being deprecated. Despite its initial implementation, user demand for this feature has been minimal. As a result, Tungsten Fabric analytics services will become unsupported in the product. All greenfield deployments starting from MOSK 24.1 do not include Tungsten Fabric analytics services. The existing deployments updated to 24.1 and newer versions will include Tungsten Fabric analytics services as well as the ability to disable them as described in Disable Tungsten Fabric analytics services.

Deprecated

MOSK 24.1

Unsupported

MOSK 24.2

Details

Tungsten Fabric analytics services, primarily designed for collecting various metrics from the Tungsten Fabric services, is being deprecated. Despite its initial implementation, user demand for this feature has been minimal. As a result, Tungsten Fabric analytics services will become unsupported in the product.

All greenfield deployments starting from MOSK 24.1 do not include Tungsten Fabric analytics services. The existing deployments updated to 24.1 and newer versions will include Tungsten Fabric analytics services as well as the ability to disable them as described in Disable Tungsten Fabric analytics services.

StackLight telegraf-openstack plugin¶

Deprecated	MOSK 23.3
Final release	MOSK 23.3.4
Removed	MOSK 24.1
Details	The StackLight `telegraf-openstack` plugin is going to be replaced by `osdpl-exporter`. As a result, all valuable Telegraf metrics that are used by StackLight components will be reimplemented in `osdpl-exporter` and all dependent StackLight alerts and dashboards will start using new metrics. Therefore, if you use any `telegraf-openstack` metrics in any cluster customizations, consider reimplementing them with new metrics. To obtain the list of metrics that are removed and replaced with new ones, contact Mirantis support.

Default L2Template for a namespace¶

Deprecated	MOSK 23.2
Unsupported	MOSK 23.3
Details	Disabled creation of the default L2 template for a namespace. On existing clusters, `clusterRef: default` is removed during the migration process. Subsequently, this parameter is not substituted with the `cluster.sigs.k8s.io/cluster-name` label, ensuring the application of the L2 template across the entire Kubernetes namespace. Therefore, you can continue using existing default L2 templates for namespaces.

Deprecated

MOSK 23.2

Unsupported

MOSK 23.3

Details

Disabled creation of the default L2 template for a namespace.

On existing clusters, clusterRef: default is removed during the migration process. Subsequently, this parameter is not substituted with the cluster.sigs.k8s.io/cluster-name label, ensuring the application of the L2 template across the entire Kubernetes namespace. Therefore, you can continue using existing default L2 templates for namespaces.

The clusterRef parameter in L2Template¶

Deprecated

MOSK 23.3

Unsupported

To be decided

Details

Deprecated the clusterRef parameter located in the L2Template spec. Use the cluster.sigs.k8s.io/cluster-name label instead.

On existing clusters, this parameter is automatically migrated to the cluster.sigs.k8s.io/cluster-name label since MOSK 23.3.

The allow-unsafe-backup parameter for MariaDB¶

Deprecated	MOSK 22.3
Final release	MOSK 22.3
Removed	MOSK 22.4
Details	Removed the unsafe `--allow-unsafe-backup` flag for MariaDB backup for security and backup procedure simplification purposes.

OpenStackDeployment CR fields containing cloud secret parameters¶

Deprecated	MOSK 22.3
Final release	MOSK 22.4
Removed	MOSK 22.5
Details	A number of fields intended to store confidential settings in the `OpenStackDeployment` custom resource has been deprecated in favor of osdplsecret-cr. The latter is a dedicated data structure to aggregate such secrets as SSL/TLS certificates, external systems access credentials, and others. The list of deprecated parameters includes `features:ssl`, `features:barbican:backends:vault:approle_role_id`, and `features:barbican:backends:vault:approle_secret_id`. To migrate to the new schema, refer to Migrating secrets from OpenStackDeployment to OpenStackDeploymentSecret CR.

The OpenStack Panko service¶

Deprecated	MOSK 22.1
Final release	MOSK 22.1
Removed	MOSK 22.2
Details	The OpenStack Panko service is no longer maintained in the upstream OpenStack. See the project repository page for details.

The tf-status service¶

Deprecated	MOSK 21.5
Final release	MOSK 21.5
Removed	MOSK 21.6
Details	The `tf-status` service duplicated the health-check information about the Tungsten Fabric services that you can also obtain from the liveness and readiness probes on the Tungsten Fabric pods. Additionally, MOSK 21.5 introduces an overall health status in the Tungsten Fabric Operator CR status with health status for every module of Tungsten Fabric. To get the overall cluster status, verify the output of `kubectl -n tf describe tfoperators <TFOPERATOR-CR-NAME>`.

The status element in the OsDpl CR¶

Deprecated	MOSK 21.5
Final release	MOSK 21.6
Removed	MOSK 22.1
Details	The `status` element in the `OpenStackDeployment` (OsDpl) custom resource has been removed from the product in favor of the `OpenStackDeploymentStatus` (OsDplSt) custom resource, a single data structure that provides a machine-readable status of an OpenStack deployment at a certain point in time.

CPU isolation using isolcpus¶

Deprecated	MOSK 22.2
Final release	To be decided
Removed	To be decided
Details	Configuring CPU isolation through the `isolcpus` configuration parameter for Linux kernel is considered deprecated. MOSK 21.5 introduces the capability to configure CPU isolation using the `cpusets` mechanism in Linux kernel. For details, see CPU isolation using cpusets.