Config v1alpha1 API Reference
Packages:
config.flomesh.io/v1alpha1
Package v1alpha1 is the v1alpha1 version of the API.
CertificateSpec
(Appears on:MeshConfigSpec)
CertificateSpec is the type to reperesent FSM’s certificate management configuration.
| Field | Description |
|---|---|
serviceCertValidityDurationstring | ServiceCertValidityDuration defines the service certificate validity duration. |
certKeyBitSizeint | CertKeyBitSize defines the certicate key bit size. |
ingressGatewayIngressGatewayCertSpec | (Optional) IngressGateway defines the certificate specification for an ingress gateway. |
ClusterPropertySpec
(Appears on:ClusterSetSpec)
ClusterPropertySpec is the type to represent cluster property.
| Field | Description |
|---|---|
namestring | Name defines the name of cluster property. |
valuestring | Value defines the name of cluster property. |
ClusterSetSpec
(Appears on:MeshConfigSpec)
ClusterSetSpec is the type to represent cluster set.
| Field | Description |
|---|---|
properties[]ClusterPropertySpec | Properties defines properties for cluster. |
ExternalAuthzSpec
(Appears on:TrafficSpec)
ExternalAuthzSpec is a type to represent external authorization configuration.
| Field | Description |
|---|---|
enablebool | Enable defines a boolean indicating if the external authorization policy is to be enabled. |
addressstring | Address defines the remote address of the external authorization endpoint. |
portuint16 | Port defines the destination port of the remote external authorization endpoint. |
statPrefixstring | StatPrefix defines a prefix for the stats sink for this external authorization policy. |
timeoutstring | Timeout defines the timeout in which a response from the external authorization endpoint. is expected to execute. |
failureModeAllowbool | FailureModeAllow defines a boolean indicating if traffic should be allowed on a failure to get a response against the external authorization endpoint. |
FeatureFlags
(Appears on:MeshConfigSpec)
FeatureFlags is a type to represent FSM’s feature flags.
| Field | Description |
|---|---|
enableEgressPolicybool | EnableEgressPolicy defines if FSM’s Egress policy is enabled. |
enableSnapshotCacheModebool | EnableSnapshotCacheMode defines if XDS server starts with snapshot cache. |
enableAsyncProxyServiceMappingbool | EnableAsyncProxyServiceMapping defines if FSM will map proxies to services asynchronously. |
enableIngressBackendPolicybool | EnableIngressBackendPolicy defines if FSM will use the IngressBackend API to allow ingress traffic to service mesh backends. |
enableAccessControlPolicybool | EnableAccessControlPolicy defines if FSM will use the AccessControl API to allow access control traffic to service mesh backends. |
enableAccessCertPolicybool | EnableAccessCertPolicy defines if FSM can issue certificates for external services.. |
enableSidecarActiveHealthChecksbool | EnableSidecarActiveHealthChecks defines if FSM will sidecar active health checks between services allowed to communicate. |
enableRetryPolicybool | EnableRetryPolicy defines if retry policy is enabled. |
enablePluginPolicybool | EnablePluginPolicy defines if plugin policy is enabled. |
enableAutoDefaultRoutebool | EnableAutoDefaultRoute defines if auto default route is enabled. |
IngressGatewayCertSpec
(Appears on:CertificateSpec)
IngressGatewayCertSpec is the type to represent the certificate specification for an ingress gateway.
| Field | Description |
|---|---|
subjectAltNames[]string | SubjectAltNames defines the Subject Alternative Names (domain names and IP addresses) secured by the certificate. |
validityDurationstring | ValidityDuration defines the validity duration of the certificate. |
secretKubernetes core/v1.SecretReference | Secret defines the secret in which the certificate is stored. |
MeshConfig
MeshConfig is the type used to represent the mesh configuration.
| Field | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
metadataKubernetes meta/v1.ObjectMeta | (Optional) Object’s metadata. Refer to the Kubernetes API documentation for the fields of themetadata field. | ||||||||||||||||
specMeshConfigSpec | (Optional) Spec is the MeshConfig specification.
|
MeshConfigSpec
(Appears on:MeshConfig)
MeshConfigSpec is the spec for FSM’s configuration.
| Field | Description |
|---|---|
clusterSetClusterSetSpec | ClusterSetSpec defines the configurations of cluster. |
sidecarSidecarSpec | Sidecar defines the configurations of the proxy sidecar in a mesh. |
repoServerRepoServerSpec | RepoServer defines the configurations of pipy repo server. |
trafficTrafficSpec | Traffic defines the traffic management configurations for a mesh instance. |
observabilityObservabilitySpec | Observalility defines the observability configurations for a mesh instance. |
certificateCertificateSpec | Certificate defines the certificate management configurations for a mesh instance. |
featureFlagsFeatureFlags | FeatureFlags defines the feature flags for a mesh instance. |
pluginChainsPluginChainsSpec | PluginChains defines the default plugin chains. |
ObservabilitySpec
(Appears on:MeshConfigSpec)
ObservabilitySpec is the type to represent FSM’s observability configurations.
| Field | Description |
|---|---|
fsmLogLevelstring | FSMLogLevel defines the log level for FSM control plane logs. |
enableDebugServerbool | EnableDebugServer defines if the debug endpoint on the FSM controller pod is enabled. |
tracingTracingSpec | Tracing defines FSM’s tracing configuration. |
remoteLoggingRemoteLoggingSpec | RemoteLogging defines FSM’s remot logging configuration. |
PluginChainSpec
(Appears on:PluginChainsSpec)
PluginChainSpec is the type to represent plugin chain.
| Field | Description |
|---|---|
pluginstring | Plugin defines the name of plugin |
priorityfloat32 | Priority defines the priority of plugin |
disablebool | Disable defines the visibility of plugin |
PluginChainsSpec
(Appears on:MeshConfigSpec)
PluginChainsSpec is the type to represent plugin chains.
| Field | Description |
|---|---|
inbound-tcp[]PluginChainSpec | InboundTCPChains defines inbound tcp chains |
inbound-http[]PluginChainSpec | InboundHTTPChains defines inbound http chains |
outbound-tcp[]PluginChainSpec | OutboundTCPChains defines outbound tcp chains |
outbound-http[]PluginChainSpec | OutboundHTTPChains defines outbound http chains |
RemoteLoggingSpec
(Appears on:ObservabilitySpec)
RemoteLoggingSpec is the type to represent FSM’s remote logging configuration.
| Field | Description |
|---|---|
enablebool | Enable defines a boolean indicating if the sidecars are enabled for remote logging. |
leveluint16 | Level defines the remote logging’s level. |
portuint16 | Port defines the remote loggings port. |
addressstring | Address defines the remote logging’s hostname. |
endpointstring | Endpoint defines the API endpoint for remote logging requests sent to the collector. |
authorizationstring | Authorization defines the access entity that allows to authorize someone in remote logging service. |
sampledFractionfloat32 | SampledFraction defines the sampled fraction. |
RepoServerSpec
(Appears on:MeshConfigSpec)
RepoServerSpec is the type to represent repo server.
| Field | Description |
|---|---|
ipaddrstring | IPAddr of the pipy repo server |
codebasestring | Codebase is the folder used by fsmController |
SidecarDriverSpec
(Appears on:SidecarSpec)
SidecarDriverSpec is the type to represent FSM’s sidecar driver define.
| Field | Description |
|---|---|
sidecarNamestring | SidecarName defines the name of the sidecar driver. |
sidecarImagestring | SidecarImage defines the container image used for the proxy sidecar. |
initContainerImagestring | InitContainerImage defines the container image used for the init container injected to meshed pods. |
proxyServerPortuint32 | ProxyServerPort is the port on which the Discovery Service listens for new connections from Sidecars |
sidecarDisabledMTLSbool | SidecarDisabledMTLS defines if mTLS are disabled. |
SidecarSpec
(Appears on:MeshConfigSpec)
SidecarSpec is the type used to represent the specifications for the proxy sidecar.
| Field | Description |
|---|---|
enablePrivilegedInitContainerbool | EnablePrivilegedInitContainer defines a boolean indicating whether the init container for a meshed pod should run as privileged. |
logLevelstring | LogLevel defines the logging level for the sidecar’s logs. Non developers should generally never set this value. In production environments the LogLevel should be set to error. |
sidecarClassstring | SidecarClass defines the container provider used for the proxy sidecar. |
sidecarImagestring | SidecarImage defines the container image used for the proxy sidecar. |
sidecarDisabledMTLSbool | SidecarDisabledMTLS defines whether mTLS is disabled. |
initContainerImagestring | InitContainerImage defines the container image used for the init container injected to meshed pods. |
sidecarDrivers[]SidecarDriverSpec | SidecarDrivers defines the sidecar supported. |
maxDataPlaneConnectionsint | MaxDataPlaneConnections defines the maximum allowed data plane connections from a proxy sidecar to the FSM controller. |
configResyncIntervalstring | ConfigResyncInterval defines the resync interval for regular proxy broadcast updates. |
sidecarTimeoutint | SidecarTimeout defines the connect/idle/read/write timeout. |
resourcesKubernetes core/v1.ResourceRequirements | Resources defines the compute resources for the sidecar. |
TracingSpec
(Appears on:ObservabilitySpec)
TracingSpec is the type to represent FSM’s tracing configuration.
| Field | Description |
|---|---|
enablebool | Enable defines a boolean indicating if the sidecars are enabled for tracing. |
portuint16 | Port defines the tracing collector’s port. |
addressstring | Address defines the tracing collectio’s hostname. |
endpointstring | Endpoint defines the API endpoint for tracing requests sent to the collector. |
sampledFractionfloat32 | SampledFraction defines the sampled fraction. |
TrafficSpec
(Appears on:MeshConfigSpec)
TrafficSpec is the type used to represent FSM’s traffic management configuration.
| Field | Description |
|---|---|
interceptionModestring | InterceptionMode defines a string indicating which traffic interception mode is used. |
enableEgressbool | EnableEgress defines a boolean indicating if mesh-wide Egress is enabled. |
outboundIPRangeExclusionList[]string | OutboundIPRangeExclusionList defines a global list of IP address ranges to exclude from outbound traffic interception by the sidecar proxy. |
outboundPortExclusionList[]int | OutboundPortExclusionList defines a global list of ports to exclude from outbound traffic interception by the sidecar proxy. |
inboundPortExclusionList[]int | InboundPortExclusionList defines a global list of ports to exclude from inbound traffic interception by the sidecar proxy. |
enablePermissiveTrafficPolicyModebool | EnablePermissiveTrafficPolicyMode defines a boolean indicating if permissive traffic policy mode is enabled mesh-wide. |
serviceAccessModestring | ServiceAccessMode defines a string indicating service access mode. |
inboundExternalAuthorizationExternalAuthzSpec | InboundExternalAuthorization defines a ruleset that, if enabled, will configure a remote external authorization endpoint for all inbound and ingress traffic in the mesh. |
http1PerRequestLoadBalancingbool | HTTP1PerRequestLoadBalancing defines a boolean indicating if load balancing based on request is enabled for http1. |
http2PerRequestLoadBalancingbool | HTTP1PerRequestLoadBalancing defines a boolean indicating if load balancing based on request is enabled for http2. |
Generated with gen-crd-api-reference-docs
on git commit 8abe9ab.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.