F5BigPersistenceProfile¶

Overview¶

Specifies persistence settings that control how session requests are directed to servers based on address affinity.

k8s.f5net.com/v1

Namespace

Singular name	Plural name	Short name
f5-big-persistence-profile	f5-big-persistence-profiles	—

Field	Required	Default	Description
`persistenceType` string	No	`SRC_ADDR`	Specifies the persistence type. Source address (`SRC_ADDR`) directs session requests to the same server based on the source IP address of a packet. Destination address (`DST_ADDR`) directs session requests to the same server based on the destination IP address of a packet. Accepted values: `SRC_ADDR`, `DST_ADDR`, `MODEL_CONTEXT_PROTOCOL`, `AGENT2AGENT`.
`timeout` integer	No	`180`	Specifies the duration of the persistence entries in seconds. This applies only to the `DEFAULT` hash algorithm. Minimum: `1`. Maximum: `4294967295`.
`addressAffinity` object	No	`{hashAlgorithm: "CARP"}`	Specifies the configuration parameters for the persistence address affinity selected.
`mcpEncryptionPassphrase` object	No	—	Reference to a Kubernetes Secret containing the Model Context Protocol (MCP) encryption passphrase. Required when `persistenceType` is `MODEL_CONTEXT_PROTOCOL`.
`a2aEncryptionPassphrase` object	No	—	Reference to a Kubernetes Secret containing the Agent-to-Agent (A2A) encryption passphrase. Required when `persistenceType` is `AGENT2AGENT`.

Note

When you set persistenceType to MODEL_CONTEXT_PROTOCOL, you must also provide a value for mcpEncryptionPassphrase.

When you set persistenceType to AGENT2AGENT, you must also provide a value for a2aEncryptionPassphrase.

You can specify either mcpEncryptionPassphrase or a2aEncryptionPassphrase, but not both.

Field	Required	Default	Description
`ipv4PrefixLength` integer	No	`32`	Specifies the prefix length to use as the IPv4 mask. The length must be a value between `1` and `32`.
`ipv6PrefixLength` integer	No	`128`	Specifies the prefix length to use as the IPv6 mask. The length must be a value between `1` and `128`.
`hashAlgorithm` string	No	`CARP`	Specifies the hash algorithm for the persistence type. `CARP` uses a stateless mechanism that directs sessions to a specific server. The selection remains consistent even if the number of servers in the pool changes. `DEFAULT` generates and maintains stateful persistence session records, and the selection of a server could vary due to factors like timeout of a persistence record. Accepted values: `CARP`, `DEFAULT`.

Field	Required	Description
`secretRef` object	Yes	Reference to a Kubernetes Secret containing the MCP encryption passphrase. The Secret must be in the same namespace as this resource.

Field	Required	Default	Description
`name` string	Yes	—	Specifies the name of the Kubernetes Secret containing the MCP passphrase. Must be between 1 and 253 characters and match the pattern `^[a-z0-9]([-a-z0-9][a-z0-9])?(\.[a-z0-9]([-a-z0-9][a-z0-9])?)*$`.
`passphraseField` string	No	`passphrase`	Specifies the field name in the referenced Kubernetes Secret that contains the passphrase. Maximum: 255 characters.

Field	Required	Description
`secretRef` object	Yes	Reference to a Kubernetes Secret containing the A2A encryption passphrase. The Secret must be in the same namespace as this resource.

Field	Required	Default	Description
`name` string	Yes	—	Specifies the name of the Kubernetes Secret containing the A2A passphrase. Must be between 1 and 253 characters and match the pattern `^[a-z0-9]([-a-z0-9][a-z0-9])?(\.[a-z0-9]([-a-z0-9][a-z0-9])?)*$`.
`passphraseField` string	No	`passphrase`	Specifies the field name in the referenced Kubernetes Secret that contains the passphrase. Maximum: 255 characters.