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

User Guide Documentation corrections for PostgreSQL

    XMLWordPrintable

Details

    Description

      These are some observations based on Q3 User Guide document (chapter 3.6)

      https://access.redhat.com/documentation/en-us/red_hat_integration/2020-Q3/html-single/debezium_user_guide/index#adding-debezium-postgresql-connector-

      configuration-to-kafka-connect

       

      in the inventory-connector.yaml file 

      FROM is wrong in the example should be (see missing -rhel7)

      registry.redhat.io/amq7/amq-streams-kafka-25-rhel7:1.5.0 

      -------------------------------------------------------------------------------
      Section 3.6.3 need to come first than 3.6.2 and 3.6.1.  It is plain confusing to have these two sections. I suggest remove, or work them into 3.6.3

      Take the ending of 3.6.3 after build image into a separate section or direct users to
      use s2i process as it is easier (I know that would only apply for OpenShift, as defined in getting started guide)
      -------------------------------------------------------------------------------
      3.6.2 - in inventory-connector.yaml the "lables" is wrong it should be (lines smudged into a single line)

       labels: 
         strimzi.io/cluster: my-connect-cluster

      -------------------------------------------------------------------------------
      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)
      -------------------------------------------------------------------------------
      inventory-yaml has

       apiVersion: kafka.strimzi.io/v1beta1

      it should be

      apiVersion: kafka.strimzi.io/v1alpha1 

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

      Kafka Connect resource yaml requires the following annotation (at least on a default install)

      apiVersion: kafka.strimzi.io/v1beta1
      kind: KafkaConnectmetadata:  
      annotations:    
        strimzi.io/use-connector-resources: 'true' 

      it is defined in this blog
      https://strimzi.io/blog/2020/01/27/deploying-debezium-with-kafkaconnector-resource/
      -------------------------------------------------------------------------------
      maybe add in `plugin.name: pgoutput` in the `inventory-connector.yaml` in the configuration or as a note for any postgresql version >= 10

      Attachments

        Issue Links

          Activity

            People

              tcohen@redhat.com Tova Cohen
              rhn-engineering-rareddy Ramesh Reddy
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: