Uploaded image for project: 'Debezium'
  1. Debezium
  2. DBZ-3297

User Guide corrections for SQL Server connector

    XMLWordPrintable

    Details

      Description

      In Q3 2020 the content of chapter 3.6 Deploying Debezium PostgreSQL connectors of the User Guide was updated based on observations recorded by Ramesh. PostgreSQL, as described in DBZ-2621. Many of the corrections that were made also apply to the SQL Server connector documentation.

      Long-term, because the steps for deploying each of the connectors are more or less the same, the goal is to create a deployment module that can be added to the documentation for each connector via an include statement. For now, because the update implies some restructuring, I'll update each of the individual connector files separately. After I've worked through any inconsistencies, I'll go on to the next step of creating a shared module.

      ===============================================================
      Restructure content and consolidate subsections of 5.4.1 into a single procedure

      5.4.1.2 - in inventory-connector.yaml the "labels" is wrong it should be (lines smudged into a single line)

       labels: 
         strimzi.io/cluster: my-connect-cluster
      • The configuration example incorrectly refers to kind: KafkaConnector.
        It should be kind: KafkaConnect
      • Add the following annotation to the Kafka Connect resource yaml:
      apiVersion: kafka.strimzi.io/v1beta1
      kind: KafkaConnect
      metadata:  
      annotations:    
        strimzi.io/use-connector-resources: 'true'

      See the Strimzi blog for information about the annotation:
      https://strimzi.io/blog/2020/01/27/deploying-debezium-with-kafkaconnector-resource/
      -------------------------------------------------------------------------------

      -------------------------------------------------------------------------------
      5.4.1.3
      Step 2.ii and 2.iii
      Provide alternate docker commands alongside current podman build and push commands.
      Explicitly specify the target container registry in the examples, such as quay.io or registry.redhat.io.
      Update "push" examples by qualifying them with generic placeholders, for example, docker push <myregistry.io>/debezium-container-for-mysql:latest.
      See Step 3iii in Deploying Kafka Connect in the Getting Started guide.

      Step 5.i

      oc logs $(oc get pods -o name -l strimzi.io/name=my-connect-cluster-connect)

      should be

      oc logs $(oc get pods -o name -l strimzi.io/cluster=my-connect-cluster)
      -------------------------------------------------------------------------------

      The sample yaml file has

       apiVersion: kafka.strimzi.io/v1beta1

      It should be

      apiVersion: kafka.strimzi.io/v1alpha1 

      Not applicable. Streams 1.6 is based on Strimzi 0.20.1, for which v1beta1 is correct

      Updated the version literal with an attribute.

      -------------------------------------------------------------------------------

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              broldan Robert Roldan
              Reporter:
              broldan Robert Roldan
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: