MSK Connect

3 resource kinds. Generated from the operator's CRD schemas.

API Group: aws.konfig.io/v1alpha1

KafkaConnectConnector # CLOUD CONTROL · AWS::KafkaConnect::Connector

KafkaConnectConnector manages AWS::KafkaConnect::Connector through the AWS Cloud Control API.

kubectl get kafkaconnectconnectors · example on GitHub

Example

# KafkaConnectConnector — MSK Connect
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/kafkaconnect.html#kafkaconnectconnector
apiVersion: aws.konfig.io/v1alpha1
kind: KafkaConnectConnector
metadata:
  name: example-kafkaconnectconnector
  namespace: default
spec:
  capacity:
    autoScaling:
      maxAutoscalingTaskCount: 2
      maxWorkerCount: 2
      mcuCount: 2
      minWorkerCount: 2
      scaleInPolicy:
        cpuUtilizationPercentage: 1
      scaleOutPolicy:
        cpuUtilizationPercentage: 1
    provisionedCapacity:
      mcuCount: 2
      workerCount: 2
  connectorConfiguration:
    key: value
  connectorDescription: Managed by konfig-konector
  connectorName: example-kafkaconnectconnector
  kafkaCluster:
    apacheKafkaCluster:
      bootstrapServers: example
      vpc:
        securityGroups:
        - example
        subnets:
        - example
  kafkaClusterClientAuthentication:
    authenticationType: NONE
  kafkaClusterEncryptionInTransit:
    encryptionType: PLAINTEXT
  kafkaConnectVersion: '1.0'
  logDelivery:
    workerLogDelivery:
      cloudWatchLogs:
        enabled: true
        logGroup: example
      firehose:
        deliveryStream: example
        enabled: true
      s3:
        bucket: example
        enabled: true
        prefix: example
  networkType: IPV4
  plugins:
  - customPlugin:
      customPluginArn: arn:aws:iam::123456789012:role/example-role
      revision: 1
  providerRef:
    name: example-kafkaconnectconnector
    region: us-east-1
  serviceExecutionRoleArn: arn:aws:iam::123456789012:role/example-role
  tags:
  - key: example
    value: example
  workerConfiguration:
    revision: 1
    workerConfigurationArn: arn:aws:iam::123456789012:role/example-role

Spec

FieldTypeRequiredDescription
capacityobjectyesKafkaConnectConnectorCapacity is a nested property type of AWS::KafkaConnect::Connector.
capacity.autoScalingobject—KafkaConnectConnectorAutoScaling is a nested property type of AWS::KafkaConnect::Connector.
capacity.autoScaling.maxAutoscalingTaskCountinteger—The maximum number of tasks allocated to the connector during autoscaling operations.
capacity.autoScaling.maxWorkerCountintegeryesThe maximum number of workers for a connector.
capacity.autoScaling.mcuCountintegeryesSpecifies how many MSK Connect Units (MCU) as the minimum scaling unit.
capacity.autoScaling.minWorkerCountintegeryesThe minimum number of workers for a connector.
capacity.autoScaling.scaleInPolicyobjectyesKafkaConnectConnectorScaleInPolicy is a nested property type of AWS::KafkaConnect::Connector.
capacity.autoScaling.scaleInPolicy.cpuUtilizationPercentageintegeryesSpecifies the CPU utilization percentage threshold at which connector scale in should trigger.
capacity.autoScaling.scaleOutPolicyobjectyesKafkaConnectConnectorScaleOutPolicy is a nested property type of AWS::KafkaConnect::Connector.
capacity.autoScaling.scaleOutPolicy.cpuUtilizationPercentageintegeryesSpecifies the CPU utilization percentage threshold at which connector scale out should trigger.
capacity.provisionedCapacityobject—KafkaConnectConnectorProvisionedCapacity is a nested property type of AWS::KafkaConnect::Connector.
capacity.provisionedCapacity.mcuCountintegeryesSpecifies how many MSK Connect Units (MCU) are allocated to the connector.
capacity.provisionedCapacity.workerCountintegeryesNumber of workers for a connector.
connectorConfigurationmap<string>yesThe configuration for the connector.
connectorDescriptionstring—A summary description of the connector.
connectorNamestringyesThe name of the connector.
kafkaClusterobjectyesCreate-only in AWS: changing it requires replacing the resource.
kafkaCluster.apacheKafkaClusterobjectyesKafkaConnectConnectorApacheKafkaCluster is a nested property type of AWS::KafkaConnect::Connector.
kafkaCluster.apacheKafkaCluster.bootstrapServersstringyesThe bootstrap servers string of the Apache Kafka cluster.
kafkaCluster.apacheKafkaCluster.vpcobjectyesKafkaConnectConnectorVpc is a nested property type of AWS::KafkaConnect::Connector.
kafkaCluster.apacheKafkaCluster.vpc.securityGroupsarray<string>yesThe AWS security groups to associate with the elastic network interfaces in order to specify what the connector has access to.
kafkaCluster.apacheKafkaCluster.vpc.subnetsarray<string>yesThe list of subnets to connect to in the virtual private cloud (VPC).
kafkaClusterClientAuthenticationobjectyesCreate-only in AWS: changing it requires replacing the resource.
kafkaClusterClientAuthentication.authenticationTypeenumyesAllowed: NONE, IAM
kafkaClusterEncryptionInTransitobjectyesCreate-only in AWS: changing it requires replacing the resource.
kafkaClusterEncryptionInTransit.encryptionTypeenumyesAllowed: PLAINTEXT, TLS
kafkaConnectVersionstringyesThe version of Kafka Connect.
logDeliveryobject—Create-only in AWS: changing it requires replacing the resource.
logDelivery.workerLogDeliveryobjectyesKafkaConnectConnectorWorkerLogDelivery is a nested property type of AWS::KafkaConnect::Connector.
logDelivery.workerLogDelivery.cloudWatchLogsobject—KafkaConnectConnectorCloudWatchLogsLogDelivery is a nested property type of AWS::KafkaConnect::Connector.
logDelivery.workerLogDelivery.cloudWatchLogs.enabledbooleanyesSpecifies whether the logs get sent to the specified CloudWatch Logs destination.
logDelivery.workerLogDelivery.cloudWatchLogs.logGroupstring—The CloudWatch log group that is the destination for log delivery.
logDelivery.workerLogDelivery.firehoseobject—KafkaConnectConnectorFirehoseLogDelivery is a nested property type of AWS::KafkaConnect::Connector.
logDelivery.workerLogDelivery.firehose.deliveryStreamstring—The Kinesis Data Firehose delivery stream that is the destination for log delivery.
logDelivery.workerLogDelivery.firehose.enabledbooleanyesSpecifies whether the logs get sent to the specified Kinesis Data Firehose delivery stream.
logDelivery.workerLogDelivery.s3object—KafkaConnectConnectorS3LogDelivery is a nested property type of AWS::KafkaConnect::Connector.
logDelivery.workerLogDelivery.s3.bucketstring—The name of the S3 bucket that is the destination for log delivery.
logDelivery.workerLogDelivery.s3.enabledbooleanyesSpecifies whether the logs get sent to the specified Amazon S3 destination.
logDelivery.workerLogDelivery.s3.prefixstring—The S3 prefix that is the destination for log delivery.
networkTypeenum—The network type of the Connector. Allowed: IPV4, DUAL
pluginsarray<object>yesList of plugins to use with the connector.
plugins[].customPluginobjectyesKafkaConnectConnectorCustomPlugin is a nested property type of AWS::KafkaConnect::Connector.
plugins[].customPlugin.customPluginArnstringyesThe Amazon Resource Name (ARN) of the custom plugin to use.
plugins[].customPlugin.revisionintegeryesThe revision of the custom plugin to use.
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
serviceExecutionRoleArnstringyesThe Amazon Resource Name (ARN) of the IAM role used by the connector to access Amazon S3 objects and other external resources.
tagsarray<object>—A collection of tags associated with a resource
tags[].keystringyes
tags[].valuestringyes
workerConfigurationobject—Create-only in AWS: changing it requires replacing the resource.
workerConfiguration.revisionintegeryesThe revision of the worker configuration to use.
workerConfiguration.workerConfigurationArnstringyesThe Amazon Resource Name (ARN) of the worker configuration to use.

Status

FieldTypeRequiredDescription
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
connectorArnstring—Amazon Resource Name for the created Connector.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.

KafkaConnectCustomPlugin # CLOUD CONTROL · AWS::KafkaConnect::CustomPlugin

KafkaConnectCustomPlugin manages AWS::KafkaConnect::CustomPlugin through the AWS Cloud Control API.

kubectl get kafkaconnectcustomplugins · example on GitHub

Example

# KafkaConnectCustomPlugin — MSK Connect
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/kafkaconnect.html#kafkaconnectcustomplugin
apiVersion: aws.konfig.io/v1alpha1
kind: KafkaConnectCustomPlugin
metadata:
  name: example-kafkaconnectcustomplugin
  namespace: default
spec:
  contentType: JAR
  description: Managed by konfig-konector
  location:
    s3Location:
      bucketArn: arn:aws:iam::123456789012:role/example-role
      fileKey: example
      objectVersion: '1.0'
  name: example-kafkaconnectcustomplugin
  providerRef:
    name: example-kafkaconnectcustomplugin
    region: us-east-1
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
contentTypeenumyesThe type of the plugin file. Allowed: JAR, ZIP
descriptionstring—A summary description of the custom plugin.
locationobjectyesCreate-only in AWS: changing it requires replacing the resource.
location.s3LocationobjectyesKafkaConnectCustomPluginS3Location is a nested property type of AWS::KafkaConnect::CustomPlugin.
location.s3Location.bucketArnstringyesThe Amazon Resource Name (ARN) of an S3 bucket.
location.s3Location.fileKeystringyesThe file key for an object in an S3 bucket.
location.s3Location.objectVersionstring—The version of an object in an S3 bucket.
namestringyesThe name of the custom plugin.
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
tagsarray<object>—An array of key-value pairs to apply to this resource.
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
customPluginArnstring—The Amazon Resource Name (ARN) of the custom plugin to use.
fileDescriptionobject—Read-only: reported by AWS after creation.
fileDescription.fileMd5string—The hex-encoded MD5 checksum of the custom plugin file.
fileDescription.fileSizeinteger—The size in bytes of the custom plugin file.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.
revisioninteger—The revision of the custom plugin.

KafkaConnectWorkerConfiguration # CLOUD CONTROL · AWS::KafkaConnect::WorkerConfiguration

KafkaConnectWorkerConfiguration manages AWS::KafkaConnect::WorkerConfiguration through the AWS Cloud Control API.

kubectl get kafkaconnectworkerconfigurations · example on GitHub

Example

# KafkaConnectWorkerConfiguration — MSK Connect
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/kafkaconnect.html#kafkaconnectworkerconfiguration
apiVersion: aws.konfig.io/v1alpha1
kind: KafkaConnectWorkerConfiguration
metadata:
  name: example-kafkaconnectworkerconfiguration
  namespace: default
spec:
  description: Managed by konfig-konector
  name: example-kafkaconnectworkerconfiguration
  propertiesFileContent: example
  providerRef:
    name: example-kafkaconnectworkerconfiguration
    region: us-east-1
  tags:
  - key: example
    value: example

Spec

FieldTypeRequiredDescription
descriptionstring—A summary description of the worker configuration.
namestringyesThe name of the worker configuration.
propertiesFileContentstringyesBase64 encoded contents of connect-distributed.properties file.
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
tagsarray<object>—A collection of tags associated with a resource
tags[].keystringyes
tags[].valuestringyes

Status

FieldTypeRequiredDescription
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.
revisioninteger—The description of a revision of the worker configuration.
workerConfigurationArnstring—The Amazon Resource Name (ARN) of the custom configuration.