TFOperator custom resource

The resource of kind TFOperator is a custom resource defined by a resource of kind CustomResourceDefinition.

The CustomResourceDefinition resource in Kubernetes uses the OpenAPI Specification version 2 to specify the schema of the defined resource. The Kubernetes API outright rejects the resources that do not pass this schema validation. Along with schema validation, TFOperator uses ValidatingAdmissionWebhook for extended validations when a custom resource is created or updated.

TFOperator uses API v2 that aligns with the OpenStack Controller API and provides a user-friendly interface for advanced configurations.

For the list of configuration options available to a cloud operator, refer to OpenSDN configuration. Also, check out the OpenSDN Operator (TFOperator) resources document of the MOSK version that your cluster has been deployed with.

TFOperator custom resource validation

TFOperator uses ValidatingAdmissionWebhook to validate environment variables set to OpenSDN components upon the TFOperator object creation or update. The following validations are performed:

• Environment variables passed to the OpenSDN components containers

• Mapping between tfVersion and tfImageTag, if defined

• Schedule for dbBackup

• Data capacity format

• Feature variable values

• Availability of the dataStorageClass class

If required, you can disable ValidatingAdmissionWebhook through the TFOperator HelmBundle resource:

apiVersion: lcm.mirantis.com/v1alpha1
kind: HelmBundle
metadata:
  name: tungstenfabric-operator
  namespace: tf
spec:
  releases:
  - name: tungstenfabric-operator
    values:
      admission:
        enabled: false

Environment variables for OpenSDN components

Warning

The features section of the TFOperator specification allows for easy configuration of all OpenSDN features. Mirantis recommends updating the environment variables through envSettings directly.

Allowed environment variables for OpenSDN components

Environment variables	OpenSDN service and envSettings name
INTROSPECT_LISTEN_ALL	analytics (alarmGen, api, collector, nodeMgr, query, snmp, topology) config (api, db-nodemgr, nodeMgr) control (control, dns, nodeMgr) vRouter (agent, nodeMgr)
PROVISION_DELAY PROVISION_RETRIES BGP_ASN ENCAP_PRIORITY VXLAN_VN_ID_MODE	analytics (provisioner) config (provisioner) control (provisioner) agent (provisioner)
CONFIG_API_LIST_OPTIMIZATION_ENABLED CONFIG_API_WORKER_COUNT CONFIG_API_MAX_REQUESTS FWAAS_ENABLE RABBITMQ_HEARTBEAT_INTERVAL DISABLE_VNC_API_STATS	config (api)
DNS_NAMED_MAX_CACHE_SIZE DNS_NAMED_MAX_RETRANSMISSIONS DNS_RETRANSMISSION_INTERVAL	control (dns)
WEBUI_LOG_LEVEL WEBUI_STATIC_AUTH_PASSWORD WEBUI_STATIC_AUTH_ROLE WEBUI_STATIC_AUTH_USER	webui (job, web)
ANALYTICS_CONFIG_AUDIT_TTL ANALYTICS_DATA_TTL ANALYTICS_FLOW_TTL ANALYTICS_STATISTICS_TTL COLLECTOR_disk_usage_percentage_high_watermark0 COLLECTOR_disk_usage_percentage_high_watermark1 COLLECTOR_disk_usage_percentage_high_watermark2 COLLECTOR_disk_usage_percentage_low_watermark0 COLLECTOR_disk_usage_percentage_low_watermark1 COLLECTOR_disk_usage_percentage_low_watermark2 COLLECTOR_high_watermark0_message_severity_level COLLECTOR_high_watermark1_message_severity_level COLLECTOR_high_watermark2_message_severity_level COLLECTOR_low_watermark0_message_severity_level COLLECTOR_low_watermark1_message_severity_level COLLECTOR_low_watermark2_message_severity_level COLLECTOR_pending_compaction_tasks_high_watermark0 COLLECTOR_pending_compaction_tasks_high_watermark1 COLLECTOR_pending_compaction_tasks_high_watermark2 COLLECTOR_pending_compaction_tasks_low_watermark0 COLLECTOR_pending_compaction_tasks_low_watermark1 COLLECTOR_pending_compaction_tasks_low_watermark2 COLLECTOR_LOG_FILE_COUNT COLLECTOR_LOG_FILE_SIZE	analytics (collector)
ANALYTICS_DATA_TTL QUERYENGINE_MAX_SLICE QUERYENGINE_MAX_TASKS QUERYENGINE_START_TIME	analytics (query)
SNMPCOLLECTOR_FAST_SCAN_FREQUENCY SNMPCOLLECTOR_SCAN_FREQUENCY	analytics (snmp)
TOPOLOGY_SCAN_FREQUENCY	analytics (topology)
PHYSICAL_INTERFACE SRIOV_PHYSICAL_INTERFACE SRIOV_PHYSICAL_NETWORK SRIOV_VF TSN_AGENT_MODE TSN_NODES AGENT_MODE FABRIC_SNAT_HASH_TABLE_SIZE PRIORITY_BANDWIDTH PRIORITY_ID PRIORITY_SCHEDULING PRIORITY_TAGGING QOS_DEF_HW_QUEUE QOS_LOGICAL_QUEUES QOS_QUEUE_ID VROUTER_GATEWAY HUGE_PAGES_2MB HUGE_PAGES_1GB DISABLE_TX_OFFLOAD DISABLE_STATS_COLLECTION	vRouter (agent)